Falcon v3.1.1-b3 Documentation

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

摘要

Falcon是一个轻量级的ASGI/WSGI框架，用于构建高性能、可靠的REST API和微服务。它注重简洁性，鼓励REST风格，支持CPython 3.5+和PyPy 3.5+，提供裸金属性能和灵活性。Falcon不依赖魔法全局变量，支持稳定接口和后向兼容性，适合大规模应用。文档介绍了其安装、快速入门、路由机制、错误处理、许可信息，并列出了部分用户和贡献者。

AI总结

### Falcon v3.1.1-b3 文档总结

#### 框架简介
Falcon 是一个轻量级的 ASGI/WSGI 网络框架，专注于构建高可靠性和高性能的 REST API 和微服务。它遵循 REST 架构风格，强调简洁和高效。

#### 核心特性
1. **高性能**：Falcon 提供裸金属性能，支持 CPython 3.5+ 和 PyPy 3.5+，在基准测试中表现优于其他 Python 框架。支持与 PyPy 结合使用以进一步提升性能。
2. **可靠性**：框架注重稳定性，避免破坏性更改，并严格测试代码。
3. **可扩展性**：Falcon 不依赖魔法全局变量，允许开发者自由定制和扩展。
4. **支持协议**：支持 ASGI、WSGI 和 WebSocket，提供原生的 asyncio 支持。
5. **错误处理**：Falcon 不自动处理未捕获的异常，推荐在资源处理中实现错误处理。

#### 安装与兼容性
- **Python 版本**：
- 支持 Python 3.8 和 3.9。
- Python 3.6+ 仅在使用新 ASGI 接口时需要，WSGI 仍支持 Python 3.5+。
- Python 3.5 支持已弃用，3.4 不再支持。
- 移除了对 CPython 2.7 和 PyPy2.7 的支持。

#### 许可证
Falcon 采用 Apache 2.0 许可证，适合商业应用，允许用户自由使用框架而不必开源其代码。

#### 主要变更
- **3.1.1 版本更新**：
- 修复了与无效或空 Forwarded 标头处理相关的 IndexError。
- 修复了 ASGI 版本中使用或-json 库的问题。
- 支持 CPython 3.11。
- **3.0 版本更新**：
- 移除了 `OptionalRepresentation` 和 `NoRepresentation` 类。
- 默认错误序列化器为所有 `falcon.HTTPError` 子类生成表示。
- 测试环境中的默认 `User-Agent` 和 `create_environ()` 函数的参数重命名。

#### 使用情况
Falcon 被广泛应用于多个组织，包括 Rackspace、OpenStack 等。

#### 文档与资源
- 提供详细的用户指南和教程。
- 社区扩展和工具（如 API 文档生成器）可通过 [Falcon Add-on Catalog](https://github.com/falconry/falcon/wiki/Add-on-Catalog) 获取。

总结：Falcon 是一个高效、可靠且灵活的框架，适合构建大规模微服务和 REST API，支持多种协议和 Python 版本，注重性能和可扩展性。