epydoc.apidoc.VariableDoc

Package epydoc :: Module apidoc :: Class VariableDoc |
[hide private]
[frames] | no frames]

# Class VariableDoc

source code

API documentation information about a single Python variable.

Note: The only time a `VariableDoc` will have its own docstring is if that variable was created using an assignment statement, and that assignment statement had a docstring-comment or was followed by a pseudo-docstring.

Instance Methods | [hide private]
__init__(self, **kwargs) Construct a new `APIDoc` object. | source code call graph
Call Graph
__repr__(self) repr(x) | source code
_get_defining_module(self) | source code call graph
Call Graph
apidoc_links(self, **filters) Return a list of all `APIDoc`s that are directly linked from this `APIDoc` (i.e., are contained or pointed to by one or more of this `APIDoc`'s attributes.) | source code call graph
Call Graph
`bool` |
is_detailed(self) Does this object deserve a box with extra details? | source code call graph
Call Graph
Inherited from `APIDoc`: `__cmp__`, `__hash__`, `__setattr__`, `__str__`, `merge_and_overwrite`, `pp`, `specialize_to` Inherited from `APIDoc` (private): `_debug_setattr` Inherited from `object`: `__delattr__`, `__getattribute__`, `__new__`, `__reduce__`, `__reduce_ex__`

Instance Variables | [hide private]
Basic Variable Information
`str` | name = `_Sentinel('UNKNOWN')` The name of this variable in its containing namespace.
ValueDoc | container = `_Sentinel('UNKNOWN')` API documentation for the namespace that contains this variable.
DottedName | canonical_name = `_Sentinel('UNKNOWN')` A dotted name that serves as a unique identifier for this `VariableDoc`.
ValueDoc | value = `_Sentinel('UNKNOWN')` The API documentation for this variable's value.
Information Extracted from Docstrings
ParsedDocstring | type_descr = `_Sentinel('UNKNOWN')` A description of the variable's expected type, extracted from its docstring.
Inherited from `APIDoc`: `descr`, `extra_docstring_fields`, `metadata`, `other_docs`, `summary`
Information about Imported Variables
DottedName | imported_from = `_Sentinel('UNKNOWN')` The fully qualified dotted name of the variable that this variable's value was imported from.
`bool` | is_imported = `_Sentinel('UNKNOWN')` Was this variable's value imported from another module? (Exception: variables that are explicitly included in __all__ have `is_imported` set to `False`, even if they are in fact imported.)
Information about Variables in Classes
`bool` | is_instvar = `_Sentinel('UNKNOWN')` If true, then this variable is an instance variable; if false, then this variable is a class variable.
VariableDoc | overrides = `_Sentinel('UNKNOWN')` The API documentation for the variable that is overridden by this variable.
Flags
`bool` | is_alias = `_Sentinel('UNKNOWN')` Is this variable an alias for another variable with the same value? If so, then this variable will be dispreferred when assigning canonical names.
`bool` | is_public = `_Sentinel('UNKNOWN')` Is this variable part of its container's public API?
Docstrings
Inherited from `APIDoc`: `docstring`, `docstring_lineno`
Source Information
Inherited from `APIDoc`: `docs_extracted_by`

Properties | [hide private]
| defining_module A read-only property that can be used to get the variable's defining module.
Inherited from `object`: `__class__`

Method Details | [hide private]

### __init__(self, **kwargs) (Constructor) | source code call graph
Call Graph
Construct a new `APIDoc` object. Keyword arguments may be used to initialize the new `APIDoc`'s attributes. Raises: `TypeError` - If a keyword argument is specified that does not correspond to a valid attribute for this (sub)class of `APIDoc`. Overrides: object.__init__ (inherited documentation)

### __repr__(self) (Representation operator) | source code
    repr(x)
Overrides: object.__repr__ (inherited documentation)

### apidoc_links(self, **filters) | source code call graph
Call Graph
Return a list of all `APIDoc`s that are directly linked from this `APIDoc` (i.e., are contained or pointed to by one or more of this `APIDoc`'s attributes.) Keyword argument `filters` can be used to selectively exclude certain categories of attribute value. For example, using `includes=False` will exclude variables that were imported from other modules; and `subclasses=False` will exclude subclasses. The filter categories currently supported by epydoc are: `imports`: Imported variables. `packages`: Containing packages for modules. `submodules`: Contained submodules for packages. `bases`: Bases for classes. `subclasses`: Subclasses for classes. `variables`: All variables. `private`: Private variables. `overrides`: Points from class variables to the variables they override. This filter is False by default. Overrides: APIDoc.apidoc_links (inherited documentation)

### is_detailed(self) | source code call graph
Call Graph
Does this object deserve a box with extra details? Returns: `bool` True if the object needs extra details, else False. Overrides: APIDoc.is_detailed (inherited documentation)

Instance Variable Details | [hide private]

  ### canonical_name A dotted name that serves as a unique identifier for this `VariableDoc`. It should be formed by concatenating the `VariableDoc`'s `container` with its `name`. Type: DottedName Value:
      _Sentinel('UNKNOWN')

  ### imported_from The fully qualified dotted name of the variable that this variable's value was imported from. This attribute should only be defined if `is_instvar` is true. Type: DottedName Value:
      _Sentinel('UNKNOWN')

  ### is_instvar If true, then this variable is an instance variable; if false, then this variable is a class variable. This attribute should only be defined if the containing namespace is a class Type: `bool` Value:
      _Sentinel('UNKNOWN')

  ### overrides The API documentation for the variable that is overridden by this variable. This attribute should only be defined if the containing namespace is a class. Type: VariableDoc Value:
      _Sentinel('UNKNOWN')

Property Details | [hide private]

### defining_module A read-only property that can be used to get the variable's defining module. This is defined as the defining module of the variable's container. Get Method: _get_defining_module(self)