The docstring for Bugzilla.query def query(self, query): '''Query bugzilla and return a list of matching bugs. query must be a dict with fields like those in in querydata['fields']. Returns a list of Bug objects. Also see the _query() method for details about the underlying implementation. ''' refers to _query, but this method is no longer very informative: def _query(self, query): # This is kinda redundant now, but various scripts call # _query with their own assembled dictionaries, so don't # drop this lest we needlessly break those users log.debug("Calling Bug.search with: %s", query) return self._proxy.Bug.search(query) So it's a bit difficult to figure out how to actually compose queries.

It would be good for issues to get created for things that we know are wrong. Currently the homepage says to e-mail the list with issues, but I'll suggest that using a bugtracker would be better. Now that the code is hosted on github, what do users think about using the github issue tracker? The irony of using bugzilla to track python-bugzilla bugs is not lost on me, but it would be very convenient. Wherever bugs are kept, consider creating an issue to update specific docstrings that are out of date.

On Mon, Jun 1, 2015 at 10:08 AM, Cole Robinson <crobinso(a)redhat.com <mailto:crobinso@redhat.com>> wrote: On 06/01/2015 05:26 AM, Florian Weimer wrote: > The docstring for Bugzilla.query > > def query(self, query): > '''Query bugzilla and return a list of matching bugs. > query must be a dict with fields like those in in > querydata['fields']. > Returns a list of Bug objects. > Also see the _query() method for details about the underlying > implementation. > ''' > refers to _query, but this method is no longer very informative: > > def _query(self, query): > # This is kinda redundant now, but various scripts call > # _query with their own assembled dictionaries, so don't > # drop this lest we needlessly break those users > log.debug("Calling Bug.search with: %s", query) > return self._proxy.Bug.search(query) > > So it's a bit difficult to figure out how to actually compose queries. > Yeah many of the docstrings are out of date, sorry about that. If you're looking for code examples I recommend checking what /usr/bin/bugzilla does, it generally represents the preferred API usage. - Cole _______________________________________________ python-bugzilla mailing list python-bugzilla(a)lists.fedorahosted.org <mailto:python-bugzilla@lists.fedorahosted.org> https://lists.fedorahosted.org/mailman/listinfo/python-bugzilla -- Brian Bouterse