在程序开发时候一套好的开发环境和工具栈,可以帮我们极大的提高开发的效率,避免把大量时间浪费在周边琐事上。本文以Python为例,教大家如何快速打造完美的Python项目开发环境:内容涵盖了模块依赖管理、代码风格管理、调试测试管理和Git版本管理,使用git hook做项目规范检查等。

pipx

Pipx是一款跨平台的Python环境隔离管理工具,可以在支持在 Linux、Mac OS 和 Windows 上运行。Pipx默认在是个人用户下建立虚拟Python环境,并以此建立实现完全隔离的Python运行环境。安装pipx需要Pthon 3.6及以上版本:

python3 -m pip install --user pipx

python3 -m pipx ensurepath

升级Pipx使用:

python3 -m pip install -U pipx

包依赖管理pipenv

Pipenv会自动为你的项目创建和管理虚拟环境,以pipfile文件方式方式管理项目的依赖包,支持包的安装和卸载。和requirements.txt不同,pipfile是TOML格式,支持开发环境与正式环境,还可以使用Pipfile.lock锁定环境版本。pipxenv的安装可以使用pipx:

pipx install pipenv

有些发行版也是可以直接通过其包管理器安装的:

比如MacOS可以下可以使用:

brew install pipenv

一个pipfile的示例如下:

Pipfile.lock的示例部分如下:

代码风格

代码格式化black

代码格式的统一不光可以给我们一个惬意的代码格式,而且可以避免由于开发人员之间的代码风格差异导致的沟通和协作问题。

Black就是用来格式化Python代码的程序。它可以自动帮我们对代码格式进行调整和统一,提高代码效率和可读性。而且通过Black减小代码风格的差异,可以极大提高团队进行代码审查的效率。

一个Black格式化示例如下:

原始代码:

def very_important_function(template: str, *variables, file: os.PathLike, engine: str, header: bool = True, debug: bool = False):

"""Applies `variables` to the `template` and writes to `file`."""

with open(file, 'w') as f:

...

格式化后的代码:

isort美化import部分代码

Python开发中经常需要import第三方的模块,往往这部分代码混乱不堪,使用isort可以则可以美化这部分的代码。 isort可以按字母表顺序对import进行排序,自动分成多个部分。

我们可以使用pipenv安装black 和isort:

pipenv install black isort -dev

isort的效果示例,可以看下面的动图:

Black和isort同时使用时,两者默认配置不兼容,我们需要覆盖isort配置,优先以Black的格式化为准。可以通过setup.cfg文件并添如下配置来完成该任务。

[isort]

multi_line_output=3

include_trailing_comma=True

force_grid_wrap=0

use_parentheses=True

line_length=88

flake8代码风格检测

Flake8可以用来确保代码遵循PEP8中定义的标准Python编程约定,是Python官方辅助代码风格检测工具,lake8检查规则灵活,支持集成额外插件(比如vim、sublime、PyCharm、vsc等都有其相关插件),扩展性强。

其安装也可以使用pipenv:

pipenv install flake8 –dev

和isort一样,为了配合兼容Black,需要在setup.cfg中额外配置:

[flake8]

ignore = E203, E266, E501, W503

max-line-length = 88

max-complexity = 18

select = B,C,E,F,W,T4

mypy静态类型

Mypy是Python的可选静态类型检查器,可以用结合动态(或"鸭子")类型和静态类型优点其他代码的性能。通过Mypy将Python的动态类型便捷性和表现力的优势与静态类型强系统和编译时类型检查相结合,并且生成原生代码,支持通过Python VM运行,可以没有运行时开销的高性能运行。在Python中使用静态类型好处有:

可以使程序更易于理解和维护;

可以帮助编译时调试和发现错误,减少测试和调试。

可以在代码部署到生产环境之前就可以找到难以捕捉的错误。

可以使用pipenv直接安装Mypy:

pipenv install mypy –dev

mypy动态类型和静态类型一个示例如下:

项目配置

默认情况下,Mypy会递归检查所有类型注释的导入,这会导致库不包含这些注释时出错。需要修改mypy配置仅检查当前代码运行,并忽略没有类型注释的import模块。这也可以在setup.cfg中设置:

[mypy]

files=项目,test

ignore_missing_imports=true

代码测试

程序开发中,除了写代码外,另外一个重要的部分是单元测试。Python测试方面我们要介绍的工具有pytest。

可以使用pipenv添加测试工具包及扩展:

pipenv install pytest pytest-cov --dev

