[python-bugzilla] Stale reference to _query
Brian Bouterse
bmbouter at gmail.com
Mon Jun 1 18:43:15 UTC 2015
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.
-Brian
On Mon, Jun 1, 2015 at 10:08 AM, Cole Robinson <crobinso at 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 at lists.fedorahosted.org
> https://lists.fedorahosted.org/mailman/listinfo/python-bugzilla
>
--
Brian Bouterse
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.fedorahosted.org/pipermail/python-bugzilla/attachments/20150601/116c84f8/attachment.html>
More information about the python-bugzilla
mailing list