stubdoc

stubdoc is a sphinx extension to read docstrings from stub files.

How to get a docstring from a stub file is discussed in this sphinx issue, and possible use cases include document generation for the c-extension.

Stub files

Stub files are explained in detail in the mypy documentation.

The module (currently) assumes that the stub file is in the same directory as the target file.

install stubdoc

pip install git+https://github.com/bayashi-cl/stubdoc

Edit conf.py

# Configuration file for the Sphinx documentation builder.
...
extensions = ["stubdoc"]
...
module_names = ["my_module"]
...

The module_names accepts a list of module names, and any module startwith that name will be the target of the stub file search.

# Find stub files only under submodules.
module_names = ["my_module.submodule"]

# Use setuptools.find_packages
module_names = find_packages("path/to/src")