DocTestCase should report as skipped if the doctest itself is skipped

[mhsmith]

Feature or enhancement

Proposal:

When a doctest is run through unittest, each docstring is wrapped in a DocTestCase. Currently, if the docstring's examples are all skipped (either with a # doctest: +SKIP comment, or the optionflags argument), the DocTestCase 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 the DocTestCase 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