class documentation

class PropertyDocumenter(DocstringStripSignatureMixin, ClassLevelDocumenter):

View In Hierarchy

Specialized Documenter subclass for properties.
Class Method can​_document​_member Called to see if a member can be documented by this Documenter.
Method add​_directive​_header Add the directive header and options to the generated content.
Method document​_members Generate reST for member documentation.
Method get​_real​_modname Get the real module name of an object to document.
Method import​_object Check the exisitence of uninitialized instance attribute when failed to import the attribute.
Class Variable member​_order Undocumented
Class Variable objtype Undocumented
Class Variable priority Undocumented
Instance Variable isclassmethod Undocumented
Instance Variable object Undocumented

Inherited from DocstringStripSignatureMixin:

Method format​_signature Undocumented
Instance Variable retann Undocumented

Inherited from DocstringSignatureMixin (via DocstringStripSignatureMixin):

Method ​_find​_signature Undocumented
Method get​_doc 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​_content Add content from docstrings, attribute documentation and user.
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​_doc Decode and return lines of the docstring(s) for the object.
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 option​_spec Undocumented
Class Variable titles​_allowed Undocumented
Instance Variable analyzer 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 parent Undocumented
Instance Variable real​_modname Undocumented
Instance Variable retann Undocumented
Property documenters Returns registered Documenter classes
@classmethod
def can_document_member(cls, member, membername, isattr, parent):
Called to see if a member can be documented by this Documenter.
Parameters
member:AnyUndocumented
membername:strUndocumented
isattr:boolUndocumented
parent:AnyUndocumented
Returns
boolUndocumented
def add_directive_header(self, sig):
Add the directive header and options to the generated content.
Parameters
sig:strUndocumented
def document_members(self, all_members=False):

Generate reST for member documentation.

If all_members is True, document all members, else those given by self.options.members.

Parameters
all​_members:boolUndocumented
def get_real_modname(self):

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
strUndocumented
def import_object(self, raiseerror=False):
Check the exisitence of uninitialized instance attribute when failed to import the attribute.
Parameters
raiseerror:boolUndocumented
Returns
boolUndocumented
member_order: int =
objtype: str =

Undocumented

priority =
isclassmethod: bool =

Undocumented

object =

Undocumented