Skip to main content

bugzilla plugin for helga

Project description

https://travis-ci.org/ktdreyer/helga-bugzilla.svg?branch=master https://badge.fury.io/py/helga-bugzilla.svg

About

Helga is a Python chat bot. Full documentation can be found at http://helga.readthedocs.org.

This Bugzilla plugin allows Helga to respond to Bugzilla ticket numbers in IRC and print information about the tickets. For example:

03:14 < ktdreyer> bz 1217809
03:14 < helgabot> ktdreyer might be talking about
                  https://bugzilla.redhat.com/1217809
                  [[TRACKER] SELinux support]

Installation

This Bugzilla plugin is available from PyPI, so you can simply install it with pip:

pip install helga-bugzilla

If you want to hack on the helga-bugzilla source code, in your virtualenv where you are running Helga, clone a copy of this repository from GitHub and run python setup.py develop.

Optional: URL Configuration

In your settings.py file (or whatever you pass to helga --settings), you can specify a BUGZILLA_XMLRPC_URL. For example:

BUGZILLA_XMLRPC_URL = 'https://bugzilla.redhat.com/xmlrpc.cgi'

(If you do not specify this setting, the plugin will use txbugzilla’s default URL, which is Red Hat’s bugzilla.)

You can also specify a URL format:

BUGZILLA_TICKET_URL = "https://bugzilla.redhat.com/%(ticket)s"

The %(ticket)s format string will be replaced with the bug number. Since the underlying library (txbugzilla) already constructs these web URLs for bugs automatically, you probably don’t need to add this setting to helga. It’s only necessary if your custom Bugzilla requires some other URL scheme.

Optional: Authenticated access

By default, Helga only reads tickets that are publicly accessible. You may optionally give Helga privileged access to Bugzilla and allow Helga to read private bugs by setting up a python-bugzilla credential:

$ pip install python-bugzilla
$ bugzilla login
(enter your username and password)

(Use the --bugzilla=https://bugzilla.example.com/xmlrpc.cgi argument here if the XMLRPC URI is not the default, https://bugzilla.redhat.com/xmlrpc.cgi)

This bugzilla login command will save your login credential to .bugzillatoken. When this is set, Helga will be able to read private bugs with using the permissions of the user to whom the API key belongs.

Note: This authentication feature can expose private information (ticket subjects) about your Bugzilla bugs. If you use this feature, be sure that the networks to which Helga connects are restricted. Everyone in Helga’s channels will see the private information, so the assumption is that they already have rights to read the private bugs.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

helga-bugzilla-1.2.1.tar.gz (5.3 kB view details)

Uploaded Source

File details

Details for the file helga-bugzilla-1.2.1.tar.gz.

File metadata

File hashes

Hashes for helga-bugzilla-1.2.1.tar.gz
Algorithm Hash digest
SHA256 e958fd615901fa18ac77eb6f8efa61ad609c458191247e8b6adf19da32d17de9
MD5 28615775b5c7f3e31e881e9db9ec79c7
BLAKE2b-256 979463b45c7001cbe361eaf121fe1c90966ac1a43342b405b247e1dd9ee30cec

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page