Skip to content

gh-113329: Catch OSError in doctest finder and document that inspect.getsourcefile/getfile can raise OSError #113335

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 3 commits into
base: main
Choose a base branch
from

Conversation

stenwessel
Copy link

@stenwessel stenwessel commented Dec 20, 2023

Fixes #113329, which occurs when running doctests in a class docstring in a REPL environment. Since Python 3.10, an OSError is raised when the class source code cannot be found.

Just as inspect.getsourcelines, this PR adds documentation for inspect.getsourcefile and inspect.getfile that it can raise an OSError when the source code cannot be found.

Additionally, this PR now also catches OSError in the doctest finder. The source code is only necessary to discover line numbers, and is already ignored when a TypeError occurs. This restores behavior from CPython version < 3.10 where doctests can be found on a class object in the REPL (and, in particular, also in notebook environments).


📚 Documentation preview 📚: https://cpython-previews--113335.org.readthedocs.build/

Fixes python#113329, which occurs when running doctests in a class docstring in a REPL environment. Since Python 3.10, an OSError is raised when the class source code cannot be found.
@ghost
Copy link

ghost commented Dec 20, 2023

All commit authors signed the Contributor License Agreement.
CLA signed

@bedevere-app
Copy link

bedevere-app bot commented Dec 20, 2023

Most changes to Python require a NEWS entry. Add one using the blurb_it web app or the blurb command-line tool.

If this change has little impact on Python users, wait for a maintainer to apply the skip news label instead.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Running doctest examples on a class results in OSError in REPL
1 participant