Python interface to Bugzilla.
Python Shell
Latest commit bb0ae5d Feb 5, 2017 @maekke maekke committed with add support for searching for addresses in CC field
Note from William:
This is not documented in Bugzilla's search API, so I don't really know
whether it is stable or not.
Failed to load latest commit information.
bugz add support for searching for addresses in CC field Feb 5, 2017
man man: Update the "SEE ALSO" section to include the other man pages Jan 1, 2017
.gitattributes do not add to the tarball Feb 20, 2011
.gitignore * .gitignore: Ignore 'tags' file and 'build' directory. Jan 22, 2013
LICENSE Add LICENSE to 0.7.x branch. Dec 31, 2007 remove old ChangeLog Aug 9, 2010
README Implement new configuration system and connection object Sep 29, 2014
lbugz lbugz: update documentation Sep 20, 2015 add documentation and examples Jul 9, 2016


PyBugz - Python Bugzilla Interface

Bugzilla has a very inefficient user interface, so I've written a
command line utility to interact with it. This is mainly done to help
me with closing bugs on Gentoo Bugzilla by grabbing patches, ebuilds
and so on.

Alastair Tse <>. Copyright (c) 2006 under GPL-2.


* Python 3.3 or later


* Searching bugzilla
* Listing details of a bug including comments and attachments
* Downloading/viewing attachments from bugzilla
* Posting bugs, comments, and making changes to an existing bug.
* Adding attachments to a bug.


PyBugz comes with a command line interface called "bugz". It's
operation is similar in style to cvs/svn where a subcommand is
required for operation. 

To explain how it works, I will use a typical workflow for Gentoo

1) Searching bugzilla for bugs I can fix, I'll run the command:

$ bugz search "version bump" --assigned-to

 * Using
 * Searching for "version bump"
 101968 liquidx              net-im/msnlib version bump
 125468 liquidx              version bump for dev-libs/g-wrap-1.9.6
 130608 liquidx              app-dicts/stardict version bump: 2.4.7

2) Narrow down on bug #101968, I can execute:

$ bugz get 101968

 * Using
 * Getting bug 130608 ..
Title       : app-dicts/stardict version bump: 2.4.7
Assignee    :
Reported    : 2006-04-20 07:36 PST
Updated     : 2006-05-29 23:18:12 PST
Status      : NEW
URL         :
Severity    : enhancement
Reporter    :
Priority    : P2
Comments    : 3
Attachments : 1

[ATTACH] [87844] [stardict 2.4.7 ebuild]

[Comment #1] : 2006-04-20 07:36 PST

3) Now this bug has an attachment submitted by the user, so I can
   easily pull that attachment in:

$ bugz attachment 87844

 * Using
 * Getting attachment 87844
 * Saving attachment: "stardict-2.4.7.ebuild"

4) If the ebuild is suitable, we can commit it using our normal
   repoman tools, and close the bug.

$ bugz modify 130608 --fixed -c "Thanks for the ebuild. Committed to

or if we find that the bug is invalid, we can close it by using:

$ bugz modify 130608 --invalid -c "Not reproducable"

Other options

bugz has an extensive help system for commands and options.

bugz --help gives help for the global options and subcommands, and
bugz <subcommand> --help gives help for that specific subcommand.

PyBugz Configuration

PyBugz supports a configuration system which defines defaults for
multiple Bugzilla installations and allows the system administrator and
individual users to override or add to these settings.

The supplied defaults are stored in /usr/share/pybugz.d/*.conf. The
system administrator can override or add to these defaults on a site-wide
basis by creating a directory /etc/pybugz.d and adding files with a
.conf extension to this directory. Individual users can override or add
to all of these settings by placing a file named .bugzrc in their home

For more information about this configuration system, see the
pybugz.d (5) man page.