You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
|
|
2 years ago | |
|---|---|---|
| .. | ||
| README.md | 2 years ago | |
| index.js | 2 years ago | |
| license.md | 2 years ago | |
| package.json | 2 years ago | |
README.md
Lint your conventional commits
@commitlint/config-conventional
Shareable commitlint config enforcing conventional commits.
Use with @commitlint/cli and @commitlint/prompt-cli.
Getting started
npm install --save-dev @commitlint/config-conventional @commitlint/cli
echo "module.exports = {extends: ['@commitlint/config-conventional']};" > commitlint.config.js
Rules
Problems
The following rules are considered problems for @commitlint/config-conventional and will yield a non-zero exit code when not met.
Consult docs/rules for a list of available rules.
type-enum
-
condition:
typeis found in value -
rule:
always -
level:
error -
value
[ 'build', 'chore', 'ci', 'docs', 'feat', 'fix', 'perf', 'refactor', 'revert', 'style', 'test' ];
echo "foo: some message" # fails
echo "fix: some message" # passes
type-case
- description:
typeis in casevalue - rule:
always - level:
error - value
'lowerCase'
echo "FIX: some message" # fails
echo "fix: some message" # passes
type-empty
- condition:
typeis empty - rule:
never - level:
error
echo ": some message" # fails
echo "fix: some message" # passes
subject-case
- condition:
subjectis in one of the cases['sentence-case', 'start-case', 'pascal-case', 'upper-case'] - rule:
never - level:
error
echo "fix(SCOPE): Some message" # fails
echo "fix(SCOPE): Some Message" # fails
echo "fix(SCOPE): SomeMessage" # fails
echo "fix(SCOPE): SOMEMESSAGE" # fails
echo "fix(scope): some message" # passes
echo "fix(scope): some Message" # passes
subject-empty
- condition:
subjectis empty - rule:
never - level:
error
echo "fix:" # fails
echo "fix: some message" # passes
subject-full-stop
- condition:
subjectends withvalue - rule:
never - level:
error - value
'.'
echo "fix: some message." # fails
echo "fix: some message" # passes
header-max-length
- condition:
headerhasvalueor less characters - rule:
always - level:
error - value
100
echo "fix: some message that is way too long and breaks the line max-length by several characters" # fails
echo "fix: some message" # passes
footer-leading-blank
- condition:
footershould have a leading blank line - rule:
always - level:
warning
echo "fix: some message
BREAKING CHANGE: It will be significant" # warning
echo "fix: some message
BREAKING CHANGE: It will be significant" # passes
footer-max-line-length
- condition:
footereach line hasvalueor less characters - rule:
always - level:
error - value
100
echo "fix: some message
BREAKING CHANGE: footer with multiple lines
has a message that is way too long and will break the line rule 'line-max-length' by several characters" # fails
echo "fix: some message
BREAKING CHANGE: footer with multiple lines
but still no line is too long" # passes
body-leading-blank
- condition:
bodyshould have a leading blank line - rule:
always - level:
warning
echo "fix: some message
body" # warning
echo "fix: some message
body" # passes
body-max-line-length
- condition:
bodyeach line hasvalueor less characters - rule:
always - level:
error - value
100
echo "fix: some message
body with multiple lines
has a message that is way too long and will break the line rule 'line-max-length' by several characters" # fails
echo "fix: some message
body with multiple lines
but still no line is too long" # passes