I'm happy to announce a new release of python-bugzilla, version 1.1.0.
python-bugzilla is a library and commandline tool for interacting with a bugzilla instance, including querying, modifying, and creating bug reports.
The release can be downloaded from:
https://fedorahosted.org/released/python-bugzilla/python-bugzilla-1.1.0.tar....
This release includes:
- Support for bugzilla tokens (Arun Babu Nelicattu) - bugzilla: Add query/modify --tags - bugzilla --login: Allow to login and run a command in one shot - bugzilla --no-cache-credentials: Don't use or save cached credentials when using the CLI - Show bugzilla errors when login fails - Don't pull down attachments in bug.refresh(), need to get bug.attachments manually - Add Bugzilla bug_autorefresh parameter.
Some of these changes deserve a bit more explanation:
* Bugzilla tokens
Sometime later in the year, bugzilla.redhat.com will be updated to a new version of bugzilla that replaces API cookie authentication with a non-cookie token system. I don't fully understand the reasoning so don't ask :) Regardless, this release supports the new token infrastructure along side the existing cookie handling.
Users shouldn't notice any difference: we cache the token in ~/.bugzillatoken so things work the same as the current cookie auth.
If you use cookiefile=None in the API to tell bugzilla _not_ to cache any login credentials, you will now also want to specify tokenfile=None (hint hint fedora infrastructure).
* bugzilla --login and bugzilla --no-cache-credentials
Right now the only way to perform an authenticated bugzilla command on a new machine requires running a one time 'bugzilla login' to cache credentials before running the desired command.
Now you can just do 'bugzilla --login <cmd>' and the login process will be initiated before invoking the command.
Additionally, the --no-cache-credentials option will tell the bugzilla tool to _not_ save any credentials to ~/.bugzillacookies or ~/.bugzillatoken.
* Bugzilla.bug_autorefresh
When interacting with a Bug object, if you attempt to access a property (say, bugobj.component) that hasn't already been fetched from the bugzilla instance, python-bugzilla will do an automatic 'refresh'/getbug to pull down every property for said bug in an attempt to satisfy the request.
This is convenient for a one off API invocation, but for recurring scripts this is a waste of time and bugzilla bandwidth. The autorefresh can be avoided by passing a properly formatted include_fields to your query request, where include_fields contains every Bug property you will access in your script.
However it's still quite easy to extend a script with a new property usage and forget to adjust include_fields. Things will continue to work due to the autorefresh feature but your script will be far slower and wasteful.
A new Bugzilla property has been added, bug_autorefresh. Set this to False to disable the autorefresh feature for newly fetched bugs. This will cause an explicit error to be raised if your code is depending on autorefresh.
Please consider setting this property for your recurring scripts. Example:
bzapi = Bugzilla("bugzilla.redhat.com") bzapi.bug_autorefresh = False ...
autorefresh can be disabled for individual bugs with:
bug.autorefresh = False
Thanks to everyone who has contributed to this release through testing, bug reporting, submitting patches, and otherwise sending in feedback!
Thanks, Cole
python-bugzilla@lists.stg.fedorahosted.org