• 
      

    Enforce our configuration defaults for autodoc.

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

    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.

    Commits

    Files