-
Python concurrent.futures.wait 会把 Future 分成 done 与 not_done 两个集合。本文说明 return_when、timeout 的边界,以及如何读取结果、处理异常并取消尚未开始的任务。
-
Python zipfile.ZipFile.open 会按成员名或 ZipInfo 定位压缩包内文件,并返回二进制文件式对象。本文用分块读取、重复成员定位、文本解码和 with 关闭边界说明如何安全消费 ZIP 成员流。
-
Python argparse subparsers 可以把一个命令行工具拆成多个独立子命令。本文说明 dest、required、set_defaults、全局参数和共享父解析器如何配合,组织可维护的多命令 CLI。
-
Python ShareableList 适合在进程间共享固定长度的小型结构化列表。本文从支持类型、字符串与字节容量、按名称连接以及 close/unlink 清理四个边界说明如何选型和使用。
-
Python WatchedFileHandler 适合 Unix/Linux 上由外部工具负责 rename/create 的日志轮转场景。本文说明设备号与 inode 的判断边界、固定路径配置、copytruncate 差异、应用内轮转冲突和 Windows 平台限制。
-
Python weakref.finalize 可以为支持弱引用的对象注册一次性清理回调,并在对象回收或主动调用时执行。本文说明回调参数、避免闭包反向持有对象、alive、detach、atexit 与 with 的边界。
-
Python 3.13 起可以用 typing.TypeIs 声明用户自定义类型谓词。本文用联合类型示例说明 True 分支如何做交集收窄、False 分支如何排除目标类型,并比较 TypeIs 与 TypeGuard 的适用边界。
-
Python dataclasses.field 通过 default_factory 为实例创建独立默认容器。文章说明零参数工厂、嵌套对象与显式传参的共享边界,并解释不可哈希默认值、init=False 和 frozen 的适用规则。
-
Python 的 sqlite3.Connection.blobopen 可以打开已有 SQLite BLOB,按偏移读取或写入固定长度数据。本文说明怎样用 zeroblob 预留空间,正确处理 readonly、事务提交和 Blob 句柄关闭。
-
Python sqlite3 默认返回元组,按列名读取需要在连接创建游标前设置 row_factory = sqlite3.Row。本文说明 row、列别名、空结果、已有游标与重复列名的边界,并给出可迁移的读取写法。
-
Python pathlib.Path.walk 默认会忽略目录扫描产生的 OSError。本文说明怎样用 on_error 接收异常,读取 filename,并按 PermissionError 等错误类型决定记录后继续还是重新抛出。
-
Python asyncio.timeout 的关键是捕获位置:上下文内部先取消当前任务,退出上下文后才转换为 TimeoutError。本文用运维排障视角说明正确结构、CancelledError 区分、阻塞代码边界和动态 deadline 用法。
-
Python 3.13 新增的 asyncio.Queue.shutdown 可以让生产者停止入队、消费者处理完已有任务后退出。本文解释 shutdown(False) 与 shutdown(True) 的差异,以及 QueueShutDown、task_done 和 join 的正确配合。
-
Python 标准库 ipaddress.collapse_addresses 可以把同一 IP 版本的网络对象按 CIDR 边界折叠,去掉重复和被覆盖的范围。本文从输入转换、连续网段合并、IPv4/IPv6 分组和输出物化几个步骤说明如何避免混合版本、未对齐边界与迭代器被消费的问题。
-
Python logging.basicConfig 在根 logger 已有 handler 时可能不再生效。本文说明 force=True 的重置范围、参数冲突和适用时机。