Checks if commit message matches the chaos-hub commit rules
Project description
commit-msg-hook
This hook is made as a custom plugin under the pre-commit hook framework and checks if commit message matches the chaos-hub team commit rules.
Installation
pip install commit-msg-hook
Using commit-msg-hook with pre-commit
For more details see: pre-commit
Install pre-commit package manager
pip install pre-commit
Create a file .pre-commit-config.yaml
in the root folder with the following configuration
- repo: https://github.com/dimaka-wix/commit-msg-hook.git
rev: v0.3.2
hooks:
- id: commit-msg-hook
stages: [commit-msg]
To enable commit-msg hook with pre-commit run:
pre-commit install --hook-type commit-msg
Update to the latest release (optional)
pre-commit autoupdate --repo https://github.com/dimaka-wix/commit-msg-hook.git
Commit Rules
- Write up to 72 characters(preventing ellipsis in git)
- Capitalize the subject line
- Use the imperative mood(e.g. Add instead of Added, Adds or Adding)
- Do not end the lines with any punctuation character
- Use the description to explain what and why vs how
- In case of multiline message do the following:
- Press Shift+Enter to create a new line and to write more characters then vscode lets you
- Separate subject line from message body with a blank line
- Follow the rules above when writing each line of the message
Example
Refactor foo function in x file from y component
* Remove duplications
* Add docstrings
* Update the types of arguments
Bypass the hook in one of the following ways
SKIP=commit-msg-hook git commit -m "Your message"
git commit -m "Your message" --no-verify
git commit -m "Your message" -n (not recommended)
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
commit-msg-hook-0.3.2.tar.gz
(5.3 kB
view hashes)
Built Distribution
Close
Hashes for commit_msg_hook-0.3.2-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 62b9ef08fb892a0ea972b24d27dfd073d513f46d3a711a456fa7dc0a801d6b60 |
|
MD5 | f219f13311c6043558366d2d806c507f |
|
BLAKE2b-256 | d6c1e9f5ff316f5eadb60d6bf640bf88084000db236b3c75463485260ef1ddeb |