teamcontrol 0.0.2

Simple script to be used as the --to-cmd/--cc-cmd parameter on git's send-email command.

‘TeamControl’ is a git send-email --to-cmd/--cc-cmd tool for repositories with multiple teams and/or constantly changing teams without a mailing-list.

Install

Use your favorite tool to download from the Cheeseshop and install:

pip install teamcontrol

Or:

easy_install teamcontrol

If you’d rather download and install from the sources, simply run:

python setup.py install

Setup

A project using ‘TeamControl’ must have a configuration file easily accessible for every developer (either versioned along the sources or publicly available somewhere).

Configuration File

A configuration file is a basic ini-like file with sections describing teams and a set of rules which might trigger the inclusion of it’s members on a code review request. Example:

[members]
batman = [e-mail]
ironman = [e-mail]
superman = [e-mail]
thor = [e-mail]
wonderwoman = [e-mail]

[rules]
avcomics = ^comics/[Aa]vengers
dc = ^publisher/dc
jlcomics = ^comics/(the)?\justiceleague
marvel = ^published/marvel

[justiceleague]
members = batman, superman, wonderwoman
rules = dc, jlcomics

[avengers]
members = thor, ironman
rules = avcomics

There are two special sections in this file: [members] and [rules]: they define aliases for named used for members = and rules = options to ease organization.

Every other defined section is regarded as a team, as long as they define the members = and rules = options (they can be empty, but must exist).

So, what is a “rule”? A Rule is a valid Python regular expression which will be matched against the files being modified by a given patch (generated by git-format-patch). If any rule matches with one of the modified files the team this rule belongs to will be included in the review request.

Per-user Setup

Now that we have a configuration file publicly accessible for every developer each must setup her git configuration to call the application when asking for review:

# tip: you can set cccmd instead of tocmd if you prefer
git config sendemail.tocmd /usr/bin/teamcontrol

And adjust properties required by “TeamControl”:

git config teamcontrol.config /path/to/teamcontrol/config/file
git config teamcontrol.team justiceleague