NAME

       pybugz.d - configuration files for pybugz

SYNOPSIS

       /usr/share/pybugz.d/*.conf

       /etc/pybugz.d/*.conf

       ~/.bugzrc

DESCRIPTION

       When started, bugz reads configuration files from all of the locations listed above, in the order listed.
       In the directories, it reads the files in lexical order.

       Files located in /usr/share/pybugz.d/*.conf are provided by pybugz and should not be modified.

       Files located in /etc/pybugz.d/*.conf, if it exists, are provided by the system administrator.

       The  final  file  that  is  read,  if  it  exists,  is  ~/.bugzrc  by  default. This is the user-specific
       configuration file. This file name can be overridden on the  command  line  by  using  the  --config-file
       option.

CONFIGURATION FILE FORMAT

       A  configuration  file  consists of sections which define parameters for the Bugzillas you intend to use.
       Each section starts with a case-sensitive section  name  in  square  brackets  and  is  followed  by  the
       settings,  in  the  form  "key  =  value" or "key : value", which define the parameters for this bugzilla
       instance.

       The section name is  also the name that should be used with the --connection option of the  bugz  command
       or the "connection" setting in the default section of the configuration file.

       The section named [default] is special. Any settings defined in this section will have the value they are
       given here in all other sections unless they are overridden. So, for example, if you want to use the same
       username for most of your bugzillas, define user in the default section.

       Comments are also allowed. A comment must begin with "#" or ";" and be on a line of its own.

CONFIGURATION SETTINGS

       This is a list of the current settings supported by pybugz.

       connection = sectionname

       This  is  used in the default section to define the bugzilla you connect with most of the time. It is not
       an error to put it in another section, but it does not make much sense to do so.

       base = http://my.project.com/bugzilla/xmlrpc.cgi

       base = http://myhttpname:myhttppasswd@my.project.com/bugzilla/xmlrpc.cgi

       This is the base URL  of  the  bugzilla.  It  must  point  to  the  xmlrpc.cgi  script  on  the  bugzilla
       installation.  The  second  form  is  used if you need to encode a username and password into the URL for
       basic http authentication.

       user = myname@my.project.com

       password = secret2

       These set your username and password for this bugzilla. If you do not provide one or both  of  these  and
       you do not use the key setting below, you will be prompted for the setting you do not provide.

       passwordcmd = gpg --decrypt ~/.my-encrypted-password.gpg

       As  another  alternative for storing your password, you can provide a password command. This command will
       be run, and pybugz expects it to output the password to stdout. The example above uses gpg to decrypt  an
       encrypted  password stored in a file. The default setting is undefined, so it will not be used unless you
       define it.

       key = string

       This is your API key, which is an alternative way to authenticate for Bugzilla 5.0  and  newer.   To  use
       this,  you must generate an API key in the preferences section of Bugzilla and set it to that value. This
       overrides the username and password settings. The default is undefined.

       columns = 80

       This is the number of columns your terminal can display. Most of the  time,  pybugz  should  be  able  to
       determine  this  value. If it cannot, the default value is 80, so more than likely you will never have to
       change this setting.

       debug = 0

       This sets the level of debug logging. This is mostly used for development purposes. It causes  PyBugz  to
       print out debugging information as it runs.

       quiet = False

       If  set  to  true,  this requests that pybugz run in quiet mode. This means only output returned from the
       Bugzilla will be displayed; several more verbose log messages will not be displayed.

       product = string

       This is the default setting for the product field in bugs in this Bugzilla instance. It  is  possible  to
       define  this  in the default section.  However, it does not make sense to do so most of the time. If this
       is set, you will not be prompted for a product when you run bugz post, and this value will  also  be  the
       default for bugz search.

       component = string

       This  is the default setting for the component field in bugs in this Bugzilla instance. It is possible to
       define this in the default section.  However, it does not make sense to do so most of the time.  If  this
       is  set,  you  will  not  be  prompted  for a component when you run bugz post, and this will also be the
       default value for bugz search.

       search_statuses = confirmed, in_progress, unconfirmed

       This sets the default statuses to be used in a search command. It is a space separated list  of  Bugzilla
       statuses.

       insecure = true | false

       If  this  is set to true, pybugz will not validate the ssl certificate used during an https connection to
       this site. Do not use this setting unless you know exactly what you are doing.

BUGS

       The home page of this project is http://www.github.com/williamh/pybugz.  Bugs should be reported  to  the
       bug tracker there.

AUTHOR

       William Hubbs <w.d.hubbs@gmail.com>

0.12                                               20 Jan 2013                                       pybugz.d(5)