mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-11-03 19:34:08 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 9

bpo-33095: Add reference to isolated mode in -m and script option (GH-7764)

Browse source 
Attempt to make isolated mode easier to discover via additional inline documentation.

Co-Authored-By: Julien Palard <julien@palard.fr>
This commit is contained in:
Xtreak 2019-09-14 01:35:44 +01:00 • committed by Nick Coghlan
parent bf169915ec
commit bdd6945d4d
1 changed files with 13 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

13
Doc/using/cmdline.rst
View file

@ -101,6 +101,11 @@ source.
first element will be set to ``"-m"``). As with the :option:`-c` option, first element will be set to ``"-m"``). As with the :option:`-c` option,
the current directory will be added to the start of :data:`sys.path`. the current directory will be added to the start of :data:`sys.path`.
: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 :envvar:`PYTHON*` environment variables are
ignored, too.
Many standard library modules contain code that is invoked on their execution Many standard library modules contain code that is invoked on their execution
as a script. An example is the :mod:`timeit` module:: as a script. An example is the :mod:`timeit` module::
@ -121,6 +126,7 @@ source.
.. versionchanged:: 3.4 .. versionchanged:: 3.4
namespace packages are also supported namespace packages are also supported
.. _cmdarg-dash:
.. describe:: - .. describe:: -
@ -133,6 +139,8 @@ source.
.. audit-event:: cpython.run_stdin "" "" .. audit-event:: cpython.run_stdin "" ""
.. _cmdarg-script:
.. describe:: <script> .. describe:: <script>
Execute the Python code contained in *script*, which must be a filesystem Execute the Python code contained in *script*, which must be a filesystem
@ -151,6 +159,11 @@ source.
added to the start of :data:`sys.path` and the ``__main__.py`` file in added to the start of :data:`sys.path` and the ``__main__.py`` file in
that location is executed as the :mod:`__main__` module. that location is executed as the :mod:`__main__` module.
: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 :envvar:`PYTHON*` environment variables are
ignored, too.
.. audit-event:: cpython.run_file filename .. audit-event:: cpython.run_file filename
.. seealso:: .. seealso::