lemon.external.epydoc.objdoc.ModuleDoc

Package lemon :: Package external :: Package epydoc :: Module objdoc :: Class ModuleDoc

[show private | hide private]

Class ModuleDoc

ObjDoc --+
         |
        ModuleDoc

The documentation for a module or package. This documentation consists of standard pieces of documentation (as defined in ObjDoc), and the following module-specific pieces of documentation:

classes: A list of all classes contained in the module/package.
functions: A list of all functions contained in the module/package.
variables: A list of all variables contained in the module/package.
modules: A list of all modules contained in the package (packages only).
imported objects: Lists of imported objects, sorted by type.

Method Summary
	`__init__(self, uid, verbosity)`
	`__repr__(self)`
Accessors
`list` of `Link`	`classes(self)` Return a list of all classes defined by the module/package documented by this `ModuleDoc`, sorted by name.
`list` of `Link`	`functions(self)` Return a list of all functions defined by the module/package documented by this `ModuleDoc`.
`list` of `Link`	`imported_classes(self)` Return a list of all classes contained in the module/package documented by this `ModuleDoc` that are not defined by that module/package, sorted by name.
`list` of `Link`	`imported_functions(self)` Return a list of all functions contained in the module/package documented by this `ModuleDoc` that are not defined by that module/package, sorted by name.
`list` of `Link`	`imported_modules(self)` Return a list of all modules that are imported by the module/package documented by this `ModuleDoc`, sorted by name.
`list` of `Var`	`imported_variables(self)` Return a list of all variables contained in the module/package documented by this `ModuleDoc` that are not defined by that module/package, sorted by name.
`boolean`	`ismodule(self)` Return true if this `ModuleDoc` documents a module (not a package).
`boolean`	`ispackage(self)` Return true if this `ModuleDoc` documents a package (not a module).
`list` of `Link`	`modules(self)` Return a list of the known modules and subpackages conained in the package documented by this `ModuleDoc`, sorted by name.
`UID` or `None`	`package(self)` Return the package that contains the module documented by this `ModuleDoc`, or `None` if no package contains the module.
`list` of `Var`	`variables(self)` Return a list of all variables defined by the module/package documented by this `ModuleDoc`, sorted by name.
Modifiers
`None`	`add_modules(self, modules)` Register submodules for the package doumented by this `ModuleDoc`.
	`remove_autogenerated_variables(self)`
Inherited from ObjDoc
`list` of `(string, elt)`	`by_group(self, elts)` Divide a set of elements into groups.
`boolean`	`defines_groups(self)` Return true if the object documented by this `ObjDoc` defines any groups.
`markup.ParsedDocstring`	`descr(self)` Return a description of the object documented by this `ObjDoc`.
`list` of `markup.ParsedDocstring`	`field_values(self, field)` Return a list of the values that are specified for the given field in the docstring of the object documented by this `ObjDoc`.
`list` of `DocField`	`fields(self)` Return a list of the fields that are given values in the docstring of the object documented by this `ObjDoc`.
`list` of `string`	`groups(self)` Return a list of the names of the groups that are defined for the object documented by this `ObjDoc`.
`boolean`	`has_docstring(self)` Return true if the object documented by this `ObjDoc` has a docstring.
`list` of `string`	`sortorder(self)` Return a list specifying the sort order that should be used for the object's children.
`markup.ParsedDocstring`	`summary(self)` Return a summary of the description of the object documented by this `ObjDoc`.
`UID`	`uid(self)` Return the UID of the object documented by this `ObjDoc`.

Class Variable Summary
Inherited from ObjDoc
`List` of `DocField`	`STANDARD_FIELDS`: The list of standard docstring fields that epydoc accepts.

Method Details

add_modules(self, modules)

Register submodules for the package doumented by this ModuleDoc. This must be done externally, since we can't determine the submodules of a package through introspection alone. This is automatically called by DocMap.add when new modules are added to a DocMap.

Parameters:: modules - A list of modules or subpackages.
(type=list of UID)

Returns:: None

classes(self)

Returns:: A list of all classes defined by the module/package documented by this ModuleDoc, sorted by name.
(type=list of Link)

functions(self)

Returns:: A list of all functions defined by the module/package documented by this ModuleDoc.
(type=list of Link)

imported_classes(self)

Returns:: A list of all classes contained in the module/package documented by this ModuleDoc that are not defined by that module/package, sorted by name.
(type=list of Link)

imported_functions(self)

Returns:: A list of all functions contained in the module/package documented by this ModuleDoc that are not defined by that module/package, sorted by name.
(type=list of Link)

imported_modules(self)

Returns:: A list of all modules that are imported by the module/package documented by this ModuleDoc, sorted by name.
(type=list of Link)

imported_variables(self)

Returns:: A list of all variables contained in the module/package documented by this ModuleDoc that are not defined by that module/package, sorted by name.
(type=list of Var)

ismodule(self)

Returns:: True if this ModuleDoc documents a module (not a package).
(type=boolean)

ispackage(self)

Returns:: True if this ModuleDoc documents a package (not a module).
(type=boolean)

modules(self)

Returns:: A list of the known modules and subpackages conained in the package documented by this ModuleDoc, sorted by name.
(type=list of Link)

Raises:: TypeError - If this ModuleDoc does not document a package.

package(self)

Returns:: The package that contains the module documented by this ModuleDoc, or None if no package contains the module.
(type=UID or None)

variables(self)

Returns:: A list of all variables defined by the module/package documented by this ModuleDoc, sorted by name.
(type=list of Var)

Generated by Epydoc 2.0 on Mon Nov 10 15:07:58 2003

http://epydoc.sf.net