fix(autodoc): restore inherited attribute docstrings — swev-id: sphinx-doc__sphinx-8548

[casey-brooks]

Summary

• memoize module analyzers across MRO when inherited members are requested
• reuse docstrings from base attribute definitions when analyzer misses them
• skip annotations unless explicitly requested to avoid noisy output

Observed Failure (before fix)

PYTHONPATH=/workspace/sphinx .venv/bin/pytest tests/test_ext_autodoc_inherited_attrs.py

============================= test session starts ==============================
platform linux -- Python 3.11.14, pytest-9.0.2, pluggy-1.6.0
libraries: Sphinx-3.4.0+/008636cdf, docutils-0.16
collected 2 items

____________________ test_autodoc_inherited_attribute_docs _____________________
>       assert 'Docstring for the base class attribute.' in output
E       AssertionError: assert 'Docstring for the base class attribute.' in '\n.. py:class:: Child()\n   :module: target.inherited_attrs\n\n\n   .. py:attribute:: Child.annotated_only\n      :mo... target.inherited_attrs\n      :value: 3\n\n      Subclass-specific documentation that overrides the base docstring.\n'

Reproduction

git checkout 008636cdf
PYTHONPATH=/workspace/sphinx .venv/bin/pytest tests/test_ext_autodoc_inherited_attrs.py

Testing

• PYTHONPATH=/workspace/sphinx .venv/bin/pytest tests/test_ext_autodoc_inherited_attrs.py
• PYTHONPATH=/workspace/sphinx .venv/bin/pytest tests/test_ext_autodoc.py::test_autodoc_special_members
• PYTHONPATH=/workspace/sphinx .venv/bin/pytest
  • fails: known baseline failures under Python 3.11 (e.g. tests/test_ext_autodoc.py::test_enum_class, tests/test_directive_code.py::test_literal_include_linenos, tests/test_ext_autodoc.py::test_autodoc_typehints_signature, etc.)

Resolves #55

[casey-brooks]

Test & Lint Summary

• PYTHONPATH=/workspace/sphinx .venv/bin/pytest tests/test_ext_autodoc_inherited_attrs.py (2 passed)
• PYTHONPATH=/workspace/sphinx .venv/bin/pytest tests/test_ext_autodoc.py::test_autodoc_special_members (1 passed)
• PYTHONPATH=/workspace/sphinx .venv/bin/pytest
  • baseline failures under Python 3.11: tests/test_ext_autodoc.py::test_enum_class, tests/test_directive_code.py::test_literal_include_linenos, tests/test_ext_autodoc.py::test_autodoc_typehints_signature, tests/test_ext_autodoc_autoattribute.py::test_autoattribute_NewType, tests/test_ext_autodoc_autodata.py::test_autodata_NewType, tests/test_ext_autodoc.py::test_coroutine, tests/test_ext_autodoc_configs.py::test_autodoc_typehints_signature, plus other known lineno/typehint expectations

[noa-lucent]

Looks great. Thanks!