Checks if commit message matches the chaos-hub commit rules
Project description
commit-msg-hook
This hook is made as custom plugins 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
See pre-commit for instructions
Add this to your .pre-commit-config.yaml
- repo: https://github.com/DimaKarpukhin/commit-msg-hook.git
rev: v0.2.0
hooks:
- id: commit-msg-hook
stages: [commit-msg]
# args is optional, the default length limit is 72
args: [--max-msg-length=<number>]
Update to the latest release (optional)
pre-commit autoupdate --repo https://github.com/DimaKarpukhin/commit-msg-hook.git
Commit Rules
- Write up to 72 characters(preventing ellipsis in git)
- Capitalise the subject line
- Do not end the subject line with a period
- Use the imperative mood(e.g. Add instead of Added)
- Start message with one of following prefixes
- Fix ...
- Add ...
- Refactor ...
- Update ...
- Remove ...
- Release ...
- Move ...
- Tslint ...
- Rename ...
- Merge ...
- Change ...
- Use the description to explain what and why vs how
- Press Shift+Enter to create a new line and to write more characters then vscode lets you
- Separate subject from body with a blank line!
- Use in/from format in suject line to add the place where the change was made (file/component)
Example
Refactor Z function in X file from Y component
- Fix ...
- Add ...
- Update ...
Bypass the hook
git commit -m "Your message" --no-verify
or
git commit -m "Your message" -n
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.2.0.tar.gz
(4.7 kB
view details)
Built Distribution
File details
Details for the file commit-msg-hook-0.2.0.tar.gz
.
File metadata
- Download URL: commit-msg-hook-0.2.0.tar.gz
- Upload date:
- Size: 4.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.4.1 importlib_metadata/4.0.0 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.60.0 CPython/3.9.4
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | c4c8e0a7b855b0ed01fb4d45ee0365e4055c2feba37d3b3dae232b460c4590f7 |
|
MD5 | 08fae9b121494422a0649fd766540fc2 |
|
BLAKE2b-256 | 6c49912e97b42bb4259a5056c8a85434f9ae653801dc0a58eae8f5dc287b17d9 |
File details
Details for the file commit_msg_hook-0.2.0-py2.py3-none-any.whl
.
File metadata
- Download URL: commit_msg_hook-0.2.0-py2.py3-none-any.whl
- Upload date:
- Size: 5.2 kB
- Tags: Python 2, Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.4.1 importlib_metadata/4.0.0 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.60.0 CPython/3.9.4
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | ccf163f924cb60bd77b17d543bf73bc5eca4a00be8c6677353d6670f159ea54a |
|
MD5 | 525b81b704c91079a6ff13fa25ae0e87 |
|
BLAKE2b-256 | 8ae9facc7c317e6bfe345c5aabd89cca0f7c83b8f7a0772cb9651268cd9fef58 |