Enforce our configuration defaults for autodoc.

Review Request #12515 — Created Aug. 8, 2022 and submitted

Information

beanbag-docutils
master

Reviewers

This listens to when configuration is being initialized and sets our own
defaults, helping to enforce a consistent style across our documentation
and to reduce the work needed to set things up.

The defaults turn off the Numpy and Google docstring parsers, set
standard autodoc class ordering and flags, and ensure our own type
hinting is used.

It sets some autodoc defaults that we end up setting in each codebase,
and normalizes autodoc_excludes.

If a codebase needs to, it can opt out of these defaults by setting
use_beanbag_autodoc_defaults=False.

It registers unicode as a type that maps to str when building
against a Python 3 intersphinx or against the unicode function when
building against a Python 2 intersphinx.

And finally, it returns version information for the extension so that
any new versions will cause a doc rebuild.

Unit tests pass.

Tested these with a couple codebases, and the default options removed
from the codebase's conf.py. Didn't see any regressions.

Summary ID
Enforce our configuration defaults for autodoc.
This listens to when configuration is being initialized and sets our own defaults, helping to enforce a consistent style across our documentation and to reduce the work needed to set things up. The defaults turn off the Numpy and Google docstring parsers, set standard autodoc class ordering and flags, and ensure our own type hinting is used. It sets some autodoc defaults that we end up setting in each codebase, and normalizes `autodoc_excludes`. If a codebase needs to, it can opt out of these defaults by setting `use_beanbag_autodoc_defaults=False`. It registers `unicode` as a type that maps to `str` when building against a Python 3 intersphinx or against the `unicode` function when building against a Python 2 intersphinx. And finally, it returns version information for the extension so that any new versions will cause a doc rebuild.
cd5a0e064d684754a9fe33472076a1f9cecd68aa
chipx86
chipx86
david
  1. Ship It!
  2. 
      
chipx86
Review request changed

Status: Closed (submitted)

Change Summary:

Pushed to master (590b65f)
Loading...