All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
- Support for Python 3.12
- Support for Python 3.8
- Compatibility with griffe > 1.0.0.
- Extension to support building docs with mkdocs.
- Docstrings inheritance with decorators.
- Warning messages are no longer shown by default.
Set the environment variable
DOCSTRING_INHERITANCE_WARNS
to activate them.
- Warning messages are more relevant.
- Some warnings for missing arguments were spurious.
- Warnings for missing method arguments in docstrings.
- Duplicated docstrings detection for missing inheritance opportunities.
- Support for Python 3.12.
- Parsing of Google docstrings with Sphinx directives (like
.. math::
) is no longer considered as a section.
- Docstring inheritance for methods only inherit from the first found parent.
- For the Numpy style, the section
OtherParameters
is no longer processed against the arguments of the signature.
- Docstring inheritance for methods with no argument descriptions.
- Format of the arguments provided with the default description for the Numpy style.
- Docstring inheritance for methods with no arguments.
- Docstring inheritance for methods with multiple parents.
- Support class docstrings with
__init__
signature description.
- Some performance improvements.
- Metaclasses API no longer leaks into the classes they create.
- Support for Python 3.11.
- Metaclasses naming.
- Handling of object in the class hierarchy.
- Rendering of Google docstrings with no summaries.
- Formatting of items without descriptions.
- Inheritance of a metaclass'd class from its grandparents.
- Initial release.