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>