【Python单元测试】pytest框架单元测试 配置 命令行操作 测试报告 覆盖率

单元测试(unit test),简称UT。本文将介绍在Python项目中,pytest测试框架的安装,配置,执行,测试报告与覆盖率

pytest简介

pytest是一款流行的,简单易上手的单元测试框架,让开发&测试人员专注业务逻辑。

同事pytest有丰富的第三方扩展库,方便生成报告,输出UT覆盖率,支持快速高效的分布式执行。

安装

pytest pypi
pytest-html
pytest-cov
pytest-xdist
更多好用好玩的扩展库,本文将持续更新中......

bash 复制代码
pip install pytest
pip install pytest-html  # 生成html格式UT报告 
pip install pytest-cov   # 覆盖率
pip install pytest-dist  # 分布式执行UT

# 更新第三方库
pip install pytest -U
pip install pytest-html -U
pip install pytest-cov -U
pip install pytest-dist -U

可行的目录结构

cmd 复制代码
Project
	ModuleA
	ModuleB
	pytest.ini
	.coveragerc
	unit_test
		__init__.py
		conftest.py
		test_xx.py

配置

pytest.ini

ini 复制代码
# Project pytest.ini

pytest.ini避坑

pytest.ini options中配置了 --cov 覆盖率相关的命令,会导致PyCharm中 单元测试用例断点调试失败。

本地开发测试中,pytest.ini中切勿配置!!!

conftest.py

此配置文件中,可以写一些前置或后置的测试套。

python 复制代码
# unit_test/conftest.py

# -*- coding: utf-8 -*-

import pytest

# 默认执行, 优先度高
# 例如 可以 将文件路径添加到 sys.path



@pytest.fixture(scope="session")  # scope范围: session > module > class > function
def handler():
	do_something_pre()
	
	yeild

	do_something_post()

.coveragerc

覆盖率配置文件,放在unit_test同级目录。

此配置文件中,可以配置

  • 覆盖率统计的代码源目录,

  • 忽略的脚本(支持正则写法),

  • 忽略的代码行(支持正则写法)。

conf 复制代码

执行UT

命令行执行

bash 复制代码
# -n 分布式执行的线程数量,需要小于系统核数。 例如: -n 7
# -

pytest -n 

PyCharm右键执行

右键执行,支持 运行 调试

测试报告report.html

生成的报告中,会显示通过/失败的测试用例。

单击行 可以折叠/打开 用例执行信息

覆盖率报告 htmlcov/index.html

覆盖率会显示全部覆盖率/某个单元测试文件(夹)的覆盖率,涉及合计/执行、未执行/忽略的行等信息

相关推荐
大数据魔法师2 小时前
Streamlit(二十三)- 教程(二)- 动态导航
python·web
心中有国也有家4 小时前
GE图引擎深度解析——CANN的计算图优化与执行引擎
人工智能·pytorch·python·学习·numpy
卷毛的技术笔记6 小时前
告别硬编码!Spring AI Alibaba 实现 AI Agent 智能工具调用(Tool Calling)
java·人工智能·后端·python·spring·ai编程
编程大师哥6 小时前
匿名函数 lambda + 高阶函数
java·python·算法
vb2008116 小时前
FastAPI APIRouter
开发语言·python
adrninistrat0r6 小时前
Java调用链MCP分析工具
java·python·ai编程
杨充7 小时前
1.3 浮点型数据设计灵魂
开发语言·python·算法
meilindehuzi_a7 小时前
深入浅出数据结构:Python 字典(Dict)与集合(Set)的哈希表底层全链路追踪
数据结构·python·散列表
Lucas凉皮7 小时前
20243408 2025-2026-2 《Python程序设计》综合实践报告
python·实验报告
键盘上的猫头鹰8 小时前
【MySQL 教程(八)】索引、事务、用户管理、导入导出与分页查询
数据库·python·mysql