Falcon v3.1.1-rc1 Documentation

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

摘要

文档介绍了Falcon Web Framework的版本v3.1.1-rc1的更新内容。Falcon是一个极简主义的ASGI/WSGI框架，专注于构建可靠、高效的REST API和微服务。该版本主要包含错误修复和一些改进，例如Request属性的更严格验证、Response属性的新增、测试客户端的改进以及对CPython 3.11的支持。同时，Python 3.5和3.6的支持已被弃用，并将在后续版本中移除。

AI总结

以下是对《Falcon v3.1.1-rc1 Documentation》的中文总结，语言简洁明了，突出核心观点和关键信息：

---

### Falcon框架概述
Falcon是一款极简主义的ASGI/WSGI框架，专注于构建可靠、高效的REST APIs和微服务。它遵循REST架构风格，强调“少即是多”的设计理念。Falcon的目标是在保持高效的同时，确保在大规模应用中表现卓越。

#### 快速入门示例
通过以下代码可以快速创建一个REST API：

class QuoteResource:
    def on_get(self, req, resp):
        """处理GET请求"""
        quote = {
            'quote': "I've always been more interested in the future than in the past.",
            'author': 'Grace Hopper'
        }
        resp.media = quote

app = falcon.App()
app.add_route('/quote', QuoteResource())

#### 文档与资源
- [官方文档](https://falcon.readthedocs.io/en/stable)
- [FAQ](https://falcon.readthedocs.io/en/stable/user/faq.html)
- [获取帮助](https://falcon.readthedocs.io/en/stable/community/help.html)
- [扩展包与工具](https://github.com/falconry/falcon/wiki)

---

### Changelog（版本更新）
#### Falcon 3.1.1-rc1
- **错误修复**：
- 修复了`Forwarded`头部解析中的`IndexError`问题。
- 修复了在ASGI模式下使用`orjson`库作为JSON序列化器时的兼容性问题。
- **平台支持**：
- 现在支持CPython 3.11（完整支持将在Falcon 4.0中正式化）。
- Python 3.5和3.6已经弃用，将在Falcon 4.0中移除。

#### Falcon 3.1.0
- **新增与改进**：
- 增加了对`get_param_as_dict()`的支持，使JSON查询参数解析更高效。
- `TestClient`和`ASGIConductor`提供了简化的方法别名（如`simulate_get()`现在也可通过`get()`调用）。
- 修复了响应流不正确关闭和请求流Chunked Transfer Encoding挂起的问题。
- **平台支持**：
- 支持CPython 3.10。
- 弃用了Python 3.6。

#### Falcon 3.0.1
- **错误修复**：
- 恢复了`api_helpers`模块（已弃用，但在4.0版本中移除）。
- 修复了ASGI与WSGI头部编码兼容性问题。

#### Falcon 1.1.0
- **新增与改进**：
- 增加了`bounded_stream`属性，减少某些WSGI服务器的阻塞行为。
- 支持JSON查询参数的CSV风格解析可选。
- 增加了`accept_ranges`属性以设置`Accept-Ranges`头部。
- 扩展了`HTTPError`的默认标题支持。

#### Falcon 1.0.0
- **破坏性变更**：
- 移除了全局钩子功能，建议使用中间件替代。
- 默认停用了自动解析“application/x-www-form-urlencoded”请求体。

#### Falcon 0.3.0
- **新增与改进**：
- 支持自定义路由架构和URI模板参数。
- 增加了对日期头部的支持（返回`datetime`对象）。
- 支持Jython 2.7。

---

### Falcon框架的主要特点
1. **极简设计**：Falcon注重“少即是多”，提供核心功能，避免不必要的复杂性。
2. **高性能与可靠性**：专注于大规模应用的性能和稳定性。
3. **灵活性与扩展性**：支持自定义路由、中间件和媒体处理器。
4. **与现代Python兼容**：支持最新的CPython版本（3.10、3.11），逐步弃用旧版本。

---

### 贡献者
感谢以下贡献者：
- CaselIT
- kgriffs
- TBoshoven
- vytas7

---

Falcon框架通过其简洁的设计和高效的性能，适合构建mission-critical REST APIs和微服务。