SuperAPI AI 工具集

python-async-runtime

编程与开发

查看项目

更新于 10-24 02:39

技能介绍

Python Async Runtime 是一个针对 Python 异步运行时代码编写的技能规则集,优先级标注为 P1(高)。其目标是在编辑 asyncio 相关工作流时,帮助写出正确、可观测、可维护的异步代码。

用途与适用场景 该技能适用于需要编写或修改 asyncio 代码的场合,尤其是涉及阻塞式数据库访问、子进程调用、旧式 HTTP 客户端,以及需要明确超时、取消和后台任务生命周期的异步工作流。

主要规则 技能给出的核心规则包括:把阻塞的数据库、子进程和旧式 HTTP 调用排除在事件循环代码之外;仅将 asyncio.to_thread 作为围绕阻塞库的显式边界使用;让超时和取消行为在调用路径中可见;有意识地跟踪长生命周期任务、清理与重试。

推荐做法

  • 优先使用原生异步客户端。
  • 在适配层接缝处一次性封装阻塞调用。
  • 传播取消与超时上下文,而不是将其吞掉。
  • 将轮询循环逻辑与工作项处理分离。
  • 测试超时与错误路径,而不仅是正常路径。

反模式

  • 不在 async def 中直接执行阻塞式 I/O。
  • 不写没有停止条件或可观测性的隐藏无限循环。
  • 不在 await 调用链外使用宽泛的 except Exception 捕获,以免抹掉任务状态。
  • 不创建没有生命周期归属的孤儿后台任务。

其他说明 资料中还列出“框架地图”和“异步边界”两个参考条目,但未提供具体内容。该技能的安装方式、具体工具集成方式、平台限制与收费信息暂未提供。