Falcon v3.0.0 Documentation

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

摘要

Falcon 3.0.0版本文档介绍了该框架的重大更新，包括对ASGI和WebSockets的支持，改进的错误处理机制，以及对Python 3.8和3.9的全面支持。文档还提到移除了对CPython 2.7和PyPy2.7的支持，修复了多个错误，并新增了静态路由功能。

AI总结

### Falcon 3.0.0 文档总结

#### 主要更新
1. **版本发布**
Falcon 3.0.0 是一个重大版本更新，引入了 ASGI 支持、WebSocket 功能以及多项性能优化和新特性。

2. **新功能与改进**
- **ASGI 支持**：新增基于 ASGI 的异步支持，兼容 asyncio，同时保留 WSGI 支持。
- **WebSocket 支持**：增加了对 WebSocket 协议的支持。
- **multipart/form-data 解析**：改进了文件上传和表单数据的解析能力。
- **错误处理**：增强了错误处理机制，确保所有 HTTP 错误都有媒体类型表示。
- **新路由器架构**：采用更高效灵活的路由器架构，支持自定义路由器和 URI 模板中的多参数字段。
- **Cookie 支持**：新增了对 Cookie 的读写功能。
- **日期处理**：支持将查询参数解析为日期对象，并返回 datetime.datetime 类型。
- **默认值支持**：在获取查询参数时可指定默认值。
- **状态码常量**：引入了友好的 HTTP 状态码常量（如 `falcon.HTTP_NO_CONTENT`）。
- **性能优化**：进行了多项代码优化，提升了整体性能。

3. **问题修复**
- 修复了文档显示问题（Note 在 Jython 下不再显示）。
- 修复了测试环境中的默认 User-Agent 字符串。
- 修复了 `create_environ()` 函数中协议和应用参数的命名问题。

4. **平台支持**
- **新增支持**：全面支持 Python 3.8 和 3.9，新增对 PyPy 3.5 的支持。
- **弃用与移除**：
- Python 3.5 支持已 deprecated，可能在下一个 major 版本中移除。
- Python 3.4 不再支持。
- 移除了对 CPython 2.7 和 PyPy 2.7 的支持。

5. **其他变化**
- **弃用类与属性**：
- `OptionalRepresentation` 和 `has_representation` 已 deprecated。
- `NoRepresentation` 已 deprecated，所有 HTTP 错误子类均支持媒体类型表示。
- **测试环境调整**：默认 User-Agent 字符串改为 `falcon-client/{version}`，可通过 `falcon.testing.helpers.DEFAULT_UA` 自定义。
- **协议参数重命名**：`create_environ()` 中的 `protocol` 参数重命名为 `http_version`，不再包含前缀 `HTTP/`。
- **应用参数重命名**：`app` 参数重命名为 `root_path`。

6. **用户指南**
- 提供了详细的安装、快速入门和教程，涵盖 WSGI 和 ASGI 的使用场景。
- 新增了针对 ASGI 的功能介绍，包括如何部署应用、配置路由、处理图像和缓存响应等。

7. **兼容性注意事项**
- 尽管尽量减少了破坏性更改，但部分方法和属性已被弃用或移除，建议用户在升级前仔细检查文档并测试应用。

### 总结
Falcon 3.0.0 是一个功能强大且灵活的 Web 框架，特别适合需要高性能和异步支持的场景。其对 ASGI 的支持和多项新功能的引入，使其在现代 Python 应用开发中更具竞争力。