-
asyncio.wait 配合 FIRST_COMPLETED 可以先拿到已经完成或被取消的任务,并把仍在运行的任务放进 pending 集合。本文说明如何读取结果、处理超时,以及为什么必须显式决定 pending 任务的后续生命周期。
-
Python 3.13 新增的 asyncio.Queue.shutdown 可以让生产者停止入队、消费者处理完已有任务后退出。本文解释 shutdown(False) 与 shutdown(True) 的差异,以及 QueueShutDown、task_done 和 join 的正确配合。
-
Python sqlite3 Blob 写完需区分句柄关闭、事务提交和连接释放。本文固定 autocommit=False,给出分块写入、提交与回滚示例,并解释固定长度、自动提交和锁竞争边界。
-
Python email.headerregistry 会把邮件头解析时发现的 RFC 合规问题放进 Header.defects。本文用 BytesParser 和 policy.default 演示如何读取字段级与消息级缺陷,转换为可落盘诊断记录,并区分缺陷与真正的 HeaderParseError。
-
Python mailbox.mbox 的 get_bytes 方法可用 from_ 参数控制是否保留 Unix From 信封行。本文用一个最小项目对比 from_=False 和 from_=True,并说明邮件头、mbox 存储格式与跨 mailbox 类型使用时的区别。
-
用 Python email.headerregistry.Address 读取邮箱地址时,display_name、username、domain 和 addr_spec 的职责并不相同。本文从单地址头、多地址头和构造序列化三个场景说明怎样分别取值,避免把显示名当成实际邮箱地址。
-
用原创示例说明 TarInfo.replace 如何保留原元数据并修改副本的名称、时间和权限,比较深浅复制的字典共享关系,并把新属性与内容流交给归档写入接口。
-
Python sqlite3 的 autocommit 不是一个简单的提交开关。本文区分 Connection.autocommit 的三种取值、SQLite 底层自动提交状态、with con 显式事务边界和旧式 isolation_level 行为,并给出可直接改写的代码。
-
Python 3.14 的 pathlib.Path.copy() 可以复制文件或目录树。本文说明目标路径、符号链接跟随、preserve_metadata 元数据保留和跨平台边界,帮助你把本地复制写得清楚。
-
Python logging.setLogRecordFactory 可以在 LogRecord 创建时统一补充 request_id 等关联字段。本文用一个可链式复用的工厂示例,说明它与 LoggerAdapter、Filter、Formatter 的职责边界,以及字段冲突和性能注意事项。
-
用 Python operator.attrgetter 创建可复用的属性读取器,覆盖单属性、多属性、点号嵌套路径,以及 sorted、map 中的批量读取和 AttributeError 边界。
-
用 Python csv.field_size_limit() 处理 CSV 超长字段,说明当前上限、newline=''、csv.Error、进程级配置影响和可恢复的读取边界。
-
Python textwrap.TextWrapper.placeholder 用来替换截断文本末尾的默认标记。本文说明它为何必须和 max_lines 一起理解,怎样设置自定义结束符,以及 width、缩进和未发生截断时的边界。
-
用 Python hashlib.file_digest 从二进制文件对象直接计算摘要,覆盖算法名称、文件位置、阻塞模式、资源关闭、HMAC 工厂和从手写读取循环迁移的检查项。
-
判断函数是否为 coroutine function,优先使用 inspect.iscoroutinefunction。本文区分 async def 函数、partial 包装、同步函数返回协程、async generator 与已经调用后的 coroutine 对象,避免把函数检查和结果检查混在一起。