该技能用于指导按 Kenneth Reitz 的风格编写 Python 代码。Reitz 是 HTTP 库 requests 的作者,其“for humans”哲学把用户体验放在首位,认为 API 设计就是面向开发者的 UI 设计,简洁优于功能,应服务 90% 的常见用例。
核心设计原则:为用户而设计,优先常见场景而非边缘情况;代码应赏心悦目;提供合理默认值,常见用法零配置;敢于拒绝加功能以保持简洁。
写作代码时应当:为每个参数提供合理默认值;让常见用例极其简单;返回有用的对象而非原始数据结构;提供能引导用户的错误信息;保持 API 面小;写出美观易读的代码。不应:为基本用法要求配置;向用户暴露内部复杂度;以“万一有人用”为由添加功能;随意破坏向后兼容;让用户为基本操作读文档。偏好:每个操作只有一种显而易见的方式;首参之后多用关键字参数;用方法链构建流式接口;用有意义的异常代替错误码;尽量使用不可变对象。
资料给出的代码模式包括:简洁自解释的接口调用(如 requests.post 直接传 data 与 headers 并调用 response.json());HTTPClient 类的合理默认值(timeout=30、verify_ssl=True、max_retries=3);返回带属性的富对象 User 及专门的 UserNotFound 异常;QueryBuilder 的链式调用 filter/order_by/limit/execute;能指导用户修复的详尽的异常信息(如 MissingAPIKey 提示设置环境变量或传参);包入口 init.py 暴露常用类与快捷函数 get/post/download。
适用场景:设计或重构 Python 库与 API、希望提升易用性与可读性的项目。使用方式为参照上述原则与模式编写代码并进行“Requests 测试”:初学者能否 5 分钟上手、常见情况是否零配置、代码是否美观、是否乐于展示给他人。限制:资料未提供具体安装命令、收费信息、运行环境与版本要求,亦未说明该技能的加载或调用方式。