Skip to main content

bugzilla plugin for helga

Project description

A Bugzilla plugin for helga chat bot
===================================

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/show_bug.cgi?id=1217809
[[TRACKER] SELinux support]

Installation
------------
This Bugzilla plugin is `available from PyPI
<https://pypi-hypernode.com/pypi/helga-bugzilla>`_, 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``.

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

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

Optionally you can also specify a short URL format::

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

The ``%(ticket)s`` format string will be replaced with the bug number.

Optional: Authenticated access
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

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

$ 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
``.bugzillacookies`` or ``.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-0.0.2.tar.gz (3.1 kB view details)

Uploaded Source

File details

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

File metadata

File hashes

Hashes for helga-bugzilla-0.0.2.tar.gz
Algorithm Hash digest
SHA256 f620e84d0a8f7c2a54d55c6f885e9e70a1b9e849c507f0af101f5a84831b83fb
MD5 725029ca1dd94fbf2418e4d696d9ff3b
BLAKE2b-256 70e71ee361e264c772851dbcb8615801862f7e095310b46dc9f2c8ef3a448281

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