Falcon v3.1.1 Documentation

语言	格式	评分
英语	.epub	3
摘要
Falcon 3.1.1 是一次小版本更新，修复了高影响的错误，并在 CPython 3.11 上启用框架。主要更新包括支持 CPython 3.11，修复了与 Forwarded 标头处理相关的索引错误，改进了 or-json 库在 ASGI 版本中的使用。此外，文档提到 Python 3.5 和 3.6 已经弃用，将在未来版本中移除支持。新版本还增强了请求验证和错误处理功能，并添加了对 Jython 2.7 的支持。
AI总结
《Falcon v3.1.1 文档总结》 ### 版本概述 Falcon 3.1.1 是一个小型补丁版本，修复了一些高影响的错误，并支持了最新发布的 CPython 3.11。该版本主要针对框架的稳定性和兼容性进行了优化。 --- ### 主要更新内容 #### 支持平台调整 - 新增支持：Falcon 现在在 CPython 3.11 上正常运行，但完整的 3.11 支持（包括处理标准库的弃用问题）将在 Falcon 4.0 中正式实现。 - 弃用支持：Python 3.5 和 3.6 已经弃用，将在 Falcon 4.0 中完全停止支持。 - Python 版本兼容性： - Python 3.8 和 3.9 现在完全受支持。 - Python 3.6+ 仅在使用新的 ASGI 接口时需要，WSGI 仍支持 Python 3.5+。 - Python 3.4 已不再支持。 --- #### 修复内容 - Forwarded 头处理：修复了在处理无效或空的 `Forwarded` 头时可能导致的 `IndexError` 问题。 - or-json 库兼容性：在 ASGI 版本的媒体处理中，`or-json` 库现在可以正确工作。 --- #### 新功能与改进 - 路由器架构：引入了新的路由器架构，提升了性能和灵活性。 - URI 模板支持：支持在单个路径段中包含多个参数化字段。 - Cookie 支持：新增了对 Cookie 的读取和写入功能。 - Jython 支持：新增对 Jython 2.7 的支持。 - 日期处理：新增 `Request` 类的方法，用于获取查询参数作为日期对象。 - 默认值支持：在 `Request.get_param()` 中新增默认值参数。 - 状态码常量：新增友好的 HTTP 状态码常量（如 `falcon.HTTP_NO_CONTENT`）。 - 性能优化：进行了多项代码优化，提升了整体性能。 --- #### 破坏性更改 - Date 头返回格式：`Date` 头现在返回 `datetime.datetime` 对象，而非字符串。 - 路由器接口变化：`add_route()` 方法的签名发生变化，不再包含 `method_map` 参数，需通过 `falcon.routing.util.map_http_methods()` 直接实现。 - 错误处理： - `OptionalRepresentation` 和 `has_representation` 类已弃用，所有 `falcon.HTTPError` 子类现在都有媒体类型表示。 - 错误处理机制更新，确保清除之前设置的响应正文。 --- #### 其他改进 - 测试客户端：新增了 `TestClient` 和 `ASGIConductor` 的便捷方法，如 `simulate_get()` 可直接使用 `get()`。 - 文档修复：修正了文档中的多项错误和模糊描述。 --- ### 贡献者感谢以下贡献者为本次修复版本做出了贡献： - CaselIT - kgriffs - TBoshoven - vytas7 --- ### 快速链接 - [官方文档](https://falcon.readthedocs.io/en/stable) - [扩展与工具](https://github.com/falconry/falcon/wiki) - [用户与开发者社区](https://gitter.im/falconry/user) --- ### 总结 Falcon 3.1.1 是一个以稳定性和兼容性为核心的版本，修复了多项关键问题，并为后续版本的全面升级奠定了基础。