Differences between revisions 2 and 3
Revision 2 as of 2007-01-17 19:20:34
Size: 1896
Comment: Add overview and reformat
Revision 3 as of 2007-01-17 21:53:12
Size: 1969
Comment: Add usage section
Deletions are marked like this. Additions are marked like this.
Line 53: Line 53:

=== Usage ===

This extension doesn't need user interaction to run.

Bugzilla Extension

This extension is currently being distributed along with Mercurial.

1. Overview

This extension lets automatically updating comments of bugzilla bugs when there's a reference to a bug id inside changesets.

The hook does not change bug status, it currently only adds comments.

2. Configuration

To use this extension enable it in the configuration file (hgrc) like this:

[extensions]
hgext.bugzilla =

[hooks]
# run bugzilla hook on every change pulled or pushed in here
incoming.bugzilla = python:hgext.bugzilla.hook

To configure the 'bugzilla' extension you can add items to '[bugzilla]' section of hgrc:

[bugzilla]
# REQUIRED ITEMS:
host = bugzilla # mysql server where bugzilla database lives
password = **   # user's password
version = 2.16  # version of bugzilla installed

# OPTIONAL ITEMS:
#   bzuser = ...    # fallback bugzilla user name to record comments with
#   db = bugs       # database to connect to
#   notify = ...    # command to run to get bugzilla to send mail
#   regexp = ...    # regexp to match bug ids (must contain one "()" group)
#   strip = 0       # number of slashes to strip for url paths
#   style = ...     # style file to use when formatting comments
#   template = ...  # template to use when formatting comments
#   timeout = 5     # database connection timeout (seconds)
#   user = bugs     # user to connect to database as
#   [web]
#   baseurl = http://hgserver/... # root of hg web site for browsing commits

If the hg committer names are not same as bugzilla user names, then use the "usermap" feature to map from committer email to bugzilla user name. The usermap can be in hgrc or separate config file.

[bugzilla]
usermap = filename # cfg file with "committer"="bugzilla user" info
[usermap]
committer_email = bugzilla_user_name

3. Usage

This extension doesn't need user interaction to run.

BugzillaExtension (last edited 2013-07-26 20:53:18 by JimHague)