BugsSite/contrib/bugzilla-submit/README

   1 bugzilla-submit
   2 ===============
   3
   4 Authors: Christian Reis <kiko@async.com.br>
   5          Eric Raymond <esr@thyrsus.com>
   6
   7 bugzilla-submit is a simple Python program that creates bugs in a Bugzilla
   8 instance. It takes as input text resembling message headers (RFC-822
   9 formatted) via standard input, or optionally a number of commandline
  10 parameters. It communicates using HTTP, which allows it to work over a
  11 network.
  12
  13 Requirements
  14 ------------
  15
  16 Its only requirement is Python 2.3 or higher; you should have the
  17 "python" executable in your path.
  18
  19 Usage Notes
  20 -----------
  21
  22 * Please constrain testing to your own installation of Bugzilla, or use
  23 * http://landfill.bugzilla.org/ for testing purposes -- opening test
  24 * bugs on production instances of Bugzilla is definitely not a good idea
  25
  26 Run "bugzilla-submit --help" for a description of the possible options.
  27
  28 An example input file, named bugdata.txt, is provided. You can pipe it
  29 in as standard input to bugzilla-submit, providing a Bugzilla URI through
  30 the command-line.
  31
  32 Note that you must create a ~/.netrc entry to authenticate against the
  33 Bugzilla instance. The entry's machine field is a *quoted* Bugzilla URI,
  34 the login field is your ID on that host, and the password field is the
  35 your password password. An example entry follows:
  36
  37     machine "http://bugzilla.mozilla.org/"
  38     login foo@bar.loo
  39     password snarf
  40
  41 Documentation
  42 -------------
  43
  44 Documentation for bugzilla-submit is provided in Docbook format; see
  45 bugzilla-submit.xml.
  46