Pytest框架可以让编写小测试变得容易,而且支持以扩展的方式提供更加复杂的功能。下面是pytest网站的一个简单示例:

# content of test_sample.py

def inc(x):

return x + 1

def test_answer():

assert inc(3) == 5

通过以下命令测试

pipenv run pytest

结果如下:

pytest-cov是pytest的单元测试行覆盖率的插件。pytets-cov的测试结果示例如下:

pytest还有很多的扩展插件:

pytest-cov: 单元测试覆盖率报告

pytest-django: 对Django框架的单元测框架

pytest-asyncio:对asyncio的支持

pytest-twisted: 对twisted框架的单元测框架

pytest-instafail: 发送错误时报告错误信息

pytest-bdd 测试驱动开发工具

pytest-konira 测试驱动开发工具

pytest-timeout: 支持超时功能

pytest-pep8: 支持PEP8检查

pytest-flakes: 结合pyflakes进行代码检查

更多插件可以查看github pytest-dev组织下的项目。

项目配置

项目中,所有的测试都应该放在test目录中,我需要给setup.cfg添加配置:

[tool:pytest]

testpaths=test

单元覆盖率的项目配置需要创建一个新文件.coveragerc返回应用程序代码的覆盖率统计信息,配置示例如下:

[run]

source = 项目

[report]

exclude_lines =

pragma: no cover

def __repr__

if self\.debug

raise AssertionError

raise NotImplementedError

if 0:

if __name__ == .__main__.:

然后再工程中运行一下命令,测试项目的覆盖率

pipenv run pytest --cov --cov-fail-under =100

如果程序代码的测试覆盖率低于100%,就会报错。

Git pre-commit hook规范检查

Git hook可以让我们在提交或推送时执行检查脚本,脚本可以配置对项目镜像测试或者规范性检查。运行脚本。我们可以配置pre-commit hook允许轻松配置这些钩子,下面.pre-commit-config.yaml配置示例可以帮我们自动做代码规范化,包括isort检查、black检查、flake8检查、mypy静态类型检查、pytest测试、pytest-cov测试覆盖率检查:

repos:

- repo: local

hooks:

- id: isort

name: isort

stages: [commit]

language: system

entry: pipenv run isort

types: [python]

- id: black

name: black

stages: [commit]

language: system

entry: pipenv run black

types: [python]

- id: flake8

name: flake8

stages: [commit]

language: system

entry: pipenv run flake8

types: [python]

exclude: setup.py

- id: mypy

name: mypy

stages: [commit]

language: system

entry: pipenv run mypy

types: [python]

pass_filenames: false

- id: pytest

name: pytest

stages: [commit]

language: system

entry: pipenv run pytest

types: [python]

- id: pytest-cov

name: pytest

stages: [push]

language: system

entry: pipenv run pytest --cov --cov-fail-under=100

types: [python]

如果你需要跳过这些钩子,你可以运行git commit --no-verify或git push --no-verify

cookiecutter自动创建项目

上面我们提到Python项目应该具备的工具集和配置,可以将其作为模版。cookiecutter的模版定义范例如下:

cookiecutter.json

{

"full_name": "Chongchong",

"project_name": "Python-Practice",

"repo_name": ""Python-Practice ",

"project_short_description": "The Simple Python Development Practice Example.",

"release_date": "2019-09-02",

"year": "2019",

"version": "0.0.1"

}

然后使用cookiecutter自动生成整改工程:

pipx run cookiecutter Python-Practice

cd Python-Practice

git init

安装依赖项

pipenv install --dev

运行 pre-commit和pre-push hook:

pipenv run pre-commit install -t pre-commit

pipenv run pre-commit install -t pre-push

总结

本文我们介绍了在Python项目开发时候必须要具备的一些开发测试检查工具。通过这些可以自动生成Python项目,代码风格检查、代码测试等操作,可以帮助我们打造一个高效完美的Python开发环境。

