Update docs

This commit is contained in:
Artem Tsebrov 2023-04-17 22:02:13 +03:00
parent f6be90db46
commit 2fce7e72b4
3 changed files with 27 additions and 17 deletions

View File

@ -85,11 +85,17 @@ Reports are stored in "$pwd/build/reports/diktat-report.html".
Набор правил для поддержки оформления архитектуры.
Список доступных правил:
- `ru.touchin.codestyle.archunit.ClassNamingArchRules`
- `ru.touchin.codestyle.archunit.ClassPackagingArchRules`
#### Список доступных правил
- `ru.touchin.codestyle.archunit.rules.ClassNamingArchRules`
- `ru.touchin.codestyle.archunit.rules.ClassPackagingArchRules`
Как использовать совместно с плагином [ArchUnit Gradle Plugin](https://github.com/societe-generale/arch-unit-gradle-plugin):
#### Gradle plugin
Настройка и применение совместно с [ArchUnit Gradle Plugin](https://github.com/societe-generale/arch-unit-gradle-plugin).
Действие `checkRules` для проверки соответствие правилам запускается при операциях сборки, по умолчанию.
Вручную можно вызвать командой ``gradle :checkRules`` для нужного модуля.
Добавить его можно следующим образом на примере установки в рутовый gradle.build проекта:
Groovy DSL:
```groovy
@ -109,24 +115,24 @@ subprojects {
apply plugin: "com.societegenerale.commons.arch-unit-gradle-plugin"
archUnit {
mainScopePath = "/classes/kotlin/main"
testScopePath = "/classes/kotlin/test"
mainScopePath = "/classes/kotlin/main" // or "/classes/java/main"
testScopePath = "/classes/kotlin/test" // or /classes/java/test"
var applyType = applyOn("ru.touchin", "main")
configurableRules = [
configurableRule(
"ru.touchin.codestyle.archunit.ClassNamingArchRules",
"ru.touchin.codestyle.archunit.rules.ClassNamingArchRules",
applyType,
),
configurableRule(
"ru.touchin.codestyle.archunit.ClassPackagingArchRules",
"ru.touchin.codestyle.archunit.rules.ClassPackagingArchRules",
applyType,
),
]
}
dependencies {
archUnitExtraLib "ru.touchin:codestyle-archunit"
archUnitExtraLib "ru.touchin:codestyle-archunit" // or archUnitExtraLib project(":codestyle-archunit")
}
}
```
@ -147,12 +153,12 @@ subprojects {
apply(plugin = "com.societegenerale.commons.arch-unit-gradle-plugin")
archUnit {
mainScopePath = "/classes/kotlin/main"
testScopePath = "/classes/kotlin/test"
mainScopePath = "/classes/kotlin/main" // or "/classes/java/main"
testScopePath = "/classes/kotlin/test" // or /classes/java/test"
configurableRules = listOf(
"ru.touchin.codestyle.archunit.ClassNamingArchRules",
"ru.touchin.codestyle.archunit.ClassPackagingArchRules"
"ru.touchin.codestyle.archunit.rules.ClassNamingArchRules",
"ru.touchin.codestyle.archunit.rules.ClassPackagingArchRules"
).map { package ->
configurableRule(
package,
@ -162,10 +168,14 @@ subprojects {
}
dependencies {
archUnitExtraLib(project(":codestyle-archunit"))
archUnitExtraLib("ru.touchin:codestyle-archunit") // or archUnitExtraLib(project(":codestyle-archunit"))
}
}
// clear action launch for root project
```
Отключить проверки на таске помимо конфигурирования `configurableRule` можно также таким образом:
```kotlin
// clear action launch for root project to avoid exception
tasks.checkRules.configure {
actions.clear()
}

View File

@ -1,4 +1,4 @@
package ru.touchin.codestyle.archunit
package ru.touchin.codestyle.archunit.rules
import com.tngtech.archunit.lang.ArchRule
import com.tngtech.archunit.lang.syntax.ArchRuleDefinition.classes

View File

@ -1,4 +1,4 @@
package ru.touchin.codestyle.archunit
package ru.touchin.codestyle.archunit.rules
import com.tngtech.archunit.lang.ArchRule
import com.tngtech.archunit.lang.syntax.ArchRuleDefinition.classes