Jonathan Robie wrote:
Ted Ross wrote:
I seem to recall using a tool called amqp-doc (in qpid/python) to
generate pydoc-style output for the AMQP specification. This output
included the "generated" parts of the API.
Unfortunately, that tool doesn't seem to work in the latest SVN.
Ideally, I'd like to find a way to produce documentation that shows me
whatever I can call in Python, generated or not, in one place. I'll
look at amqp-doc to see what it did.
Here's what I found:
1. The last version of amqp-doc that worked seemed to be around version 2.1
2. The underlying data structures have changed since then, which broke
the amqp-doc tool
3. The methods I want to document are not instantiated when the spec is
first loaded, they seem to be instantiated when first invoked. Rafi is
on vacation, so I have to wait for him to return and verify that. But if
I understand this correctly, there's nothing for pydoc to see unless I
force each method to be instantiated.
At this point, generating complete Python API docs seems to be a
non-trivial exercise. If I'm wrong, I'm sure Rafi will point it out and
I'll give it another try on Monday.
Jonathan
