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
 name: Example
 graph: classtree
 introspect: no

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  

Functions [hide private]
    Argument & Config File Parsing
  parse_arguments()
  parse_configfiles(configfiles, options, names)
  _str_to_bool(val, optname)
    Interface
  main(options, names)
  write_html(docindex, options)
  write_latex(docindex, options, format)
  write_text(docindex, options)
  check_docs(docindex, options)
  cli()
  _profile()

Variables [hide private]
INHERITANCE_STYLES  
GRAPH_TYPES  
ACTIONS  
DEFAULT_DOCFORMAT  
    Interface
_RERUN_LATEX_RE  

Function Details [hide private]

parse_arguments()

source code 

parse_configfiles(configfiles, options, names)

source code 

_str_to_bool(val, optname)

source code 

main(options, names)

source code 

write_html(docindex, options)

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 Details [hide private]

INHERITANCE_STYLES

Value:
('grouped', 'listed', 'included')                                      
      

GRAPH_TYPES

Value:
('classtree', 'callgraph', 'umlclasstree')                             
      

ACTIONS

Value:
('html', 'text', 'latex', 'dvi', 'ps', 'pdf', 'check')                 
      

DEFAULT_DOCFORMAT

Value:
'epytext'                                                              
      

_RERUN_LATEX_RE

Value:
^LaTeX\s+Warning:\s+Label\(s\)\s+may\s+have\s+changed.\s+Rerun