-
-
Notifications
You must be signed in to change notification settings - Fork 2.1k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
References to pathlib
objects are incorrectly picked up by autodoc
#13178
Comments
This is a known issue (at least to me) and I should have probably already said it somewhere but the issue is because of the (C)Python intersphinx mappings. When |
pathlib
objects are not incorrectly picked up by autodoc
pathlib
objects are not incorrectly picked up by autodocpathlib
objects are incorrectly picked up by autodoc
Could you give a bit more detail here @picnixz? The intersphinx mappings for Python 3.12 and 3.13 appear to be identical w/r/t the entry for grepping against current master for |
Internally, Namely, when you have On CPython's side, we document I'll honestly try to come up with something by the end of the year for at least forcing any false positive to be manually resolved to something else =/ |
thanks for the explainer! |
Describe the bug
Type annotations using
pathlib.Path
of callable that are handed by autodoc generate the following warning on Python 3.13:They do not on 3.12 and below.
How to Reproduce
Failing build on RTD: https://readthedocs.org/projects/sybil/builds/26566926/
Passing build on RTD: https://readthedocs.org/projects/sybil/builds/26567027/
Only difference is Python 3.12 versus 3.13.
Python source being auto-doc'ed:
https://github.com/simplistix/sybil/blob/8d58cfe196a9f8136f8eea453805e6e3c9e6b263/sybil/sybil.py#L159-L164
Sphinx .rst referencing this:
https://github.com/simplistix/sybil/blob/8d58cfe196a9f8136f8eea453805e6e3c9e6b263/docs/api.rst?plain=1#L14-L16
Sphinx config:
https://github.com/simplistix/sybil/blob/8d58cfe196a9f8136f8eea453805e6e3c9e6b263/docs/conf.py#L1-L45
Environment Information
Sphinx extensions
"sphinx.ext.autodoc"
is the one here.The text was updated successfully, but these errors were encountered: