commit-msg-hook 0.2.6

Checks if commit message matches the chaos-hub commit rules

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

See pre-commit for instructions

Add this to your .pre-commit-config.yaml

-   repo: hhttps://github.com/dimaka-wix/commit-msg-hook.git
    rev: v0.2.6
    hooks:
    -   id: commit-msg-hookcs
        stages: [commit-msg]

Add valid prefixes(optional)

Add additional prefixes as an args: separated by , after the keyword --prefix and end with the delimiter --

Example

hooks:
   -   id: commit-msg-hookcs
       args: [--prefix, Check, Modify, --]
       stages: [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)
• 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
  • Add ...
  • Change ...
  • Create ...
  • Disable ...
  • Fix ...
  • Merge ...
  • Move ...
  • Refactor ...
  • Release ...
  • Remove ...
  • Rename ...
  • Tslint ...
  • Update ...
• 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!

Example

Refactor Z function in X file from Y component
<optional part, adding it leave an empty line here>
- Fix ...
- Add ...
- Update ...

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)