Untitled diff

Created Diff never expires
38 removals
132 lines
65 additions
159 lines
$ pip3 help download
$ pip3 help install


Usage:
Usage:
pip download [options] <requirement specifier> [package-index-options] ...
pip install [options] <requirement specifier> [package-index-options] ...
pip download [options] -r <requirements file> [package-index-options] ...
pip install [options] -r <requirements file> [package-index-options] ...
pip download [options] [-e] <vcs project url> ...
pip install [options] [-e] <vcs project url> ...
pip download [options] [-e] <local project path> ...
pip install [options] [-e] <local project path> ...
pip download [options] <archive url/path> ...
pip install [options] <archive url/path> ...


Description:
Description:
Download packages from:
Install packages from:


- PyPI (and other indexes) using requirement specifiers.
- PyPI (and other indexes) using requirement specifiers.
- VCS project urls.
- VCS project urls.
- Local project directories.
- Local project directories.
- Local or remote source archives.
- Local or remote source archives.


pip also supports downloading from "requirements files", which provide
pip also supports installing from "requirements files", which provide
an easy way to specify a whole environment to be downloaded.
an easy way to specify a whole environment to be installed.


Download Options:
Install Options:
-c, --constraint <file> Constrain versions using the given constraints
-c, --constraint <file> Constrain versions using the given constraints
file. This option can be used multiple times.
file. This option can be used multiple times.
-e, --editable <path/url> Install a project in editable mode (i.e.
-e, --editable <path/url> Install a project in editable mode (i.e.
setuptools "develop mode") from a local project
setuptools "develop mode") from a local project
path or a VCS url.
path or a VCS url.
-r, --requirement <file> Install from the given requirements file. This
-r, --requirement <file> Install from the given requirements file. This
option can be used multiple times.
option can be used multiple times.
-b, --build <dir> Directory to unpack packages into and build in.
-b, --build <dir> Directory to unpack packages into and build in.
-t, --target <dir> Install packages into <dir>. By default this
will not replace existing files/folders in
<dir>. Use --upgrade to replace existing
packages in <dir> with new versions.
-d, --download <dir> Download packages into <dir> instead of
installing them, regardless of what's already
installed.
--src <dir> Directory to check out editable projects into.
The default in a virtualenv is "<venv
path>/src". The default for global installs is
"<current dir>/src".
-U, --upgrade Upgrade all specified packages to the newest
available version. The handling of dependencies
depends on the upgrade-strategy used.
--upgrade-strategy <upgrade_strategy>
Determines how dependency upgrading should be
handled. "eager" - dependencies are upgraded
regardless of whether the currently installed
version satisfies the requirements of the
upgraded package(s). "only-if-needed" - are
upgraded only when they do not satisfy the
requirements of the upgraded package(s).
--force-reinstall When upgrading, reinstall all packages even if
they are already up-to-date.
-I, --ignore-installed Ignore the installed packages (reinstalling
instead).
--ignore-requires-python Ignore the Requires-Python information.
--no-deps Don't install package dependencies.
--no-deps Don't install package dependencies.
--install-option <options> Extra arguments to be supplied to the setup.py
install command (use like --install-option="--
install-scripts=/usr/local/bin"). Use multiple
--install-option options to pass multiple
options to setup.py install. If you are using an
option with a directory path, be sure to use
absolute path.
--global-option <options> Extra global options to be supplied to the
--global-option <options> Extra global options to be supplied to the
setup.py call before the install command.
setup.py call before the install command.
--user Install to the Python user install directory for
your platform. Typically ~/.local/, or
%APPDATA%\Python on Windows. (See the Python
documentation for site.USER_BASE for full
details.)
--egg Install packages as eggs, not 'flat', like pip
normally does. This option is not about
installing *from* eggs. (WARNING: Because this
option overrides pip's normal install logic,
requirements files may not behave as expected.)
--root <dir> Install everything relative to this alternate
root directory.
--prefix <dir> Installation prefix where lib, bin and other
top-level folders are placed
--compile Compile py files to pyc
--no-compile Do not compile py files to pyc
--no-use-wheel Do not Find and prefer wheel archives when
searching indexes and find-links locations.
DEPRECATED in favour of --no-binary.
--no-binary <format_control>
--no-binary <format_control>
Do not use binary packages. Can be supplied
Do not use binary packages. Can be supplied
multiple times, and each time adds to the
multiple times, and each time adds to the
existing value. Accepts either :all: to disable
existing value. Accepts either :all: to disable
all binary packages, :none: to empty the set, or
all binary packages, :none: to empty the set, or
one or more package names with commas between
one or more package names with commas between
them. Note that some packages are tricky to
them. Note that some packages are tricky to
compile and may fail to install when this option
compile and may fail to install when this option
is used on them.
is used on them.
--only-binary <format_control>
--only-binary <format_control>
Do not use source packages. Can be supplied
Do not use source packages. Can be supplied
multiple times, and each time adds to the
multiple times, and each time adds to the
existing value. Accepts either :all: to disable
existing value. Accepts either :all: to disable
all source packages, :none: to empty the set, or
all source packages, :none: to empty the set, or
one or more package names with commas between
one or more package names with commas between
them. Packages without binary distributions will
them. Packages without binary distributions will
fail to install when this option is used on
fail to install when this option is used on
them.
them.
--src <dir> Directory to check out editable projects into.
The default in a virtualenv is "<venv
path>/src". The default for global installs is
"<current dir>/src".
--pre Include pre-release and development versions. By
--pre Include pre-release and development versions. By
default, pip only finds stable versions.
default, pip only finds stable versions.
--no-clean Don't clean up build directories.
--no-clean Don't clean up build directories.
--require-hashes Require a hash to check each requirement
--require-hashes Require a hash to check each requirement
against, for repeatable installs. This option is
against, for repeatable installs. This option is
implied when any package in a requirements file
implied when any package in a requirements file
has a --hash option.
has a --hash option.
-d, --dest <dir> Download packages into <dir>.
--platform <platform> Only download wheels compatible with <platform>.
Defaults to the platform of the running system.
--python-version <python_version>
Only download wheels compatible with Python
interpreter version <version>. If not specified,
then the current system interpreter minor
version is used. A major version (e.g. '2') can
be specified to match all minor revs of that
major version. A minor version (e.g. '34') can
also be specified.
--implementation <implementation>
Only download wheels compatible with Python
implementation <implementation>, e.g. 'pp',
'jy', 'cp', or 'ip'. If not specified, then the
current interpreter implementation is used. Use
'py' to force implementation-agnostic wheels.
--abi <abi> Only download wheels compatible with Python abi
<abi>, e.g. 'pypy_41'. If not specified, then
the current interpreter abi tag is used.
Generally you will need to specify
--implementation, --platform, and --python-
version when using this option.


Package Index Options:
Package Index Options (including deprecated options):
-i, --index-url <url> Base URL of Python Package Index (default
-i, --index-url <url> Base URL of Python Package Index (default
https://pypi.python.org/simple). This should
https://pypi.python.org/simple). This should
point to a repository compliant with PEP 503
point to a repository compliant with PEP 503
(the simple repository API) or a local directory
(the simple repository API) or a local directory
laid out in the same format.
laid out in the same format.
--extra-index-url <url> Extra URLs of package indexes to use in addition
--extra-index-url <url> Extra URLs of package indexes to use in addition
to --index-url. Should follow the same rules as
to --index-url. Should follow the same rules as
--index-url.
--index-url.
--no-index Ignore package index (only looking at --find-
--no-index Ignore package index (only looking at --find-
links URLs instead).
links URLs instead).
-f, --find-links <url> If a url or path to an html file, then parse for
-f, --find-links <url> If a url or path to an html file, then parse for
links to archives. If a local path or file://
links to archives. If a local path or file://
url that's a directory, then look for archives
url that's a directory, then look for archives
in the directory listing.
in the directory listing.
--process-dependency-links Enable the processing of dependency links.
--process-dependency-links Enable the processing of dependency links.


General Options:
General Options:
-h, --help Show help.
-h, --help Show help.
--isolated Run pip in an isolated mode, ignoring
--isolated Run pip in an isolated mode, ignoring
environment variables and user configuration.
environment variables and user configuration.
-v, --verbose Give more output. Option is additive, and can be
-v, --verbose Give more output. Option is additive, and can be
used up to 3 times.
used up to 3 times.
-V, --version Show version and exit.
-V, --version Show version and exit.
-q, --quiet Give less output. Option is additive, and can be
-q, --quiet Give less output. Option is additive, and can be
used up to 3 times (corresponding to WARNING,
used up to 3 times (corresponding to WARNING,
ERROR, and CRITICAL logging levels).
ERROR, and CRITICAL logging levels).
--log <path> Path to a verbose appending log.
--log <path> Path to a verbose appending log.
--proxy <proxy> Specify a proxy in the form
--proxy <proxy> Specify a proxy in the form
[user:passwd@]proxy.server:port.
[user:passwd@]proxy.server:port.
--retries <retries> Maximum number of retries each connection should
--retries <retries> Maximum number of retries each connection should
attempt (default 5 times).
attempt (default 5 times).
--timeout <sec> Set the socket timeout (default 15 seconds).
--timeout <sec> Set the socket timeout (default 15 seconds).
--exists-action <action> Default action when a path already exists:
--exists-action <action> Default action when a path already exists:
(s)witch, (i)gnore, (w)ipe, (b)ackup, (a)bort.
(s)witch, (i)gnore, (w)ipe, (b)ackup, (a)bort.
--trusted-host <hostname> Mark this host as trusted, even though it does
--trusted-host <hostname> Mark this host as trusted, even though it does
not have valid or any HTTPS.
not have valid or any HTTPS.
--cert <path> Path to alternate CA bundle.
--cert <path> Path to alternate CA bundle.
--client-cert <path> Path to SSL client certificate, a single file
--client-cert <path> Path to SSL client certificate, a single file
containing the private key and the certificate
containing the private key and the certificate
in PEM format.
in PEM format.
--cache-dir <dir> Store the cache data in <dir>.
--cache-dir <dir> Store the cache data in <dir>.
--no-cache-dir Disable the cache.
--no-cache-dir Disable the cache.
--disable-pip-version-check
--disable-pip-version-check
Don't periodically check PyPI to determine
Don't periodically check PyPI to determine
whether a new version of pip is available for
whether a new version of pip is available for
download. Implied with --no-index.
download. Implied with --no-index.