Git commit hook for adding related JIRA issue ids to commit messages.

Issue id is parsed from the current branch name and prepended to your commit message.

$ git checkout -b EXAMPLE-123-new-feature
$ git add some_code.py
$ git commit -m "Added some pretty code."
$ git log
    ...
    EXAMPLE-123 Added some pretty code.

Here's the specification generated from spec.py tests:

• prepends issue id from branch name to commit message
• prepends first matching issue id to commit message if multiple ids in branch name exist
• prepends issue id to commit message when message contains a different issue id
• doesnt modify commit message if issue id not in branch name
• doesnt modify commit message if it already contains this issue id
• doesnt modify commit message if in detached HEAD state
• supports aborting a commit by providing an empty message
• supports aborting a commit by exiting from editor without making changes

1. Copy commit-msg file into .git/hooks/ directory of your project's repository.
2. Make sure the commit-msg file has execution mode flag set (chmod +x commit-msg).

This plugin requires having Python 2.x or Python 3.x installed (comes pre-installed on OS X and Ubuntu). Verified against versions 2.7 and 3.4.

It's possible to apply this hook to every newly cloned or initialized repository using git's template directory feature:

1. Create a directory for your git templates and put this commit-msg script into it, e.g. into ~/.git-templates/hooks/commit-msg.
2. Configure git to use your template directory when initializing repositories: git config --global init.templatedir ~/.git-templates.

Customizations are supported by opening your copy of commit-msg file and adjusting the configuration variables.

Provide your commit message formatting by changing commit_message_format variable.

By default, issue ids matching the default JIRA project key pattern are discovered. You can customize the project key pattern or explicitly specify the project key to look for by adjusting project_format variable.

JIRA issue ids are supported by default, but the hook can support any other issue id patterns. Simply change the issue_pattern variable to a regular expression that matches the issue ids from your ticket system.

As this commit hook depends on parsing the current branch name, it won't work when committing in detached HEAD state, e.g. when doing a reword operation during git rebase --interactive.