支持python开发的环境有哪些变化_Python开发实践:打造完美的项目工程环境相关推荐

  1. header python 环境信息_Python开发必备:如何建立一个完美的项目工程环境

    在程序开发时候一套好的开发环境和工具栈,可以帮我们极大的提高开发的效率,避免把大量时间浪费在周边琐事上.本文以Python为例,教大家如何快速打造完美的Python项目开发环境:内容涵盖了模块依赖管理 ...

  2. python开发技术详解pdf下载_python开发技术详解附源码-python开发技术详解电子书pdf下载高清去水印版-精品下载...

    Python开发技术详解适合Python爱好者.大中专院校的学生.社会培训班的学生以及用Python语言进行系统管理.GUI开发.Web开发.数据库编程.网络编程的人员使用. 内容提要 Python是 ...

  3. python可以用break作为变量名_Python初体验(一)—【配置环境变量】【变量】【input】【条件语句】【循环语句】...

    写在前面的: 作为一个控制专业的女研究生,不知道每天在研究什么,但总归逃脱不了码代码的命运.之前也学习过一些C语言.C++,基础嘛,稍稍微有一些.本不想走上码农的道路,天真烂漫的过此生(白日梦过程中. ...

  4. python开发工具和框架安装器_Python 开发工具和框架安装

    引言: 其实之前对于 Python,只是知道有这门语言而已.大部分还是使用 .net 开发的,之前也学了 MVC+EF 开发,但是由于工作上完全用不到,也就没有在博客记录学习的东西了. 最近又接触到了 ...

  5. python写游戏需要安装什么软件_python开发游戏的前期准备

    本文章面向有一定基础的python学习者,使用Pygame包开发一款简单的游戏 首先打开命令行,使用PyPI下载Pygame包(输入命令pip install pygame) 打开python编辑器( ...

  6. python设计图形界面执行exe程序_Python开发案例:设计启动工具箱,显示图形界面的方式...

    本文的文字及图片来源于网络,仅供学习.交流使用,不具有任何商业用途,版权归原作者所有,如有问题请及时联系我们以作处理. 以下文章来源于云+社区,作者 用户2870857 转载地址 https://bl ...

  7. python好用的内置库_Python开发哪些库好?老男孩Python学习班

    近年来,伴随着人工智能时代的到来,也促使Python编程语言发展,因此Python成为公认的人工智能编程语言.之所以Python受欢迎,得益于其内置大量的库,那么Python开发有哪些基本库呢?这六大 ...

  8. 无法支持python程序的编辑运行和调试_python程序的调试方法

    本文讨论在没有方便的IDE工具可用的情况下,使用pdb调试python程序 源码例子 例如,有模拟税收计算的程序: #!/usr/bin/python def debug_demo(val): if ...

  9. python如何实现日期格式的转换_python开发中时间格式如何转化?

    如果给出大家这样的一道题,给定一个12小时AM/PM格式的时间,将其转换为军用(24小时)时间.并且是利用python去实现,大家可以做到吗?先给大家分析下,这里是一个12小时制度和24小时的来回转换 ...

最新文章

  1. MFC Dll的详细介绍及创建
  2. VC6.0生成文件的种类和作用
  3. 2015年计算机初中,2015北京小升初电脑派位解读
  4. Java线程池框架核心代码分析
  5. Sql2008的行列转换之行转列
  6. Spring AOP编程-传统aop开发总结
  7. 川崎机器人c#通讯(转)
  8. 信息奥赛一本通基础之一维数组
  9. Spring Cloud Eureka(二)注册一个服务的提供者
  10. winform 让他间隔一段时间 执行事件 且只执行一次_记一次golang定时器引发的诡异错误...
  11. 前台如何正确接收流信息_如何绕过 Android 8.0 startService 限制?
  12. Ubuntu操作系统
  13. 使用 docker 来安装 oracle 11c
  14. axios http错误码处理
  15. 上海,夜访大一女生宿舍,满足。
  16. Spring Security - 21 记住我功能
  17. 解决vs2019属性管理器里面没有Microsoft.Cpp.x64.user
  18. CSS的动画特效(animation)
  19. php pecl 扩展,PECL
  20. kibana Dev Tools语句查询简单使用入门

热门文章

  1. 每日程序C语言33-打印杨辉三角
  2. Java黑皮书课后题第6章:6.1(数学:五角数)一个五角数被定义为n*(3*n-1)/2,其中n=1、2…。所以开始的几个数字就是1、5、12、22…,编写具有以下方法头的方法,返回一个五角数
  3. Java黑皮书课后题第3章:**3.9(商业:检验ISBN-10)ISBN-10由10个个位整数d1d2d3d4d5d6d7d8d9d10组成,最后一位d10是校验和,输入前9个数,显示10位ISBN
  4. mysql游标遍历修改_mysql使用游标遍历数据进行批量针对性更新数据,急求mysql大神解答...
  5. GROUP BY 和 ORDER BY 同时使用问题
  6. saltstack批量加用户脚本
  7. bzoj4013: [HNOI2015]实验比较
  8. 01.WPF中制作无边框窗体
  9. C语言不用循环不用递归打印0-999的小程序,你看懂了吗?
  10. jQuery的三种bind/One/Live事件绑定使用方法