Buongiorno a tutti,
Epydoc 3.0 beta è disponibile per il download da SourceForge.
Epydoc è un tool per la generazione della documentazione delle API per i
moduli Python, in grado di ottenere informazioni tramite l'estrazione delle
docstring.
- La homepage di Epydoc.
<http://epydoc.sourceforge.net/>
- Pagina di download.
<http://sourceforge.net/project/platformdownload.php?group_id=32455>
Per qualche esempio della documentazione generata da Epydoc potete vedere:
- La documentazione delle API di Epydoc stesso.
<http://epydoc.sourceforge.net/api/>
- La documentazione delle API della libreria standard di Python 2.4.
<http://epydoc.sourceforge.net/stdlib/>
- La documentazione delle API di NLTK, "the natural language toolkit".
<http://nltk.sourceforge.net/lite/doc/api/>
Il cambiamento più importante da Epydoc 2.1 consiste nel modo in cui le
informazione sulla documentazione vengono estratte dai moduli. Nelle versioni
precedenti i moduli venivano importati e sottoposti ad introspezione per
esaminarne il contenuto; la nuova versione affianca all'introspezione il
parsing dei sorgenti, riuscendo ad unire i vantaggi di entrambi gli approcci.
Ad esempio tramite parsing è possibile documentare le variabili associandovi
una docstring o estraendone i commenti.
Per un elenco completo delle novità disponibili vi rimando alla pagina del
sito:
<http://epydoc.sourceforge.net/whatsnew.html>
Se avete suggerimenti su come migliorare Epydoc, o se trovate bug, potete
riportarli sui tracker di SourceForge:
- Bugs: <http://tinyurl.com/odvfw>
- Features: <http://tinyurl.com/p2rl8>
o potete mandare un'e-mail a <[EMAIL PROTECTED]>.
Buona giornata!
--
Daniele Varrazzo - Develer S.r.l.
http://www.develer.com
_______________________________________________
Python mailing list
Python@lists.python.it
http://lists.python.it/mailman/listinfo/python
