mirror of
https://github.com/pypa/pip
synced 2023-12-13 21:30:23 +01:00
Merge pull request #9131 from uranusjr/install-method-order
This commit is contained in:
commit
23324a664f
2 changed files with 60 additions and 17 deletions
|
@ -10,8 +10,58 @@ Do I need to install pip?
|
||||||
pip is already installed if you are using Python 2 >=2.7.9 or Python 3 >=3.4
|
pip is already installed if you are using Python 2 >=2.7.9 or Python 3 >=3.4
|
||||||
downloaded from `python.org <https://www.python.org>`_ or if you are working
|
downloaded from `python.org <https://www.python.org>`_ or if you are working
|
||||||
in a :ref:`Virtual Environment <pypug:Creating and using Virtual Environments>`
|
in a :ref:`Virtual Environment <pypug:Creating and using Virtual Environments>`
|
||||||
created by :ref:`pypug:virtualenv` or :ref:`pyvenv <pypug:venv>`.
|
created by :ref:`pypug:virtualenv` or :ref:`venv <pypug:venv>`. Just make sure
|
||||||
Just make sure to :ref:`upgrade pip <Upgrading pip>`.
|
to :ref:`upgrade pip <Upgrading pip>`.
|
||||||
|
|
||||||
|
Use the following command to check whether pip is installed:
|
||||||
|
|
||||||
|
.. tab:: Unix/macOS
|
||||||
|
|
||||||
|
.. code-block:: console
|
||||||
|
|
||||||
|
$ python -m pip --version
|
||||||
|
pip X.Y.Z from .../site-packages/pip (python X.Y)
|
||||||
|
|
||||||
|
.. tab:: Windows
|
||||||
|
|
||||||
|
.. code-block:: console
|
||||||
|
|
||||||
|
C:\> py -m pip --version
|
||||||
|
pip X.Y.Z from ...\site-packages\pip (python X.Y)
|
||||||
|
|
||||||
|
Using Linux Package Managers
|
||||||
|
============================
|
||||||
|
|
||||||
|
.. warning::
|
||||||
|
|
||||||
|
If you installed Python from a package manager on Linux, you should always
|
||||||
|
install pip for that Python installation using the same source.
|
||||||
|
|
||||||
|
See `pypug:Installing pip/setuptools/wheel with Linux Package Managers <https://packaging.python.org/guides/installing-using-linux-tools/>`_
|
||||||
|
in the Python Packaging User Guide.
|
||||||
|
|
||||||
|
Here are ways to contact a few Linux package maintainers if you run into
|
||||||
|
problems:
|
||||||
|
|
||||||
|
* `Deadsnakes PPA <https://github.com/deadsnakes/issues>`_
|
||||||
|
* `Debian Python Team <https://wiki.debian.org/Teams/PythonTeam>`_ (for general
|
||||||
|
issues related to ``apt``)
|
||||||
|
* `Red Hat Bugzilla <https://bugzilla.redhat.com/>`_
|
||||||
|
|
||||||
|
pip developers do not have control over how Linux distributions handle pip
|
||||||
|
installations, and are unable to provide solutions to related issues in
|
||||||
|
general.
|
||||||
|
|
||||||
|
Using ensurepip
|
||||||
|
===============
|
||||||
|
|
||||||
|
Python >=3.4 can self-bootstrap pip with the built-in
|
||||||
|
:ref:`ensurepip <pypug:ensurepip>` module. Refer to the standard library
|
||||||
|
documentation for more details. Make sure to :ref:`upgrade pip <Upgrading pip>`
|
||||||
|
after ``ensurepip`` installs pip.
|
||||||
|
|
||||||
|
See the `Using Linux Package Managers`_ section if your Python reports
|
||||||
|
``No module named ensurepip`` on Debian and derived systems (e.g. Ubuntu).
|
||||||
|
|
||||||
|
|
||||||
.. _`get-pip`:
|
.. _`get-pip`:
|
||||||
|
@ -19,7 +69,13 @@ Just make sure to :ref:`upgrade pip <Upgrading pip>`.
|
||||||
Installing with get-pip.py
|
Installing with get-pip.py
|
||||||
==========================
|
==========================
|
||||||
|
|
||||||
To install pip, securely [1]_ download ``get-pip.py`` by following
|
.. warning::
|
||||||
|
|
||||||
|
Be cautious if you are using a Python install that is managed by your operating
|
||||||
|
system or another package manager. ``get-pip.py`` does not coordinate with
|
||||||
|
those tools, and may leave your system in an inconsistent state.
|
||||||
|
|
||||||
|
To manually install pip, securely [1]_ download ``get-pip.py`` by following
|
||||||
this link: `get-pip.py
|
this link: `get-pip.py
|
||||||
<https://bootstrap.pypa.io/get-pip.py>`_. Alternatively, use ``curl``::
|
<https://bootstrap.pypa.io/get-pip.py>`_. Alternatively, use ``curl``::
|
||||||
|
|
||||||
|
@ -40,13 +96,6 @@ have downloaded ``get-pip.py``:
|
||||||
|
|
||||||
py get-pip.py
|
py get-pip.py
|
||||||
|
|
||||||
|
|
||||||
.. warning::
|
|
||||||
|
|
||||||
Be cautious if you are using a Python install that is managed by your operating
|
|
||||||
system or another package manager. ``get-pip.py`` does not coordinate with
|
|
||||||
those tools, and may leave your system in an inconsistent state.
|
|
||||||
|
|
||||||
``get-pip.py`` also installs :ref:`pypug:setuptools` [2]_ and :ref:`pypug:wheel`
|
``get-pip.py`` also installs :ref:`pypug:setuptools` [2]_ and :ref:`pypug:wheel`
|
||||||
if they are not already. :ref:`pypug:setuptools` is required to install
|
if they are not already. :ref:`pypug:setuptools` is required to install
|
||||||
:term:`source distributions <pypug:Source Distribution (or "sdist")>`. Both are
|
:term:`source distributions <pypug:Source Distribution (or "sdist")>`. Both are
|
||||||
|
@ -134,13 +183,6 @@ Install behind a proxy:
|
||||||
|
|
||||||
py get-pip.py pip==9.0.2 wheel==0.30.0 setuptools==28.8.0
|
py get-pip.py pip==9.0.2 wheel==0.30.0 setuptools==28.8.0
|
||||||
|
|
||||||
Using Linux Package Managers
|
|
||||||
============================
|
|
||||||
|
|
||||||
See :ref:`pypug:Installing pip/setuptools/wheel with Linux Package Managers` in
|
|
||||||
the `Python Packaging User Guide
|
|
||||||
<https://packaging.python.org/guides/tool-recommendations/>`_.
|
|
||||||
|
|
||||||
.. _`Upgrading pip`:
|
.. _`Upgrading pip`:
|
||||||
|
|
||||||
Upgrading pip
|
Upgrading pip
|
||||||
|
|
1
news/9131.doc.rst
Normal file
1
news/9131.doc.rst
Normal file
|
@ -0,0 +1 @@
|
||||||
|
Reorder and revise installation instructions to make them easier to follow.
|
Loading…
Reference in a new issue