Falcon v3.1.1-a Documentation

• 语言: 英语
• 格式: .epub
• 来源: falcon.readthedocs.io

摘要

Falcon 3.1.1版本主要针对高影响错误进行了修复，并新增了对CPython 3.11的支持。该版本弃用了对Python 3.5和3.6的支持，并计划在Falcon 4.0中正式移除。此外，Falcon 3.1.1还修复了与Forwarded头处理相关的索引错误问题，以及或-json库在ASGI版本中的使用问题。其他版本如Falcon 3.0.0引入了ASGI支持和WebSocket功能，同时进行了多项性能优化，并修复了一些错误。

AI总结

### Falcon 版本更新总结

#### 3.1.1 版本更新
- **新增功能**：
- 支持 CPython 3.11，但完整支持将在 Falcon 4.0 中实现。
- **修复问题**：
- 修复了 `Request.attributes.forwarded` 在处理无效或空 `Forwarded` 标头时引发的 `IndexError`。
- 修复了 ASGI 版本中 `or-json` 库作为 JSON 序列化器时的兼容性问题。
- **弃用**：
- Python 3.5 和 3.6 已经弃用，将在 Falcon 4.0 中移除支持。

#### 3.1.0 版本更新
- **新增功能**：
- 改进请求验证和错误处理，优化静态文件和 downloadable files 的响应处理。
- `TestClient` 和 `ASGIConductor` 新增 `simulate_get()` 等快捷方法。
- 支持 CPython 3.10，弃用 CPython 3.6。
- **修复问题**：
- 解决了 streamed chunked transfer encoding 请求体读取时的悬挂问题。
- **其他改进**：
- `jsonschema.validate` 装饰器现在使用 `MediaValidationError` 替代通用的 `HTTPBadRequest`，并支持自定义错误处理。
- 文档中的一些错误和模糊描述已修正。

#### 3.0.1 版本更新
- **修复问题**：
- 修复了 `api_helpers` 模块的重新引入问题，该模块已 deprecated，将在未来版本中移除。
- 修复 ASGI HTTP 头部编码问题，现在使用 ISO-8859-1 而不是 UTF-8。
- 修复了 README 在 PyPI 上的渲染问题，并在构建过程中添加了验证步骤。

#### 3.0.0 版本更新
- **重大更新**：
- 引入 ASGI 支持，新增 asyncio 和 WebSocket 功能。
- 提供了强大的 multipart/form-data 解析功能。
- 改进错误处理和现有功能的增强。
- **兼容性改进**：
- 尽量最小化破坏性更改，但部分方法和属性已 deprecated。
- **其他改进**：
- 新增对 Jython 2.7 的支持。
- 新增 `Request.get_param_as_date()` 方法。
- 新增 `Response.downloadable_as` 属性以设置 `Content-Disposition` 头部。
- 优化性能，包括对 `Response.body_encoded` 属性的改进。

#### 1.4.0 版本更新
- **新增功能**：
- 新增 `add_static_route()` 方法，用于轻松从本地目录提供文件服务。
- 支持在请求中传递参数到钩子（hooks）。
- 默认 JSON 处理器现在使用 `ujson` 以提高性能。
- **兼容性改进**：
- 支持 PyPy 3.5 v5.10。
- 弃用 CPython 3.3 支持，将在 Falcon 2.0 中移除。
- **其他改进**：
- 新增 `get_param_as_uuid()` 方法。
- 支持 WebDAV 方法（如 UPDATE 和 REPORT）。

#### 1.0.0 版本更新
- **重大更新**：
- 移除 deprecated 的全局钩子功能，建议迁移到中间件。
- 中间件的 `process_resource()` 方法新增 `params` 参数。
- 新增对自动解析 `application/x-www-form-urlencoded` 请求内容的控制，需手动启用。
- **其他改进**：
- `HTTPUnauthorized` 初始化器现在需要 `challenges` 参数。
- 响应体生成性能优化，移除 `Response.body_encoded` 属性。

以上为 Falcon 各版本的主要更新内容，涵盖新增功能、修复问题、兼容性改进和 deprecated 功能。