Git Commit Notifier
by Bodo Tasche (bodo ‘at’ wannawork ‘dot’ de), Akzhan Abdulin (akzhan ‘dot’ abdulin ‘at’ gmail ‘dot’ com), Csoma Zoltan (Primalgrasp) (zoltan ‘at’ primalgrasp ‘dot’ com)
Sends email commit messages splitting commits that were pushed in one step.
Email is delivered as text or HTML with changes refined per word. Emails
have a scanable subject containing the first sentence of the commit as well
as the author, project and branch name.
It’s also possible to send a mail to a newsgroup using NNTP.
[rails][branch] Fix Brasilia timezone. [#1180 state:resolved]
A reply-to header is added containing the author of the commit. This makes
follow up really simple. If multiple commits are pushed at once, emails are
numbered in chronological order:
[rails][branch] Added deprecated warning messages to Float#months and Float#years deprications. [rails][branch] Enhance testing for fractional days and weeks. Update changelog.
Installing and Configuring
Install the gem:
sudo gem install git-commit-notifier
After you installed the gem, you need to configure your git repository. Add a file called
“post-receive” to the “hooks” directory of your git repository with this content:
#!/bin/sh git-commit-notifier path_to_config.yml
(Don’t forget to make that file executable.)
An example for the config file can be found in config/git-notifier-config.yml.sample.
If you want to send mails on each commit instead on each pull, you should add a file called “post-commit” with this content:
#!/bin/sh echo "HEAD^1 HEAD refs/heads/master" | git-commit-notifier path_to_config.yml
Integration with Redmine, Bugzilla, MediaWiki
Git-commit-notifier supports easy integration with Redmine, Bugzilla and MediaWiki. All you need is to uncomment the according line in the configuration and change the links to your software installations instead of example ones (no trailing slash please).
- “BUG 123” sentence in commit message will be replaced with link to bug in Bugzilla.
- “refs #123” and “fixes #123” sentences in commit message will be replaced with link to issue in Redmine.
- “[[SomePage]]” sentence in commit message will be replaced with link to page in MediaWiki.
Integration of links to other websites
If you need integration with other websites not supported by git-commit-notifier you can use the message_map property. For that you need to know basics of regular expressions syntax.
Each key of message_map is a case sensitive Regexp pattern, and its value is the replacement string.
Every matched group (that defined by round brackets in regular expression) will be automatically substituted instead of \1-\9 backreferences in replacement string where number after backslash informs which group should be substituted instead of the backreference. The first matched group is known as \1.
For example, when we need to expand “follow 23” to http://example.com/answer/23, simply type this:
Key and value are enclosed into single quotes. \b means that “follow” must not be preceded by other word chars, so “befollow” will not match but “be follow” will match. After “follow” we expect one or more spaces followed by group of one or more digits. The \1 in the result url will be replaced with the matched group.
More examples can be found in the config file.
Logic of commits handling
Commit notifier use special files named *previously.txt to track already
handled commits to not send repeated messages about commits.
By default all commits tracked through overall repository so after merge action
You should not receive messages about commits those already posted in other branches.
This behaviour can be changed using unique_commits_per_branch option. When it’s true,
you should receive new message about commit when it’s merged in other branch.
Yet another option, skip_commits_older_than (in days), should be used to not inform about
old commits in processes of forking, branching etc.
Note on Patches/Pull Requests
- Fork the project.
- Make your feature addition or bug fix.
- Add tests for it. This is important so I don’t break it in a
future version unintentionally.
- Commit, do not mess with rakefile, version, or history.
(if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
- Send me a pull request. Bonus points for topic branches.
Permission denied – /var/git/repo/previously.txt (Errno::EACCES)
The file previously.txt is created at the first commit. If you moved the file to the server, you have to check the rights to that file and fix them if needed. The git repo owner needs the right to write into that file.
MIT License, see the file LICENSE.