Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jcamp-code/commitlint-config-unjs
A commitlint config for unjs's changelogen tool
https://github.com/jcamp-code/commitlint-config-unjs
Last synced: 23 days ago
JSON representation
A commitlint config for unjs's changelogen tool
- Host: GitHub
- URL: https://github.com/jcamp-code/commitlint-config-unjs
- Owner: jcamp-code
- License: mit
- Created: 2023-04-04T01:06:00.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-04-13T16:52:12.000Z (9 months ago)
- Last Synced: 2024-04-14T06:58:58.218Z (9 months ago)
- Language: TypeScript
- Size: 97.7 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 11
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
> Lint your conventional commits, extended for use with [changelogen](https://github.com/unjs/changelogen)
# commitlint-config-unjs
Shareable `commitlint` config enforcing [conventional commits](https://conventionalcommits.org/).
Use with [@commitlint/cli](https://npm.im/@commitlint/cli) and [@commitlint/prompt-cli](https://npm.im/@commitlint/prompt-cli).
## Changes
Identical to [@commitlint/config-conventional](https://github.com/conventional-changelog/commitlint/tree/master/%40commitlint/config-conventional), with these changes:
- Added `examples`, `types` for compatibility with [changelogen](https://github.com/unjs/changelogen)
- Updated commitizen icons to match [changelogen](https://github.com/unjs/changelogen)
- Added a `wip` type for commits that should not hit the changelog
## Getting started
```sh
npm install --save-dev @commitlint-config-unjs @commitlint/cli
echo "module.exports = {extends: ['unjs']};" > commitlint.config.js
```
## Rules
### Problems
The following rules are considered problems for `commitlint-config-unjs` and will yield a non-zero exit code when not met.
Consult [docs/rules](https://conventional-changelog.github.io/commitlint/#/reference-rules) for a list of available rules.
#### type-enum
- **condition**: `type` is found in value
- **rule**: `always`
- **level**: `error`
- **value**
```
[
'build',
'chore',
'ci',
'docs',
'examples',
'feat',
'fix',
'perf',
'refactor',
'revert',
'style',
'test',
'types',
'wip'
];
```
```sh
echo "foo: some message" # fails
echo "fix: some message" # passes
```
#### type-case
- **description**: `type` is in case `value`
- **rule**: `always`
- **level**: `error`
- **value**
```
'lowerCase'
```
```sh
echo "FIX: some message" # fails
echo "fix: some message" # passes
```
#### type-empty
- **condition**: `type` is empty
- **rule**: `never`
- **level**: `error`
```sh
echo ": some message" # fails
echo "fix: some message" # passes
```
#### subject-case
- **condition**: `subject` is in one of the cases `['sentence-case', 'start-case', 'pascal-case', 'upper-case']`
- **rule**: `never`
- **level**: `error`
```sh
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**: `subject` is empty
- **rule**: `never`
- **level**: `error`
```sh
echo "fix:" # fails
echo "fix: some message" # passes
```
#### subject-full-stop
- **condition**: `subject` ends with `value`
- **rule**: `never`
- **level**: `error`
- **value**
```
'.'
```
```sh
echo "fix: some message." # fails
echo "fix: some message" # passes
```
#### header-max-length
- **condition**: `header` has `value` or less characters
- **rule**: `always`
- **level**: `error`
- **value**
```
100
```
```sh
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**: `footer` should have a leading blank line
- **rule**: `always`
- level: `warning`
```sh
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**: `footer` each line has `value` or less characters
- **rule**: `always`
- level: `error`
- **value**
```
100
```
```sh
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**: `body` should have a leading blank line
- **rule**: `always`
- level: `warning`
```sh
echo "fix: some message
body" # warning
echo "fix: some message
body" # passes
```
#### body-max-line-length
- **condition**: `body` each line has `value` or less characters
- **rule**: `always`
- level: `error`
- **value**
```
100
```
```sh
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
```