Rulebook
Third-party rules for JVM and Python lint tools, meant to be used in conjunction
with official ones. Most of the rules are opinionated personal code styles.
However, some already exists in other linters, providing the same experience
across multiple languages.
View all rules
Download
Maven
repositories {
mavenCentral()
}
dependencies {
ktlint "com.hanggrian.rulebook:rulebook-ktlint:$version"
checkstyle "com.hanggrian.rulebook:rulebook-checkstyle:$version"
codenarc "com.hanggrian.rulebook:rulebook-codenarc:$version"
}
PyPI
pip install pylint regex rulebook-pylint
Usage
Ktlint
- Apply Ktlint Integration
to Gradle project.
- Using configuration
ktlint
, add this project as dependency.
configurations {
ktlint
}
dependencies {
ktlint "com.hanggrian.rulebook:rulebook-ktlint:$libraryVersion"
}
// the rest of ktlint tasks' configuration
Checkstyle
- Apply Checkstyle Gradle Plugin.
- Using configuration
checkstyle
, add this project as dependency. - Point to local config file or put in
/config/checkstyle/codenarc.xml
.
plugins {
checkstyle
}
checkstyle {
toolVersion "$checkstyleVersion"
configFile "path/to/rulebook_checkstyle.xml"
}
dependencies {
checkstyle "com.hanggrian.rulebook:rulebook-checkstyle:$libraryVersion"
}
CodeNarc
- Apply CodeNarc Gradle Plugin.
- Using configuration
codenarc
, add this project as dependency. - Point to local config file or put in
/config/codenarc/codenarc.xml
.
plugins {
codenarc
}
codenarc {
toolVersion "$codenarcVersion"
configFile "path/to/rulebook_codenarc.xml"
}
dependencies {
codenarc "com.hanggrian.rulebook:rulebook-codenarc:$libraryVersion"
}
Pylint
- Point config file to local
pylintrc
.
First time installation
Presuming the IDE is IntelliJ IDEA or PyCharm, consider applying the linter
style to it.
Ktlint
Explained in Ktlint IntelliJ IDEA Configuration,
using standard Kotlin coding conventions
is enough:
- In File > Settings > Editor > Code Style > Kotlin, set from
Kotlin style guide.
- Append
kotlin.code.style=official
to root gradle.properties
.
Checkstyle
Explained in Google Java Format:
Pylint
Apply few changes in settings:
- In File > Settings > Editor > Code Style > Python > Blank Lines:
- Set After local imports and Before the first method to 0.
- Set the rest to 1.