Skip to content

gh-133525: doc that PYTHONEXECUTABLE is not Mac-only and respected with -E/-I options #133526

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.

Sign up for GitHub

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 6 commits into
base: main
Choose a base branch
from
Open

gh-133525: doc that PYTHONEXECUTABLE is not Mac-only and respected with -E/-I options #133526

Changes from 3 commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
0e6584d
docs: note that PYTHONEXECUTABLE is respected with -E/-I options
rickeylev May 6, 2025
22327ff
add sphinx markup to symbols
rickeylev May 6, 2025
03aa8ce
add missing backtick
rickeylev May 6, 2025
c42d191
say it affects sys.executable
rickeylev May 7, 2025
38fa6a6
Merge branch 'docs.note.pyexe.envvar.exception' of https://github.com…
rickeylev May 7, 2025
a868d03
Merge branch 'main' into docs.note.pyexe.envvar.exception
emmatyping May 7, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 7 additions & 7 deletions Doc/using/cmdline.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -107,8 +107,8 @@ source.

:option:`-I` option can be used to run the script in isolated mode where
:data:`sys.path` contains neither the current directory nor the user's
site-packages directory. All ``PYTHON*`` environment variables are
ignored, too.
site-packages directory. All ``PYTHON*`` environment variables (except
:envvar:`PYTHONEXECUTABLE`) are ignored, too.

Many standard library modules contain code that is invoked on their execution
as a script. An example is the :mod:`timeit` module::
Expand Down Expand Up @@ -165,8 +165,8 @@ source.

:option:`-I` option can be used to run the script in isolated mode where
:data:`sys.path` contains neither the script's directory nor the user's
site-packages directory. All ``PYTHON*`` environment variables are
ignored, too.
site-packages directory. All ``PYTHON*`` environment variables (except
:envvar:`PYTHONEXECUTABLE`) are ignored, too.

.. audit-event:: cpython.run_file filename

Expand Down Expand Up @@ -285,7 +285,7 @@ Miscellaneous options

.. option:: -E

Ignore all ``PYTHON*`` environment variables, e.g.
Ignore all ``PYTHON*`` environment variables (except :envvar:`PYTHONEXECUTABLE`), e.g.
:envvar:`PYTHONPATH` and :envvar:`PYTHONHOME`, that might be set.

See also the :option:`-P` and :option:`-I` (isolated) options.
Expand Down Expand Up @@ -939,8 +939,8 @@ conflict.
.. envvar:: PYTHONEXECUTABLE

If this environment variable is set, ``sys.argv[0]`` will be set to its
value instead of the value got through the C runtime. Only works on
macOS.
value instead of the value got through the C runtime. This environment
variable isn't ignored by the :option:`-E` and :option:`-I` options.

.. envvar:: PYTHONWARNINGS

Expand Down
Loading