pip

Langue: en

Autres versions - même langue

Version: March 31, 2009 (debian - 07/07/09)

Section: 1 (Commandes utilisateur)

NAME

pip - install Python packages

SYNOPSIS

pip [command] [options]

DESCRIPTION

This manual page documents briefly the pip command.

This manual page was written for the Debian distribution because the original program does not have a manual page.

pip is an alternative Python package installer. It performs the same basic job as easy_install, but with some extra features. It can work with version control repositories (currently only Git, Mercurial, and Bazaar repositories), logs output extensively, and prevents partial installs by downloading all requirements before starting installation.

It has some disadvantages when compared to easy_install. It does not use egg files, although it does preserve egg metadata. Some setuptools features are not yet supported, and some custom setup.py features won't work.

pip is designed to work with virtualenv, in that it can be given the path to a virtualenv environment (with -E or --environment) and it will know to install to that environment instead of the system locations.

COMMANDS

The command comes before any options. The following commands are recognized:

help

Show the help text.

bundle

Create "bundles" which can be used by pip to install the group of Python packages in multiple places.

freeze

Write the current list of installed packages to a requirements file, which can be used by pip to reinstall the same set of packages.

install

Install packages.

unzip

Unzip an individual package.

zip

Zip an individual package.

OPTIONS

These programs follow the usual GNU command line syntax, with long options starting with two dashes (`-'). A summary of options is included below.

-h --help

Show summary of options.

--version

Show version of program.

-v --verbose

Be more verbose.

-q --quiet

Be less verbose; suppress unimportant output.

-E --environment

When using pip with a virtual environment created by virtualenv, use this option to specify either the path to the environment or the path to its Python interpreter.

--log

Output a log file describing the actions taken to the specified file.

--proxy

Have pip use a proxy server to access sites. This can be specified using "user:password@proxy.server:port" notation. If the password is left out, pip will ask for it.

--timeout

Set the timeout for connecting to download sites, in seconds. This defaults to 15 seconds if not given.

SEE ALSO

The upstream documentation, stored in /usr/share/doc/python-pip.

AUTHOR

This manual page was written by Jeff Licquia <licquia@debian.org> for the Debian system (but may be used by others). Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, Version 2 any later version published by the Free Software Foundation.

On Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common-licenses/GPL.

Copyright © 2009 Jeff Licquia