GitZilla 1.9.1

GitZilla is Python module to support Git-Bugzilla integration. There are various ways of using GitZilla.

Note that GitZilla must be installed on the machine receiving commits from everyone - home to the the "official" or the "central" repository.

Usage:

Simple ready scripts

To quickly start using GitZilla:

 * Install GitZilla. You may choose the .deb for easy installation on Debian/Ubuntu systems. Otherwise, just unpack the source and install in the usual setuptools way:

 sudo python setup.py install

 * Switch to the hooks directory (/path/to/repository/.git/hooks) and delete the post-receive and update hooks.
 * Link (or copy) the gitzilla provided hooks:

 ln -s $(which gitzilla-post-receive) post-receive
 ln -s $(which gitzilla-update) update

 * Read and edit the config file at /etc/gitzillarc. A simple (and sufficient for most cases) configuration is something like:

 [/path/to/repository/.git]
 bugzilla_url: https://repo.example.com/bugzilla/
 bugzilla_user: foo@example.com
 bugzilla_password: blahblah
 allowed_bug_states: NEW, ASSIGNED, REOPENED

 (and even the last item is optional!)

 * Commit away!

Configuration:

GitZilla uses a global configuration file (at /etc/gitzillarc) as well as per-user configuration files (at ~/.gitzillarc). All the configuration options are picked up from the global config file, and the user specific config is allowed to override only the bugzilla_user and bugzilla_password parameters.

The configuration files themselves are in the ConfigParser format (see http://docs.python.org/library/configparser.html). A sample configuration looks like:

[/path/to/repository/.git]
bugzilla_url: https://repo.example.com/bugzilla/
bugzilla_user: foo@example.com
bugzilla_password: blahblah
allowed_bug_states: NEW, ASSIGNED, REOPENED
logfile: /var/log/gitzilla.log
loglevel: info

Each git repository on the system MUST have its own section. The global config MUST specify the bugzilla_url, bugzilla_user and bugzilla_password parameters.

The user specific files are entirely optional.


Product's homepage

Requirements:

· Python
· PyBugz