commitlint plugin to use functions as rule value
npm install commitlint-plugin-function-rules[commitlint][commitlint] plugin to use functions as rule value.
- Create custom function, sync or async, as rule value.
- Create rules that are based on the commit message.
- Write rules with regular expressions.
- Use the same rules that are [available in commitlint][commitlint].
---
- Install
- Usage
- Contributing
- Security policy
- License
``shell`
npm install --save-dev commitlint-plugin-function-rules @commitlint/cli @commitlint/config-conventional
Use this plugin in your project's [commitlint][commitlint] configuration by specifying it as item in the plugins array. All rules have same name as rules that are [available in commitlint][rules], but with the function-rules prefix. The example commitlint.config.js, or commitlint.config.cjs if the package is an ES module, shows the usage of a function rule.
> Note The available rules are the same as in [commitlint][commitlint], so it is recommended to disable the [commitlint][commitlint] rule when specifying a function rule to avoid undefined behaviour.
`js``
module.exports = {
extends: ['@commitlint/config-conventional'],
plugins: ['commitlint-plugin-function-rules'],
rules: {
'header-max-length': [0], // level: disabled
'function-rules/header-max-length': [
2, // level: error
'always',
(parsed) => {
// Allow longer headers for commits with "deps" scope.
if (parsed.scope === 'deps' && parsed.header.length <= 200) {
return [true];
}
return [false, 'deps header must not be longer than 200 characters'];
},
],
},
};
Please create an issue if you have a bug report or feature proposal, or create a discussion if you have a question. If you like this project, please consider giving it a star ⭐
Refer to the contributing guide for detailed information about other contributions, like pull requests.
Please refer to the Security Policy on GitHub for the security policy.
This project is licensed under the GPLv3 license.
Copyright © 2020-2026 Jeroen de Bruijn
This program is free software: you can redistribute it and/or modify This program is distributed in the hope that it will be useful, You should have received a copy of the GNU General Public License The full text of the license is available in the LICENSE file in this repository and online.License notice
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
along with this program. If not, see
[commitlint]: https://commitlint.js.org/
[rules]: https://commitlint.js.org/#/reference-rules