Falcon v3.1.1-b1 Documentation

语言	格式	评分
英语	.epub	3
摘要
文档详细记录了Falcon Framework的多个版本更新，包括新功能、改进和错误修复。Falcon 3.1.1-b1版本主要修复了高影响错误，并添加了对CPython 3.11的支持。Falcon 3.1.0版本引入了对CPython 3.10的支持，并 deprecated CPython 3.6。版本0.3.0引入了新的路由架构、改进的性能和URI模板支持。此外，多个版本更新中添加了新的属性如bounded_stream和uri_template，提升了错误处理和请求/响应功能。
AI总结
《Falcon v3.1.1-b1 Documentation》摘要如下： --- ### Falcon v3.1.1-b1 更新日志 ####تغییرات اصلی (破坏性更改) - 无重大更改。 #### 新增与改进 - Falcon 现在支持 CPython 3.11，尽管 3.11 的完整支持将在 Falcon 4.0 中正式化。 - Python 3.5 和 3.6 已被弃用，将在 Falcon 4.0 中移除。 #### 修复 - 修复了 `Request` 中 `forwarded_scheme` 和 `forwarded_host` 属性在处理无效或空的 `Forwarded`_header 时可能引发的 `IndexError`。 - 修复了 `orjson` 库在 ASGI 版本中的序列化问题。 #### 贡献者 - 特别感谢以下贡献者：CaselIT、kgriffs、TBoshoven、vytas7。 --- ### Falcon v3.1.0 更新日志 #### 摘要该版本主要优化了请求验证和错误处理，并改进了静态文件和可下载文件的响应处理。还增加了对 CPython 3.10 的支持，并弃用了 Python 3.6。 #### 新增与改进 - `TestClient` 和 `ASGIConductor` 现在支持 `simulate_` 方法的简便别名（如 `get()` 替代 `simulate_get()`）。 - 引入了 `MediaValidationError` 以处理媒体验证失败的情况，改进了错误处理的粒度。 - 改进了请求流处理，避免响应流未正确清理导致的挂起问题。 - 所有错误类的参数现在均为可选参数。 #### 修复 - 修复了请求正文流使用分块传输编码时的潜在挂起问题。 - 修复了 `Forwarded`_header 中带有逗号的引号字符串解析问题。 --- ### Falcon v1.1.0 更新日志 #### 新增与改进 - `falcon.Request` 中新增了 `bounded_stream` 属性，用于减少 WSGI 服务器输入对象的阻塞行为。 - `Request` 中新增 `uri_template` 属性，暴露与请求路径对应的路由模板。 - `Response` 中新增 `context` 属性，镜像 `Request` 中的同名属性。 - 支持通过 `get_param_as_dict()` 一步检索和解码 JSON 编码的查询参数。 - 支持禁用 CSV 样式解析查询参数值。 - `get_param_as_bool()` 现在识别 “on” 和 “off”（支持 IE 的默认复选框值）。 - `Response` 中新增 `accept_ranges` 属性，用于设置 `Accept-Ranges` 标头。 - 新增 `HTTPUriTooLong` 和 `HTTPGone` 错误类。 - 未指定 `HTTPError` 标题时，默认为 HTTP 状态文本。 --- ### Falcon v0.3.0 更新日志 #### 破坏性更改 - 日期标头现在返回 `datetime.datetime` 对象，而非字符串。 - 自定义路由器的 `add_route()` 方法不再包含 `method_map` 参数。 #### 新增与改进 - 引入了新的路由器架构，提升性能和灵活性。 - 支持读取和写入 Cookie。 - 支持 Jython 2.7。 - `Request` 中新增获取查询参数作为日期的方法。 - `Request.get_param()` 现支持指定默认值。 --- ### 安装 - PyPy：支持 PyPy 3.5+，为获得最佳性能推荐使用 PyPy。 ```bash pip install falcon ``` - CPython*：支持 CPython 3.5+。 - 使用 Cython 加速 Falcon： ```bash pip install cython pip install --no-build-isolation --no-binary :all: falcon ``` --- 以上是 Falcon 框架版本更新的核心内容总结，涵盖了主要的功能改进、破坏性更改和修复内容。