Registry / devops / conventional-pre-commit

conventional-pre-commit

JSON →
library4.4.0pypypiunverified

A pre-commit hook that validates commit messages against the Conventional Commits specification. Supports husky-style configuration and custom patterns. Version 4.4.0, actively maintained, released monthly.

devops
pip install conventional-pre-commit
github ↗package ↗
INSTALL
IMPORT
SIG · CONVENTIONAL-PRE-C
C
conventional-pre-commit
devopspythonv4.4.0
harness data pending
Install & Compatibility
Where this runs

No compatibility data collected yet for this library.

Code
Verified usage

Minimal pre-commit config to validate commit messages.

# In .pre-commit-config.yaml repos: - repo: https://github.com/compilerla/conventional-pre-commit rev: v4.4.0 hooks: - id: conventional-pre-commit stages: [commit-msg] args: [] # optional: add --strict, --force-scope, etc.
conventional-pre-commit --version
Debug
Known issues
gotchaThe hook only runs on commit-msg stage. If you use a different stage (e.g., pre-commit), it will not validate the message.
fix
Set stages: [commit-msg] in your hook config.
affects: all
gotchaArguments like --strict or --force-scope are passed via the args list in pre-commit config, not environment variables.
fix
Use args: [--strict] in the hook definition.
affects: all
breakingIn version 4.0.0, the default behavior changed from allowing short footers to requiring full Conventional Commits spec. Old configs may reject previously valid messages.
fix
Update commit messages to match spec or use --no-verify temporarily.
affects: >= 4.0.0
Errors
Common errors & fixes
conventional-pre-commit: error: argument types: invalid choice: 'feat' (choose from 'feat', 'fix', 'docs', 'style', 'refactor', 'perf', 'test', 'build', 'ci', 'chore', 'revert')
Misspelled type or custom type not allowed by default.
fix
Use one of the allowed types or add --types 'type1,type2' to allow custom types.
conventional-pre-commit: error: unrecognized arguments: --force-scope
Typo or incorrect argument name.
fix
Use the correct argument: --force-scope (double dash). Check official docs.
Upgrade
Version history
4.4.0latest on PyPI · released Feb 18, 2026
Audit
Dependencies

No dependency data recorded yet.

Agent activity
10 hits · last 30 days
node
10
Resources
githubhttps://github.com/compilerla/conventional-pre-commit ↗
packagehttps://pypi.org/project/conventional-pre-commit/ ↗
conventional-pre-commit — pip install conventional-pre-commit · libregistry