pydoctor.templatewriter.util

module documentation
(source)

Miscellaneous utilities for the HTML writer.

Class CaseInsensitiveDict A case-insensitive ``dict``-like object. Implements all methods and operations of ``collections.MutableMapping`` as well as dict's ``copy``. Also provides ``lower_items``. All keys are expected to be strings...
Class DocGetter epydoc2stan bridge.
Function class_members Returns the members as well as the inherited members of a class.
Function css_class A short, lower case description for use as a CSS class in HTML. Includes the kind and privacy.
Function inherited_members Returns only the inherited members of a class, as a plain list.
Function nested_bases Helper function to retreive the complete list of base classes chains (represented by tuples) for a given Class. A chain of classes is used to compute the member inheritence from the first element to the last element of the chain.
Function objects_order Function to use as the value of standard library's sorted function key argument such that the objects are sorted by: Privacy, Kind and Name.
Function overriding_subclasses Helper function to retreive the subclasses that override the given name from the parent class object.
Function srclink Get object source code URL, i.e. hosted on github.
Function templatefile Deprecated: can be removed once Twisted stops patching this.
Function unmasked_attrs Helper function to reteive the list of inherited children given a base classes chain (As yielded by nested_bases). The returned members are inherited from the Class listed first in the chain to the Class listed last: they are not overriden in between.
Type Variable _VT Undocumented
def class_members(cls): (source)

Returns the members as well as the inherited members of a class.

Parameters
cls:model.ClassUndocumented
Returns
List[Tuple[Tuple[model.Class, ...], Sequence[model.Documentable]]]Tuples of tuple: inherited_via:Tuple[model.Class, ...], attributes:Sequence[model.Documentable].
def css_class(o): (source)

A short, lower case description for use as a CSS class in HTML. Includes the kind and privacy.

Parameters
o:model.DocumentableUndocumented
Returns
strUndocumented
def inherited_members(cls): (source)

Returns only the inherited members of a class, as a plain list.

Parameters
cls:model.ClassUndocumented
Returns
List[model.Documentable]Undocumented
def nested_bases(classobj): (source)

Helper function to retreive the complete list of base classes chains (represented by tuples) for a given Class. A chain of classes is used to compute the member inheritence from the first element to the last element of the chain.

The first yielded chain only contains the Class itself.

Then for each of the super-classes:

  • the next yielded chain contains the super class and the class itself,
  • the the next yielded chain contains the super-super class, the super class and the class itself, etc...
Parameters
classobj:model.ClassUndocumented
Returns
Iterator[Tuple[model.Class, ...]]Undocumented
def objects_order(o): (source)

Function to use as the value of standard library's sorted function key argument such that the objects are sorted by: Privacy, Kind and Name.

Example:

    children = sorted((o for o in ob.contents.values() if o.isVisible),
                  key=objects_order)
Parameters
o:model.DocumentableUndocumented
Returns
Tuple[int, int, str]Undocumented
def overriding_subclasses(classobj, name, firstcall=True): (source)

Helper function to retreive the subclasses that override the given name from the parent class object.

Parameters
classobj:model.ClassUndocumented
name:strUndocumented
firstcall:boolUndocumented
Returns
Iterator[model.Class]Undocumented
def srclink(o): (source)

Get object source code URL, i.e. hosted on github.

Parameters
o:model.DocumentableUndocumented
Returns
Optional[str]Undocumented
def templatefile(filename): (source)

Deprecated: can be removed once Twisted stops patching this.

Parameters
filename:strUndocumented
def unmasked_attrs(baselist): (source)

Helper function to reteive the list of inherited children given a base classes chain (As yielded by nested_bases). The returned members are inherited from the Class listed first in the chain to the Class listed last: they are not overriden in between.

Parameters
baselist:Sequence[model.Class]Undocumented
Returns
Sequence[model.Documentable]Undocumented
_VT = (source)

Undocumented

Value
TypeVar('_VT')