Re: [RFC] Add a new email notification script to "contrib"

From: Michael Haggerty <mhagger@alum.mit.edu>
Date: Nov 8, 2012, 09:42 UTC
Message-ID: <509B7E6B.1030407@alum.mit.edu>
In-Reply-To: <CACBZZX6=e6_qO=wMcxLdUAc6XxYpdiP-9RPRsCXrVC_iuJ11Jg@mail.gmail.com>

On 11/07/2012 10:47 PM, Ævar Arnfjörð Bjarmason wrote:

Show 17 quoted lines

> On Fri, Jul 20, 2012 at 12:01 PM, Michael Haggerty <mhagger@alum.mit.edu> wrote:
>> On 07/14/2012 08:59 AM, mhagger@alum.mit.edu wrote:
>>>
>>> Add a new Python script, contrib/hooks/post-receive-multimail.py, that
>>> can be used to send notification emails describing pushes into a git
>>> repository.  [...]
>>
>>
>> Thanks to everybody for your feedback.  I will try to incorporate it in a
>> new version of the script, which I will put forward as a replacement for
>> contrib/hooks/post-receive-email rather than as an alternative.  But I have
>> very little open-sourcing time these days, and will be on vacation next
>> week, so please be patient (or feel free to lend a hand if you are so
>> inclined).
> 
> I'm curious as to whether you got around to this? I'd be interested in
> updates on this script.

Thanks for asking. I have made many of the changes that were requested and/or I had planned:

* Tentatively renamed the system to git-multimail

* Store the configuration in namespace "multimailhook.*" instead of
"hooks.*".

* Reinstated (optional) support for including shortlogs since the last
tag in announce emails.

* Script to migrate post-receive-email configuration to the equivalent
git-multimail config.

* Better documentation (including of the migration process).

* Made it easier to use Python code to customize the script's behavior
(by allowing it to be imported as a Python module), plus a demo script
showing this usage.

* Some primitive testing tools to generate a test git repository and
generate many kinds of notification emails (though the emails still have
to be checked manually for correctness).

But I haven't submitted the new version because I just haven't had a good block of time to really wrap it up and call it a "final" version. One remaining question is how to fit it into the git source tree along with its supporting materials (or even whether to maintain it as a separate project).

Nevertheless I think that the script is quite usable as it is and it would be great if other people could try it out, give feedback, and even submit patches.

So I just created a github repository containing my current version:

    https://github.com/mhagger/git-multimail

Enjoy!

Michael

-- 
Michael Haggerty
mhagger@alum.mit.edu
http://softwareswirl.blogspot.com/