5分钟 Pipenv 上手指南


Posted in Python onDecember 20, 2018

现在就花5分钟,掌握这个工具的使用吧。

pipenv是requests作者的一个项目, 整合了virtualenv, pip, pipfile, 用于更方便地为项目建立虚拟环境并管理虚拟环境中的第三方模块。

安装 Pipenv

pipenv 的安装和普通的第三方库没什么区别,可以直接使用 pip 命令安装。

pip install pipenv

在 Mac 上可以使用 brew 命令来安装

brew install pipenv

接下来介绍如何使用 Pipenv,我们开启新项目后,首先要做的就是为其单独创建一个虚拟环境(确保你的电脑里面只安装一个Python版本,否则总会出现不可预知的问题)

创建虚拟环境

虚拟环境是每个项目独立使用的 Python 执行环境。

#进入项目所在目录
cd your_project
pipenv install

严格来说,pipenv 没有直接提供创建虚拟环境的命令,而是在背后默默帮你创建,install 其实是安装第三方包的命令,对新项目来说,它会先创建虚拟环境,同时,在项目目录下创建名为 Pipfile 的空文件。

虚拟环境的名字和项目名相关,默认情况下,Pipenv 会自动为你选择虚拟环境的存储位置,在 Windows 下通常为 C:\Users\<YOURNAME>\.virtualenvs

安装第三方包

以前安装包使用 pip 命令,现在你可以用 pipenv 命令来安装,例如我安装 requests 包:

pipenv install requests

使用 pipenv 安装第三方包有什么好处呢?安装前你不需要激活虚拟环境,就直接下载到了虚拟环境中,如果用 pip 安装,你还要先激活该环境。(我经常忘记给虚拟环境取了什么名字)

安装完包之后,Pipfile 文件会被更新,同时新增了 Pipfile.lock 文件

Pipfile 文件中的结构:

[[source]]
name = "pypi"
url = "https://pypi.org/simple"
verify_ssl = true

[dev-packages]

[packages]
requests = "*"

[requires]
python_version = "3.7"

Pipfile 文件中记录了3件事情:

  1. 包从哪里下载的
  2. 需要下载哪些包, * 表示始终下载最新版本, dev-packages 表示专用于开发阶段使用的包。
  3. Python 版本是多少

Pipfile.lock 文件详细记录了这些包的信息,包括这个包的hash值多少,还有包所依赖的其他包有哪些。

把这些信息写在 Pipfile 文件中的好处是,当我们把项目部署到正式环境时,不再需要一个一个去安装了,直接执行 pipenv install 就会自动创建虚拟环境的同时,把 Pipfile 中包都安装好。

激活虚拟环境

运行程序前我们还是要激活虚拟环境,我们可以使用 pipenv shell 来激活,不需要指定名字,只要你在当前项目下执行该命令就行。

pipenv shell

Launching subshell in virtual environment…
Microsoft Windows [Version 10.0.18290.1000]
(c) 2018 Microsoft Corporation. All rights reserved.

(weihub-flask-j3rUnHkH) D:\my\weihub-flask>

注意到了吗? 目录前面多了一对括号括起来的字符串,它就是我们刚刚创建的虚拟环境名字。 激活虚拟环境后,你就可以开始运行你的程序了。

(weihub-flask-j3rUnHkH) D:\my\weihub-flask> python

>>> import requests
>>> requests.get("http://baidu.com").text
'<html>\n<meta http-equiv="refresh" content="0;url=http://www.baidu.com/">\n</html>\n'
>>>

退出虚拟环境使用 exit 命令, 这时候那对括号就消失了。

pipenv run

另外,pipenv 还准备了一个 run 命令,它可以在你不必显示激活虚拟环境的情况下,用虚拟环境执行命令,例如:

pipenv run python -m http.server
pipenv run python main.py

以上就是你要掌握的 Pipenv 基础知识,如果有兴趣,你还可以了解下面的内容

从 requirements.txt 导入

如果是老项目,你把依赖包全部放在 requirements.txt 中,pipenv 很贴心,它支持从 requirements.txt 文件中安装,方便使用 pip 的用户平滑迁移过来。

pipenv install -r requirements.txt

只安装到开发环境

在开发环境下我们要安装 django-debug-toolbar, pytest 这样的包,这些在生产环境其实是用不上的,所以没必要安装,那么我们在安装某个包的时候可以在 isntall 后面加个参数 --dev,表示只安装在开发环境,例如:

