Falcon v3.0.0-b1 Documentation

语言	格式	评分
英语	.pdf	3
摘要
文档详细介绍了Falcon框架的3.0.0版本更新内容，包括对Python 3.8和3.9的支持，移除了对Python 2.7和PyPy2.7的支持，修复了多项已知问题，并新增了多项功能，如URI模板字段转换器支持、新的错误处理类以及性能优化等。文档还涵盖了框架的安装、部署、测试和社区贡献等内容。
AI总结
### Falcon 3.0.0b1 文档总结 Falcon 3.0.0b1 是 Falcon 框架的最新版本，主要更新包括新功能、改进、兼容性变化以及一些已知问题的修复。以下是文档的核心内容总结： --- #### 1. 新功能与改进 - 新增功能： - 新增 `bounded_stream` 属性，用于替代 `stream` 属性，以减少阻塞行为。 - 新增 `uri_template` 属性，用于暴露请求路径对应的路由模板。 - 新增 `accept_ranges` 属性，便于设置 `Accept-Ranges` 头。 - 新增 `get_param_as_datetime()` 方法，支持从请求参数中解析日期时间。 - 新增 `HTTPUriTooLong` 和 `HTTPGone` 错误类。 - 测试框架新增 `falcon.testing.Cookie` 类，便于处理模拟请求返回的 Cookie。 - 支持 Python 3.8 和 3.9，同时弃用对 Python 2 和 3.5 的支持。 - 改进： - 测试框架新增 pytest 支持，用户可以选择 unittest 或 pytest 风格编写测试。 - 文档中新增了对中文的支持，便于中文用户阅读和理解。 - 错误处理机制改进，所有 `HTTPError` 子类现在都有媒体类型表示。 - 新增多个 Internet 媒体类型常量，便于设置和检查内容类型头。 - 兼容性改进： - 支持 CPython 3.6+，其中 Python 3.6+ 是使用新 ASGI 接口的最低要求。 - WSGI 仍支持 Python 3.5+，但 Python 3.5 支持已 deprecated，可能在下一个 major 版本中移除。 --- #### 2. 已知问题与修复 - 修复的问题： - 修复了 URI 模板路径段中的非字母数字字符处理问题。 - 修复了测试框架在 Jython 上的 Cookie 解析问题，以及 Cookie 解析中未去除空格的问题。 - 修复了默认 OPTIONS 响应状态码问题，从 204 修改为 200。 - 修复了 WSGI 服务器未提供 `wsgi.file_wrapper` 时的资源释放问题。 - 兼容性问题： - Python 2 和 Jython 2.7 支持已移除。 - 部分全局钩子功能已 deprecated，建议迁移到中间件实现。 - `falcon.get_http_status()` 方法 deprecated，不再接受浮点数参数。 --- #### 3. 其他重要信息 - 文档结构： - 用户指南：包括安装、快速上手、WSGI 和 ASGI 教程、调试技巧等。 - 部署指南：提供在 Linux 上使用 NGINX 和 uWSGI 部署的指导。 - 社区指南：包括如何获取帮助、如何贡献代码等。 - 测试框架： - 新增了对测试框架的改进，支持更多场景测试。 - 测试结果中新增 Cookie 属性，便于检查返回的 Cookie。 --- #### 4. 总结 Falcon 3.0.0b1 是一个功能丰富且性能优化的版本，重点提升了对现代 Python 版本的支持，新增了多项实用功能，并修复了部分兼容性和测试问题。对于开发者来说，建议关注新功能和兼容性变化，以便顺利迁移和使用该版本。