blark.sphinxdomain.BlarkDirectiveWithDeclarations

class blark.sphinxdomain.BlarkDirectiveWithDeclarations(name, arguments, options, content, lineno, content_offset, block_text, state, state_machine)

Bases: BlarkDirective

Methods

before_content()	Called before parsing content.
get_signature_prefix(sig)
handle_signature(sig, signode)	Transform a signature/object into RST nodes.
transform_content(contentnode)	Called after creating the content through nested parsing, but before the object-description-transform event is emitted, and before the info-fields are transformed.

Attributes

config	Reference to the Config object.
doc_field_types
domain
env	Reference to the BuildEnvironment object.
final_argument_whitespace	May the final argument contain whitespace?
has_content	May the directive have content?
indexnode
objtype
option_spec	Mapping of option names to validator functions.
optional_arguments	Number of optional arguments after the required arguments.
required_arguments	Number of required directive arguments.
obj
name	The role name actually used in the document.
rawtext	A string containing the entire interpreted text input.
text	The interpreted text content.
lineno	The line number where the interpreted text begins.
options	A dictionary of directive options for customization ("role" directive).
content	A list of strings, the directive content for customization ("role" directive).

obj: FunctionSummary | FunctionBlockSummary | MissingDeclaration

doc_field_types: List[Field] = [<sphinx.util.docfields.GroupedField object>]

handle_signature(sig: str, signode: desc_signature) → Tuple[str, str]

Transform a signature/object into RST nodes.

before_content() → None

Called before parsing content. Used to set information about the current directive context on the build environment.

transform_content(contentnode: desc_content) → None

Called after creating the content through nested parsing, but before the object-description-transform event is emitted, and before the info-fields are transformed. Can be used to manipulate the content.

get_signature_prefix(sig: str) → List[Node]