Skip to content

Latest commit

 

History

History
32 lines (21 loc) · 657 Bytes

File metadata and controls

32 lines (21 loc) · 657 Bytes

docassert

This extension checks that functions or classes have not undocumented parameters.

Usage

This extension does nothing but generating warnings if a function or a class documents a misspelled parameter (not in the signature) or if one parameter is missing from the documentation.

In conf.py:

extensions = [ ...
    'sphinx_runpython.docassert',
]

Sphinx outputs some warnings:

WARNING: [docassert] '_init' has undocumented parameters 'translator_class' (in 'example_file.py').

Classes

.. autoclass:: sphinx_runpython.docassert.sphinx_docassert_extension.OverrideDocFieldTransformer