Support callables and dataclasses in Annotated metadata

[AA-Turner]

Resolves #12601

cc: @2bndy5 -- Brendan, if you'd be able to test this PR I would be grateful.

A

[2bndy5]

Using the zip from #12601 thread, I now get the following nitpicky warnings:

path/to/issue#12601/annotated.py:docstring of annotated.CustomAdmonitionConfig:1: WARNING: py:class reference target not found: pydantic.functional_validators.AfterValidator
path/to/issue#12601/annotated.py:docstring of annotated.CustomAdmonitionConfig:1: WARNING: py:class reference target not found: docutils.nodes.make_id
path/to/issue#12601/annotated.py:docstring of annotated.CustomAdmonitionConfig.classes:1: WARNING: py:class reference target not found: pydantic.functional_validators.AfterValidator
path/to/issue#12601/annotated.py:docstring of annotated.CustomAdmonitionConfig.classes:1: WARNING: py:class reference target not found: docutils.nodes.make_id
path/to/issue#12601/annotated.py:docstring of annotated.CustomAdmonitionConfig.title:1: WARNING: py:class reference target not found: FieldInfo
path/to/issue#12601/annotated.py:docstring of annotated.CustomAdmonitionConfig.title:1: WARNING: py:class reference target not found: NoneType

after adding to conf.py:

extensions = [
    "sphinx.ext.autodoc",
    "sphinx.ext.intersphinx",
]
autodoc_mock_imports = [
    "docutils",
    "pydantic",
]
intersphinx_mapping = {
    "python": ("https://docs.python.org/3", None),
}

I get the following nitpicky warnings:

path/to/issue#12601/annotated.py:docstring of annotated.CustomAdmonitionConfig.classes:1: WARNING: py:class reference target not found: pydantic.AfterValidator
path/to/issue#12601/annotated.py:docstring of annotated.CustomAdmonitionConfig.title:1: WARNING: py:class reference target not found: pydantic.Field

with the following HTML output:

Overall, I think this is a considerable improvement. Thanks!

[AA-Turner]

Thanks @2bndy5!

A

[2bndy5]

Thank you for taking the lead on this!