Scopo | Genera aiuto per i moduli Python e le classi dal codice |
Versione Python | 2.1 e superiore |
A partire dal 1 gennaio 2021 le versioni 2.x di Python non sono piu' supportate. Ti invito a consultare la corrispondente versione 3.x dell'articolo per il modulo pydoc
Il modulo pydoc importa un modulo Python e ne usa il contenuto per generare un testo di aiuto in fase di esecuzione. L'output include le stringhe di documentazione per qualsiasi oggetto che ne sia dotato, e la descrizione di tutto il contenuto documentabile del modulo.
Lanciando:
$ pydoc atexit
Si ottiene un aiuto in testo semplice sulla console, usando il proprio pager (less, more o simili - n.d.t.), se configurato.
Si può anche far sì che pydoc generi un output HTML, sia scrivendo un file statico in una directory locale, che lanciando un web server per scorrere la documentazione in linea.
$ pydoc -w atexit
Crea
atexit.html
nella directory corrente.
$ pydoc -p 5000
Lancia un web server che ascolta
http://localhost:5000/
. Il server genera la documentazione mentre si scorrono i moduli disponibili.
pydoc aggiunge anche una funzione
help()
a
__builtins__
cosi' che si possa avere accesso alle stesse informazioni dal prompt dell'interprete Python.
$ python Python 2.6.2 (r262:71600, Apr 16 2009, 09:17:39) [GCC 4.0.1 (Apple Computer, Inc. build 5250)] on darwin Type "help", "copyright", "credits" or "license" for more information. >>> help('atexit') Help on module atexit: NAME atexit FILE /Library/Frameworks/Python.framework/Versions/2.6/lib/python2.6/atexit.py ...
Vedere anche: