mirror of https://github.com/pypa/pip
137 lines
2.9 KiB
ReStructuredText
137 lines
2.9 KiB
ReStructuredText
==========
|
|
Quickstart
|
|
==========
|
|
|
|
First, :doc:`install pip <installing>`.
|
|
|
|
Install a package from `PyPI`_:
|
|
|
|
.. tab:: Unix/macOS
|
|
|
|
.. code-block:: console
|
|
|
|
$ python -m pip install SomePackage
|
|
[...]
|
|
Successfully installed SomePackage
|
|
|
|
.. tab:: Windows
|
|
|
|
.. code-block:: console
|
|
|
|
C:\> py -m pip install SomePackage
|
|
[...]
|
|
Successfully installed SomePackage
|
|
|
|
|
|
Install a package that's already been downloaded from `PyPI`_ or
|
|
obtained from elsewhere. This is useful if the target machine does not have a
|
|
network connection:
|
|
|
|
.. tab:: Unix/macOS
|
|
|
|
.. code-block:: console
|
|
|
|
$ python -m pip install SomePackage-1.0-py2.py3-none-any.whl
|
|
[...]
|
|
Successfully installed SomePackage
|
|
|
|
.. tab:: Windows
|
|
|
|
.. code-block:: console
|
|
|
|
C:\> py -m pip install SomePackage-1.0-py2.py3-none-any.whl
|
|
[...]
|
|
Successfully installed SomePackage
|
|
|
|
Show what files were installed:
|
|
|
|
.. tab:: Unix/macOS
|
|
|
|
.. code-block:: console
|
|
|
|
$ python -m pip show --files SomePackage
|
|
Name: SomePackage
|
|
Version: 1.0
|
|
Location: /my/env/lib/pythonx.x/site-packages
|
|
Files:
|
|
../somepackage/__init__.py
|
|
[...]
|
|
|
|
.. tab:: Windows
|
|
|
|
.. code-block:: console
|
|
|
|
C:\> py -m pip show --files SomePackage
|
|
Name: SomePackage
|
|
Version: 1.0
|
|
Location: /my/env/lib/pythonx.x/site-packages
|
|
Files:
|
|
../somepackage/__init__.py
|
|
[...]
|
|
|
|
List what packages are outdated:
|
|
|
|
.. tab:: Unix/macOS
|
|
|
|
.. code-block:: console
|
|
|
|
$ python -m pip list --outdated
|
|
SomePackage (Current: 1.0 Latest: 2.0)
|
|
|
|
.. tab:: Windows
|
|
|
|
.. code-block:: console
|
|
|
|
C:\> py -m pip list --outdated
|
|
SomePackage (Current: 1.0 Latest: 2.0)
|
|
|
|
Upgrade a package:
|
|
|
|
.. tab:: Unix/macOS
|
|
|
|
.. code-block:: console
|
|
|
|
$ python -m pip install --upgrade SomePackage
|
|
[...]
|
|
Found existing installation: SomePackage 1.0
|
|
Uninstalling SomePackage:
|
|
Successfully uninstalled SomePackage
|
|
Running setup.py install for SomePackage
|
|
Successfully installed SomePackage
|
|
|
|
.. tab:: Windows
|
|
|
|
.. code-block:: console
|
|
|
|
C:\> py -m pip install --upgrade SomePackage
|
|
[...]
|
|
Found existing installation: SomePackage 1.0
|
|
Uninstalling SomePackage:
|
|
Successfully uninstalled SomePackage
|
|
Running setup.py install for SomePackage
|
|
Successfully installed SomePackage
|
|
|
|
Uninstall a package:
|
|
|
|
.. tab:: Unix/macOS
|
|
|
|
.. code-block:: console
|
|
|
|
$ python -m pip uninstall SomePackage
|
|
Uninstalling SomePackage:
|
|
/my/env/lib/pythonx.x/site-packages/somepackage
|
|
Proceed (y/n)? y
|
|
Successfully uninstalled SomePackage
|
|
|
|
.. tab:: Windows
|
|
|
|
.. code-block:: console
|
|
|
|
C:\> py -m pip uninstall SomePackage
|
|
Uninstalling SomePackage:
|
|
/my/env/lib/pythonx.x/site-packages/somepackage
|
|
Proceed (y/n)? y
|
|
Successfully uninstalled SomePackage
|
|
|
|
.. _PyPI: https://pypi.org/
|