Package epydoc :: Module cli
[hide private]
[frames] | no frames]

Module cli

source code

Command-line interface for epydoc. Abbreviated Usage:

epydoc [options] NAMES...

    NAMES...                  The Python modules to document.
    --html                    Generate HTML output (default).
    --latex                   Generate LaTeX output.
    --pdf                     Generate pdf output, via LaTeX.
    -o DIR, --output DIR      The output directory.
    --inheritance STYLE       The format for showing inherited objects.
    -V, --version             Print the version of epydoc.
    -h, --help                Display a usage message.

Run "epydoc --help" for a complete option list. See the epydoc(1) man page for more information.

Config Files

Configuration files can be specified with the --config option. These files are read using ConfigParser. Configuration files may set options or add names of modules to document. Option names are (usually) identical to the long names of command line options. To specify names to document, use any of the following option names:

 module modules value values object objects

A simple example of a config file is:

 [epydoc]
 modules: sys, os, os.path, re, %(MYSANDBOXPATH)/utilities.py
 name: Example
 graph: classtree
 introspect: no

All ConfigParser interpolations are done using local values and the environment variables.

Verbosity Levels

The -v and -q options increase and decrease verbosity, respectively. The default verbosity level is zero. The verbosity levels are currently defined as follows:

               Progress    Markup warnings   Warnings   Errors
-3               none            no             no        no
-2               none            no             no        yes
-1               none            no             yes       yes
 0 (default)     bar             no             yes       yes
 1               bar             yes            yes       yes
 2               list            yes            yes       yes
Classes [hide private]
    Logging
ConsoleLogger
UnifiedProgressConsoleLogger
HTMLLogger
A logger used to generate a log of all warnings and messages to an HTML file.
Functions [hide private]
    Argument & Config File Parsing
 
option_defaults() source code
 
add_action(option, opt, value, optparser) source code
 
add_target(option, opt, value, optparser) source code
 
parse_arguments() source code
 
parse_configfiles(configfiles, options, names) source code
 
_str_to_bool(val, optname) source code
 
_str_to_int(val, optname) source code
 
_str_to_list(val) source code
    Interface
 
main(options)
Perform all actions indicated by the given set of options.
source code
 
write_html(docindex, options) source code
 
write_pickle(docindex, options)
Helper for writing output to a pickle file, which can then be read in at a later time.
source code
 
pickle_persistent_id(obj)
Helper for pickling, which allows us to save and restore UNKNOWN, which is required to be identical to apidoc.UNKNOWN.
source code
 
pickle_persistent_load(identifier)
Helper for pickling, which allows us to save and restore UNKNOWN, which is required to be identical to apidoc.UNKNOWN.
source code
 
write_latex(docindex, options) source code
 
write_text(docindex, options) source code
 
check_docs(docindex, options) source code
 
cli()
Perform all actions indicated by the options in sys.argv.
source code
 
_profile() source code
Variables [hide private]
  INHERITANCE_STYLES = ('grouped', 'listed', 'included', 'hidden')
  GRAPH_TYPES = ('classtree', 'callgraph', 'umlclasstree')
  ACTIONS = ('html', 'text', 'latex', 'dvi', 'ps', 'pdf', 'check')
  DEFAULT_DOCFORMAT = 'epytext'
  PROFILER = 'profile'
Which profiler to use: 'hotshot' or 'profile'
  TARGET_ACTIONS = ('html', 'latex', 'dvi', 'ps', 'pdf')
  DEFAULT_ACTIONS = ('html')
  PDFDRIVERS = ('pdflatex', 'latex', 'auto')
  descr = 'Black on white, with blue highlights'
  key = 'white'
  sheet = '\n\n/* Epydoc CSS Stylesheet\n *\n * This stylesheet ...
  topic = 'inheritance'
    Help Topics
  DOCFORMATS = ('epytext', 'plaintext', 'restructuredtext', 'jav...
  HELP_TOPICS = {'css': 'The following built-in CSS stylesheets ...
    Argument & Config File Parsing
  DEFAULT_TARGET = {'dvi': 'api.dvi', 'html': 'html', 'latex': '...
    Interface
  _RERUN_LATEX_RE = re.compile(r'(?im)^LaTeX\s+Warning:\s+Label\...
Function Details [hide private]

main(options)

source code 

Perform all actions indicated by the given set of options.

Returns:
the epydoc.apidoc.DocIndex object created while running epydoc (or None).

write_pickle(docindex, options)

source code 

Helper for writing output to a pickle file, which can then be read in at a later time. But loading the pickle is only marginally faster than building the docs from scratch, so this has pretty limited application.

cli()

source code 

Perform all actions indicated by the options in sys.argv.

Returns:
the epydoc.apidoc.DocIndex object created while running epydoc (or None).

Variables Details [hide private]

DOCFORMATS

Value:
('epytext', 'plaintext', 'restructuredtext', 'javadoc')

HELP_TOPICS

Value:
{'css': '''The following built-in CSS stylesheets are available:
        blue: Black on steel blue
     default: Default stylesheet (=white)
   grayscale: Grayscale black on white
       black: White on black, with blue highlights
       green: Black on green
       white: Black on white, with blue highlights''',
 'docformat': '''__docformat__ is a module variable that specifies the\
...

DEFAULT_TARGET

Value:
{'dvi': 'api.dvi',
 'html': 'html',
 'latex': 'latex',
 'pdf': 'api.pdf',
 'pickle': 'api.pickle',
 'ps': 'api.ps'}

_RERUN_LATEX_RE

Value:
re.compile(r'(?im)^LaTeX\s+Warning:\s+Label\(s\)\s+may\s+have\s+change\
d.\s+Rerun')

sheet

Value:
'''

/* Epydoc CSS Stylesheet
 *
 * This stylesheet can be used to customize the appearance of epydoc\'\
s
 * HTML output.
 *
...