pydoctor - Online in the Cloud

PROGRAM:

NAME

pydoctor - API documentation generator for Python

SYNOPSIS

pydoctor [options]

DESCRIPTION

Pydoctor is an API documentation generator that works primarily by static analysis.

It was written primarily to replace epydoc for the purposes of the Twisted project as
epydoc has difficulties with zope.interface, but can be used for non-Zope Python code as
well.

OPTIONS

-h, --help
show this help message and exit

-c CONFIGFILE, --config=CONFIGFILE
Use config from this file (any command lineoptions override settings from the
file).

-p INPUTPICKLE, --input-pickle=INPUTPICKLE
Load the system from this pickle file (default: none, a blank system is created).

-o OUTPUTPICKLE, --output-pickle=OUTPUTPICKLE
Save the system to this pickle file (default: none, the system is not saved by
default).

--extra-system=SYS:URLPREFIX
Look for objects in this system to. Links to these objects will have URLPREFIX
prepended to them.

--system-class=SYSTEMCLASS
A dotted name of the class to use to make a system.

--project-name=PROJECTNAME
The project name, appears in the html.

--project-url=PROJECTURL
The project url, appears in the html if given.

--project-base-dir=PROJECTBASEDIRECTORY
Absolute path to the base directory of the project. Source links will be computed
based on this value.

--testing
Don't complain if the run doesn't have any effects.

--pdb Like py.test's --pdb.

--make-html
Produce html output.

--server
Serve HTML on a local server.

--server-port=SERVER_PORT
The port for --server to use.

--local-only
Bind the server to localhost only.

--facing-path=FACING_PATH
Set up a VHostMonster, with all the confusion that implies.

--edit When serving HTML, allow editing.

--no-check
When serving HTML and allow editing, don't check all docstrings first.

--add-package=PACKAGEDIR
Add a package to the system. Can be repeated to add more than one package.

--add-module=MODULE
Add a module to the system. Can be repeated.

--prepend-package=PREPENDEDPACKAGE
Pretend that all packages are within this one. Can be used to document part of a
package.

--resolve-aliases
This updates references to classes imported from a module into which they were
imported to references to where they are defined.

--abbreviate-specialcase=ABBREVMAPPING
This is a comma seperated list of key=value pairs. Where any key corresponds to a
module name and value is the desired abbreviation. This can be used to resolve
conflicts with abbreviation where you have two or more modules that start with the
same letter. Example: twistedcaldav=tcd.

--docformat=DOCFORMAT
Which epydoc-supported format docstrings are assumed to be in.

--html-subject=HTMLSUBJECTS
The fullName of object to generate API docs for (default: everything).

--html-summary-pages
Only generate the summary pages.

--html-write-function-pages
Make individual HTML files for every function and method. They're not linked to in
any pydoctorgenerated HTML, but they can be useful for third-party linking.

--html-output=HTMLOUTPUT
Directory to save HTML files to (default 'apidocs')

--html-writer=HTMLWRITER
Dotted name of html writer class to use (default 'pydoctor.nevowhtml.NevowWriter',
requires Divmod Nevow to be installed).

--html-viewsource-base=HTMLSOURCEBASE
This should be the path to the trac browser for the top of the svn checkout we are
documenting part of.

--html-use-sorttable
Use the sorttable JS library to make tables of package, module and class contents
sortable

--html-use-splitlinks
Generate (unobstrusive) JavaScript to allow class methods to be shown either in one
table per base class or in one big table.

--html-shorten-lists
Generate (unobstrusive) JavaScript to hide some of the entries in long lists of
e.g. subclasses.

--livecheck
Import and examine the modules too. XXX not working right now

-v, --verbose
Be noisier. Can be repeated for more noise.

-q, --quiet
Be quieter.

--auto Automagic mode: analyze all modules and packages in the current working directory
and run a local server that allows examination and editing of the docstrings.

--verbose-about=stage
Be noiser during a particular stage of generation.

Use pydoctor online using onworks.net services