Pybugz

This article is a stub. Please help out by expanding it - how to get started.

Resources

Home

Official documentation

GitWeb

Package information

Pybugz is a command line interface to Gentoo Bugzilla. It is geared towards Bugzilla users that find the web interface inefficient.

It's features include:

• Searching bugzilla
• Listing details of a bug including comments and attachments
• Downloading/viewing attachments
• Posting bugs & comments
• Making changes to existing bugs
• Adding attachments to bugs

Installation

Emerge

Install the www-client/pybugz package:

root #emerge --ask www-client/pybugz

Documentation

Please read man 5 pybugz.d for configuring pybugz. The README on GitHub has general informations. Help about using bugz is available with

user $bugz <subcommand> -h

The subcommands are: attach, attachment, connections, get, modify, post, search.

Easy configuration for bugs.gentoo.org

pybugz comes with a predefined profile for bugs.gentoo.org except for a required API key. Create an API key in the web interface and write it to the suitable place(s)

bugzilla.gentoo.org screenshot with numbers: 1 Preferences, 2 API Keys

• Visit the API keys tab and login if prompted
• Generate a new key and write an optional description
• Edit ~/.bugzrc and add:

FILE ~/.bugzrc

[Gentoo]
key=<api key>

• Do this for every user, e.g. root, <user>

Check if everything works with

bugzilla.gentoo.org screenshot assisting in generating a new API key. With numbers: 3 activated check box, 4 optional description, 5 Submit changes

bugzilla.gentoo.org screenshot showing the generated key. 6: the generated key to copy to .bugzrc

user $bugz search arm64

Examples

Attach plain text file $log to bug nr 12345

user $bugz attach -c "text/plain" -d "build log" 12345 $log

Search for version bump bugs assigned to maintainer-needed:

user $bugz search "version bump" --assigned-to maintainer-needed

Get more info about a bug nr 12345

user $bugz get 12345

Mark bug 12345 as fixed and send a custom message

user $bugz modify 12345 --fixed -c "This bug was closed in #<commit_hash>"

Mark bug 12345 as invalid and send a custom message

user $bugz modify 12345 --invalid -c "Not reproducable"