pipenv-使用简介.md
2019-04-20

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 文件下创建 PipfilePipfile.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 将会自动更新 PipfilePipfile.lock[dev-packages] 则是一些开发依赖但不是项目依赖包的存放目录,如 pylint 等 pep8 检查工具 可以在安装时指定 pipenv install --dev将某个包声明为 dev-package 卸载 package 也很简单

pip uninstall

如果通过 pipenv 命令安装和卸载 package,安装或卸载完成后还会更新 Pipfile.lock 文件,有时候会卡在这个步骤。通常可以 ctrl+c 强制推出,删除 Pipfile.lock, 然后

pipenv lock

重新生成该文件

当然,你也可以通过设置环境变量 PIPENV_SKIP_LOCK=1 跳过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 shellpipenv 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

更多高级用户可以参考 官方文档