Click Documentation Release 4.2.dev0

• 语言: 法语
• 格式: .pdf
• 来源: click.palletsprojects.com

摘要

文档记录了Click版本4.2.dev0的更新内容，包括新增功能如颜色支持、错误处理改进，以及修复的Bug。Click是一个用于创建命令行界面的Python包，支持命令嵌套、自动帮助生成和子命令懒加载。该版本还引入了多命令链式调用、默认值支持和进度条标签处理等功能。同时，文档展示了Click的使用示例，如选项处理、帮助页面自动生成和参数验证。

AI总结

# 《Click Documentation Release 4.2.dev0》总结

## 概述
Click是一款专注于通过尽可能少的代码创建优美命令行界面的Python包。它支持灵活的命令嵌套、自动生成帮助页面，并支持子命令的运行时懒加载。Click旨在快速构建命令行工具，同时避免因无法实现预期的CLI API而带来的挫败感。

## 新增功能
1. **支持多命令链**：允许多个命令在一条命令中链式调用。
2. **支持默认值**：对多选项参数和nargs不等于1的参数提供默认值支持。
3. **错误处理改进**：
- 主方法的独立模式可以禁用，以更好地处理错误。
- 测试系统中增加了不吞噬异常的功能。
4. **色彩与进度条**：
- 增强了对颜色支持的对齐，支持重写自动检测。
- 进度条标签渲染时保留空白字符。
5. **自动化帮助优化**：
- 自动短帮助检测更好地处理不以句号结尾的句子。
- 选项定义时，若无有效选项字符串，Click将报错而非默默忽略。
6. **内部架构优化**：
- Click内部重组以支持vendoring。
- 支持从命令回调返回值。
7. **其他改进**：
- 增加了`open_file`功能。
- 简化了通过`echo`向stderr打印的操作。

## 错误修复
1. **Version 4.1（2015年7月14日发布）**：
- 修复了错误消息中包含尾随`None`的问题。
- 修复了Click在docstring后带有换行符时崩溃的问题。
2. **Version 2.6（2014年8月11日发布）**：
- 修复了Python 3上包装流报告不正确的`seekable`值。
3. **Version 2.5（2014年7月28日发布）**：
- 修复了Python 3上的文本换行问题。
4. **Version 2.4（2014年7月4日发布）**：
- 更正了2.3版本中帮助选项的修改问题。
5. **Version 2.3（2014年7月3日发布）**：
- 修复了计数选项的帮助记录格式错误。

## 其他改进
- **支持多平台颜色代码**：在Windows上，如果没有colorama，支持剥离ANSI代码。
- **Context上下文改进**：多次进入上下文时，清理操作延迟到最后一次退出。

## API参考
- 新增：`result_callback`、`resultcallback()`、`runner`、`secho()`、`section()`、`split_envvar_value()`、`style()`、`terminal_width`、`token_normalize_func`、`type_cast_value()`、`write()`, `write_dl()`, `write_heading()`, `write_paragraph()`, `write_text()`和`write_usage()`等。