讲师中心 微信公众号
AI工具推荐 视频效率加速

如何处理Python 3.12中废弃的unittest方法报警_使用pytest重构用例

轻墨同学_3276

轻墨同学_3276

发布时间:2026-05-21 08:55:00

|

571人浏览过

|

来源于php中文网

原创

Python 3.12正式废弃unittest.TestCase.runTest方法,调用时触发DeprecationWarning: TestCase.runTest() is deprecated,未来版本将移除;旧式动态测试需迁移至pytest等现代框架。

如何处理python 3.12中废弃的unittest方法报警_使用pytest重构用例

为什么unittest.TestCase.runTest在Python 3.12里报DeprecationWarning

Python 3.12正式废弃了unittest.TestCase.runTest方法——它曾被用来动态定义测试逻辑(比如在基类中重写runTest再通过TestCase(methodName='runTest')构造实例)。现在调用会触发DeprecationWarning: TestCase.runTest() is deprecated,且未来版本会直接移除。

这不是误报,而是CPython明确标记的废弃路径。如果你的项目还依赖这种写法(常见于老式参数化测试、动态测试生成或某些测试框架封装层),升级到3.12后必须改。

直接替换为pytest是更可持续的选择:它不依赖TestCase类结构,天然支持函数式测试和灵活参数化,也避免了这类API生命周期绑定问题。

把unittest.TestCase子类快速转成pytest函数

核心原则:丢掉继承、去掉self、把assert*换成原生assert语句。pytest能自动识别test_*命名的函数,并处理断言失败时的详细输出(包括变量值展开)。

立即学习“Python免费学习笔记(深入)”;

  • 删掉import unittest和class TestFoo(unittest.TestCase):声明
  • 把每个def test_something(self):改成def test_something():(无参数)
  • 把self.assertEqual(a, b)换成assert a == b;self.assertIn(x, y) → assert x in y
  • 若原测试用了setUp/tearDown,改用@pytest.fixture作用域控制,或直接内联初始化/清理逻辑

示例:

Li Python Sec Check
Li Python Sec Check

Python 安全规范检查工具:基于 CloudBase 规范、腾讯安全指南,LLM 智能分析(默认禁用,优先本地执行)

下载
# 旧 unittest 写法
class TestCalc(unittest.TestCase):
    def setUp(self):
        self.calc = Calculator()
    def test_add(self):
        self.assertEqual(self.calc.add(2, 3), 5)
# 新 pytest 写法
def test_add():
    calc = Calculator()
    assert calc.add(2, 3) == 5

处理unittest特有模式:参数化、跳过、预期异常

pytest原生支持这些,但语法和行为有差异,容易踩坑:

  • @unittest.skip → 改用@pytest.mark.skip或@pytest.mark.skipif(condition);注意reason参数名不变,但必须显式传参,不能省略
  • 参数化:unittest靠subTest或第三方库,而pytest用@pytest.mark.parametrize("a,b,expected", [(1,2,3), (0,0,0)]),参数名必须与函数签名严格匹配
  • 预期异常:with self.assertRaises(ValueError): → with pytest.raises(ValueError):;但pytest.raises默认不捕获BaseException子类(如SystemExit),需显式加match=或用pytest.raises(..., match=r"xxx")校验消息

特别注意:subTest在pytest里没有直接等价物——它本质是unittest的“嵌套测试报告”机制,pytest靠参数化+清晰的用例命名替代,不需要模拟嵌套。

运行和兼容性:别漏掉pytest.ini和conftest.py

直接跑pytest命令可能因默认配置导致行为变化:

  • 默认不收集*_test.py或test_*.py以外的文件,确认你的测试文件名符合约定;否则在pytest.ini里加python_files = *_test.py test_*.py mytests.py
  • 如果有全局fixture(比如DB连接、mock配置),别放在unittest的setUpClass里,统一移到conftest.py中用@pytest.fixture(scope="session")
  • pytest默认开启--tb=short,但若你依赖完整traceback(比如CI日志分析),加--tb=long到addopts

迁移后务必验证覆盖率工具是否仍能识别新测试——有些旧版coverage.py对pytest支持不全,建议升级到6.0+并检查pyproject.toml中[tool.coverage.run]的source和omit配置是否覆盖新路径。

最易忽略的是隐式依赖unittest内部状态的代码,比如手动调用TestCase.__init__或修改_outcome属性。这类代码必须重写,pytest不提供对应钩子,强行兼容只会拖慢迁移节奏。

热门AI工具

更多
咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

相关专题

更多
python打包成可执行文件
python打包成可执行文件

本专题为大家带来python打包成可执行文件相关的文章,大家可以免费的下载体验。

1671

2023.07.20

python能做什么
python能做什么

python能做的有:可用于开发基于控制台的应用程序、多媒体部分开发、用于开发基于Web的应用程序、使用python处理数据、系统编程等等。本专题为大家提供python相关的各种文章、以及下载和课程。

4164

2023.07.25

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

1669

2023.07.31

python教程
python教程

Python已成为一门网红语言,即使是在非编程开发者当中,也掀起了一股学习的热潮。本专题为大家带来python教程的相关文章,大家可以免费体验学习。

24077

2023.08.03

python环境变量的配置
python环境变量的配置

Python是一种流行的编程语言,被广泛用于软件开发、数据分析和科学计算等领域。在安装Python之后,我们需要配置环境变量,以便在任何位置都能够访问Python的可执行文件。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2947

2023.08.04

python eval
python eval

eval函数是Python中一个非常强大的函数,它可以将字符串作为Python代码进行执行,实现动态编程的效果。然而,由于其潜在的安全风险和性能问题,需要谨慎使用。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2967

2023.08.04

scratch和python区别
scratch和python区别

scratch和python的区别:1、scratch是一种专为初学者设计的图形化编程语言,python是一种文本编程语言;2、scratch使用的是基于积木的编程语法,python采用更加传统的文本编程语法等等。本专题为大家提供scratch和python相关的文章、下载、课程内容,供大家免费下载体验。

1163

2023.08.11

python合并两个列表
python合并两个列表

Python是一种强大的编程语言,具有许多方便的功能和工具。在Python中,有多种方法可以合并两个列表。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

596

2023.08.10

LLVM自定义Pass怎么写
LLVM自定义Pass怎么写

本专题聚焦LLVM自定义Pass开发,整理Pass类结构、run()方法、PreservedAnalyses、CMake构建、插件注册、-load-pass-plugin加载和测试用例编写流程。

100

2026.09.30

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn