pipenv 使用简介
之前在开发时一直使用 conda 使用作为虚拟环境管理工具,但有时候会经常会临时性的需要一个虚拟环境,
如果使用 conda create
创建一个新环境,耗时不说,有时候还忘了删除,最后系统里一堆的虚拟环境。
偶然发现 pipenv
后试用了一下,感觉它的工作流相比之前虚拟环境环境加 requirements.txt
的方式更加简单方便。
安装
pipenv
最好和 Python3 一起使用
最简单的方式是通过 pip 安装
pip3 install pipenv
如果是 mac 用户也可以通过 Homebrew 安装
brew install pipenv
如果没有安装 pip 可以通过以下方式安装
https://raw.githubusercontent.com/kennethreitz/pipenv/master/get-pipenv.py | python
使用
创建新项目
mkdir myproject pipenv install
这会在 myproject 文件下创建 Pipfile
和 Pipfile.lock
文件,同时创建虚拟环境
虚拟环境名称为 pipenv 加项目路径哈希值,如 pipenv-7BgKv-oX
ll -rw-r--r-- 1 rookie rookie 138 4月 20 20:24 Pipfile -rw-r--r-- 1 rookie rookie 453 4月 20 20:24 Pipfile.lock
虚拟机环境默认位于 ~/.local/share/virtualenvs/
,由于 pipenv 通过路径名哈希值与虚拟环境
建立映射关系,因此如果移动项目会导致虚拟环境不可用。可以通过在 .bashrc
添加export PIPENV_VENV_IN_PROJECT=1
让 pipenv 在项目文件中创建虚拟环境,这时候虚拟环境位于 myproject/.venv
文件夹下。
如果项删除虚拟环境,在项目顶层目录下运行
pipenv --rm
如果要指定 Python 版本,可以通过 --python
完成,如我要安装 python3.7 的虚拟环境
pipenv --python 3.7
配置文件
# cat Pipfile [[source]] name = "pypi" url = "https://pypi.org/simple" verify_ssl = true [dev-packages] [packages] [requires] python_version = "3.6"
[[source]]
模块指定了 pip 源位置,通常国内 pip 源加快下载速度
[[source]] name = "tuna" url = "https://pypi.tuna.tsinghua.edu.cn/simple/" verify_ssl = true [[source]] name = "pypi" url = "https://pypi.org/simple" verify_ssl = true [dev-packages] [packages] [requires] python_version = "3.6"
安装和卸载 packages
你可以编辑 packages
, 添加项目需要的 Python 库,如 requests='**'
,甚至可以指定不同
平台下的包配置,详细配置参考 Advanced Usage of Pipenv
不过你可以通过pipenv install requests
来安装,pipenv 将会自动更新 Pipfile
和 Pipfile.lock
。[dev-packages]
则是一些开发依赖但不是项目依赖包的存放目录,如 pylint
等 pep8 检查工具
可以在安装时指定 pipenv install --dev
将某个包声明为 dev-package
卸载 package 也很简单
pip uninstall
如果通过 pipenv 命令安装和卸载 package,安装或卸载完成后还会更新 Pipfile.lock
文件,有时候会卡在这个步骤。通常可以 ctrl+c
强制推出,删除 Pipfile.lock
, 然后
pipenv lock
重新生成该文件
进入和退出虚拟环境
进入虚拟环境
cd myproject pipenv shell
退出虚拟环境
pipenv exit
高级用法
有时候某些 package 需要指定特定的 pip 源,可以通过如下方式指定,非常简便
[[source]] url = "https://pypi.python.org/simple" verify_ssl = true name = "pypi" [[source]] url = "http://pypi.home.kennethreitz.org/simple" verify_ssl = false name = "home" [dev-packages] [packages] requests = {version="*", index="home"} maya = {version="*", index="pypi"} records = "*"
有时候需要生成 requirements.txt
文件
pipenv lock -r
如果只需要生成 dev-pakcages 列表,也很简单
pipenv lock -r --dev
自动载入环境变量文件。如果 .env
文件在项目根目录下,pipenv shell
和 pipenv run
将
会自动载入文件中的环境变量。
$ cat .env HELLO=WORLD $ pipenv run python Loading .env environment variables… Python 2.7.13 (default, Jul 18 2017, 09:17:00) [GCC 4.2.1 Compatible Apple LLVM 8.1.0 (clang-802.0.42)] on darwin Type "help", "copyright", "credits" or "license" for more information. >>> import os >>> os.environ['HELLO'] 'WORLD'
pipenv 还支持自定义命令,这对于某些开发过程中经常使用的命令来说非常方便。
在 Pipfile
中添加 [scripts]
[scripts] printspam = "python -c \"print('I am a silly example, no one would need to do this')\""
通过 pipenv run <custom_command>
即可运行自定义命令,如
pipenv run echospam "indeed" I am really a very silly example indeed
更多高级用户可以参考 官方文档
最后欢迎关注我的 Blog-PrivateRookie