mirror of
https://github.com/pypa/pip
synced 2023-12-13 21:30:23 +01:00
Remind users to update system path since script does not. Well, at least on Windows it doesn't update PATH. Perhaps this should be qualified?
91 lines
2.1 KiB
ReStructuredText
91 lines
2.1 KiB
ReStructuredText
.. _`Installation`:
|
|
|
|
Installation
|
|
============
|
|
|
|
Python & OS Support
|
|
-------------------
|
|
|
|
pip works with CPython versions 2.6, 2.7, 3.1, 3.2, 3.3, 3.4 and also pypy.
|
|
|
|
pip works on Unix/Linux, OS X, and Windows.
|
|
|
|
.. note::
|
|
|
|
Python 2.5 was supported through v1.3.1, and Python 2.4 was supported through v1.1.
|
|
|
|
|
|
.. _`get-pip`:
|
|
|
|
Install pip
|
|
-----------
|
|
|
|
To install or upgrade pip, securely download `get-pip.py
|
|
<https://bootstrap.pypa.io/get-pip.py>`_. [1]_
|
|
|
|
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]_
|
|
|
|
To upgrade an existing `setuptools`_ (or `distribute`_), run ``pip install -U setuptools`` [3]_
|
|
|
|
To enable the use of pip from the command line, ensure the ``Scripts`` subdirectory of
|
|
your Python installation is available on the system PATH. (This is not done automatically.)
|
|
|
|
Upgrade pip
|
|
-----------
|
|
|
|
On Linux or OS X:
|
|
|
|
::
|
|
|
|
pip install -U pip
|
|
|
|
|
|
On Windows [4]_:
|
|
|
|
::
|
|
|
|
python -m pip install -U pip
|
|
|
|
|
|
|
|
Using Package Managers
|
|
----------------------
|
|
|
|
On Linux, pip will generally be available for the system install of python using
|
|
the system package manager, although often the latest version will be
|
|
unavailable.
|
|
|
|
On Debian and Ubuntu::
|
|
|
|
sudo apt-get install python-pip
|
|
|
|
On Fedora::
|
|
|
|
sudo yum install python-pip
|
|
|
|
|
|
----
|
|
|
|
.. [1] "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
|
|
be installed first.
|
|
|
|
.. [3] 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] https://github.com/pypa/pip/issues/1299
|
|
|
|
.. _setuptools: https://pypi.python.org/pypi/setuptools
|
|
.. _distribute: https://pypi.python.org/pypi/distribute
|