redmine plugin for helga
Helga is a Python chat bot. Full documentation can be found at http://helga.readthedocs.org.
This Redmine plugin allows Helga to respond to Redmine ticket numbers in IRC and print information about the tickets. For example:
03:14 < ktdreyer> issue 8825 03:14 < helgabot> ktdreyer might be talking about http://tracker.ceph.com/issues/8825 [ceph-deploy tox tests not working with python-remoto (CEPH_DEPLOY_NO_VENDOR)]
You can specify multiple tickets as well:
03:14 < ktdreyer> issue 123 and issue 456 03:14 < helgabot> ktdreyer might be talking about http://tracker.ceph.com/issues/123 [fix msgr message retry seq numbering] and http://tracker.ceph.com/issues/456 [make dumpjournal functionality usable]
Or more simply, “issues <numbers>,”, like so:
03:14 < ktdreyer> issues 777, 888, and 999 03:14 < helgabot> ktdreyer might be talking about http://tracker.ceph.com/issues/777 [mount hung, tid timed out messages in log], http://tracker.ceph.com/issues/888 [get new sepia machines into autotest pool] and http://tracker.ceph.com/issues/999 [Duplicate Bucket Created]
This Redmine plugin is available from PyPI, so you can simply install it with pip:
pip install helga-redmine
If you want to hack on the helga-redmine source code, in your virtualenv where you are running Helga, clone a copy of this repository from GitHub and run python setup.py develop.
In your settings.py file (or whatever you pass to helga --settings), you must specify a REDMINE_URL. For example:
REDMINE_URL = "http://tracker.ceph.com/issues/%(ticket)s"
The %(ticket)s format string will be replaced with the ticket number.
Optional: Authenticated access
By default, Helga only reads tickets that are publicly accessible. You may optionally give Helga privilieged access to Redmine and allow Helga to read private tickets by setting the REDMINE_API_KEY variable:
REDMINE_API_KEY = "598bde2b1ee7082b5ead63712a9fc41dcc4ea160"
The Redmine software provides each user account with its own API key that looks like a sha1 string. This string can be found by browsing to the “/my/account” page in Redmine.
When REDMINE_API_KEY is set, Helga will be able to read private tickets 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 Redmine 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 tickets.