/usr/share/doc/python-pip/installing.rst is in python-pip 8.1.1-2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 | .. _`Installation`:
Installation
============
Do I need to install pip?
-------------------------
pip is already installed if you're using Python 2 >=2.7.9 or Python 3 >=3.4
downloaded from `python.org <https://www.python.org>`_, but you'll need to
:ref:`upgrade pip <Upgrading pip>`.
Additionally, pip will already be installed if you're working in a :ref:`Virtual
Environment <pypug:Creating and using Virtual Environments>` created by
:ref:`pypug:virtualenv` or :ref:`pyvenv <pypug:venv>`.
.. _`get-pip`:
Installing with get-pip.py
--------------------------
To install pip, securely download `get-pip.py
<https://bootstrap.pypa.io/get-pip.py>`_. [2]_
Then run the following:
::
python get-pip.py
.. warning::
Be cautious if you're using a Python install that's 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 will also install :ref:`pypug:setuptools` [3]_ and :ref:`pypug:wheel`,
if they're not already. :ref:`pypug:setuptools` is required to install
:term:`source distributions <pypug:Source Distribution (or "sdist")>`. Both are
required to be able to build a :ref:`Wheel cache` (which improves installation
speed), although neither are required to install pre-built :term:`wheels
<pypug:Wheel>`.
get-pip.py options
~~~~~~~~~~~~~~~~~~~
.. option:: --no-setuptools
If set, don't attempt to install :ref:`pypug:setuptools`
.. option:: --no-wheel
If set, don't attempt to install :ref:`pypug:wheel`
Additionally, ``get-pip.py`` supports using the :ref:`pip install options <pip
install Options>` and the :ref:`general options <General Options>`. Below are
some examples:
Install from local copies of pip and setuptools::
python get-pip.py --no-index --find-links=/local/copies
Install to the user site [4]_::
python get-pip.py --user
Install behind a proxy::
python get-pip.py --proxy="[user:passwd@]proxy.server:port"
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/en/latest/current/>`_.
.. _`Upgrading pip`:
Upgrading pip
-------------
On Linux or OS X:
::
pip install -U pip
On Windows [5]_:
::
python -m pip install -U pip
Python and OS Compatibility
---------------------------
pip works with CPython versions 2.6, 2.7, 3.3, 3.4, 3.5 and also pypy.
This means pip works on the latest patch version of each of these minor versions
(i.e. 2.6.9 for 2.6, etc).
Previous patch versions are supported on a best effort approach.
pip works on Unix/Linux, OS X, and Windows.
----
.. [1] For Python 2, see https://docs.python.org/2/installing, and for Python3,
see https://docs.python.org/3/installing.
.. [2] "Secure" in this context means using a modern browser or a
tool like `curl` that verifies SSL certificates when downloading from
https URLs.
.. [3] Beginning with pip v1.5.1, ``get-pip.py`` stopped requiring setuptools to
be installed first.
.. [4] The pip developers are considering making ``--user`` the default for all
installs, including ``get-pip.py`` installs of pip, but at this time,
``--user`` installs for pip itself, should not be considered to be fully
tested or endorsed. For discussion, see `Issue 1668
<https://github.com/pypa/pip/issues/1668>`_.
.. [5] https://github.com/pypa/pip/issues/1299
|