[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