0

0

Python pluggy 的 hook 实现与优先级控制

冰川箭仙

冰川箭仙

发布时间:2026-02-20 11:56:58

|

865人浏览过

|

来源于php中文网

原创

tryfirst/trylast 是协商式优先级:先按 priority 排序,再将 tryfirst 放最前、trylast 放最后;tryfirst 对应 priority=0(非负无穷),冲突时回退到 priority 比较,相同则按注册顺序(不稳定)。

python pluggy 的 hook 实现与优先级控制

hookimpl 的 tryfirsttrylast 怎么生效?

tryfirst=Truetrylast=True 不是强制排序,而是“协商式优先级”:当多个插件注册了同名 hook,pluggy 会先按 hookimplpriority 数值排序,再把 tryfirst 的放最前、trylast 的放最后——但仅限于它们之间不冲突时。一旦 priority 显式设为高值(比如 100),它就可能压过 tryfirst

  • tryfirst 对应的 priority 实际是 0,不是负无穷;trylast 对应 0,也不是正无穷
  • 如果两个插件都设 tryfirst=True,那就退回到比 priority,priority 相同才按注册顺序(非稳定)
  • 在 hookspec 声明里加 firstresult=True 后,tryfirst 更关键——第一个返回非 None 的 tryfirst 实现会直接中断执行
@hookimpl(tryfirst=True)
def pytest_runtest_makereport(item, call):
    if call.excinfo:
        return ReportWrapper(call.excinfo)

为什么 hook 调用顺序和预期不符?

常见现象是:明明写了 trylast=True,结果自己的逻辑还是被别的插件覆盖或截断。根本原因通常是 hookspec 定义时没开 hookwrapper=Truefirstresult=True,导致所有实现都串行执行,而你的逻辑在中间就被其他返回值干扰了。

  • 插件加载顺序影响注册顺序,但 pluggy 不保证 import 顺序 = 注册顺序,尤其用了 setuptools entry points 时
  • pm.register() 手动注册的插件,其 hookimpl 优先级只在本次注册中有效,不会覆盖已注册的同名 hook
  • 使用 pm.hook.my_hook._nonwrappers 可以查当前实际参与调用的实现列表,调试时比猜更可靠

hookwrapper=True 和普通 hookimpl 有什么实质区别?

hookwrapper=True 不是“更高优先级”,而是切换了执行模型:它不直接返回值,而是用 yield 切入 hook 执行流,在前后都能拦截——比如在测试开始前改 item,或在所有普通 impl 返回后统一收口日志。

Musico
Musico

Musico 是一个AI驱动的软件引擎,可以生成音乐。 它可以对手势、动作、代码或其他声音做出反应。

