From dc14e33eff1df31f7c239a8785161db8849cae74 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ville=20Skytt=C3=A4?= Date: Sat, 9 Apr 2022 21:37:01 +0300 Subject: bpo-22295: use python -m pip rather than plain pip in more examples (GH-24003) --- Doc/library/importlib.metadata.rst | 2 +- Doc/library/itertools.rst | 2 +- Doc/tutorial/venv.rst | 24 ++++++++++++------------ 3 files changed, 14 insertions(+), 14 deletions(-) diff --git a/Doc/library/importlib.metadata.rst b/Doc/library/importlib.metadata.rst index a6caa99..b374017 100644 --- a/Doc/library/importlib.metadata.rst +++ b/Doc/library/importlib.metadata.rst @@ -43,7 +43,7 @@ something into it: $ python3 -m venv example $ source example/bin/activate - (example) $ pip install wheel + (example) $ python -m pip install wheel You can get the version string for ``wheel`` by running the following: diff --git a/Doc/library/itertools.rst b/Doc/library/itertools.rst index 8c3b784..26c9253 100644 --- a/Doc/library/itertools.rst +++ b/Doc/library/itertools.rst @@ -721,7 +721,7 @@ Substantially all of these recipes and many, many others can be installed from the `more-itertools project `_ found on the Python Package Index:: - pip install more-itertools + python -m pip install more-itertools The extended tools offer the same high performance as the underlying toolset. The superior memory performance is kept by processing elements one at a time diff --git a/Doc/tutorial/venv.rst b/Doc/tutorial/venv.rst index 58ad319..7cdce3f 100644 --- a/Doc/tutorial/venv.rst +++ b/Doc/tutorial/venv.rst @@ -130,8 +130,8 @@ package name followed by ``==`` and the version number: If you re-run this command, ``pip`` will notice that the requested version is already installed and do nothing. You can supply a -different version number to get that version, or you can run ``pip -install --upgrade`` to upgrade the package to the latest version: +different version number to get that version, or you can run ``python +-m pip install --upgrade`` to upgrade the package to the latest version: .. code-block:: bash @@ -143,14 +143,14 @@ install --upgrade`` to upgrade the package to the latest version: Successfully uninstalled requests-2.6.0 Successfully installed requests-2.7.0 -``pip uninstall`` followed by one or more package names will remove the -packages from the virtual environment. +``python -m pip uninstall`` followed by one or more package names will +remove the packages from the virtual environment. -``pip show`` will display information about a particular package: +``python -m pip show`` will display information about a particular package: .. code-block:: bash - (tutorial-env) $ pip show requests + (tutorial-env) $ python -m pip show requests --- Metadata-Version: 2.0 Name: requests @@ -163,25 +163,25 @@ packages from the virtual environment. Location: /Users/akuchling/envs/tutorial-env/lib/python3.4/site-packages Requires: -``pip list`` will display all of the packages installed in the virtual -environment: +``python -m pip list`` will display all of the packages installed in +the virtual environment: .. code-block:: bash - (tutorial-env) $ pip list + (tutorial-env) $ python -m pip list novas (3.1.1.3) numpy (1.9.2) pip (7.0.3) requests (2.7.0) setuptools (16.0) -``pip freeze`` will produce a similar list of the installed packages, -but the output uses the format that ``pip install`` expects. +``python -m pip freeze`` will produce a similar list of the installed packages, +but the output uses the format that ``python -m pip install`` expects. A common convention is to put this list in a ``requirements.txt`` file: .. code-block:: bash - (tutorial-env) $ pip freeze > requirements.txt + (tutorial-env) $ python -m pip freeze > requirements.txt (tutorial-env) $ cat requirements.txt novas==3.1.1.3 numpy==1.9.2 -- cgit v0.12