Epydoc

Automatic API Documentation Generation for Python

Overview

Epydoc is a tool for generating API documentation for Python modules, based on their docstrings. For an example of epydoc's output, see the API documentation for epydoc itself (html, pdf). A lightweight markup language called epytext can be used to format docstrings, and to add information about specific fields, such as parameters and instance variables. Epydoc also understands docstrings written in reStructuredText, Javadoc, and plaintext. For a more extensive example of epydoc's output, see the API documentation for Python 2.5.

Latest Release

The latest stable release is Epydoc 3.0. If you wish to keep up on the latest developments, you can also get epydoc from the subversion repository. See Installing Epydoc for more information.

Screenshots

Generated HTML documentation for epydoc
Example of a UML graph generated by epydoc
Example of syntax highlighted source, w/ links to API docs
Identifier index page for generated Python 2.4 docs

News

Epydoc 3.0 released [January 2008]
Epydoc version 3.0 is now available on the SourceForge download page. See the What's New page for details. Epydoc is under active development; if you wish to keep up on the latest developments, you can get epydoc from the subversion repository. If you find any bugs, or have suggestions for improving it, please report them on sourceforge.

Presentation at PyCon [March 2004]
Epydoc was presented at PyCon by Edward Loper. Video and audio from the presentation are available for download.