no documention on how to debug launchpadlib request patterns.

[Robert Collins]

Leonard manages to show really lovely detailed traces of the requests that launchpadlib makes when talking about performance. I wants to knows how to do this myself - and for other users to be able to figure it out.

I suggest that launchpadlib/__init__.py have a module level docstring that either contain [good] pointers to existing things (such as httplib2's debugging instructions [if it has any]) or contain brief 'do X to get Y' information. pydoc launchpadlib is something that I would expect most python programmers to try - or even looking at the source themselves. Either way, it should be fairly discoverable, and being the root probably doesn't conflict with autogenerated help from wadl or anything like that, either.

[Robert Collins (lifeless)]

20:52 < leonardr> sure
20:52 < leonardr> the simplest way to do it is:
20:52 < leonardr> import httplib2
20:52 < leonardr> httplib2.debuglevel = 1
20:52 < lifeless> how would you feel about that being in the docstring for launchpadlib/__init__.py ?
20:53 < leonardr> sounds good
20:53 < lifeless> would you like me to propose a merge for that ?
20:53 < lifeless> or do you want to JFDI ? :)
20:53 < leonardr> sure. i can also put timing information in lazr.restfulclient that's controlled by httplib2.debuglevel or a separate debuglevel
20:53 < leonardr> httplib2's debuglevel won't give your elapsed time
20:53 < lifeless> ok

[Gary Poster (gary)]

This sounds like a good quick win for performance analysis as well as an easy way to ask for more information in bug reports.