[python-bugzilla] Stale reference to _query
Cole Robinson
crobinso at redhat.com
Mon Jun 1 19:15:01 UTC 2015
On 06/01/2015 02:43 PM, Brian Bouterse wrote:
> 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.
>
Indeed, once we finish the transition to github, I intend to publicize its
issue tracker as our official bug tracker. So if anyone wants to file a github
issue about auditing docstrings and point to this thread, I'm all for it
- Cole
>
>
>
> On Mon, Jun 1, 2015 at 10:08 AM, Cole Robinson <crobinso at redhat.com
> <mailto: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
> <mailto:python-bugzilla at lists.fedorahosted.org>
> https://lists.fedorahosted.org/mailman/listinfo/python-bugzilla
>
>
>
>
> --
> Brian Bouterse
More information about the python-bugzilla
mailing list