Falcon v1.4.1-post-1 Documentation

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

摘要

文档详细记录了Falcon框架的版本更新日志，包括新功能、改进和问题修复。主要内容涵盖Falcon 1.4.1、1.4.0、1.3.0等多个版本的更新，涉及路由改进、性能优化、新功能添加、中间件处理、错误处理以及文档修正等方面。

AI总结

以下是《Falcon v1.4.1-post-1 Documentation》的中文总结：

---

### **Falcon v1.4.1 更新日志**
#### **主要更新**
1. **新功能**：
- `bounded_stream` 属性：解决WSGI服务器的阻塞行为。
- `uri_template` 属性：暴露请求的路由模板。
- `Response.context` 属性：与`Request`对齐。
- `get_param_as_dict()`：支持一步获取和解码JSON查询参数。
- 支持关闭CSV风格的查询参数解析。
- `get_param_as_bool()`：新增对“on”和“off”的支持。
- `Response.accept_ranges` 属性：便于设置`Accept-Ranges`头。
- 新增`HTTPUriTooLong`和`HTTPGone`错误类。
- 错误标题默认使用HTTP状态文本。
- 错误类参数默认可选。

2. **文档改进**：
- Cookie文档澄清和扩展。
- 测试框架新增`Cookie`类和`Result.cookie`属性。

3. **其他**：
- 安装时不再显示`note`。
- 修复文档中的错误。

---

### **Falcon v1.4.0 更新日志**
#### **主要更新**
1. **Breaking Changes**：
- `falcon.testing.Result.json`在响应为空时返回`None`，而非报错。

2. **平台支持**：
- 支持PyPy3.5 v5.10的Python 3。
- CPython 3.3即将弃用，Python 2.6和Jython 2.7继续弃用。

3. **新功能**：
- 新增静态路由：`add_static_route()`便于从本地目录服务文件。
- 钩子支持传递参数。
- 默认使用`ujson`加速JSON处理。
- 新增`get_param_as_uuid()`。
- 支持WebDAV方法（如`UPDATE`和`REPORT`）。
- `Response.downloadable_as`属性：设置`Content-Disposition`头。
- 路由方法重构：`map_http_methods()`和`set_default_responders()`。

4. **改进**：
- 测试框架的`simulate_request()`支持自动 sanitize请求正文。

---

### **Falcon v1.3.0 更新日志**
#### **主要更新**
1. **新功能**：
- 媒体类型常量：便于设置和检查内容类型。
- 字段转换器支持：增强URI模板字段处理。
- 新增`get_param_as_datetime()`。
- `Request`新增`forwarded`、`forwarded_uri`、`forwarded_scheme`、`forwarded_host`、`forwarded_prefix`和`prefix`属性。
- 新增`Request.referer`属性。
- 实现`__repr__()`便于调试。
- 新增多个5xx错误类。

2. **改进**：
- 请求解析改进：跳过解析错误的Cookie（尽力而为）。
- CPython 3.6完全支持。

---

### **Falcon v1.2.0 更新日志**
#### **主要更新**
1. **新功能**：
- 默认参数新增到`get_header()`。
- `Response.delete_header()`：支持删除响应头。
- 新增多个HTTP状态码和错误类（如`HTTPFailedDependency`）。
- 使用`ujson`加速JSON处理（CPython）。
- 新增`independent_middleware`选项：执行`process_response`中间件，即使`process_request`报错。
- 单字母字段名支持：URL模板中允许单字母参数。

2. **改进**：
- 冲突路由检测：返回详细错误信息。
- 测试框架支持指定协议版本。
- 新增`ResponseOptions`和`secure_cookies_by_default`选项。

3. **其他**：
- 默认移除`strip_url_path_trailing_slash`选项，改为可配置。

---

### **Falcon v1.1.0 更新日志**
#### **主要更新**
1. **新功能**：
- `bounded_stream`、`uri_template`、`context`属性。
- `get_param_as_dict()`和`get_param_as_bool()`改进。
- 新增`HTTPUriTooLong`和`HTTPGone`错误类。
- 错误标题默认使用HTTP状态文本。
- 错误类参数默认可选。
- Cookie文档扩展。

2. **改进**：
- 钩子支持：可传递参数。
- 性能优化：JSON处理和查询字符串解析改进。

3. **其他**：
- 修复文档错误。
- 解决README在PyPI上的渲染问题。

---

### **Falcon v0.3.0 更新日志**
#### **主要更新**
1. **Breaking Changes**：
- 日期头返回类型从字符串改为`datetime.datetime`对象。

2. **新功能**：
- 新路由架构：提升性能和灵活性。
- 支持自定义路由器。
- URI模板支持多参数字段。
- 支持读写Cookie。
- 支持Jython 2.7。
- 新增`get_param_as_date()`方法。

3. **改进**：
- 请求字符串解析改进：处理百分比编码数据。
- 文档修复：解决README渲染问题。

---

以上为《Falcon v1.4.1-post-1 Documentation》的核心内容总结，涵盖主要功能更新和改进。