class documentation
class Indirection(_docspec.Indirection, ApiObject): (source)
Known subclasses: pydocspec.Indirection
Represents an imported name. It can be used to properly find the full name target of a link written with a local name.
Method | __init__ |
Undocumented |
Instance Variable | is |
Undocumented |
Class Variable | _spec |
Undocumented |
Inherited from Indirection
:
Instance Variable | target |
Undocumented |
Inherited from ApiObject
(via Indirection
, Inheritable
):
Method | sync |
Synchronize the hierarchy of this API object and all of it's children. This should be called when the #HasMembers.members are updated to ensure that all child objects reference the right #parent. Loaders are expected to return #ApiObject#s in a fully synchronized state such that the user does not have to call this method unless they are doing modifications to the tree. |
Instance Variable | docstring |
The documentation string of the API object. |
Instance Variable | location |
The location of the API object, i.e. where it is sourced from/defined in the code. |
Instance Variable | name |
The name of the entity. This is usually relative to the respective parent of the entity, as opposed to it's fully qualified name/absolute name. However, that is more of a recommendation than rule. For example the #docspec_python loader by default returns #Module objects with their full module name (and does not create a module hierarchy). |
Instance Variable | parent |
The parent of the API object. |
Property | path |
Returns a list of all of this API object's parents, from top to bottom. The list includes self as the last item. |
Inherited from _HasInitAttribsMethod
(via Indirection
, Inheritable
, ApiObject
):
Method | _init |
A method to define extra attributes that will be set after initialization. |
Inherited from ApiObject
:
Method | __repr__ |
Undocumented |
Method | __str__ |
Undocumented |
Method | add |
A new nodes to the tree, siblings to this node. |
Method | get |
Retrieve a member from the API object. This will always return None for objects that don't support members (eg. Function and Variable ). |
Method | get |
Like get_member but can return several items with the same name. |
Method | remove |
Undocumented |
Method | replace |
Replace this object by one or more objects. |
Method | walk |
Traverse a tree of objects, calling the genericvisitor.Visitor.visit method of visitor when entering each node. |
Method | walkabout |
Perform a tree traversal similarly to walk() , except also call the genericvisitor.Visitor.depart method before exiting each node. |
Class Variable | parent |
The parent of the API object. |
Instance Variable | root |
TreeRoot instance holding references to all objects in the tree. |
Property | dotted |
The fully qualified dotted name of this object, as DottedName instance. |
Property | full |
The fully qualified dotted name of this object, as string. This value is used as the key in the ApiObject.root.all_objects dictionnary. |
Property | module |
Undocumented |
Property | scope |
Undocumented |
Method | _init |
A method to define extra attributes that will be set after initialization. |
Method | _members |
Undocumented |
Method | _remove |
Undocumented |
Method | _repr |
Undocumented |
Inherited from ApiObject
(via ApiObject
):
Method | sync |
Synchronize the hierarchy of this API object and all of it's children. This should be called when the #HasMembers.members are updated to ensure that all child objects reference the right #parent. Loaders are expected to return #ApiObject#s in a fully synchronized state such that the user does not have to call this method unless they are doing modifications to the tree. |
Instance Variable | docstring |
The documentation string of the API object. |
Instance Variable | location |
The location of the API object, i.e. where it is sourced from/defined in the code. |
Instance Variable | name |
The name of the entity. This is usually relative to the respective parent of the entity, as opposed to it's fully qualified name/absolute name. However, that is more of a recommendation than rule. For example the #docspec_python loader by default returns #Module objects with their full module name (and does not create a module hierarchy). |
Property | path |
Returns a list of all of this API object's parents, from top to bottom. The list includes self as the last item. |
Inherited from CanTriggerWarnings
(via ApiObject
):
Method | warn |
Undocumented |
Inherited from GetMembersMixin
(via ApiObject
):
Method | __getitem__ |
Undocumented |