This holds several tools and code developped in the frame of the
HELIOS project's WP3 on bugtracker synchronisation.

More details may be found at :
https://picoforge.int-evry.fr/cgi-bin/twiki/view/Helios_wp3/Web/


Here one will find :

* an improved version of the python btsutils package that will be able
to process a local copy of the database of the Debian bugtracker
(debbugs), much like what bts-link does (see debbugsloc.py which
extends btsutils.debbugs).

* npmdebbugs.py : will process bugs to output RDF version (turtle
  format) compatible with ontologies used by the nepomuk project (see
  http://nepomuk.linbox.org/wiki)


debbugsloc.py extension for btsutils
------------------------------------

The original python btsutils code was developped as part of the
project at : http://bug-triage.alioth.debian.org/ and is available in
the Debian package 'python-btsutils'.

Here, debbugsloc.py overloads the debbugs class from btsutils to add
spool backend support.

The debbugs database consists in the "spool" '.summary' files. We're
reusing code from a modified version of the bts-link tool, to extend
btsutils .

Note that the The bts-link code needs to be patched to add reading of
the following bugs attributes : Summary, Severity, Submitter and
Subject.

See my (Olivier Berger) git repo at
http://www-public.it-sudparis.eu/~berger_o/git/bts-link.git/ (git
clone http://www-public.it-sudparis.eu/~berger_o/git/bts-link.git/),
or in bts/interfaces.py, in BtsSpoolReport's constructor, add :

        if 'Summary' in spooldata:
            self.summary    = spooldata['Summary']
        else:
            self.summary    = ''
        self.severity   = spooldata['Severity']
        self.submitter  = spooldata['Submitter']
        self.subject  = spooldata['Subject']


The debbugs database mirror/spool must have been fetched locally (see
bts-link's bin/btslink-spoolindex.sh script) and a btslink.cfg file
needs to have been setup.

Example scripts :

* check-summary-soap.py : will demonstrate access of
  python-btsutils API through the spool database

  To check attributes of all bugs open on package twiki :

  # python check-summary-soap.py $(bts select package:twiki | xargs echo -n)

  Explanation :
    "bts select package:twiki" : will return the bug numbers associated
    to a particular package