Feature or enhancement

Proposal:

When a doctest is run throughunittest, each docstring is wrapped in aDocTestCase. Currently, if the docstring's examples are all skipped (either with a# doctest: +SKIP comment, or theoptionflags argument), theDocTestCase still reports as a test pass. Even in the verbose unittest log, there's no indication that anything has been skipped.

It would make sense for theDocTestCase to report as skipped in this situation.

Has this already been discussed elsewhere?

This is a minor feature, which does not need previous discussion elsewhere

Linked PRs

• gh-117294: Report DocTestCase as skipped if all examples in the doctest are skipped #117297