post_receive_email.py

Introduction

This is a Git post-receive hook script written in Python that will sendemails when commits are pushed to the repository. It has nodependencies other than Python and Git (i.e. it does not usesendmail).

Status

The script:

Always uses TLS when sending emails.
Sets the Reply-To header to the author of the commit.
Only handles commits. No effort has yet been made to handle merge commits.

I will continue to develop this script as the need for morefunctionality arises.

Configuration

The script uses the following configuration variables:

hooks.mailinglist

A comma separted list of email recipients.

hooks.emailprefix

All emails will have their subjects prefixed with the value of thisvariable

hooks.smtp-subject

If this variable is set the subject line will be formatted accordingto this template. The format is the same as for Python stringinterpolation when using dictionaries for the values.

The available keys are:

%(prefix)s - The value of hooks.emailprefix.
%(ref_name)s - The ref name sent to post_receive(eg. refs/heads/master)
%(hash)s - The abbreviated commit hash.
%(index)s - An individual commit's order number among all thecommits being pushed.
%(message)s - The first line of the commit message.

The default subject template is%(prefix)s %(ref_name)s commit %(hash)s if one commit is being pushedand %(prefix)s %(ref_name)s commit #%(index)s %(hash)s if more thanone is being pushed.

hooks.smtp-host