docspec

module documentation

(source)

Undocumented

Class	`ApiObject`	The base class for representing "API Objects". Any API object is any addressable entity in code, be that a variable/constant, function, class or module.
Class	`Argument`	Represents a #Function argument.
Class	`Class`	Represents a class definition.
Class	`ClassSemantic`	A list of well-known properties and behaviour that can be attributed to a class.
Class	`Decoration`	Represents a decorator on a #Class or #Function.
Class	`Docstring`	Represents a docstring for an #APIObject, i.e. it's content and location. This class is a subclass of `str` for backwards compatibility reasons. Use the #content property to access the docstring content over the #Docstring value directory.
Class	`Function`	Represents a function definition. This can be in a #Module for plain functions or in a #Class for methods. The #decorations need to be introspected to understand if the function has a special purpose (e...
Class	`FunctionSemantic`	A list of well-known properties and behaviour that can be attributed to a function.
Class	`HasMembers`	Base class for API objects that can have members, e.g. #Class and #Module.
Class	`Indirection`	Represents an imported name. It can be used to properly find the full name target of a link written with a local name.
Class	`Location`	Represents the location of an #ApiObject by a filename and line number.
Class	`Module`	Represents a module, basically a named container for code/API objects. Modules may be nested in other modules. Be aware that for historical reasons, some loaders lile #docspec_python by default do not return nested modules, even if nesting would be appropriate (and instead the #Module...
Class	`Variable`	Represents a variable assignment (e.g. for global variables (often used as constants) or class members).
Class	`VariableSemantic`	A list of well-known properties and behaviour that can be attributed to a variable/constant.
Function	`dump_module`	Dumps a module to the specified target or returns it as plain structured data.
Function	`filter_visit`	No summary
Function	`get_member`	Generic function to retrieve a member from an API object. This will always return #None for objects that don't support members (eg. #Function and #Variable).
Function	`load_module`	No summary
Function	`load_modules`	Loads a stream of modules from the specified source. Similar to #load_module(), the source can be a filename, file-like object or a list of plain structured data to deserialize from.
Function	`visit`	Visits all objects, applying func in the specified order.
Variable	`__author__`	Undocumented
Variable	`__version__`	Undocumented
Variable	`_Members`	Undocumented
Variable	`_MemberType`	Undocumented
Variable	`_ModuleMembers`	Undocumented
Variable	`_ModuleMemberType`	Undocumented

def dump_module(module, target=None, dumper=json.dump): (source)

Dumps a module to the specified target or returns it as plain structured data.

Parameters
module:`Module`	Undocumented
target:`t.Optional[t.Union[str, t.IO[str]]]`	Undocumented
dumper:`t.Callable[[t.Any, t.IO[str]], None]`	Undocumented
Returns
`t.Optional[t.Dict[str, t.Any]]`	Undocumented

def filter_visit(objects, predicate, order='pre'): (source)

Parameters
objects:`t.MutableSequence[ApiObject]`	Undocumented
predicate:`t.Callable[[ApiObject], bool]`	Undocumented
order:`str`	Undocumented
Returns
`t.MutableSequence[ApiObject]`	Undocumented

def get_member(obj, name): (source)

Generic function to retrieve a member from an API object. This will always return #None for objects that don't support members (eg. #Function and #Variable).

Parameters
obj:`ApiObject`	Undocumented
name:`str`	Undocumented
Returns
`t.Optional[ApiObject]`	Undocumented

def load_module(source, filename=None, loader=json.load): (source)

Parameters
source:`t.Union[str, t.TextIO, t.Dict[str, t.Any]]`	Undocumented
filename:`t.Optional[str]`	Undocumented
loader:`t.Callable[[t.IO[str]], t.Any]`	Undocumented
Returns
`Module`	Undocumented

def load_modules(source, filename=None, loader=json.load): (source)

Loads a stream of modules from the specified *source*. Similar to #load_module(), the *source* can be a filename, file-like object or a list of plain structured data to deserialize from.

Parameters
source:`t.Union[str, t.TextIO, t.Iterable[t.Any]]`	Undocumented
filename:`t.Optional[str]`	Undocumented
loader:`t.Callable[[t.IO[str]], t.Any]`	Undocumented
Returns
`t.Iterable[Module]`	Undocumented

def visit(objects, func, order='pre'): (source)

Visits all *objects*, applying *func* in the specified *order*.

Parameters
objects:`t.Sequence[ApiObject]`	Undocumented
func:`t.Callable[[ApiObject], t.Any]`	Undocumented
order:`str`	Undocumented

__author__: str = (source)

Undocumented

__version__: str = (source)

Undocumented

_Members = (source)

Undocumented

_MemberType = (source)

Undocumented

_ModuleMembers = (source)

Undocumented

_ModuleMemberType = (source)

Undocumented