postgresql_autodoc in Python?

Tino Wildenhain tino at wildenhain.de
Mon Dec 7 09:44:16 EST 2009


Am 07.12.2009 15:14, schrieb Jean-Michel Pichavant:
> Wolfgang Keller wrote:
>> Hello,
>>
>> has anyone ever implemented something similar to postgresql_autodoc in
>> Python?
>>
>> TIA,
>>
>> Sincerely,
>>
>> Wolfgang
>>
> If by postgresql_autodoc you mean tools for generating html
> documentation from python code, yes.
>
> Starting from the ugliest:
>
> - pydoc
> - epydoc
> - sphinx
>
> are 3 of them. I would suggest epydoc, the best look&feel/complexity
> ratio. Sphinx is used to generate any kind of documentation (look at
> http://docs.python.org/ it's build with Sphinx) but I never figured out
> how to easily build documentation from code despite it states it is
> posible. With epydoc you only need to press the GO button.

I suspect he meant documenting postgres database structure.

One way would be reading the informaton_schema* and generating python
code out of it then use any of the above methods to finally document the
stuff :-)

*) http://www.alberton.info/postgresql_meta_info.html

Regards
Tino

-------------- next part --------------
A non-text attachment was scrubbed...
Name: smime.p7s
Type: application/pkcs7-signature
Size: 3254 bytes
Desc: S/MIME Cryptographic Signature
URL: <http://mail.python.org/pipermail/python-list/attachments/20091207/bb175a09/attachment-0001.bin>


More information about the Python-list mailing list