pipenv install pytest --dev
 ```

在生产环境执行:
```python
# 生产环境
pipenv install

开发环境执行:

# 开发环境
pipenv install --dev

卸载包

pipenv uninstall requests

删除虚拟环境

pipenv --rm

删除虚拟环境后,会把虚拟环境目录和里面的所有依赖包删除掉,但是 Pipfile 和 Pipfile.lock 文件还会保留。

常见问题:

如果你在使用 pipenv 创建虚拟环境失败了,出现类似这样的错误:

pipenv install
Creating a virtualenv for this project…
Pipfile: D:\my\weihub-flask\Pipfile
Using c:\users\lzjun\appdata\local\programs\python\python37-32\python.exe (3.7.1) to create virtualenv…
[ ===] Creating virtual environment...Already using interpreter c:\users\lzjun\appdata\local\programs\python\python37-32\python.exe
Using base prefix 'c:\\users\\lzjun\\appdata\\local\\programs\\python\\python37-32'
New python executable in C:\Users\lzjun\.virtualenvs\weihub-flask-j3rUnHkH\Scripts\python.exe
ERROR: The executable C:\Users\lzjun\.virtualenvs\weihub-flask-j3rUnHkH\Scripts\python.exe is not functioning
ERROR: It thinks sys.prefix is 'd:\\my\\weihub-flask' (should be 'c:\\users\\lzjun\\.virtualenvs\\weihub-flask-j3runhkh')
ERROR: virtualenv is not compatible with this system or executable
Note: some Windows users have reported this error when they installed Python for "Only this user" or have multiple versions of Python installed. Copying the appropriate PythonXX.dll to the virtualenv Scripts/ directory may fix this problem.

Failed creating virtual environment
[pipenv.exceptions.VirtualenvCreationException]: File "c:\users\lzjun\appdata\local\programs\python\python37-32\lib\site-packages\pipenv\cli\command.py", line 254, in install
[pipenv.exceptions.VirtualenvCreationException]:  editable_packages=state.installstate.editables,
[pipenv.exceptions.VirtualenvCreationException]: File "c:\users\lzjun\appdata\local\programs\python\python37-32\lib\site-packages\pipenv\core.py", line 1741, in do_install
[pipenv.exceptions.VirtualenvCreationException]:  pypi_mirror=pypi_mirror,
[pipenv.exceptions.VirtualenvCreationException]: File "c:\users\lzjun\appdata\local\programs\python\python37-32\lib\site-packages\pipenv\core.py", line 574, in ensure_project
[pipenv.exceptions.VirtualenvCreationException]:  pypi_mirror=pypi_mirror,
[pipenv.exceptions.VirtualenvCreationException]: File "c:\users\lzjun\appdata\local\programs\python\python37-32\lib\site-packages\pipenv\core.py", line 506, in ensure_virtualenv
[pipenv.exceptions.VirtualenvCreationException]:  python=python, site_packages=site_packages, pypi_mirror=pypi_mirror
[pipenv.exceptions.VirtualenvCreationException]: File "c:\users\lzjun\appdata\local\programs\python\python37-32\lib\site-packages\pipenv\core.py", line 935, in do_create_virtualenv
[pipenv.exceptions.VirtualenvCreationException]:  extra=[crayons.blue("{0}".format(c.err)),]
[pipenv.exceptions.VirtualenvCreationException]: Fatal Python error: initfsencoding: unable to load the file system codec
Traceback (most recent call last):
 File "C:\Users\lzjun\.virtualenvs\weihub-flask-j3rUnHkH\lib\encodings\__init__.py", line 31, in <module>
 File "C:\Users\lzjun\.virtualenvs\weihub-flask-j3rUnHkH\lib\codecs.py", line 481
 except UnicodeDecodeError, exc:
        ^
SyntaxError: invalid syntax

很有可能就是你的系统中安装多有个版本的Python,可以模糊搜索 Python*.dll ,把那些不相关的全部删除,重新试试。

如何提高下载速度

修改 Pipfile 文件中的URL,将下载源指定为阿里云或者豆瓣等国内更快的源

[[source]]
name = "pypi"
url = "https://mirrors.aliyun.com/pypi/simple"
#或者使用豆瓣源
url = "http://pypi.douban.com/simple"
verify_ssl = true

Pipenv 有什么缺点

