[Python] Rilasciato Epydoc 3.0 beta

Daniele Varrazzo piro a develer.com
Mar 27 Feb 2007 11:08:04 CET


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 <epydoc-devel a lists.sourceforge.net>.

Buona giornata!

-- 
Daniele Varrazzo - Develer S.r.l.
http://www.develer.com


Maggiori informazioni sulla lista Python