Skip to main content

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


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)

Uploaded Source

Built Distribution

commit_msg_hook-0.2.0-py2.py3-none-any.whl (5.2 kB view details)

Uploaded Python 2 Python 3

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

Hashes for commit-msg-hook-0.2.0.tar.gz
Algorithm Hash digest
SHA256 c4c8e0a7b855b0ed01fb4d45ee0365e4055c2feba37d3b3dae232b460c4590f7
MD5 08fae9b121494422a0649fd766540fc2
BLAKE2b-256 6c49912e97b42bb4259a5056c8a85434f9ae653801dc0a58eae8f5dc287b17d9

See more details on using hashes here.

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

Hashes for commit_msg_hook-0.2.0-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 ccf163f924cb60bd77b17d543bf73bc5eca4a00be8c6677353d6670f159ea54a
MD5 525b81b704c91079a6ff13fa25ae0e87
BLAKE2b-256 8ae9facc7c317e6bfe345c5aabd89cca0f7c83b8f7a0772cb9651268cd9fef58

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page