慢,有时候感觉特别慢,就一直卡在 Locking 过程中,你在安装的时候跳过 lock 环节,使用命令

pipenv install --skip-lock

更多操作指南,请参考官方文档: https://pipenv.readthedocs.io/en/latest/basics/

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持三水点靠木。

Python 相关文章推荐
Python获取电脑硬件信息及状态的实现方法
Aug 29 Python
详细介绍Ruby中的正则表达式
Apr 10 Python
关于Python元祖,列表,字典,集合的比较
Jan 06 Python
2018年Python值得关注的开源库、工具和开发者(总结篇)
Jan 04 Python
Python GUI Tkinter简单实现个性签名设计
Jun 19 Python
python 输入一个数n,求n个数求乘或求和的实例
Nov 13 Python
Python字典循环添加一键多值的用法实例
Jan 20 Python
python多线程下信号处理程序示例
May 31 Python
python处理自动化任务之同时批量修改word里面的内容的方法
Aug 23 Python
python numpy实现rolling滚动案例
Jun 08 Python
python Protobuf定义消息类型知识点讲解
Mar 02 Python
pandas 操作 Excel操作总结
Mar 31 Python
对python 多个分隔符split 的实例详解
Dec 20 #Python
python 使用正则表达式按照多个空格分割字符的实例
Dec 20 #Python
Python 获取div标签中的文字实例
Dec 20 #Python
浅谈Python采集网页时正则表达式匹配换行符的问题
Dec 20 #Python
Python实现正则表达式匹配任意的邮箱方法
Dec 20 #Python
用Python编写一个高效的端口扫描器的方法
Dec 20 #Python
python re正则匹配网页中图片url地址的方法
Dec 20 #Python
You might like
学习discuz php 引入文件的方法DISCUZ_ROOT
2009/06/21 PHP
PHP小技巧之JS和CSS优化工具Minify的使用方法
2014/05/19 PHP
Linux下php5.4启动脚本
2014/08/03 PHP
php使用MySQL保存session会话的方法
2015/06/18 PHP
Javascript - HTML的request类
2006/07/15 Javascript
利用jquery包将字符串生成二维码图片
2013/09/12 Javascript
IE下window.onresize 多次调用与死循环bug处理方法介绍
2013/11/12 Javascript
jquery马赛克拼接翻转效果代码分享
2015/08/24 Javascript
深入浅析JavaScript字符串操作方法 slice、substr、substring及其IE兼容性
2015/12/16 Javascript
jquery实现简单的遮罩层
2016/01/08 Javascript
微信小程序 自己制作小组件实例详解
2016/12/22 Javascript
JavaScript实现翻页功能(附效果图)
2017/02/16 Javascript
移动端利用H5实现压缩图片上传功能
2017/03/29 Javascript
angularjs中使用ng-bind-html和ng-include的实例
2017/04/28 Javascript
JS计算距当前时间的时间差实例
2017/12/29 Javascript
jQuery 防止相同的事件快速重复触发方法
2018/02/08 jQuery
微信小程序适配iphoneX的实现方法
2018/09/18 Javascript
JS Web Flex弹性盒子模型代码实例
2020/03/10 Javascript
《javascript设计模式》学习笔记一:Javascript面向对象程序设计对象成员的定义分析
2020/04/07 Javascript
python 换位密码算法的实例详解
2017/07/19 Python
python实现壁纸批量下载代码实例
2018/01/25 Python
对Python中TKinter模块中的Label组件实例详解
2019/06/14 Python
使用Python将图片转正方形的两种方法实例代码详解
2020/04/29 Python
用Python 执行cmd命令
2020/12/18 Python
美国滑雪和滑雪板商店:Buckman
2018/03/03 全球购物
德国团购网站:Groupon德国
2018/03/13 全球购物
实习自我鉴定范文
2013/10/30 职场文书
给护士表扬信
2014/01/19 职场文书
优秀技术工人先进材料
2014/02/17 职场文书
优秀的2014年两会精神解读
2014/03/17 职场文书
社区工作者演讲稿
2014/05/23 职场文书
市场营销计划书范文
2015/01/16 职场文书
社区环境卫生倡议书
2015/04/29 职场文书
2015年七一建党节活动方案
2015/05/05 职场文书
《只有一个地球》教学反思
2016/02/16 职场文书
妇联2016年六一国际儿童节活动总结
2016/04/06 职场文书