pip #

用法 #

python -m pip <command> [options]
					
py -m pip <command> [options]
					

描述 #

日志 #

控制台日志 #

pip offers -v, --verbose and -q, --quiet to control the console log level. By default, some messages (error and warnings) are colored in the terminal. If you want to suppress the colored output use --no-color .

File logging #

pip offers the --log option for specifying a file where a maximum verbosity log will be kept. This option is empty by default. This log appends to previous logging.

Like all pip options, --log can also be set as an environment variable, or placed into the pip config file. See the 配置 章节。

--exists-action option #

This option specifies default behavior when path already exists. Possible cases: downloading files or checking out repositories for installation, creating archives. If --exists-action is not defined, pip will prompt when decision is needed.

(s)witch

Only relevant to VCS checkout. Attempt to switch the checkout to the appropriate URL and/or revision.

(i)gnore

Abort current operation (e.g. don’t copy file, don’t create archive, don’t modify a checkout).

(w)ipe

Delete the file or VCS checkout before trying to create, download, or checkout a new one.

(b)ackup

Rename the file or checkout to {name}{'.bak' * n} , where n is some number of .bak extensions, such that the file didn’t exist at some point. So the most recent backup will be the one with the largest number after .bak .

(a)bort

Abort pip and return non-zero exit status.

构建系统接口 #

This is now covered in 构建系统接口 .

一般选项 #

-h , --help #

展示帮助。

--debug #

Let unhandled exceptions propagate outside the main subroutine, instead of logging them to stderr.

--isolated #

Run pip in an isolated mode, ignoring environment variables and user configuration.

--require-virtualenv #

Allow pip to only run in a virtual environment; exit with an error otherwise.

-v , --verbose #

Give more output. Option is additive, and can be used up to 3 times.

-V , --version #

Show version and exit.

-q , --quiet #

Give less output. Option is additive, and can be used up to 3 times (corresponding to WARNING, ERROR, and CRITICAL logging levels).

--log <path> #

Path to a verbose appending log.

--no-input #

Disable prompting for input.

--proxy <proxy> #

Specify a proxy in the form scheme://[user:passwd@]proxy.server:port.

--retries <retries> #

Maximum number of retries each connection should attempt (default 5 times).

--timeout <sec> #

Set the socket timeout (default 15 seconds).

--exists-action <action> #

Default action when a path already exists: (s)witch, (i)gnore, (w)ipe, (b)ackup, (a)bort.

--trusted-host <hostname> #

Mark this host or host:port pair as trusted, even though it does not have valid or any HTTPS.

--cert <path> #

Path to PEM-encoded CA certificate bundle. If provided, overrides the default. See ‘SSL Certificate Verification’ in pip documentation for more information.

--client-cert <path> #

Path to SSL client certificate, a single file containing the private key and the certificate in PEM format.

--cache-dir <dir> #

Store the cache data in <dir>.

--no-cache-dir #

Disable the cache.

--disable-pip-version-check #

Don’t periodically check PyPI to determine whether a new version of pip is available for download. Implied with --no-index.

--no-color #

Suppress colored output.

--no-python-version-warning #

Silence deprecation warnings for upcoming unsupported Pythons.

--use-feature <feature> #

Enable new functionality, that may be backward incompatible.

--use-deprecated <feature> #

Enable deprecated functionality, that will be removed in the future.

内容