Package epydoc :: Module cli

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

TerminalController
A class that can be used to portably generate formatted output to a terminal.

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

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

Interface

main(options, names)

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, format)

source code

write_text(docindex, options)

source code

check_docs(docindex, options)

source code

cli()

source code

_profile()

source code

Variables

[hide private]

INHERITANCE_STYLES = ('grouped', 'listed', 'included')

GRAPH_TYPES = ('classtree', 'callgraph', 'umlclasstree')

ACTIONS = ('html', 'text', 'latex', 'dvi', 'ps', 'pdf', 'check')

DEFAULT_DOCFORMAT = 'epytext'

PROFILER = 'hotshot'
Which profiler to use: 'hotshot' or 'profile'

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

OPTION_DEFAULTS = {'action': 'html', 'debug': True, 'docformat...

Interface

_RERUN_LATEX_RE = re.compile(r'(?im)^LaTeX\s+Warning:\s+Label\...

Function Details

[hide private]

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.

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
...

OPTION_DEFAULTS

Value:

{'action': 'html',
 'debug': True,
 'docformat': 'epytext',
 'exclude': [],
 'exclude_introspect': [],
 'exclude_parse': [],
 'external_api': [],
 'external_api_file': [],
...

_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.
 *
...