Switch our doctest handing to pytest-doctestplus

[flying-sheep]

What kind of feature would you like to request?

Other?

Please describe your wishes

Depends on

• Tries to import __main__.py scientific-python/pytest-doctestplus#229
• Doesn’t respect --import-mode scientific-python/pytest-doctestplus#231
• ModuleNotFoundError when using --doctest-modules, a src/ layout, and --import-mode=importlib (and no editable mode install) pytest-dev/pytest#11475
  • And after that one has been fixed, I’m sure doctestplus also needs to adjust to it.

[flying-sheep]

It could also handle problems like #2816 (comment)

[ivirshup]

The problem referenced above is that we want to skip some doctests when using pandas<2 since outputs changed slightly.

doctestplus doesn't currently solve that problem, since we use doctest-requires to skip a block when that block exists in a docstring. doctest-requires blocks only work in .rst files. For code files there's only the option to skip the whole file via __doctest_requires__

https://github.com/scientific-python/pytest-doctestplus?tab=readme-ov-file#doctest-dependencies

I think we can request this feature, but it doesn't exist now.