griffe-inherited-docstrings

Griffe extension for inheriting docstrings.


Keywords
docstrings, griffe, griffe-extension
License
ISC
Install
pip install griffe-inherited-docstrings==1.0.0

Documentation

Griffe Inherited Docstrings

ci documentation pypi version gitpod gitter

Griffe extension for inheriting docstrings.

Installation

With pip:

pip install griffe-inherited-docstrings

With pipx:

python3.8 -m pip install --user pipx
pipx install griffe-inherited-docstrings

Usage

With Python:

import griffe

griffe.load("...", extensions=griffe.load_extensions(["griffe_inherited_docstrings"]))

With MkDocs and mkdocstrings:

plugins:
- mkdocstrings:
    handlers:
      python:
        options:
          extensions:
          - griffe_inherited_docstrings

The extension will iterate on every class and their members to set docstrings from parent classes when they are not already defined.