一、常用命令
pip 是首选的Python包管理工具,主要用于安装 PyPI 上托管的软件包(第三方库、应用、框架等),用于替代老版的 easy_install 工具。在Python3的开发中应该尽量使用pip,不要继续使用 easy_install。
从 Python 3.4 开始,Python默认内置了pip (import pip)。,但是你可以执行下面的命令升级pip:
$ pip install -U pip
1、使用 install 命令安装包:
1.1 安装PyPI包
$ pip install SomePackage # 安装最新版本
$ pip install SomePackage==1.0.4 # 安装指定版本
$ pip install 'SomePackage>=1.0.4' # 指定安装的最小版本
使用 requirement.txt 需求文件
可以将要安装的数据包也就是将 install 命令后面的参数都写入 requirement.txt
文件中,使用 -r
选项一次性全部安装。requirements.txt 文件的每一行都要表明安装的内容,而且尽量不要依赖文件中指定包的前后安装顺序。
$ pip install -r requirements.txt
可以将 pip freeze
列出的包写入到 requirement.txt 文件中,以便在其他系统中安装。
$ pip freeze > requirements.txt
$ pip install -r requirements.txt
1.2 安装 wheel 包
wheel本质上是一个 zip 包格式,用于 python 模块的安装,它的出现是为了替代 老版本的Eggs。pip也可以直接安装wheel包。如果发布模块,推荐使用 wheel 格式。
$ pip install SomePackage-1.0-py2.py3-none-any.whl
1.3 安装本地包
$ pip install -e . # 项目在当前目录
$ pip install -e path/to/project # 指定项目的目录路径
1.4 从服务器托管的包中安装
$ pip install -e git+https://git.repo/some_pkg.git#egg=SomePackage # 从git安装
$ pip install -e svn+svn://svn.repo/some_pkg/trunk/#egg=SomePackage # 从svn安装
$ pip install -e git+https://git.repo/some_pkg.git@feature#egg=SomePackage # 从一个分支安装
$ pip install -e "git+https://git.repo/some_repo.git#egg=subdir&subdirectory=subdir_path" # install a python package from a repo subdirectory
从其他的索引中(除了PyPI)安装:
$ pip install --index-url http://my.package.repo/simple/ SomePackage
在安装期间搜索其他的索引(除了PyPI):
$ pip install --extra-index-url http://my.package.repo/simple SomePackage
1.5 升级软件包
pip在升级软件包之前会自动卸载旧的软件包
$ pip install -U|--upgrade SomePackage
2、查看安装的包
2.1 使用 freeze 格式化输出安装的包:
$ pip freeze
2.2 使用 list 命令查看安装的第三方包
$ pip list [--fromat (legacy|columns)]
查看哪些软件需要更新(列出过时的包):
$ pip list -o|--outdated
2.3 使用 show 命令查看安装的包的详细信息:
$ pip show SomePackage
查看安装包的具体安装文件
$ pip show -f|--files SomePackage
3、使用 uninstall 命令卸载软件包
$ pip uninstall Django
也可以像安装包一样,将要卸载的包写入到 uninstall.txt 文件中,然后使用 -r 参数,一次性卸载。
4、使用 download 命令下载软件包
$ pip download Django
5、使用 search 命令在PyPI仓库中搜索软件包
$ pip search Django
6、使用 help 命令查看pip的帮助手册
$ pip help
也可以访问官方的站点:
https://pip.pypa.io/en/stable/reference/
二、 配置文件
pip允许你在标准的ini配置文件中设置所有命令选项的默认,配置文件的名称和路径,在不同的平台并不相同,你可能有针对系统的、用户的以及虚拟环境的配置。
针对系统的配置文件:
在Unix平台,配置文件的位置可能是 /etc/pip.conf
,或者它可能是环境变量 XDG_CONFIG_DIRS
中设置的路径 pip 路径的子目录 。
针对用户的配置文件:
在Unix平台,默认的配置文件是 $HOME/.config/pip/pip.conf
,这个路径取决于
XDG_CONFIG_HOME
环境变量的值。有一个早些版本使用的位置:$HOME/.pip/pip.conf
,也是可以使用的。
你也可以在环境变量 PIP_CONFIG_FILE
中自定义一个路径。
针对虚拟环境:
在Unix平台,默认的配置文件是 $VIRTUAL_ENV/pip.conf
如果由pip找到多个配置文件,那么它们将按以下顺序组合:
首先,站点范围的文件被读取
然后,读取每个用户的文件
最后,特定于virtualenv的文件被读取
后面配置文件的读取覆盖会覆盖前面的文件读取的值,所以如果在系统的配置文件和用户的配置文件中的超时时间参数都设定了,那么使用用户配置文件中的值。
设置参数的名字来自于命令行的选项,例如:你想要使用不同的包的索引 (--index-url) 并设置http的超时时间 (--default-timeout)为60s:
[global]
timeout = 60
index-url = http://download.zope.org/ppix
任何子命令都可以在它自己的部分被设置,这个时候同名的全局的设置会被覆盖。例如:减少freeze命令的超时时间到10s,其他的命令的超时时间为60s。
[global]
timeout = 60
[freeze]
timeout = 10
命令行自动补全
在bash、zsh和fish中,pip支持命令行补全。
bash:
$pip completion --bash >> ~/.profile
同样的,你也可以在shell中直接使用eval函数和completion命令:
$ eval "`pip completion --bash`"
更多的配置参数可以参考官方文档:
https://pip.pypa.