McSinyx/pip
1
1
Fork 0
mirror of https://github.com/pypa/pip synced 2023-12-13 21:30:23 +01:00
Code Issues Releases Activity

DOC: pip is sometimes included with Python

Browse source
This commit is contained in:
jarondl 2014-12-08 14:15:12 +02:00
parent 33ad03c6d6
commit b974eadd9d
1 changed files with 16 additions and 10 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

26
docs/installing.rst
View file

@ -14,6 +14,10 @@ pip works on Unix/Linux, OS X, and Windows.
Python 2.5 was supported through v1.3.1, and Python 2.4 was supported through v1.1.
pip included with Python
------------------------
Python 2.7.9 and later (on the python2 series), and Python 3.4
and later include pip by default [1]_, so you may have pip already.
.. _`get-pip`:
@ -21,7 +25,7 @@ Install pip
-----------
To install pip, securely download `get-pip.py
<https://bootstrap.pypa.io/get-pip.py>`_. [1]_
<https://bootstrap.pypa.io/get-pip.py>`_. [2]_
Then run the following (which may require administrator access):
@ -30,10 +34,10 @@ Then run the following (which may require administrator access):
python get-pip.py
If `setuptools`_ (or `distribute`_) is not already installed, ``get-pip.py`` will
install `setuptools`_ for you. [2]_
install `setuptools`_ for you. [3]_
To upgrade an existing `setuptools`_ (or `distribute`_), run ``pip install -U
setuptools``. [3]_
setuptools``. [4]_
Additionally, ``get-pip.py`` supports using the :ref:`pip install options <pip
install Options>` and the :ref:`general options <General Options>`. Below are
@ -43,7 +47,7 @@ Install from local copies of pip and setuptools::
python get-pip.py --no-index --find-links=/local/copies
Install to the user site [4]_::
Install to the user site [5]_::
python get-pip.py --user
@ -63,7 +67,7 @@ On Linux or OS X:
pip install -U pip
On Windows [5]_:
On Windows [6]_:
::
@ -89,26 +93,28 @@ On Fedora::
----
.. [1] "Secure" in this context means using a modern browser or a
.. [1] 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.
.. [2] Beginning with pip v1.5.1, ``get-pip.py`` stopped requiring setuptools to
.. [3] Beginning with pip v1.5.1, ``get-pip.py`` stopped requiring setuptools to
be installed first.
.. [3] Although using ``pip install --upgrade setuptools`` to upgrade from
.. [4] Although using ``pip install --upgrade setuptools`` to upgrade from
distribute to setuptools works in isolation, it's possible to get
"ImportError: No module named setuptools" when using pip<1.4 to upgrade a
package that depends on setuptools or distribute. See :doc:`here for
details <distribute_setuptools>`.
.. [4] The pip developers are considering making ``--user`` the default for all
.. [5] 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
.. [6] https://github.com/pypa/pip/issues/1299
.. _setuptools: https://pypi.python.org/pypi/setuptools
.. _distribute: https://pypi.python.org/pypi/distribute