https://github.com/python/cpython/commit/138ed6db9f89171983dc32af4e7ad2e73d46a940 commit: 138ed6db9f89171983dc32af4e7ad2e73d46a940 branch: main author: Bartosz Sławecki <[email protected]> committer: ZeroIntensity <[email protected]> date: 2025-08-18T10:58:23-04:00 summary:
gh-44538: Mention nested classes/functions in doctest docs (GH-137870) files: M Doc/library/doctest.rst diff --git a/Doc/library/doctest.rst b/Doc/library/doctest.rst index 5a2c6bdd27c386..02b73ccd3f3d19 100644 --- a/Doc/library/doctest.rst +++ b/Doc/library/doctest.rst @@ -350,6 +350,13 @@ searches them recursively for docstrings, which are then scanned for tests. Any classes found are recursively searched similarly, to test docstrings in their contained methods and nested classes. +.. note:: + + ``doctest`` can only automatically discover classes and functions that are + defined at the module level or inside other classes. + + Since nested classes and functions only exist when an outer function + is called, they cannot be discovered. Define them outside to make them visible. .. _doctest-finding-examples: _______________________________________________ Python-checkins mailing list -- [email protected] To unsubscribe send an email to [email protected] https://mail.python.org/mailman3//lists/python-checkins.python.org Member address: [email protected]
