sphinx.domains.python.PythonDomain

class documentation

class PythonDomain(Domain):

Python language domain.

Method	`note_module`	Note a python module for cross reference.
Method	`note_object`	Note a python object for cross reference.
Method	`_make_module_refnode`	Undocumented
Method	`clear_doc`	Remove traces of a document in the domain-specific inventories.
Method	`find_obj`	Find a Python object for "name", perhaps using the given module and/or classname. Returns a list of (name, object entry) tuples.
Method	`get_full_qualified_name`	Return full qualified name for given node.
Method	`get_objects`	Return an iterable of "object descriptions".
Method	`merge_domaindata`	Merge in data regarding docnames from a different domaindata inventory (coming from a subprocess in parallel builds).
Method	`resolve_any_xref`	Resolve the pending_xref node with the given target.
Method	`resolve_xref`	Resolve the pending_xref node with the given typ and target.
Class Variable	`directives`	Undocumented
Class Variable	`indices`	Undocumented
Class Variable	`initial_data`	Undocumented
Class Variable	`label`	Undocumented
Class Variable	`name`	Undocumented
Class Variable	`object_types`	Undocumented
Class Variable	`roles`	Undocumented
Property	`modules`	Undocumented
Property	`objects`	Undocumented

Inherited from Domain:

Method	`add_object_type`	Add an object type.
Method	`check_consistency`	Do consistency checks (experimental).
Method	`directive`	Return a directive adapter class that always gives the registered directive its full name ('domain:name') as `self.name`.
Method	`get_enumerable_node_type`	Get type of enumerable nodes (experimental).
Method	`get_type_name`	Return full name for given ObjType.
Method	`process_doc`	Process a document after it is read by the environment.
Method	`process_field_xref`	Process a pending xref created in a doc field. For example, attach information about the current scope.
Method	`role`	Return a role adapter function that always gives the registered role its full name ('domain:name') as the first argument.
Method	`setup`	Set up domain object.
Class Variable	`dangling_warnings`	Undocumented
Class Variable	`data_version`	Undocumented
Class Variable	`enumerable_nodes`	Undocumented
Instance Variable	`data`	Undocumented
Method	`__init__`	Undocumented
Instance Variable	`_directive_cache`	Undocumented
Instance Variable	`_role2type`	Undocumented
Instance Variable	`_role_cache`	Undocumented
Instance Variable	`_type2role`	Undocumented
Instance Variable	`env`	Undocumented
Instance Variable	`objtypes_for_role`	Undocumented
Instance Variable	`role_for_objtype`	Undocumented

def note_module(self, name, node_id, synopsis, platform, deprecated):

Note a python module for cross reference.

New in version 2.1.

Parameters
name:`str`	Undocumented
node_id:`str`	Undocumented
synopsis:`str`	Undocumented
platform:`str`	Undocumented
deprecated:`bool`	Undocumented

def note_object(self, name, objtype, node_id, aliased=False, location=None):

Note a python object for cross reference.

New in version 2.1.

Parameters
name:`str`	Undocumented
objtype:`str`	Undocumented
node_id:`str`	Undocumented
aliased:`bool`	Undocumented
location:`Any`	Undocumented

def _make_module_refnode(self, builder, fromdocname, name, contnode):

Undocumented

Parameters
builder:`Builder`	Undocumented
fromdocname:`str`	Undocumented
name:`str`	Undocumented
contnode:`Node`	Undocumented
Returns
`Element`	Undocumented

def clear_doc(self, docname):

overrides sphinx.domains.Domain.clear_doc

Remove traces of a document in the domain-specific inventories.

Parameters
docname:`str`	Undocumented

def find_obj(self, env, modname, classname, name, type, searchmode=0):

Find a Python object for "name", perhaps using the given module and/or classname. Returns a list of (name, object entry) tuples.

Parameters
env:`BuildEnvironment`	Undocumented
modname:`str`	Undocumented
classname:`str`	Undocumented
name:`str`	Undocumented
type:`str`	Undocumented
searchmode:`int`	Undocumented
Returns
`List[Tuple[str, ObjectEntry]]`	Undocumented

def get_full_qualified_name(self, node):

overrides sphinx.domains.Domain.get_full_qualified_name

Return full qualified name for given node.

Parameters
node:`Element`	Undocumented
Returns
`Optional[str]`	Undocumented

def get_objects(self):

overrides sphinx.domains.Domain.get_objects

Return an iterable of "object descriptions".

Object descriptions are tuples with six items:

name

Fully qualified name.

dispname

Name to display when searching/linking.

type

Object type, a key in self.object_types.

docname

The document where it is to be found.

anchor

The anchor name for the object.

priority

How "important" the object is (determines placement in search results). One of:

1: Default priority (placed before full-text matches).
0: Object is important (placed before default-priority objects).
2: Object is unimportant (placed after full-text matches).
-1: Object should not show up in search at all.

Returns
`Iterator[Tuple[str, str, str, str, str, int]]`	Undocumented

def merge_domaindata(self, docnames, otherdata):

overrides sphinx.domains.Domain.merge_domaindata

Merge in data regarding docnames from a different domaindata inventory (coming from a subprocess in parallel builds).

Parameters
docnames:`List[str]`	Undocumented
otherdata:`Dict`	Undocumented

def resolve_any_xref(self, env, fromdocname, builder, target, node, contnode):

overrides sphinx.domains.Domain.resolve_any_xref

Resolve the pending_xref node with the given target.

The reference comes from an "any" or similar role, which means that we don't know the type. Otherwise, the arguments are the same as for resolve_xref.

The method must return a list (potentially empty) of tuples ('domain:role', newnode), where 'domain:role' is the name of a role that could have created the same reference, e.g. 'py:func'. newnode is what resolve_xref would return.

New in version 1.3.

Parameters
env:`BuildEnvironment`	Undocumented
fromdocname:`str`	Undocumented
builder:`Builder`	Undocumented
target:`str`	Undocumented
node:`pending_xref`	Undocumented
contnode:`Element`	Undocumented
Returns
`List[Tuple[str, Element]]`	Undocumented

def resolve_xref(self, env, fromdocname, builder, type, target, node, contnode):

overrides sphinx.domains.Domain.resolve_xref

Resolve the pending_xref node with the given typ and target.

This method should return a new node, to replace the xref node, containing the contnode which is the markup content of the cross-reference.

If no resolution can be found, None can be returned; the xref node will then given to the :event:`missing-reference` event, and if that yields no resolution, replaced by contnode.

The method can also raise sphinx.environment.NoUri to suppress the :event:`missing-reference` event being emitted.

Parameters
env:`BuildEnvironment`	Undocumented
fromdocname:`str`	Undocumented
builder:`Builder`	Undocumented
type:`str`	Undocumented
target:`str`	Undocumented
node:`pending_xref`	Undocumented
contnode:`Element`	Undocumented
Returns
`Optional[Element]`	Undocumented

directives =

overrides sphinx.domains.Domain.directives

Undocumented

indices =

overrides sphinx.domains.Domain.indices

Undocumented

initial_data: Dict[str, Dict[str, Tuple[Any]]] =

overrides sphinx.domains.Domain.initial_data

Undocumented

label: str =

overrides sphinx.domains.Domain.label

Undocumented

name: str =

overrides sphinx.domains.Domain.name

Undocumented

object_types: Dict[str, ObjType] =

overrides sphinx.domains.Domain.object_types

Undocumented

roles =

overrides sphinx.domains.Domain.roles

Undocumented

@property
modules: Dict[str, ModuleEntry] =

Undocumented

@property
objects: Dict[str, ObjectEntry] =

Undocumented