summaryrefslogtreecommitdiffstats
path: root/contrib/bug-bugzilla/README
blob: 08bc3d85c67d869582d680b1b067d2e7005fe537 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
Bug-Bugzilla
============

Authors: Christian Reis <kiko@async.com.br>
         Eric Raymond <esr@thyrsus.com>

Bug-Bugzilla is a simple Python program that creates bugs in a Bugzilla
instance. It takes as input text resembling message headers (RFC-822
formatted) via standard input, or optionally a number of commandline
parameters. It communicates using HTTP, which allows it to work over a
network.

Requirements
------------

Its only requirement is Python 2.3 or higher; you should have the
"python" executable in your path.

Usage Notes
-----------

* Please constrain testing to your own installation of Bugzilla, or use
* http://landfill.bugzilla.org/ for testing purposes -- opening test
* bugs on production instances of Bugzilla is definitely not a good idea

Run "bug-bugzilla --help" for a description of the possible options.

An example input file, named bugdata.txt, is provided. You can pipe it
in as standard input to bug-bugzilla, providing a Bugzilla URI through
the command-line.

Note that you must create a ~/.netrc entry to authenticate against the
Bugzilla instance. The entry's machine field is a *quoted* Bugzilla URI,
the login field is your ID on that host, and the password field is the
your password password. An example entry follows:

    machine "http://bugzilla.mozilla.org/"
    login foo@bar.loo
    password snarf

Documentation
-------------

Documentation for bug-bugzilla is provided in Docbook format; see
bug-bugzilla.xml.