gh-131484: Document that directory and zipfile script targets stay on sys.path - #154853
Open
yhay81 wants to merge 1 commit into
Open
gh-131484: Document that directory and zipfile script targets stay on sys.path#154853yhay81 wants to merge 1 commit into
yhay81 wants to merge 1 commit into
Conversation
… sys.path -P, -I and PYTHONSAFEPATH drop the implicit sys.path[0] entries (current directory, script directory, empty string), but a directory or zipfile named as the script argument is still prepended: that entry is used to locate __main__.py and makes other modules stored in the target importable. The -P section currently enumerates only the -m, script and -c/REPL cases. Co-Authored-By: Claude Fable 5 <[email protected]>
Documentation build overview
|
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
The
-Pdocumentation covers only the-m/ script /-c/ REPL cases. A directoryor zipfile passed as the script argument stays at the start of
sys.path, insafe-path and isolated modes alike: that entry is used to locate
__main__and makesother modules stored in the target importable.
This documents existing behavior; there is no code change. It assumes keeping the
named target is intended — if it should change instead, please close this; the
analysis is in #131484.
Verified with 3.14.6 and main at 8b048eb.
AI-assisted; I reviewed the changes and verified the behavior and cited source myself.