structlog 25.4.0版本发布:异常组支持与Python 3.13兼容性升级
structlog是一个强大的Python结构化日志记录库,它通过处理器链的方式提供了灵活且可扩展的日志记录功能。与标准库logging模块相比,structlog更注重于结构化数据的记录,使得日志信息更易于解析和分析。
主要更新内容
Python 3.13.4兼容性修复
本次发布的一个重要背景是即将到来的Python 3.13.4版本中包含了一个向后不兼容的变更。这个变更影响了logging.Logger.isEnabledFor()
方法的行为:当有日志条目正在处理时,该方法现在会始终返回False。
这一变化主要影响了structlog标准库集成中的structlog.stdlib.filter_by_level()
功能。开发者应当在升级Python 3.13.4之前先升级structlog到25.4.0版本,以确保日志过滤功能正常工作。
异常组支持
25.4.0版本引入了对Python异常组(Exception Groups)的支持,这一功能借鉴了Rich库的实现方式。异常组是Python 3.11引入的新特性,允许将多个异常作为一个组抛出和处理。
structlog的tracebacks
模块现在能够正确处理异常组,新增了两个重要字段:
is_group
: 布尔值,标识是否为异常组exceptions
: 包含所有子异常的列表
这一改进使得structlog能够更全面地捕获和记录复杂的异常情况,特别是在异步编程场景中,异常组的使用越来越普遍。
其他改进
异常美化处理器修复
ExceptionPrettyPrinter
处理器现在能够正确尊重exception_formatter
参数,而不是总是使用默认的格式化器。这意味着开发者可以更灵活地自定义异常信息的显示方式。
技术细节
对于异常组的支持实现,structlog采用了类似Rich库v14.0.0的处理方式。异常组中的每个子异常都会被递归处理,最终形成一个完整的异常跟踪树。这种处理方式特别适合复杂的并发编程场景,能够清晰地展示异常之间的关系。
在性能方面,structlog保持了其一贯的高效特性。即使增加了异常组的支持,日志处理的性能开销仍然保持在最低水平。
升级建议
对于正在使用structlog的项目,特别是那些计划升级到Python 3.13.4的项目,强烈建议尽快升级到25.4.0版本。升级过程通常是无缝的,但需要注意以下几点:
- 如果项目中使用了自定义的异常处理器,可能需要检查它们是否能够正确处理异常组
- 在Python 3.13.4环境下,确保所有依赖
filter_by_level
的功能都经过充分测试 - 对于复杂的异步应用,可以利用新的异常组支持来获得更详细的错误信息
structlog 25.4.0继续保持了项目的稳定性和可靠性,同时增加了对Python最新特性的支持,为开发者提供了更强大的日志记录工具。
- QQwen3-Next-80B-A3B-InstructQwen3-Next-80B-A3B-Instruct 是一款支持超长上下文(最高 256K tokens)、具备高效推理与卓越性能的指令微调大模型00
- QQwen3-Next-80B-A3B-ThinkingQwen3-Next-80B-A3B-Thinking 在复杂推理和强化学习任务中超越 30B–32B 同类模型,并在多项基准测试中优于 Gemini-2.5-Flash-Thinking00
GitCode-文心大模型-智源研究院AI应用开发大赛
GitCode&文心大模型&智源研究院强强联合,发起的AI应用开发大赛;总奖池8W,单人最高可得价值3W奖励。快来参加吧~0172DuiLib_Ultimate
DuiLib_Ultimate是duilib库的增强拓展版,库修复了大量用户在开发使用中反馈的Bug,新增了更加贴近产品开发需求的功能,并持续维护更新。C++03AI内容魔方
AI内容专区,汇集全球AI开源项目,集结模块、可组合的内容,致力于分享、交流。00- HHunyuan-MT-7B腾讯混元翻译模型主要支持33种语言间的互译,包括中国五种少数民族语言。00
GOT-OCR-2.0-hf
阶跃星辰StepFun推出的GOT-OCR-2.0-hf是一款强大的多语言OCR开源模型,支持从普通文档到复杂场景的文字识别。它能精准处理表格、图表、数学公式、几何图形甚至乐谱等特殊内容,输出结果可通过第三方工具渲染成多种格式。模型支持1024×1024高分辨率输入,具备多页批量处理、动态分块识别和交互式区域选择等创新功能,用户可通过坐标或颜色指定识别区域。基于Apache 2.0协议开源,提供Hugging Face演示和完整代码,适用于学术研究到工业应用的广泛场景,为OCR领域带来突破性解决方案。00- HHowToCook程序员在家做饭方法指南。Programmer's guide about how to cook at home (Chinese only).Dockerfile04
- PpathwayPathway is an open framework for high-throughput and low-latency real-time data processing.Python00
- Dd2l-zh《动手学深度学习》:面向中文读者、能运行、可讨论。中英文版被70多个国家的500多所大学用于教学。Python011
热门内容推荐
最新内容推荐
项目优选









