pip reference

Installation

Installing in Ubuntu

1
2
3
4
# python2
sudo apt-get install python-pip
# python3
sudo apt-get install python3-pip

Installing with get-pip.py

1
2
3
4
# download get-pip.py
curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py
# then run the install
python get-pip.py

pip 会安装在相应的 Python 版本中。

1
2
3
python2.7 get-pip.py
# 如果环境变量中没有,添加到 /usr/bin
ln -s /path/to/python2.7/bin/pip2.7 /usr/bin/pip2.7

Upgrading pip

1
2
3
pip install -U pip  # or pip install --upgrade pip
# upgrading pip3
pip3 install -U pip # or python3 -m pip -U pip

Running pip

1
2
pip <pip arguments>
python -m pip <pip arguments>

默认情况下,使用的pip为系统默认的pip (如,/usr/bin/pip/usr/local/bin/pip),如果有多个版本的 Python,可以将相应的 pip 添加到系统PATH路径下,如:/usr/bin/python3 -> /usr/local/python3/bin/pip

当 Python 的 pip 不在系统PATH路径下的时候,也可以使用相应的 Python 调用模块的方式使用 pip:

1
python3.6 -m pip <pip arguments>

Installing Packages

1
2
3
pip install some_package                       # latest version
pip3 install some_package==1.0.4 # specific version
python3.7 -m pip install 'some_package>=1.04' # minimum version

Using a proxy server

1
pip install some_package --proxy <[user:passwd@]proxy.server:port>

如,在本地开了一个 SOCKS5 的代理服务器 (127.0.0.1:1080):

1
pip install some_package --proxy localhost:1080

Requirements Files

将当前 Python 环境的安装包导入到 requirements.txt:

1
pip freeze > requirements.txt

从 requirements.txt 文件中安装包到当前 Python 环境:

1
pip install -r requirements.txt

从当前 Python 环境中卸载 requirements.txt 中的包:

1
pip uninstall -y -r requirements.txt

项目管理中,一般结合 virtualenv 工具使用。

Git

pip 工具也支持从 Git 仓库中克隆项目包。

1
2
3
pip install -e git://git.myproject.org/MyProject.git#egg=MyProject
pip install -e git+http://git.myproject.org/MyProject.git#egg=MyProject
pip install -e git+ssh://git.myproject.org/MyProject.git#egg=MyProject

也可以指定克隆的分支, commit hash 或 tag name:

1
2
3
pip install -e git://git.myproject.org/MyProject.git@master#egg=MyProject
pip install -e git://git.myproject.org/MyProject.git@v1.0#egg=MyProject
pip install -e git://git.myproject.org/MyProject.git@da39a3ee5e6b4b0d3255bfef95601890afd80709#egg=MyProject

Django2+ 安装 xadmin:

1
pip install git+git://github.com/sshwsfc/xadmin.git@django2

注意,pip freeze生成的 requirements.txt 中相应的包为 xadmin==xx。当用pip install -r requirements.txt再次安装的时候会出错,需要修改requirements.txtxadmin==xx -> git+git://github.com/sshwsfc/xadmin.git@django2

更多查看Requirements files

Uninstalling Packages

1
2
pip uninstall some_package
pip uninstall -r requirements.txt

Listing packages

列出已经安装的包

1
pip list

查看已安装的包的具体信息:

1
pip show some_package

Searching for Packages

1
pip search "query"