cz-jira-smart-commit-validated

About

Standardize your team's commits using this adapter for commitzen.

This adapter makes it possible to specify and validate the commit of a project that uses Jira as a tool of management. Using this tool you can benefit from using Jira's smart commit commands more easily without having to worry about remembering which commands are available and which syntax must be respected. Besides, it is a perfect adapter to be used together with semantic versioning.

This adapter was based on cz-jira-smart-commit and cz-conventional-changelog.

Highlights

Standardizes the squad commit;
Can be used together with semantic-release;
Prevents typing errors, preventing an erroneous flow in relation to smart commit commands;
Prevents an invalid team from being informed to Jira, forcing the default(1w 1d 1h 1m);
Prevents an Issue ID from being informed with a key different from the one specified as default;
Validates the commit title size respecting the defined limitation.

Example

Flow sample:

Sample of the result of mounting the commit using this adapter:

Installation

If using yarn:

yarn add cz-jira-smart-commit-validated

If using npm:

npm i cz-jira-smart-commit-validated

Usage

Reference cz-jira-smart-commit-validated path in commitzen path property:

{
    ...
 "config": {
        "commitizen": {
            "path": "./node_modules/cz-jira-smart-commit-validated",
            "disableScopeLowerCase": false,
            "disableSubjectLowerCase": false,
            "maxHeaderWidth": 100,
            "maxLineWidth": 100,
            "defaultType": "",
            "defaultScope": "",
            "defaultSubject": "",
            "defaultBody": "",
            "defaultIssuesPrefix": "EVOLOG",
            "enableMultiIssuesIdByCommit": false
        }
    }
}

Example of what would look like package.json of a project using cz-jira-smart-commit-validated.

To use adapter after integration with commitzen, just run:

git cz

or if you prefer, you can use husky to trigger the hook prepare-commmit-msg. Inside this hook this line should be executed:

exec < /dev/tty && node_modules/.bin/cz --hook || true

Example of how the hook would look:

#!/bin/sh
. "$(dirname "$0")/_/husky.sh"

    exec < /dev/tty && node_modules/.bin/cz --hook || true

So whenever the command is executed:

git commit

The commitzen will be triggered via the husky using cz-jira-smart-commit-validated.

Documentation