| 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: