Repository navigation
DOC: docs builds are failing (new warning from pytest-doctestplus 1.7.0) #19134
Description
warning:
/home/docs/checkouts/readthedocs.org/user_builds/astropy/checkouts/19127/docs/modeling/new-fitter.rst:74: WARNING: Definition list ends without a blank line; unexpected unindent. [docutils]
this is the block that the warning is pointing to
.. doctest-skip::
setup(
# ...
entry_points = {'astropy.modeling': 'PluginFitterName = fitter_module:PlugFitterClass'}
)last success: https://app.readthedocs.org/api/v2/build/30922943.txt
first failure: https://app.readthedocs.org/api/v2/build/30929132.txt
env diff
15c15
< astropy-8.0.0.dev241+gb571a9f41
---
> astropy-8.0.0.dev236+ga3ddbe94e
81c81
< pytest-doctestplus-1.6.0
---
> pytest-doctestplus-1.7.0
so it seems very likely that pytest-doctestplus 1.7.0 has the relevant change. I'll check now if it is intended.
Activity
neutrinoceros commentedon Jan 8, 2026
I don't see anything on the changelog that seems related. Specifically, the only change in v1.7.0 seems to be scientific-python/pytest-doctestplus#316, and the connection isn't really obvious to me.
neutrinoceros commentedon Jan 8, 2026
(putatively adding the "upstream action required" label because it looks like a regression from where I'm standing, but it could be removed when/if we get a better understanding of the actual issue)
pllim commentedon Jan 8, 2026
Why is doctest-skip even used here? Hmm.
neutrinoceros commentedon Jan 8, 2026
I'm guessing because this snippet would raise a NameError if run ?
pllim commentedon Jan 8, 2026
It has no
>>>. Why would doctest even care? I can investigate.bsipocz commentedon Jan 8, 2026
This is not upstream, but a bug in the astropy docs.