Falcon v3.0.0-b2 Documentation

语言	格式	评分
英语	.epub	3
摘要
文档详细介绍了Falcon框架的版本更新，包括新功能、性能优化、兼容性调整以及已知问题的修复。主要更新内容包括对Python 3.8和3.9的支持，移除对Python 2和3.4的支持，优化了JSON处理和错误处理机制，修复了与WSGI和ASGI接口相关的多个问题，并改进了文档结构和测试功能。
AI总结
### Falcon 框架更新总结 #### 3.0.0 版本更新 - 支持平台： - 支持 Python 3.8 和 3.9。 - Python 3.6+ 仅用于新 ASGI 接口，WSGI 仍支持 Python 3.5+。 - Python 3.5 支持已弃用，可能在下次大版本中移除。 - Python 3.4 不再支持。 - CPython 2.7 和 PyPy2.7 支持已移除。 - Breaking Changes： - `OptionalRepresentation` 和 `has_representation` 已弃用。 - 错误处理默认生成表示，确保所有 `falcon.HTTPError` 子类都有媒体类型表示。 - `create_environ()` 的默认 `User-Agent` 头已更改。 - `create_environ()` 的 `protocol` 参数重命名为 `http_version`。 - `app` 参数重命名为 `root_path`。 - `BoundedStream` 的 `writeable` 属性重命名为 `writable`。 - 新功能与改进： - 支持 ASGI 接口。 - 支持 Jython 2.7。 - 新增 `get_param_as_date()` 方法。 - 默认值支持 `Request.get_param()`。 - 新增友好状态码常量（如 `falcon.HTTP_NO_CONTENT`）。 - 性能优化。 #### 2.0.0 版本更新 - Breaking Changes： - `util.misc.percent_escape` 和 `utilmisc.percent_unescape` 已移除，建议使用 `util.uri` 模块。 - `API.set_default_route` 已移除，建议使用 sinks 替代。 - `HTTPRangeNotSatisfiable` 不再接受 `media_type` 参数。 - 查询字符串解析规则变更，空元素不再插入 `None`。 - 新功能与改进： - 支持 `application/x-www-form-urlencoded` 内容解析。 - 支持自定义请求和响应类。 - 新增中间件功能，替代全局钩子。 - 新增 `req.context` 属性用于共享上下文信息。 - 支持 XML 错误响应。 - 新增 `get_param_as_uuid()` 方法。 - 支持 WebDAV 方法（如 `UPDATE` 和 `REPORT`）。 - 新增 `downloadable_as` 属性设置 `Content-Disposition` 头。 #### 1.4.0 版本更新 - Breaking Changes： - `falcon.testing.Result.json` 现在返回 `None` 而不是抛出错误。 - 新功能与改进： - 新增 `add_static_route()` 方法。 - 支持将文件从本地目录提供服务。 - 默认 JSON 处理器使用 `ujson` 提升性能。 - 新增 `get_param_as_datetime()` 方法。 - 新增请求代理信息属性（如 `forwarded`, `forwarded_uri` 等）。 - 新增 `referer` 属性。 - 实现 `__repr__()` 方法便于调试。 - 新增多个 5xx 错误类。 #### 0.3.0 版本更新 - Breaking Changes： - 日期头返回类型从字符串改为 `datetime.datetime` 对象。 - `add_route()` 方法的签名变更，不再包含 `method_map` 参数。 - 新功能与改进： - 新增路由架构，提升性能和灵活性。 - 支持自定义路由器。 - URI 模板支持多个参数字段。 - 支持读写 Cookie。 - 支持 Jython 2.7。 - 新增 `get_param_as_date()` 方法。 - 支持默认值 `Request.get_param()`。 - 新增友好状态码常量。 #### 0.2.0 版本更新 - Breaking Changes： - `util.misc.percent_escape` 和 `utilmisc.percent_unescape` 已移除。 - `API.set_default_route` 已移除。 - 新功能与改进： - 支持 `application/x-www-form-urlencoded` 内容解析。 - 支持自定义请求和响应类。 - 新增中间件功能。 - 新增 `req.context` 属性。 - 支持 XML 错误响应。 - 新增 `get_param_as_uuid()` 方法。 #### 1.3.0 版本更新 - 新功能与改进： - 新增资源表示序列化和反序列化功能。 - 支持 URI 模板字段转换器。 - 新增 `get_param_as_datetime()` 方法。 - 新增请求代理信息属性。 - 实现 `__repr__()` 方法便于调试。 - 新增多个 Internet 媒体类型常量。 #### 总结 Falcon 框架在不同版本中持续改进性能、扩展功能，并对部分接口进行调整以适应新需求。用户在升级时需注意 Breaking Changes，确保代码兼容性。新版本引入了更多灵活性和扩展性，如 ASGI 支持、中间件功能、错误处理改进等，同时修复了多项已知问题。