Doc: use `python -m pip` rather than plain `pip` in more examples
Refs https://bugs.python.org/issue22295
This commit is contained in:
parent
2edfc86f69
commit
226d08cf05
|
@ -38,7 +38,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:
|
||||
|
||||
|
|
|
@ -719,7 +719,7 @@ Substantially all of these recipes and many, many others can be installed from
|
|||
the `more-itertools project <https://pypi.org/project/more-itertools/>`_ 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
|
||||
|
|
|
@ -100,7 +100,7 @@ limited search feature:
|
|||
|
||||
.. code-block:: bash
|
||||
|
||||
(tutorial-env) $ pip search astronomy
|
||||
(tutorial-env) $ python -m pip search astronomy
|
||||
skyfield - Elegant astronomy for Python
|
||||
gary - Galactic astronomy and gravitational dynamics.
|
||||
novas - The United States Naval Observatory NOVAS astronomy library
|
||||
|
@ -136,8 +136,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
|
||||
|
||||
|
@ -149,14 +149,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
|
||||
|
@ -169,25 +169,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
|
||||
|
|
Loading…
Reference in New Issue