pip

Links

http://pip.openplans.org/

https://github.com/sesh/piprot How rotten are your requirements?

Help

To get help on a command (e.g. install):

pip help install

Install

Packages

pip install django
pip install yolk

Local

To install a package locally rather than in the system folders:

pip install --user markdown2

Note I would normally use a virtualenv for this…

Source

Bazaar:

pip install bzr+http://download.gna.org/pychart/bzr-archive#egg=pychart

GIT:

pip install git+git://github.com/rackspace/python-cloudfiles.git#egg=python-cloudfiles

# Passing branch names, a commit hash or a tag name is possible like so
pip install git+git://git.myproject.org/MyProject.git@master#egg=MyProject
pip install git+git://git.myproject.org/MyProject.git@v1.0#egg=MyProject
pip install git+git://git.myproject.org/MyProject.git@da39a3ee5e6b4b0d3255bfef95601890afd80709#egg=MyProject

To install a branch, use the @ parameter e.g:

pip install git+https://github.com/django-compressor/django-compressor.git@develop#egg=compressor

Mercurial:

pip install hg+ssh://hg@server/django-persistent-messages#egg=django-persistent-messages

To install a specific revision:

pip install hg+ssh://hg@server/django-persistent-messages@1a70941d2d66#egg=django-persistent-messages

Uninstall

pip uninstall hgsubversion

I can’t find a simple way to rebuild a wheel… so I did it like this:

Find the wheel in the cache (in this example I am rebuilding pillow):

cd ~/.cache/pip/wheels/
find . -iname \*pillow\*

# sample output
$ ./e3/29/cd/0761582ad93ad680a439eb56b021fe26739be7a7d5dc05ee15/Pillow-2.9.0-cp34-cp34m-linux_x86_64.whl
$ rm ./e3/29/cd/0761582ad93ad680a439eb56b021fe26739be7a7d5dc05ee15/Pillow-2.9.0-cp34-cp34m-linux_x86_64.whl

# back to your project folder
pip uninstall pillow
pip install pillow

Upgrade/Update

pip install --upgrade sphinx

Version

pip install Django==1.1

Edit Mode

Packages normally install under site-packages, but when you’re making changes, it makes more sense to run the package straight from the checked-out source tree. Editable installs create a .pth file in site-packages that extends Python’s import path to find the package:

pip install -e path/to/SomePackage

virtualenv

To force PIP to respect the virtual environment, add PIP_RESPECT_VIRTUALENV to your .bashrc configuration file …or use the -E parameter passing the path to the folder of the virtual environment e.g:

pip -E ~/repo/ve/my-virtual-env/ install http://dist.repoze.org/PIL-1.1.6.tar.gz