gh-142474: Clarify -i interaction with PYTHONSTARTUP#142502
Open
Joshua-Ward1 wants to merge 1 commit intopython:mainfrom
Open
gh-142474: Clarify -i interaction with PYTHONSTARTUP#142502Joshua-Ward1 wants to merge 1 commit intopython:mainfrom
Joshua-Ward1 wants to merge 1 commit intopython:mainfrom
Conversation
|
All commit authors signed the Contributor License Agreement. |
FFY00
reviewed
Dec 10, 2025
Comment on lines
+305
to
+306
| Enter interactive mode after execution, or force interactive mode even when | ||
| :data:`sys.stdin` does not appear to be a terminal. |
Member
There was a problem hiding this comment.
I would probably rewrite it as it is worded in python --help.
forces a prompt even if stdin does not appear to be a terminal
Saying "interactive" is not quite correct, "prompt" better describes it.
Member
|
@vstinner, would you mind giving this a look? |
vstinner
reviewed
Dec 16, 2025
| :envvar:`PYTHONSTARTUP` file is not read. | ||
| In these "execute then interact" cases, Python runs the script or command | ||
| first and does not read the :envvar:`PYTHONSTARTUP` file before entering | ||
| interactive mode. |
Member
There was a problem hiding this comment.
I don't understand this paragraph (it looks wrong). For example, PYTHONSTARTUP=script.py ./python -i -c pass does execute script.py.
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
3 participants
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.
Summary
Clarify the documentation for the
-icommand-line option so that it accurately reflects how it interacts withPYTHONSTARTUP.The updated text distinguishes the two distinct behaviors of
-i:When
-iis used with a script or with-c, Python executes the script or command and then enters interactive mode. In these “execute then interact” cases,PYTHONSTARTUPis not read.When
-iis used solely to force interactive mode even ifstdinis not a terminal (for example with redirected standard input), the interpreter enters interactive mode directly andPYTHONSTARTUPis read as usual. The previous documentation implied it was never read when using-i.Issue number
Closes gh-142474.
Type of change
Testing
make html) to confirm RST formatting.-iandPYTHONSTARTUP.Notes
.github/CONTRIBUTING.rst, no NEWS entry is required for this small documentation clarification.📚 Documentation preview 📚: https://cpython-previews--142502.org.readthedocs.build/