class AttributeDocumenter(GenericAliasMixin, NewTypeMixin, SlotsMixin, TypeVarMixin, RuntimeInstanceAttributeMixin, UninitializedInstanceAttributeMixin, NonDataDescriptorMixin, DocstringStripSignatureMixin, ClassLevelDocumenter):
Known subclasses: sphinx.ext.autodoc.deprecated.InstanceAttributeDocumenter
, sphinx.ext.autodoc.deprecated.SlotsAttributeDocumenter
, sphinx.ext.autodoc.NewTypeAttributeDocumenter
Class Method | can_document_member |
Called to see if a member can be documented by this Documenter. |
Static Method | is_function_or_method |
Undocumented |
Method | add_content |
Add content from docstrings, attribute documentation and user. |
Method | add_directive_header |
Add the directive header and options to the generated content. |
Method | document_members |
Generate reST for member documentation. |
Method | get_attribute_comment |
Undocumented |
Method | get_doc |
Decode and return lines of the docstring(s) for the object. |
Method | get_real_modname |
Get the real module name of an object to document. |
Method | import_object |
Check the existence of runtime instance attribute after failing to import the attribute. |
Method | isinstanceattribute |
Check the subject is an instance attribute. |
Method | should_suppress_value_header |
Check :value: header should be suppressed. |
Method | update_annotations |
Update __annotations__ to support type_comment and so on. |
Class Variable | member_order |
Undocumented |
Class Variable | objtype |
Undocumented |
Class Variable | option_spec |
Undocumented |
Class Variable | priority |
Undocumented |
Instance Variable | analyzer |
Undocumented |
Instance Variable | object |
Undocumented |
Instance Variable | parent |
Undocumented |
Inherited from GenericAliasMixin
:
Method | should_suppress_directive_header |
Check directive header should be suppressed. |
Method | update_content |
Update docstring for the NewType object. |
Inherited from DataDocumenterMixinBase
(via GenericAliasMixin
):
Class Variable | config |
Undocumented |
Class Variable | env |
Undocumented |
Class Variable | modname |
Undocumented |
Class Variable | objpath |
Undocumented |
Inherited from NewTypeMixin
:
Method | should_suppress_directive_header |
Check directive header should be suppressed. |
Method | update_content |
Update docstring for the NewType object. |
Inherited from DataDocumenterMixinBase
(via NewTypeMixin
):
Class Variable | config |
Undocumented |
Class Variable | env |
Undocumented |
Class Variable | modname |
Undocumented |
Class Variable | objpath |
Undocumented |
Inherited from SlotsMixin
:
Method | isslotsattribute |
Check the subject is an attribute in __slots__. |
Property | _datadescriptor |
Undocumented |
Inherited from DataDocumenterMixinBase
(via SlotsMixin
):
Method | should_suppress_directive_header |
Check directive header should be suppressed. |
Method | update_content |
Update docstring for the NewType object. |
Class Variable | config |
Undocumented |
Class Variable | env |
Undocumented |
Class Variable | modname |
Undocumented |
Class Variable | objpath |
Undocumented |
Inherited from TypeVarMixin
:
Method | should_suppress_directive_header |
Check directive header should be suppressed. |
Method | update_content |
Update docstring for the NewType object. |
Inherited from DataDocumenterMixinBase
(via TypeVarMixin
):
Class Variable | config |
Undocumented |
Class Variable | env |
Undocumented |
Class Variable | modname |
Undocumented |
Class Variable | objpath |
Undocumented |
Inherited from RuntimeInstanceAttributeMixin
:
Constant | RUNTIME_INSTANCE_ATTRIBUTE |
Undocumented |
Method | is_runtime_instance_attribute |
Check the subject is an attribute defined in __init__(). |
Method | is_runtime_instance_attribute_not_commented |
Check the subject is an attribute defined in __init__() without comment. |
Inherited from DataDocumenterMixinBase
(via RuntimeInstanceAttributeMixin
):
Method | should_suppress_directive_header |
Check directive header should be suppressed. |
Method | update_content |
Update docstring for the NewType object. |
Class Variable | config |
Undocumented |
Class Variable | env |
Undocumented |
Class Variable | modname |
Undocumented |
Class Variable | objpath |
Undocumented |
Inherited from UninitializedInstanceAttributeMixin
:
Method | is_uninitialized_instance_attribute |
Check the subject is an annotation only attribute. |
Inherited from DataDocumenterMixinBase
(via UninitializedInstanceAttributeMixin
):
Method | should_suppress_directive_header |
Check directive header should be suppressed. |
Method | update_content |
Update docstring for the NewType object. |
Class Variable | config |
Undocumented |
Class Variable | env |
Undocumented |
Class Variable | modname |
Undocumented |
Class Variable | objpath |
Undocumented |
Inherited from NonDataDescriptorMixin
:
Instance Variable | non_data_descriptor |
Undocumented |
Inherited from DataDocumenterMixinBase
(via NonDataDescriptorMixin
):
Method | should_suppress_directive_header |
Check directive header should be suppressed. |
Method | update_content |
Update docstring for the NewType object. |
Class Variable | config |
Undocumented |
Class Variable | env |
Undocumented |
Class Variable | modname |
Undocumented |
Class Variable | objpath |
Undocumented |
Inherited from DocstringStripSignatureMixin
:
Method | format_signature |
Undocumented |
Instance Variable | retann |
Undocumented |
Inherited from DocstringSignatureMixin
(via DocstringStripSignatureMixin
):
Method | _find_signature |
Undocumented |
Instance Variable | _new_docstrings |
Undocumented |
Instance Variable | _signatures |
Undocumented |
Instance Variable | args |
Undocumented |
Inherited from ClassLevelDocumenter
:
Method | resolve_name |
Resolve the module and name of the object to document given by the arguments and the current module/class. |
Inherited from Documenter
(via ClassLevelDocumenter
):
Method | __init__ |
Undocumented |
Method | _call_format_args |
Undocumented |
Method | add_line |
Append one line of generated reST to the output. |
Method | check_module |
Check if self.object is really defined in the module given by self.modname. |
Method | filter_members |
Filter the given member list. |
Method | format_args |
Format the argument signature of self.object. |
Method | format_name |
Format the name of self.object. |
Method | format_signature |
Format the signature (arguments and return annotation) of the object. |
Method | generate |
Generate reST for the object given by self.name, and possibly for its members. |
Method | get_attr |
getattr() override for types such as Zope interfaces. |
Method | get_object_members |
Return (members_check_module, members) where members is a list of (membername, member) pairs of the members of self.object. |
Method | get_sourcename |
Undocumented |
Method | parse_name |
Determine what module to import and what attribute to document. |
Method | process_doc |
Let the user process the docstrings before adding them. |
Method | sort_members |
Sort the given member list. |
Class Variable | content_indent |
Undocumented |
Class Variable | titles_allowed |
Undocumented |
Instance Variable | args |
Undocumented |
Instance Variable | config |
Undocumented |
Instance Variable | directive |
Undocumented |
Instance Variable | env |
Undocumented |
Instance Variable | fullname |
Undocumented |
Instance Variable | indent |
Undocumented |
Instance Variable | modname |
Undocumented |
Instance Variable | module |
Undocumented |
Instance Variable | name |
Undocumented |
Instance Variable | object_name |
Undocumented |
Instance Variable | objpath |
Undocumented |
Instance Variable | options |
Undocumented |
Instance Variable | real_modname |
Undocumented |
Instance Variable | retann |
Undocumented |
Property | documenters |
Returns registered Documenter classes |
sphinx.ext.autodoc.NewTypeAttributeDocumenter
Parameters | |
member:Any | Undocumented |
membername:str | Undocumented |
isattr:bool | Undocumented |
parent:Any | Undocumented |
Returns | |
bool | Undocumented |
Undocumented
Parameters | |
obj:Any | Undocumented |
Returns | |
bool | Undocumented |
Parameters | |
more_content:Optional[ | Undocumented |
no_docstring:bool | Undocumented |
Parameters | |
sig:str | Undocumented |
Generate reST for member documentation.
If all_members is True, document all members, else those given by self.options.members.
Parameters | |
all_members:bool | Undocumented |
Undocumented
Parameters | |
parent:Any | Undocumented |
attrname:str | Undocumented |
Returns | |
Optional[ | Undocumented |
sphinx.ext.autodoc.SlotsMixin.get_doc
Decode and return lines of the docstring(s) for the object.
When it returns None, autodoc-process-docstring will not be called for this object.
Parameters | |
ignore:int | Undocumented |
Returns | |
Optional[ | Undocumented |
Get the real module name of an object to document.
It can differ from the name of the module through which the object was imported.
Returns | |
str | Undocumented |
Parameters | |
raiseerror:bool | Undocumented |
Returns | |
bool | Undocumented |
Returns | |
bool | Undocumented |
Parameters | |
parent:Any | Undocumented |
int
=
sphinx.ext.autodoc.deprecated.InstanceAttributeDocumenter
, sphinx.ext.autodoc.deprecated.SlotsAttributeDocumenter
Undocumented