plasmapy_sphinx.ext.automodsumm

This module is a Sphinx extension that exposes the functionality of plasmapy_sphinx.automodsumm.

plasmapy_sphinx.automodsumm contains functionality that defines the automodsumm directive, and the associated automatic stub file generation for the documented items in the generated automodsumm tables.

This functionality was highly influenced by and adapted from sphinx.ext.autosummary and sphinx_automodapi.automodsumm.

Defined Directives

A directive (ref) is a generic block of explicit markup. Along with roles, it is one of the extension mechanisms of reST and, thus, Sphinx.

Directive	Description
automodsumm .. automodsumm:: modname	A directive that generates and auto-populates autosummary tables for a given module modname (i.e. sub-package or .py file).

Defined Configuration Values

Configuration values are variables that can be defined in the conf.py file to control the default behavior Sphinx and Sphinx extension packages like plasmapy_sphinx.

Configuration Value	Description
automodapi_custom_groups	Used to define custom groups to be displayed by the automodsumm and automodapi directives
automodapi_generate_module_stub_files	Used to control is stub files are by default generated to modules (i.e. sub-packages and .py files).

Connected Sphinx Events

Sphinx events occur at specific points in the Sphinx build that “pauses” the build process, signals connected functionality to do additional processing, and then continues with the processed results.

Event	Connected
builder-inited	GenDocsFromAutomodsumm
autodoc-skip-member	event_handler__autodoc_skip_member

Functions

setup(app)

Sphinx setup() function for setting up the automodsumm functionality.