1pybugz.d(5) File Formats Manual pybugz.d(5)
2
3
4
6 pybugz.d - configuration files for pybugz
7
9 /usr/share/pybugz.d/*.conf
10
11 /etc/pybugz.d/*.conf
12
13 ~/.bugzrc
14
16 When started, bugz reads configuration files from all of the locations
17 listed above, in the order listed. In the directories, it reads the
18 files in lexical order.
19
20 Files located in /usr/share/pybugz.d/*.conf are provided by pybugz and
21 should not be modified.
22
23 Files located in /etc/pybugz.d/*.conf, if it exists, are provided by
24 the system administrator.
25
26 The final file that is read, if it exists, is ~/.bugzrc by default.
27 This is the user-specific configuration file. This file name can be
28 overridden on the command line by using the --config-file option.
29
31 A configuration file consists of sections which define parameters for
32 the Bugzillas you intend to use. Each section starts with a case-
33 sensitive section name in square brackets and is followed by the
34 settings, in the form "key = value" or "key : value", which define the
35 parameters for this bugzilla instance.
36
37 The section name is also the name that should be used with the
38 --connection option of the bugz command or the "connection" setting in
39 the default section of the configuration file.
40
41 The section named [default] is special. Any settings defined in this
42 section will have the value they are given here in all other sections
43 unless they are overridden. So, for example, if you want to use the
44 same username for most of your bugzillas, define user in the default
45 section.
46
47 Comments are also allowed. A comment must begin with "#" or ";" and be
48 on a line of its own.
49
51 This is a list of the current settings supported by pybugz.
52
53 connection = sectionname
54
55 This is used in the default section to define the bugzilla you connect
56 with most of the time. It is not an error to put it in another section,
57 but it does not make much sense to do so.
58
59 base = http://my.project.com/bugzilla/xmlrpc.cgi
60
61 base =
62 http://myhttpname:myhttppasswd@my.project.com/bugzilla/xmlrpc.cgi
63
64 This is the base URL of the bugzilla. It must point to the xmlrpc.cgi
65 script on the bugzilla installation. The second form is used if you
66 need to encode a username and password into the URL for basic http
67 authentication.
68
69 user = myname@my.project.com
70
71 password = secret2
72
73 These set your username and password for this bugzilla. If you do not
74 provide these, you will be prompted for them.
75
76 passwordcmd = gpg --decrypt ~/.my-encrypted-password.gpg
77
78 As another alternative for storing your password, you can provide a
79 password command. This command will be run, and pybugz expects it to
80 output the password to stdout. The example above uses gpg to decrypt an
81 encrypted password stored in a file. The default setting is undefined,
82 so it will not be used unless you define it.
83
84 columns = 80
85
86 This is the number of columns your terminal can display. Most of the
87 time, pybugz should be able to determine this value. If it cannot, the
88 default value is 80, so more than likely you will never have to change
89 this setting.
90
91 debug = 0
92
93 This sets the level of debug logging. This is mostly used for
94 development purposes. It causes PyBugz to print out debugging
95 information as it runs.
96
97 quiet = False
98
99 If set to true, this requests that pybugz run in quiet mode. This means
100 only output returned from the Bugzilla will be displayed; several more
101 verbose log messages will not be displayed.
102
103 product = string
104
105 This is the default setting for the product field in bugs in this
106 Bugzilla instance. It is possible to define this in the default
107 section. However, it does not make sense to do so most of the time. If
108 this is set, you will not be prompted for a product when you run bugz
109 post, and this value will also be the default for bugz search.
110
111 component = string
112
113 This is the default setting for the component field in bugs in this
114 Bugzilla instance. It is possible to define this in the default
115 section. However, it does not make sense to do so most of the time. If
116 this is set, you will not be prompted for a component when you run bugz
117 post, and this will also be the default value for bugz search.
118
119 search_statuses = confirmed in_progress unconfirmed
120
121 This sets the default statuses to be used in a search command. It is a
122 space separated list of Bugzilla statuses.
123
125 The home page of this project is http://www.github.com/williamh/pybugz.
126 Bugs should be reported to the bug tracker there.
127
129 William Hubbs <w.d.hubbs@gmail.com>
130
131
132
1330.12 20 Jan 2013 pybugz.d(5)