下载
  • 普通 hookimpl 必须有 return,且返回值会进入结果列表(除非 hookspec 设了 firstresult=True
  • hookwrapper 函数体内必须有且仅有一个 yield,否则启动时报 HookCallError
  • 多个 hookwrapper 之间仍受 priority 控制,但它们包裹的是“整个 hook 调用过程”,不是单个返回值
  • 注意:wrapper 里 yield 后的代码,是在所有普通 impl 执行完之后才运行的
@hookimpl(hookwrapper=True)
def pytest_runtest_makereport(item, call):
    outcome = yield
    report = outcome.get_result()  # 获取普通 impl 的返回结果
    if report.failed:
        log_failure(report)

如何安全地覆盖第三方插件的 hook 行为?

别试图用 tryfirst=True 硬顶替——尤其当对方用了 hookwrapper 或修改了内部状态时,容易引发静默失败。真正可控的方式是:明确 hookspec 是否允许你介入、是否支持 firstresult、以及有没有公开的配置开关。

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

  • 先看目标 hookspec 的定义:在源码里搜 @hookspec,确认有没有 firstresulthookwrapperhistoric 等标记
  • 如果原 hook 是 firstresult=True,你设 tryfirst=True + return 非 None,就能短路后续逻辑
  • 如果原 hook 是 hookwrapper=True,你的 wrapper 必须小心 yield 后的副作用,避免重复执行或状态错乱
  • 最稳妥的覆盖点,其实是 hookspec 允许的参数注入位置(比如 pytest_configure(config) 中改 config.pluginmanager),而不是硬抢 hook 顺序

pluggy 的 hook 优先级本质是“协作契约”,不是调度器。越想绕过规则强行控制,越容易掉进注册时机、yield 生命周期、结果聚合逻辑这些隐性坑里。

相关文章

相关标签:

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
pixiv网页版官网登录与阅读指南_pixiv官网直达入口与在线访问方法
pixiv网页版官网登录与阅读指南_pixiv官网直达入口与在线访问方法

本专题系统整理pixiv网页版官网入口及登录访问方式,涵盖官网登录页面直达路径、在线阅读入口及快速进入方法说明,帮助用户高效找到pixiv官方网站,实现便捷、安全的网页端浏览与账号登录体验。

705

2026.02.13

微博网页版主页入口与登录指南_官方网页端快速访问方法
微博网页版主页入口与登录指南_官方网页端快速访问方法

本专题系统整理微博网页版官方入口及网页端登录方式,涵盖首页直达地址、账号登录流程与常见访问问题说明,帮助用户快速找到微博官网主页,实现便捷、安全的网页端登录与内容浏览体验。

233

2026.02.13

Flutter跨平台开发与状态管理实战
Flutter跨平台开发与状态管理实战

本专题围绕Flutter框架展开,系统讲解跨平台UI构建原理与状态管理方案。内容涵盖Widget生命周期、路由管理、Provider与Bloc状态管理模式、网络请求封装及性能优化技巧。通过实战项目演示,帮助开发者构建流畅、可维护的跨平台移动应用。

117

2026.02.13

TypeScript工程化开发与Vite构建优化实践
TypeScript工程化开发与Vite构建优化实践

本专题面向前端开发者,深入讲解 TypeScript 类型系统与大型项目结构设计方法,并结合 Vite 构建工具优化前端工程化流程。内容包括模块化设计、类型声明管理、代码分割、热更新原理以及构建性能调优。通过完整项目示例,帮助开发者提升代码可维护性与开发效率。

22

2026.02.13

Redis高可用架构与分布式缓存实战
Redis高可用架构与分布式缓存实战

本专题围绕 Redis 在高并发系统中的应用展开,系统讲解主从复制、哨兵机制、Cluster 集群模式及数据分片原理。内容涵盖缓存穿透与雪崩解决方案、分布式锁实现、热点数据优化及持久化策略。通过真实业务场景演示,帮助开发者构建高可用、可扩展的分布式缓存系统。

61

2026.02.13

c语言 数据类型
c语言 数据类型

本专题整合了c语言数据类型相关内容,阅读专题下面的文章了解更多详细内容。

30

2026.02.12

雨课堂网页版登录入口与使用指南_官方在线教学平台访问方法
雨课堂网页版登录入口与使用指南_官方在线教学平台访问方法

本专题系统整理雨课堂网页版官方入口及在线登录方式,涵盖账号登录流程、官方直连入口及平台访问方法说明,帮助师生用户快速进入雨课堂在线教学平台,实现便捷、高效的课程学习与教学管理体验。

15

2026.02.12

豆包AI网页版入口与智能创作指南_官方在线写作与图片生成使用方法
豆包AI网页版入口与智能创作指南_官方在线写作与图片生成使用方法

本专题汇总豆包AI官方网页版入口及在线使用方式,涵盖智能写作工具、图片生成体验入口和官网登录方法,帮助用户快速直达豆包AI平台,高效完成文本创作与AI生图任务,实现便捷智能创作体验。

669

2026.02.12

PostgreSQL性能优化与索引调优实战
PostgreSQL性能优化与索引调优实战

本专题面向后端开发与数据库工程师,深入讲解 PostgreSQL 查询优化原理与索引机制。内容包括执行计划分析、常见索引类型对比、慢查询优化策略、事务隔离级别以及高并发场景下的性能调优技巧。通过实战案例解析,帮助开发者提升数据库响应速度与系统稳定性。

58

2026.02.12

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
最新Python教程 从入门到精通
最新Python教程 从入门到精通

共4课时 | 22.4万人学习

Django 教程
Django 教程

共28课时 | 4.4万人学习

SciPy 教程
SciPy 教程

共10课时 | 1.6万人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号