【跟小嘉学 Rust 编程】二十五、Rust命令行参数解析库(clap)

小嘉丶学长2023-09-05 21:32

系列文章目录

【跟小嘉学 Rust 编程】一、Rust 编程基础
【跟小嘉学 Rust 编程】二、Rust 包管理工具使用
【跟小嘉学 Rust 编程】三、Rust 的基本程序概念
【跟小嘉学 Rust 编程】四、理解 Rust 的所有权概念
【跟小嘉学 Rust 编程】五、使用结构体关联结构化数据
【跟小嘉学 Rust 编程】六、枚举和模式匹配
【跟小嘉学 Rust 编程】七、使用包(Packages)、单元包(Crates)和模块(Module)来管理项目
【跟小嘉学 Rust 编程】八、常见的集合
【跟小嘉学 Rust 编程】九、错误处理(Error Handling)
【跟小嘉学 Rust 编程】十一、编写自动化测试
【跟小嘉学 Rust 编程】十二、构建一个命令行程序
【跟小嘉学 Rust 编程】十三、函数式语言特性：迭代器和闭包
【跟小嘉学 Rust 编程】十四、关于 Cargo 和 Crates.io
【跟小嘉学 Rust 编程】十五、智能指针(Smart Point)
【跟小嘉学 Rust 编程】十六、无畏并发(Fearless Concurrency)
【跟小嘉学 Rust 编程】十七、面向对象语言特性
【跟小嘉学 Rust 编程】十八、模式匹配(Patterns and Matching)
【跟小嘉学 Rust 编程】十九、高级特性
【跟小嘉学 Rust 编程】二十、进阶扩展
【跟小嘉学 Rust 编程】二十一、网络编程
【跟小嘉学 Rust 编程】二十三、Cargo 使用指南
【跟小嘉学 Rust 编程】二十四、内联汇编(inline assembly)
【跟小嘉学 Rust 编程】二十五、Rust命令行参数解析库(clap)

### 文章目录

  • [系列文章目录](#文章目录 系列文章目录 @TOC 前言 一、 Clap 使用方式一：build构建 1.1、引入 clap 库 1.2、快速启动 1.3、配置解析器(Configuring the Parser) 1.3.1、使用 Command 构建解析器 1.3.2、使用 command! 构建解析器 1.3.2、使用 Command::next_line_help 方法 1.4、添加命令行参数(Adding Arguments) 1.4、设置参数行为 1.5、参数选项 1.5.1、参数选项 1.5.2、开启/关闭标志 1.5.3、参数调用计数 1.5.4、默认值 1.5.5、参数校验 1.5.5.1、默认情况 1.5.5.2、枚举值(Enumerated values) 1.5.5.3、校验值(Validated values) 1.5.5.4、自定义解析器(Custom Parser) 1.5.5.5、参数关系(Argument Relations) 1.5.5.6、自定义校验(Custom Validation) 1.6、子命令(Subcommand) 1.7、测试 二、 Clap 使用方式二：derive feature 2.1、添加依赖 2.2、快速开始 2.3、配置解析器 2.3.1、配置解析器 2.3.2、默认值 2.3.3、Command::next_line_help 替代 2.4、添加参数 2.4.1、添加可选参数 2.4.2、添加多值参数 2.4.3、参数选项 2.4.3.1、短参数名称和长参数名称 2.4.3.2、开启和关闭 2.4.3.3、参数计数 2.4.3.4、参数默认值 2.4.3.5、参数枚举 2.4.3.6、参数校验 2.4.3.7、自定义解析 2.4.3.8、参数关系 2.4.3.9、自定义校验 2.5、子命令 三、如何选择 总结)
  • [@[TOC](文章目录)](#文章目录 系列文章目录 @TOC 前言 一、 Clap 使用方式一：build构建 1.1、引入 clap 库 1.2、快速启动 1.3、配置解析器(Configuring the Parser) 1.3.1、使用 Command 构建解析器 1.3.2、使用 command! 构建解析器 1.3.2、使用 Command::next_line_help 方法 1.4、添加命令行参数(Adding Arguments) 1.4、设置参数行为 1.5、参数选项 1.5.1、参数选项 1.5.2、开启/关闭标志 1.5.3、参数调用计数 1.5.4、默认值 1.5.5、参数校验 1.5.5.1、默认情况 1.5.5.2、枚举值(Enumerated values) 1.5.5.3、校验值(Validated values) 1.5.5.4、自定义解析器(Custom Parser) 1.5.5.5、参数关系(Argument Relations) 1.5.5.6、自定义校验(Custom Validation) 1.6、子命令(Subcommand) 1.7、测试 二、 Clap 使用方式二：derive feature 2.1、添加依赖 2.2、快速开始 2.3、配置解析器 2.3.1、配置解析器 2.3.2、默认值 2.3.3、Command::next_line_help 替代 2.4、添加参数 2.4.1、添加可选参数 2.4.2、添加多值参数 2.4.3、参数选项 2.4.3.1、短参数名称和长参数名称 2.4.3.2、开启和关闭 2.4.3.3、参数计数 2.4.3.4、参数默认值 2.4.3.5、参数枚举 2.4.3.6、参数校验 2.4.3.7、自定义解析 2.4.3.8、参数关系 2.4.3.9、自定义校验 2.5、子命令 三、如何选择 总结)
  • [前言](#文章目录 系列文章目录 @TOC 前言 一、 Clap 使用方式一：build构建 1.1、引入 clap 库 1.2、快速启动 1.3、配置解析器(Configuring the Parser) 1.3.1、使用 Command 构建解析器 1.3.2、使用 command! 构建解析器 1.3.2、使用 Command::next_line_help 方法 1.4、添加命令行参数(Adding Arguments) 1.4、设置参数行为 1.5、参数选项 1.5.1、参数选项 1.5.2、开启/关闭标志 1.5.3、参数调用计数 1.5.4、默认值 1.5.5、参数校验 1.5.5.1、默认情况 1.5.5.2、枚举值(Enumerated values) 1.5.5.3、校验值(Validated values) 1.5.5.4、自定义解析器(Custom Parser) 1.5.5.5、参数关系(Argument Relations) 1.5.5.6、自定义校验(Custom Validation) 1.6、子命令(Subcommand) 1.7、测试 二、 Clap 使用方式二：derive feature 2.1、添加依赖 2.2、快速开始 2.3、配置解析器 2.3.1、配置解析器 2.3.2、默认值 2.3.3、Command::next_line_help 替代 2.4、添加参数 2.4.1、添加可选参数 2.4.2、添加多值参数 2.4.3、参数选项 2.4.3.1、短参数名称和长参数名称 2.4.3.2、开启和关闭 2.4.3.3、参数计数 2.4.3.4、参数默认值 2.4.3.5、参数枚举 2.4.3.6、参数校验 2.4.3.7、自定义解析 2.4.3.8、参数关系 2.4.3.9、自定义校验 2.5、子命令 三、如何选择 总结)
  • [一、 Clap 使用方式一：build构建](#文章目录 系列文章目录 @TOC 前言 一、 Clap 使用方式一：build构建 1.1、引入 clap 库 1.2、快速启动 1.3、配置解析器(Configuring the Parser) 1.3.1、使用 Command 构建解析器 1.3.2、使用 command! 构建解析器 1.3.2、使用 Command::next_line_help 方法 1.4、添加命令行参数(Adding Arguments) 1.4、设置参数行为 1.5、参数选项 1.5.1、参数选项 1.5.2、开启/关闭标志 1.5.3、参数调用计数 1.5.4、默认值 1.5.5、参数校验 1.5.5.1、默认情况 1.5.5.2、枚举值(Enumerated values) 1.5.5.3、校验值(Validated values) 1.5.5.4、自定义解析器(Custom Parser) 1.5.5.5、参数关系(Argument Relations) 1.5.5.6、自定义校验(Custom Validation) 1.6、子命令(Subcommand) 1.7、测试 二、 Clap 使用方式二：derive feature 2.1、添加依赖 2.2、快速开始 2.3、配置解析器 2.3.1、配置解析器 2.3.2、默认值 2.3.3、Command::next_line_help 替代 2.4、添加参数 2.4.1、添加可选参数 2.4.2、添加多值参数 2.4.3、参数选项 2.4.3.1、短参数名称和长参数名称 2.4.3.2、开启和关闭 2.4.3.3、参数计数 2.4.3.4、参数默认值 2.4.3.5、参数枚举 2.4.3.6、参数校验 2.4.3.7、自定义解析 2.4.3.8、参数关系 2.4.3.9、自定义校验 2.5、子命令 三、如何选择 总结)
  • [1.1、引入 clap 库](#文章目录 系列文章目录 @TOC 前言 一、 Clap 使用方式一：build构建 1.1、引入 clap 库 1.2、快速启动 1.3、配置解析器(Configuring the Parser) 1.3.1、使用 Command 构建解析器 1.3.2、使用 command! 构建解析器 1.3.2、使用 Command::next_line_help 方法 1.4、添加命令行参数(Adding Arguments) 1.4、设置参数行为 1.5、参数选项 1.5.1、参数选项 1.5.2、开启/关闭标志 1.5.3、参数调用计数 1.5.4、默认值 1.5.5、参数校验 1.5.5.1、默认情况 1.5.5.2、枚举值(Enumerated values) 1.5.5.3、校验值(Validated values) 1.5.5.4、自定义解析器(Custom Parser) 1.5.5.5、参数关系(Argument Relations) 1.5.5.6、自定义校验(Custom Validation) 1.6、子命令(Subcommand) 1.7、测试 二、 Clap 使用方式二：derive feature 2.1、添加依赖 2.2、快速开始 2.3、配置解析器 2.3.1、配置解析器 2.3.2、默认值 2.3.3、Command::next_line_help 替代 2.4、添加参数 2.4.1、添加可选参数 2.4.2、添加多值参数 2.4.3、参数选项 2.4.3.1、短参数名称和长参数名称 2.4.3.2、开启和关闭 2.4.3.3、参数计数 2.4.3.4、参数默认值 2.4.3.5、参数枚举 2.4.3.6、参数校验 2.4.3.7、自定义解析 2.4.3.8、参数关系 2.4.3.9、自定义校验 2.5、子命令 三、如何选择 总结)
  • [1.2、快速启动](#文章目录 系列文章目录 @TOC 前言 一、 Clap 使用方式一：build构建 1.1、引入 clap 库 1.2、快速启动 1.3、配置解析器(Configuring the Parser) 1.3.1、使用 Command 构建解析器 1.3.2、使用 command! 构建解析器 1.3.2、使用 Command::next_line_help 方法 1.4、添加命令行参数(Adding Arguments) 1.4、设置参数行为 1.5、参数选项 1.5.1、参数选项 1.5.2、开启/关闭标志 1.5.3、参数调用计数 1.5.4、默认值 1.5.5、参数校验 1.5.5.1、默认情况 1.5.5.2、枚举值(Enumerated values) 1.5.5.3、校验值(Validated values) 1.5.5.4、自定义解析器(Custom Parser) 1.5.5.5、参数关系(Argument Relations) 1.5.5.6、自定义校验(Custom Validation) 1.6、子命令(Subcommand) 1.7、测试 二、 Clap 使用方式二：derive feature 2.1、添加依赖 2.2、快速开始 2.3、配置解析器 2.3.1、配置解析器 2.3.2、默认值 2.3.3、Command::next_line_help 替代 2.4、添加参数 2.4.1、添加可选参数 2.4.2、添加多值参数 2.4.3、参数选项 2.4.3.1、短参数名称和长参数名称 2.4.3.2、开启和关闭 2.4.3.3、参数计数 2.4.3.4、参数默认值 2.4.3.5、参数枚举 2.4.3.6、参数校验 2.4.3.7、自定义解析 2.4.3.8、参数关系 2.4.3.9、自定义校验 2.5、子命令 三、如何选择 总结)
  • [1.3、配置解析器(Configuring the Parser)](#文章目录 系列文章目录 @TOC 前言 一、 Clap 使用方式一：build构建 1.1、引入 clap 库 1.2、快速启动 1.3、配置解析器(Configuring the Parser) 1.3.1、使用 Command 构建解析器 1.3.2、使用 command! 构建解析器 1.3.2、使用 Command::next_line_help 方法 1.4、添加命令行参数(Adding Arguments) 1.4、设置参数行为 1.5、参数选项 1.5.1、参数选项 1.5.2、开启/关闭标志 1.5.3、参数调用计数 1.5.4、默认值 1.5.5、参数校验 1.5.5.1、默认情况 1.5.5.2、枚举值(Enumerated values) 1.5.5.3、校验值(Validated values) 1.5.5.4、自定义解析器(Custom Parser) 1.5.5.5、参数关系(Argument Relations) 1.5.5.6、自定义校验(Custom Validation) 1.6、子命令(Subcommand) 1.7、测试 二、 Clap 使用方式二：derive feature 2.1、添加依赖 2.2、快速开始 2.3、配置解析器 2.3.1、配置解析器 2.3.2、默认值 2.3.3、Command::next_line_help 替代 2.4、添加参数 2.4.1、添加可选参数 2.4.2、添加多值参数 2.4.3、参数选项 2.4.3.1、短参数名称和长参数名称 2.4.3.2、开启和关闭 2.4.3.3、参数计数 2.4.3.4、参数默认值 2.4.3.5、参数枚举 2.4.3.6、参数校验 2.4.3.7、自定义解析 2.4.3.8、参数关系 2.4.3.9、自定义校验 2.5、子命令 三、如何选择 总结)
  • [1.3.1、使用 Command 构建解析器](#文章目录 系列文章目录 @TOC 前言 一、 Clap 使用方式一：build构建 1.1、引入 clap 库 1.2、快速启动 1.3、配置解析器(Configuring the Parser) 1.3.1、使用 Command 构建解析器 1.3.2、使用 command! 构建解析器 1.3.2、使用 Command::next_line_help 方法 1.4、添加命令行参数(Adding Arguments) 1.4、设置参数行为 1.5、参数选项 1.5.1、参数选项 1.5.2、开启/关闭标志 1.5.3、参数调用计数 1.5.4、默认值 1.5.5、参数校验 1.5.5.1、默认情况 1.5.5.2、枚举值(Enumerated values) 1.5.5.3、校验值(Validated values) 1.5.5.4、自定义解析器(Custom Parser) 1.5.5.5、参数关系(Argument Relations) 1.5.5.6、自定义校验(Custom Validation) 1.6、子命令(Subcommand) 1.7、测试 二、 Clap 使用方式二：derive feature 2.1、添加依赖 2.2、快速开始 2.3、配置解析器 2.3.1、配置解析器 2.3.2、默认值 2.3.3、Command::next_line_help 替代 2.4、添加参数 2.4.1、添加可选参数 2.4.2、添加多值参数 2.4.3、参数选项 2.4.3.1、短参数名称和长参数名称 2.4.3.2、开启和关闭 2.4.3.3、参数计数 2.4.3.4、参数默认值 2.4.3.5、参数枚举 2.4.3.6、参数校验 2.4.3.7、自定义解析 2.4.3.8、参数关系 2.4.3.9、自定义校验 2.5、子命令 三、如何选择 总结)
  • [1.3.2、使用 command! 构建解析器](#文章目录 系列文章目录 @TOC 前言 一、 Clap 使用方式一：build构建 1.1、引入 clap 库 1.2、快速启动 1.3、配置解析器(Configuring the Parser) 1.3.1、使用 Command 构建解析器 1.3.2、使用 command! 构建解析器 1.3.2、使用 Command::next_line_help 方法 1.4、添加命令行参数(Adding Arguments) 1.4、设置参数行为 1.5、参数选项 1.5.1、参数选项 1.5.2、开启/关闭标志 1.5.3、参数调用计数 1.5.4、默认值 1.5.5、参数校验 1.5.5.1、默认情况 1.5.5.2、枚举值(Enumerated values) 1.5.5.3、校验值(Validated values) 1.5.5.4、自定义解析器(Custom Parser) 1.5.5.5、参数关系(Argument Relations) 1.5.5.6、自定义校验(Custom Validation) 1.6、子命令(Subcommand) 1.7、测试 二、 Clap 使用方式二：derive feature 2.1、添加依赖 2.2、快速开始 2.3、配置解析器 2.3.1、配置解析器 2.3.2、默认值 2.3.3、Command::next_line_help 替代 2.4、添加参数 2.4.1、添加可选参数 2.4.2、添加多值参数 2.4.3、参数选项 2.4.3.1、短参数名称和长参数名称 2.4.3.2、开启和关闭 2.4.3.3、参数计数 2.4.3.4、参数默认值 2.4.3.5、参数枚举 2.4.3.6、参数校验 2.4.3.7、自定义解析 2.4.3.8、参数关系 2.4.3.9、自定义校验 2.5、子命令 三、如何选择 总结)
  • [1.3.2、使用 Command::next_line_help 方法](#文章目录 系列文章目录 @TOC 前言 一、 Clap 使用方式一：build构建 1.1、引入 clap 库 1.2、快速启动 1.3、配置解析器(Configuring the Parser) 1.3.1、使用 Command 构建解析器 1.3.2、使用 command! 构建解析器 1.3.2、使用 Command::next_line_help 方法 1.4、添加命令行参数(Adding Arguments) 1.4、设置参数行为 1.5、参数选项 1.5.1、参数选项 1.5.2、开启/关闭标志 1.5.3、参数调用计数 1.5.4、默认值 1.5.5、参数校验 1.5.5.1、默认情况 1.5.5.2、枚举值(Enumerated values) 1.5.5.3、校验值(Validated values) 1.5.5.4、自定义解析器(Custom Parser) 1.5.5.5、参数关系(Argument Relations) 1.5.5.6、自定义校验(Custom Validation) 1.6、子命令(Subcommand) 1.7、测试 二、 Clap 使用方式二：derive feature 2.1、添加依赖 2.2、快速开始 2.3、配置解析器 2.3.1、配置解析器 2.3.2、默认值 2.3.3、Command::next_line_help 替代 2.4、添加参数 2.4.1、添加可选参数 2.4.2、添加多值参数 2.4.3、参数选项 2.4.3.1、短参数名称和长参数名称 2.4.3.2、开启和关闭 2.4.3.3、参数计数 2.4.3.4、参数默认值 2.4.3.5、参数枚举 2.4.3.6、参数校验 2.4.3.7、自定义解析 2.4.3.8、参数关系 2.4.3.9、自定义校验 2.5、子命令 三、如何选择 总结)
  • [1.4、添加命令行参数(Adding Arguments)](#文章目录 系列文章目录 @TOC 前言 一、 Clap 使用方式一：build构建 1.1、引入 clap 库 1.2、快速启动 1.3、配置解析器(Configuring the Parser) 1.3.1、使用 Command 构建解析器 1.3.2、使用 command! 构建解析器 1.3.2、使用 Command::next_line_help 方法 1.4、添加命令行参数(Adding Arguments) 1.4、设置参数行为 1.5、参数选项 1.5.1、参数选项 1.5.2、开启/关闭标志 1.5.3、参数调用计数 1.5.4、默认值 1.5.5、参数校验 1.5.5.1、默认情况 1.5.5.2、枚举值(Enumerated values) 1.5.5.3、校验值(Validated values) 1.5.5.4、自定义解析器(Custom Parser) 1.5.5.5、参数关系(Argument Relations) 1.5.5.6、自定义校验(Custom Validation) 1.6、子命令(Subcommand) 1.7、测试 二、 Clap 使用方式二：derive feature 2.1、添加依赖 2.2、快速开始 2.3、配置解析器 2.3.1、配置解析器 2.3.2、默认值 2.3.3、Command::next_line_help 替代 2.4、添加参数 2.4.1、添加可选参数 2.4.2、添加多值参数 2.4.3、参数选项 2.4.3.1、短参数名称和长参数名称 2.4.3.2、开启和关闭 2.4.3.3、参数计数 2.4.3.4、参数默认值 2.4.3.5、参数枚举 2.4.3.6、参数校验 2.4.3.7、自定义解析 2.4.3.8、参数关系 2.4.3.9、自定义校验 2.5、子命令 三、如何选择 总结)
  • [1.4、设置参数行为](#文章目录 系列文章目录 @TOC 前言 一、 Clap 使用方式一：build构建 1.1、引入 clap 库 1.2、快速启动 1.3、配置解析器(Configuring the Parser) 1.3.1、使用 Command 构建解析器 1.3.2、使用 command! 构建解析器 1.3.2、使用 Command::next_line_help 方法 1.4、添加命令行参数(Adding Arguments) 1.4、设置参数行为 1.5、参数选项 1.5.1、参数选项 1.5.2、开启/关闭标志 1.5.3、参数调用计数 1.5.4、默认值 1.5.5、参数校验 1.5.5.1、默认情况 1.5.5.2、枚举值(Enumerated values) 1.5.5.3、校验值(Validated values) 1.5.5.4、自定义解析器(Custom Parser) 1.5.5.5、参数关系(Argument Relations) 1.5.5.6、自定义校验(Custom Validation) 1.6、子命令(Subcommand) 1.7、测试 二、 Clap 使用方式二：derive feature 2.1、添加依赖 2.2、快速开始 2.3、配置解析器 2.3.1、配置解析器 2.3.2、默认值 2.3.3、Command::next_line_help 替代 2.4、添加参数 2.4.1、添加可选参数 2.4.2、添加多值参数 2.4.3、参数选项 2.4.3.1、短参数名称和长参数名称 2.4.3.2、开启和关闭 2.4.3.3、参数计数 2.4.3.4、参数默认值 2.4.3.5、参数枚举 2.4.3.6、参数校验 2.4.3.7、自定义解析 2.4.3.8、参数关系 2.4.3.9、自定义校验 2.5、子命令 三、如何选择 总结)
  • [1.5、参数选项](#文章目录 系列文章目录 @TOC 前言 一、 Clap 使用方式一：build构建 1.1、引入 clap 库 1.2、快速启动 1.3、配置解析器(Configuring the Parser) 1.3.1、使用 Command 构建解析器 1.3.2、使用 command! 构建解析器 1.3.2、使用 Command::next_line_help 方法 1.4、添加命令行参数(Adding Arguments) 1.4、设置参数行为 1.5、参数选项 1.5.1、参数选项 1.5.2、开启/关闭标志 1.5.3、参数调用计数 1.5.4、默认值 1.5.5、参数校验 1.5.5.1、默认情况 1.5.5.2、枚举值(Enumerated values) 1.5.5.3、校验值(Validated values) 1.5.5.4、自定义解析器(Custom Parser) 1.5.5.5、参数关系(Argument Relations) 1.5.5.6、自定义校验(Custom Validation) 1.6、子命令(Subcommand) 1.7、测试 二、 Clap 使用方式二：derive feature 2.1、添加依赖 2.2、快速开始 2.3、配置解析器 2.3.1、配置解析器 2.3.2、默认值 2.3.3、Command::next_line_help 替代 2.4、添加参数 2.4.1、添加可选参数 2.4.2、添加多值参数 2.4.3、参数选项 2.4.3.1、短参数名称和长参数名称 2.4.3.2、开启和关闭 2.4.3.3、参数计数 2.4.3.4、参数默认值 2.4.3.5、参数枚举 2.4.3.6、参数校验 2.4.3.7、自定义解析 2.4.3.8、参数关系 2.4.3.9、自定义校验 2.5、子命令 三、如何选择 总结)
  • [1.5.1、参数选项](#文章目录 系列文章目录 @TOC 前言 一、 Clap 使用方式一：build构建 1.1、引入 clap 库 1.2、快速启动 1.3、配置解析器(Configuring the Parser) 1.3.1、使用 Command 构建解析器 1.3.2、使用 command! 构建解析器 1.3.2、使用 Command::next_line_help 方法 1.4、添加命令行参数(Adding Arguments) 1.4、设置参数行为 1.5、参数选项 1.5.1、参数选项 1.5.2、开启/关闭标志 1.5.3、参数调用计数 1.5.4、默认值 1.5.5、参数校验 1.5.5.1、默认情况 1.5.5.2、枚举值(Enumerated values) 1.5.5.3、校验值(Validated values) 1.5.5.4、自定义解析器(Custom Parser) 1.5.5.5、参数关系(Argument Relations) 1.5.5.6、自定义校验(Custom Validation) 1.6、子命令(Subcommand) 1.7、测试 二、 Clap 使用方式二：derive feature 2.1、添加依赖 2.2、快速开始 2.3、配置解析器 2.3.1、配置解析器 2.3.2、默认值 2.3.3、Command::next_line_help 替代 2.4、添加参数 2.4.1、添加可选参数 2.4.2、添加多值参数 2.4.3、参数选项 2.4.3.1、短参数名称和长参数名称 2.4.3.2、开启和关闭 2.4.3.3、参数计数 2.4.3.4、参数默认值 2.4.3.5、参数枚举 2.4.3.6、参数校验 2.4.3.7、自定义解析 2.4.3.8、参数关系 2.4.3.9、自定义校验 2.5、子命令 三、如何选择 总结)
  • [1.5.2、开启/关闭标志](#文章目录 系列文章目录 @TOC 前言 一、 Clap 使用方式一：build构建 1.1、引入 clap 库 1.2、快速启动 1.3、配置解析器(Configuring the Parser) 1.3.1、使用 Command 构建解析器 1.3.2、使用 command! 构建解析器 1.3.2、使用 Command::next_line_help 方法 1.4、添加命令行参数(Adding Arguments) 1.4、设置参数行为 1.5、参数选项 1.5.1、参数选项 1.5.2、开启/关闭标志 1.5.3、参数调用计数 1.5.4、默认值 1.5.5、参数校验 1.5.5.1、默认情况 1.5.5.2、枚举值(Enumerated values) 1.5.5.3、校验值(Validated values) 1.5.5.4、自定义解析器(Custom Parser) 1.5.5.5、参数关系(Argument Relations) 1.5.5.6、自定义校验(Custom Validation) 1.6、子命令(Subcommand) 1.7、测试 二、 Clap 使用方式二：derive feature 2.1、添加依赖 2.2、快速开始 2.3、配置解析器 2.3.1、配置解析器 2.3.2、默认值 2.3.3、Command::next_line_help 替代 2.4、添加参数 2.4.1、添加可选参数 2.4.2、添加多值参数 2.4.3、参数选项 2.4.3.1、短参数名称和长参数名称 2.4.3.2、开启和关闭 2.4.3.3、参数计数 2.4.3.4、参数默认值 2.4.3.5、参数枚举 2.4.3.6、参数校验 2.4.3.7、自定义解析 2.4.3.8、参数关系 2.4.3.9、自定义校验 2.5、子命令 三、如何选择 总结)
  • [1.5.3、参数调用计数](#文章目录 系列文章目录 @TOC 前言 一、 Clap 使用方式一：build构建 1.1、引入 clap 库 1.2、快速启动 1.3、配置解析器(Configuring the Parser) 1.3.1、使用 Command 构建解析器 1.3.2、使用 command! 构建解析器 1.3.2、使用 Command::next_line_help 方法 1.4、添加命令行参数(Adding Arguments) 1.4、设置参数行为 1.5、参数选项 1.5.1、参数选项 1.5.2、开启/关闭标志 1.5.3、参数调用计数 1.5.4、默认值 1.5.5、参数校验 1.5.5.1、默认情况 1.5.5.2、枚举值(Enumerated values) 1.5.5.3、校验值(Validated values) 1.5.5.4、自定义解析器(Custom Parser) 1.5.5.5、参数关系(Argument Relations) 1.5.5.6、自定义校验(Custom Validation) 1.6、子命令(Subcommand) 1.7、测试 二、 Clap 使用方式二：derive feature 2.1、添加依赖 2.2、快速开始 2.3、配置解析器 2.3.1、配置解析器 2.3.2、默认值 2.3.3、Command::next_line_help 替代 2.4、添加参数 2.4.1、添加可选参数 2.4.2、添加多值参数 2.4.3、参数选项 2.4.3.1、短参数名称和长参数名称 2.4.3.2、开启和关闭 2.4.3.3、参数计数 2.4.3.4、参数默认值 2.4.3.5、参数枚举 2.4.3.6、参数校验 2.4.3.7、自定义解析 2.4.3.8、参数关系 2.4.3.9、自定义校验 2.5、子命令 三、如何选择 总结)
  • [1.5.4、默认值](#文章目录 系列文章目录 @TOC 前言 一、 Clap 使用方式一：build构建 1.1、引入 clap 库 1.2、快速启动 1.3、配置解析器(Configuring the Parser) 1.3.1、使用 Command 构建解析器 1.3.2、使用 command! 构建解析器 1.3.2、使用 Command::next_line_help 方法 1.4、添加命令行参数(Adding Arguments) 1.4、设置参数行为 1.5、参数选项 1.5.1、参数选项 1.5.2、开启/关闭标志 1.5.3、参数调用计数 1.5.4、默认值 1.5.5、参数校验 1.5.5.1、默认情况 1.5.5.2、枚举值(Enumerated values) 1.5.5.3、校验值(Validated values) 1.5.5.4、自定义解析器(Custom Parser) 1.5.5.5、参数关系(Argument Relations) 1.5.5.6、自定义校验(Custom Validation) 1.6、子命令(Subcommand) 1.7、测试 二、 Clap 使用方式二：derive feature 2.1、添加依赖 2.2、快速开始 2.3、配置解析器 2.3.1、配置解析器 2.3.2、默认值 2.3.3、Command::next_line_help 替代 2.4、添加参数 2.4.1、添加可选参数 2.4.2、添加多值参数 2.4.3、参数选项 2.4.3.1、短参数名称和长参数名称 2.4.3.2、开启和关闭 2.4.3.3、参数计数 2.4.3.4、参数默认值 2.4.3.5、参数枚举 2.4.3.6、参数校验 2.4.3.7、自定义解析 2.4.3.8、参数关系 2.4.3.9、自定义校验 2.5、子命令 三、如何选择 总结)
  • [1.5.5、参数校验](#文章目录 系列文章目录 @TOC 前言 一、 Clap 使用方式一：build构建 1.1、引入 clap 库 1.2、快速启动 1.3、配置解析器(Configuring the Parser) 1.3.1、使用 Command 构建解析器 1.3.2、使用 command! 构建解析器 1.3.2、使用 Command::next_line_help 方法 1.4、添加命令行参数(Adding Arguments) 1.4、设置参数行为 1.5、参数选项 1.5.1、参数选项 1.5.2、开启/关闭标志 1.5.3、参数调用计数 1.5.4、默认值 1.5.5、参数校验 1.5.5.1、默认情况 1.5.5.2、枚举值(Enumerated values) 1.5.5.3、校验值(Validated values) 1.5.5.4、自定义解析器(Custom Parser) 1.5.5.5、参数关系(Argument Relations) 1.5.5.6、自定义校验(Custom Validation) 1.6、子命令(Subcommand) 1.7、测试 二、 Clap 使用方式二：derive feature 2.1、添加依赖 2.2、快速开始 2.3、配置解析器 2.3.1、配置解析器 2.3.2、默认值 2.3.3、Command::next_line_help 替代 2.4、添加参数 2.4.1、添加可选参数 2.4.2、添加多值参数 2.4.3、参数选项 2.4.3.1、短参数名称和长参数名称 2.4.3.2、开启和关闭 2.4.3.3、参数计数 2.4.3.4、参数默认值 2.4.3.5、参数枚举 2.4.3.6、参数校验 2.4.3.7、自定义解析 2.4.3.8、参数关系 2.4.3.9、自定义校验 2.5、子命令 三、如何选择 总结)
  • [1.5.5.1、默认情况](#文章目录 系列文章目录 @TOC 前言 一、 Clap 使用方式一：build构建 1.1、引入 clap 库 1.2、快速启动 1.3、配置解析器(Configuring the Parser) 1.3.1、使用 Command 构建解析器 1.3.2、使用 command! 构建解析器 1.3.2、使用 Command::next_line_help 方法 1.4、添加命令行参数(Adding Arguments) 1.4、设置参数行为 1.5、参数选项 1.5.1、参数选项 1.5.2、开启/关闭标志 1.5.3、参数调用计数 1.5.4、默认值 1.5.5、参数校验 1.5.5.1、默认情况 1.5.5.2、枚举值(Enumerated values) 1.5.5.3、校验值(Validated values) 1.5.5.4、自定义解析器(Custom Parser) 1.5.5.5、参数关系(Argument Relations) 1.5.5.6、自定义校验(Custom Validation) 1.6、子命令(Subcommand) 1.7、测试 二、 Clap 使用方式二：derive feature 2.1、添加依赖 2.2、快速开始 2.3、配置解析器 2.3.1、配置解析器 2.3.2、默认值 2.3.3、Command::next_line_help 替代 2.4、添加参数 2.4.1、添加可选参数 2.4.2、添加多值参数 2.4.3、参数选项 2.4.3.1、短参数名称和长参数名称 2.4.3.2、开启和关闭 2.4.3.3、参数计数 2.4.3.4、参数默认值 2.4.3.5、参数枚举 2.4.3.6、参数校验 2.4.3.7、自定义解析 2.4.3.8、参数关系 2.4.3.9、自定义校验 2.5、子命令 三、如何选择 总结)
  • [1.5.5.2、枚举值(Enumerated values)](#文章目录 系列文章目录 @TOC 前言 一、 Clap 使用方式一：build构建 1.1、引入 clap 库 1.2、快速启动 1.3、配置解析器(Configuring the Parser) 1.3.1、使用 Command 构建解析器 1.3.2、使用 command! 构建解析器 1.3.2、使用 Command::next_line_help 方法 1.4、添加命令行参数(Adding Arguments) 1.4、设置参数行为 1.5、参数选项 1.5.1、参数选项 1.5.2、开启/关闭标志 1.5.3、参数调用计数 1.5.4、默认值 1.5.5、参数校验 1.5.5.1、默认情况 1.5.5.2、枚举值(Enumerated values) 1.5.5.3、校验值(Validated values) 1.5.5.4、自定义解析器(Custom Parser) 1.5.5.5、参数关系(Argument Relations) 1.5.5.6、自定义校验(Custom Validation) 1.6、子命令(Subcommand) 1.7、测试 二、 Clap 使用方式二：derive feature 2.1、添加依赖 2.2、快速开始 2.3、配置解析器 2.3.1、配置解析器 2.3.2、默认值 2.3.3、Command::next_line_help 替代 2.4、添加参数 2.4.1、添加可选参数 2.4.2、添加多值参数 2.4.3、参数选项 2.4.3.1、短参数名称和长参数名称 2.4.3.2、开启和关闭 2.4.3.3、参数计数 2.4.3.4、参数默认值 2.4.3.5、参数枚举 2.4.3.6、参数校验 2.4.3.7、自定义解析 2.4.3.8、参数关系 2.4.3.9、自定义校验 2.5、子命令 三、如何选择 总结)
  • [1.5.5.3、校验值(Validated values)](#文章目录 系列文章目录 @TOC 前言 一、 Clap 使用方式一：build构建 1.1、引入 clap 库 1.2、快速启动 1.3、配置解析器(Configuring the Parser) 1.3.1、使用 Command 构建解析器 1.3.2、使用 command! 构建解析器 1.3.2、使用 Command::next_line_help 方法 1.4、添加命令行参数(Adding Arguments) 1.4、设置参数行为 1.5、参数选项 1.5.1、参数选项 1.5.2、开启/关闭标志 1.5.3、参数调用计数 1.5.4、默认值 1.5.5、参数校验 1.5.5.1、默认情况 1.5.5.2、枚举值(Enumerated values) 1.5.5.3、校验值(Validated values) 1.5.5.4、自定义解析器(Custom Parser) 1.5.5.5、参数关系(Argument Relations) 1.5.5.6、自定义校验(Custom Validation) 1.6、子命令(Subcommand) 1.7、测试 二、 Clap 使用方式二：derive feature 2.1、添加依赖 2.2、快速开始 2.3、配置解析器 2.3.1、配置解析器 2.3.2、默认值 2.3.3、Command::next_line_help 替代 2.4、添加参数 2.4.1、添加可选参数 2.4.2、添加多值参数 2.4.3、参数选项 2.4.3.1、短参数名称和长参数名称 2.4.3.2、开启和关闭 2.4.3.3、参数计数 2.4.3.4、参数默认值 2.4.3.5、参数枚举 2.4.3.6、参数校验 2.4.3.7、自定义解析 2.4.3.8、参数关系 2.4.3.9、自定义校验 2.5、子命令 三、如何选择 总结)
  • [1.5.5.4、自定义解析器(Custom Parser)](#文章目录 系列文章目录 @TOC 前言 一、 Clap 使用方式一：build构建 1.1、引入 clap 库 1.2、快速启动 1.3、配置解析器(Configuring the Parser) 1.3.1、使用 Command 构建解析器 1.3.2、使用 command! 构建解析器 1.3.2、使用 Command::next_line_help 方法 1.4、添加命令行参数(Adding Arguments) 1.4、设置参数行为 1.5、参数选项 1.5.1、参数选项 1.5.2、开启/关闭标志 1.5.3、参数调用计数 1.5.4、默认值 1.5.5、参数校验 1.5.5.1、默认情况 1.5.5.2、枚举值(Enumerated values) 1.5.5.3、校验值(Validated values) 1.5.5.4、自定义解析器(Custom Parser) 1.5.5.5、参数关系(Argument Relations) 1.5.5.6、自定义校验(Custom Validation) 1.6、子命令(Subcommand) 1.7、测试 二、 Clap 使用方式二：derive feature 2.1、添加依赖 2.2、快速开始 2.3、配置解析器 2.3.1、配置解析器 2.3.2、默认值 2.3.3、Command::next_line_help 替代 2.4、添加参数 2.4.1、添加可选参数 2.4.2、添加多值参数 2.4.3、参数选项 2.4.3.1、短参数名称和长参数名称 2.4.3.2、开启和关闭 2.4.3.3、参数计数 2.4.3.4、参数默认值 2.4.3.5、参数枚举 2.4.3.6、参数校验 2.4.3.7、自定义解析 2.4.3.8、参数关系 2.4.3.9、自定义校验 2.5、子命令 三、如何选择 总结)
  • [1.5.5.5、参数关系(Argument Relations)](#文章目录 系列文章目录 @TOC 前言 一、 Clap 使用方式一：build构建 1.1、引入 clap 库 1.2、快速启动 1.3、配置解析器(Configuring the Parser) 1.3.1、使用 Command 构建解析器 1.3.2、使用 command! 构建解析器 1.3.2、使用 Command::next_line_help 方法 1.4、添加命令行参数(Adding Arguments) 1.4、设置参数行为 1.5、参数选项 1.5.1、参数选项 1.5.2、开启/关闭标志 1.5.3、参数调用计数 1.5.4、默认值 1.5.5、参数校验 1.5.5.1、默认情况 1.5.5.2、枚举值(Enumerated values) 1.5.5.3、校验值(Validated values) 1.5.5.4、自定义解析器(Custom Parser) 1.5.5.5、参数关系(Argument Relations) 1.5.5.6、自定义校验(Custom Validation) 1.6、子命令(Subcommand) 1.7、测试 二、 Clap 使用方式二：derive feature 2.1、添加依赖 2.2、快速开始 2.3、配置解析器 2.3.1、配置解析器 2.3.2、默认值 2.3.3、Command::next_line_help 替代 2.4、添加参数 2.4.1、添加可选参数 2.4.2、添加多值参数 2.4.3、参数选项 2.4.3.1、短参数名称和长参数名称 2.4.3.2、开启和关闭 2.4.3.3、参数计数 2.4.3.4、参数默认值 2.4.3.5、参数枚举 2.4.3.6、参数校验 2.4.3.7、自定义解析 2.4.3.8、参数关系 2.4.3.9、自定义校验 2.5、子命令 三、如何选择 总结)
  • [1.5.5.6、自定义校验(Custom Validation)](#文章目录 系列文章目录 @TOC 前言 一、 Clap 使用方式一：build构建 1.1、引入 clap 库 1.2、快速启动 1.3、配置解析器(Configuring the Parser) 1.3.1、使用 Command 构建解析器 1.3.2、使用 command! 构建解析器 1.3.2、使用 Command::next_line_help 方法 1.4、添加命令行参数(Adding Arguments) 1.4、设置参数行为 1.5、参数选项 1.5.1、参数选项 1.5.2、开启/关闭标志 1.5.3、参数调用计数 1.5.4、默认值 1.5.5、参数校验 1.5.5.1、默认情况 1.5.5.2、枚举值(Enumerated values) 1.5.5.3、校验值(Validated values) 1.5.5.4、自定义解析器(Custom Parser) 1.5.5.5、参数关系(Argument Relations) 1.5.5.6、自定义校验(Custom Validation) 1.6、子命令(Subcommand) 1.7、测试 二、 Clap 使用方式二：derive feature 2.1、添加依赖 2.2、快速开始 2.3、配置解析器 2.3.1、配置解析器 2.3.2、默认值 2.3.3、Command::next_line_help 替代 2.4、添加参数 2.4.1、添加可选参数 2.4.2、添加多值参数 2.4.3、参数选项 2.4.3.1、短参数名称和长参数名称 2.4.3.2、开启和关闭 2.4.3.3、参数计数 2.4.3.4、参数默认值 2.4.3.5、参数枚举 2.4.3.6、参数校验 2.4.3.7、自定义解析 2.4.3.8、参数关系 2.4.3.9、自定义校验 2.5、子命令 三、如何选择 总结)
  • [1.6、子命令(Subcommand)](#文章目录 系列文章目录 @TOC 前言 一、 Clap 使用方式一：build构建 1.1、引入 clap 库 1.2、快速启动 1.3、配置解析器(Configuring the Parser) 1.3.1、使用 Command 构建解析器 1.3.2、使用 command! 构建解析器 1.3.2、使用 Command::next_line_help 方法 1.4、添加命令行参数(Adding Arguments) 1.4、设置参数行为 1.5、参数选项 1.5.1、参数选项 1.5.2、开启/关闭标志 1.5.3、参数调用计数 1.5.4、默认值 1.5.5、参数校验 1.5.5.1、默认情况 1.5.5.2、枚举值(Enumerated values) 1.5.5.3、校验值(Validated values) 1.5.5.4、自定义解析器(Custom Parser) 1.5.5.5、参数关系(Argument Relations) 1.5.5.6、自定义校验(Custom Validation) 1.6、子命令(Subcommand) 1.7、测试 二、 Clap 使用方式二：derive feature 2.1、添加依赖 2.2、快速开始 2.3、配置解析器 2.3.1、配置解析器 2.3.2、默认值 2.3.3、Command::next_line_help 替代 2.4、添加参数 2.4.1、添加可选参数 2.4.2、添加多值参数 2.4.3、参数选项 2.4.3.1、短参数名称和长参数名称 2.4.3.2、开启和关闭 2.4.3.3、参数计数 2.4.3.4、参数默认值 2.4.3.5、参数枚举 2.4.3.6、参数校验 2.4.3.7、自定义解析 2.4.3.8、参数关系 2.4.3.9、自定义校验 2.5、子命令 三、如何选择 总结)
  • [1.7、测试](#文章目录 系列文章目录 @TOC 前言 一、 Clap 使用方式一：build构建 1.1、引入 clap 库 1.2、快速启动 1.3、配置解析器(Configuring the Parser) 1.3.1、使用 Command 构建解析器 1.3.2、使用 command! 构建解析器 1.3.2、使用 Command::next_line_help 方法 1.4、添加命令行参数(Adding Arguments) 1.4、设置参数行为 1.5、参数选项 1.5.1、参数选项 1.5.2、开启/关闭标志 1.5.3、参数调用计数 1.5.4、默认值 1.5.5、参数校验 1.5.5.1、默认情况 1.5.5.2、枚举值(Enumerated values) 1.5.5.3、校验值(Validated values) 1.5.5.4、自定义解析器(Custom Parser) 1.5.5.5、参数关系(Argument Relations) 1.5.5.6、自定义校验(Custom Validation) 1.6、子命令(Subcommand) 1.7、测试 二、 Clap 使用方式二：derive feature 2.1、添加依赖 2.2、快速开始 2.3、配置解析器 2.3.1、配置解析器 2.3.2、默认值 2.3.3、Command::next_line_help 替代 2.4、添加参数 2.4.1、添加可选参数 2.4.2、添加多值参数 2.4.3、参数选项 2.4.3.1、短参数名称和长参数名称 2.4.3.2、开启和关闭 2.4.3.3、参数计数 2.4.3.4、参数默认值 2.4.3.5、参数枚举 2.4.3.6、参数校验 2.4.3.7、自定义解析 2.4.3.8、参数关系 2.4.3.9、自定义校验 2.5、子命令 三、如何选择 总结)
  • [二、 Clap 使用方式二：derive feature](#文章目录 系列文章目录 @TOC 前言 一、 Clap 使用方式一：build构建 1.1、引入 clap 库 1.2、快速启动 1.3、配置解析器(Configuring the Parser) 1.3.1、使用 Command 构建解析器 1.3.2、使用 command! 构建解析器 1.3.2、使用 Command::next_line_help 方法 1.4、添加命令行参数(Adding Arguments) 1.4、设置参数行为 1.5、参数选项 1.5.1、参数选项 1.5.2、开启/关闭标志 1.5.3、参数调用计数 1.5.4、默认值 1.5.5、参数校验 1.5.5.1、默认情况 1.5.5.2、枚举值(Enumerated values) 1.5.5.3、校验值(Validated values) 1.5.5.4、自定义解析器(Custom Parser) 1.5.5.5、参数关系(Argument Relations) 1.5.5.6、自定义校验(Custom Validation) 1.6、子命令(Subcommand) 1.7、测试 二、 Clap 使用方式二：derive feature 2.1、添加依赖 2.2、快速开始 2.3、配置解析器 2.3.1、配置解析器 2.3.2、默认值 2.3.3、Command::next_line_help 替代 2.4、添加参数 2.4.1、添加可选参数 2.4.2、添加多值参数 2.4.3、参数选项 2.4.3.1、短参数名称和长参数名称 2.4.3.2、开启和关闭 2.4.3.3、参数计数 2.4.3.4、参数默认值 2.4.3.5、参数枚举 2.4.3.6、参数校验 2.4.3.7、自定义解析 2.4.3.8、参数关系 2.4.3.9、自定义校验 2.5、子命令 三、如何选择 总结)
  • [2.1、添加依赖](#文章目录 系列文章目录 @TOC 前言 一、 Clap 使用方式一：build构建 1.1、引入 clap 库 1.2、快速启动 1.3、配置解析器(Configuring the Parser) 1.3.1、使用 Command 构建解析器 1.3.2、使用 command! 构建解析器 1.3.2、使用 Command::next_line_help 方法 1.4、添加命令行参数(Adding Arguments) 1.4、设置参数行为 1.5、参数选项 1.5.1、参数选项 1.5.2、开启/关闭标志 1.5.3、参数调用计数 1.5.4、默认值 1.5.5、参数校验 1.5.5.1、默认情况 1.5.5.2、枚举值(Enumerated values) 1.5.5.3、校验值(Validated values) 1.5.5.4、自定义解析器(Custom Parser) 1.5.5.5、参数关系(Argument Relations) 1.5.5.6、自定义校验(Custom Validation) 1.6、子命令(Subcommand) 1.7、测试 二、 Clap 使用方式二：derive feature 2.1、添加依赖 2.2、快速开始 2.3、配置解析器 2.3.1、配置解析器 2.3.2、默认值 2.3.3、Command::next_line_help 替代 2.4、添加参数 2.4.1、添加可选参数 2.4.2、添加多值参数 2.4.3、参数选项 2.4.3.1、短参数名称和长参数名称 2.4.3.2、开启和关闭 2.4.3.3、参数计数 2.4.3.4、参数默认值 2.4.3.5、参数枚举 2.4.3.6、参数校验 2.4.3.7、自定义解析 2.4.3.8、参数关系 2.4.3.9、自定义校验 2.5、子命令 三、如何选择 总结)
  • [2.2、快速开始](#文章目录 系列文章目录 @TOC 前言 一、 Clap 使用方式一：build构建 1.1、引入 clap 库 1.2、快速启动 1.3、配置解析器(Configuring the Parser) 1.3.1、使用 Command 构建解析器 1.3.2、使用 command! 构建解析器 1.3.2、使用 Command::next_line_help 方法 1.4、添加命令行参数(Adding Arguments) 1.4、设置参数行为 1.5、参数选项 1.5.1、参数选项 1.5.2、开启/关闭标志 1.5.3、参数调用计数 1.5.4、默认值 1.5.5、参数校验 1.5.5.1、默认情况 1.5.5.2、枚举值(Enumerated values) 1.5.5.3、校验值(Validated values) 1.5.5.4、自定义解析器(Custom Parser) 1.5.5.5、参数关系(Argument Relations) 1.5.5.6、自定义校验(Custom Validation) 1.6、子命令(Subcommand) 1.7、测试 二、 Clap 使用方式二：derive feature 2.1、添加依赖 2.2、快速开始 2.3、配置解析器 2.3.1、配置解析器 2.3.2、默认值 2.3.3、Command::next_line_help 替代 2.4、添加参数 2.4.1、添加可选参数 2.4.2、添加多值参数 2.4.3、参数选项 2.4.3.1、短参数名称和长参数名称 2.4.3.2、开启和关闭 2.4.3.3、参数计数 2.4.3.4、参数默认值 2.4.3.5、参数枚举 2.4.3.6、参数校验 2.4.3.7、自定义解析 2.4.3.8、参数关系 2.4.3.9、自定义校验 2.5、子命令 三、如何选择 总结)
  • [2.3、配置解析器](#文章目录 系列文章目录 @TOC 前言 一、 Clap 使用方式一：build构建 1.1、引入 clap 库 1.2、快速启动 1.3、配置解析器(Configuring the Parser) 1.3.1、使用 Command 构建解析器 1.3.2、使用 command! 构建解析器 1.3.2、使用 Command::next_line_help 方法 1.4、添加命令行参数(Adding Arguments) 1.4、设置参数行为 1.5、参数选项 1.5.1、参数选项 1.5.2、开启/关闭标志 1.5.3、参数调用计数 1.5.4、默认值 1.5.5、参数校验 1.5.5.1、默认情况 1.5.5.2、枚举值(Enumerated values) 1.5.5.3、校验值(Validated values) 1.5.5.4、自定义解析器(Custom Parser) 1.5.5.5、参数关系(Argument Relations) 1.5.5.6、自定义校验(Custom Validation) 1.6、子命令(Subcommand) 1.7、测试 二、 Clap 使用方式二：derive feature 2.1、添加依赖 2.2、快速开始 2.3、配置解析器 2.3.1、配置解析器 2.3.2、默认值 2.3.3、Command::next_line_help 替代 2.4、添加参数 2.4.1、添加可选参数 2.4.2、添加多值参数 2.4.3、参数选项 2.4.3.1、短参数名称和长参数名称 2.4.3.2、开启和关闭 2.4.3.3、参数计数 2.4.3.4、参数默认值 2.4.3.5、参数枚举 2.4.3.6、参数校验 2.4.3.7、自定义解析 2.4.3.8、参数关系 2.4.3.9、自定义校验 2.5、子命令 三、如何选择 总结)
  • [2.3.1、配置解析器](#文章目录 系列文章目录 @TOC 前言 一、 Clap 使用方式一：build构建 1.1、引入 clap 库 1.2、快速启动 1.3、配置解析器(Configuring the Parser) 1.3.1、使用 Command 构建解析器 1.3.2、使用 command! 构建解析器 1.3.2、使用 Command::next_line_help 方法 1.4、添加命令行参数(Adding Arguments) 1.4、设置参数行为 1.5、参数选项 1.5.1、参数选项 1.5.2、开启/关闭标志 1.5.3、参数调用计数 1.5.4、默认值 1.5.5、参数校验 1.5.5.1、默认情况 1.5.5.2、枚举值(Enumerated values) 1.5.5.3、校验值(Validated values) 1.5.5.4、自定义解析器(Custom Parser) 1.5.5.5、参数关系(Argument Relations) 1.5.5.6、自定义校验(Custom Validation) 1.6、子命令(Subcommand) 1.7、测试 二、 Clap 使用方式二：derive feature 2.1、添加依赖 2.2、快速开始 2.3、配置解析器 2.3.1、配置解析器 2.3.2、默认值 2.3.3、Command::next_line_help 替代 2.4、添加参数 2.4.1、添加可选参数 2.4.2、添加多值参数 2.4.3、参数选项 2.4.3.1、短参数名称和长参数名称 2.4.3.2、开启和关闭 2.4.3.3、参数计数 2.4.3.4、参数默认值 2.4.3.5、参数枚举 2.4.3.6、参数校验 2.4.3.7、自定义解析 2.4.3.8、参数关系 2.4.3.9、自定义校验 2.5、子命令 三、如何选择 总结)
  • [2.3.2、默认值](#文章目录 系列文章目录 @TOC 前言 一、 Clap 使用方式一：build构建 1.1、引入 clap 库 1.2、快速启动 1.3、配置解析器(Configuring the Parser) 1.3.1、使用 Command 构建解析器 1.3.2、使用 command! 构建解析器 1.3.2、使用 Command::next_line_help 方法 1.4、添加命令行参数(Adding Arguments) 1.4、设置参数行为 1.5、参数选项 1.5.1、参数选项 1.5.2、开启/关闭标志 1.5.3、参数调用计数 1.5.4、默认值 1.5.5、参数校验 1.5.5.1、默认情况 1.5.5.2、枚举值(Enumerated values) 1.5.5.3、校验值(Validated values) 1.5.5.4、自定义解析器(Custom Parser) 1.5.5.5、参数关系(Argument Relations) 1.5.5.6、自定义校验(Custom Validation) 1.6、子命令(Subcommand) 1.7、测试 二、 Clap 使用方式二：derive feature 2.1、添加依赖 2.2、快速开始 2.3、配置解析器 2.3.1、配置解析器 2.3.2、默认值 2.3.3、Command::next_line_help 替代 2.4、添加参数 2.4.1、添加可选参数 2.4.2、添加多值参数 2.4.3、参数选项 2.4.3.1、短参数名称和长参数名称 2.4.3.2、开启和关闭 2.4.3.3、参数计数 2.4.3.4、参数默认值 2.4.3.5、参数枚举 2.4.3.6、参数校验 2.4.3.7、自定义解析 2.4.3.8、参数关系 2.4.3.9、自定义校验 2.5、子命令 三、如何选择 总结)
  • [2.3.3、Command::next_line_help 替代](#文章目录 系列文章目录 @TOC 前言 一、 Clap 使用方式一：build构建 1.1、引入 clap 库 1.2、快速启动 1.3、配置解析器(Configuring the Parser) 1.3.1、使用 Command 构建解析器 1.3.2、使用 command! 构建解析器 1.3.2、使用 Command::next_line_help 方法 1.4、添加命令行参数(Adding Arguments) 1.4、设置参数行为 1.5、参数选项 1.5.1、参数选项 1.5.2、开启/关闭标志 1.5.3、参数调用计数 1.5.4、默认值 1.5.5、参数校验 1.5.5.1、默认情况 1.5.5.2、枚举值(Enumerated values) 1.5.5.3、校验值(Validated values) 1.5.5.4、自定义解析器(Custom Parser) 1.5.5.5、参数关系(Argument Relations) 1.5.5.6、自定义校验(Custom Validation) 1.6、子命令(Subcommand) 1.7、测试 二、 Clap 使用方式二：derive feature 2.1、添加依赖 2.2、快速开始 2.3、配置解析器 2.3.1、配置解析器 2.3.2、默认值 2.3.3、Command::next_line_help 替代 2.4、添加参数 2.4.1、添加可选参数 2.4.2、添加多值参数 2.4.3、参数选项 2.4.3.1、短参数名称和长参数名称 2.4.3.2、开启和关闭 2.4.3.3、参数计数 2.4.3.4、参数默认值 2.4.3.5、参数枚举 2.4.3.6、参数校验 2.4.3.7、自定义解析 2.4.3.8、参数关系 2.4.3.9、自定义校验 2.5、子命令 三、如何选择 总结)
  • [2.4、添加参数](#文章目录 系列文章目录 @TOC 前言 一、 Clap 使用方式一：build构建 1.1、引入 clap 库 1.2、快速启动 1.3、配置解析器(Configuring the Parser) 1.3.1、使用 Command 构建解析器 1.3.2、使用 command! 构建解析器 1.3.2、使用 Command::next_line_help 方法 1.4、添加命令行参数(Adding Arguments) 1.4、设置参数行为 1.5、参数选项 1.5.1、参数选项 1.5.2、开启/关闭标志 1.5.3、参数调用计数 1.5.4、默认值 1.5.5、参数校验 1.5.5.1、默认情况 1.5.5.2、枚举值(Enumerated values) 1.5.5.3、校验值(Validated values) 1.5.5.4、自定义解析器(Custom Parser) 1.5.5.5、参数关系(Argument Relations) 1.5.5.6、自定义校验(Custom Validation) 1.6、子命令(Subcommand) 1.7、测试 二、 Clap 使用方式二：derive feature 2.1、添加依赖 2.2、快速开始 2.3、配置解析器 2.3.1、配置解析器 2.3.2、默认值 2.3.3、Command::next_line_help 替代 2.4、添加参数 2.4.1、添加可选参数 2.4.2、添加多值参数 2.4.3、参数选项 2.4.3.1、短参数名称和长参数名称 2.4.3.2、开启和关闭 2.4.3.3、参数计数 2.4.3.4、参数默认值 2.4.3.5、参数枚举 2.4.3.6、参数校验 2.4.3.7、自定义解析 2.4.3.8、参数关系 2.4.3.9、自定义校验 2.5、子命令 三、如何选择 总结)
  • [2.4.1、添加可选参数](#文章目录 系列文章目录 @TOC 前言 一、 Clap 使用方式一：build构建 1.1、引入 clap 库 1.2、快速启动 1.3、配置解析器(Configuring the Parser) 1.3.1、使用 Command 构建解析器 1.3.2、使用 command! 构建解析器 1.3.2、使用 Command::next_line_help 方法 1.4、添加命令行参数(Adding Arguments) 1.4、设置参数行为 1.5、参数选项 1.5.1、参数选项 1.5.2、开启/关闭标志 1.5.3、参数调用计数 1.5.4、默认值 1.5.5、参数校验 1.5.5.1、默认情况 1.5.5.2、枚举值(Enumerated values) 1.5.5.3、校验值(Validated values) 1.5.5.4、自定义解析器(Custom Parser) 1.5.5.5、参数关系(Argument Relations) 1.5.5.6、自定义校验(Custom Validation) 1.6、子命令(Subcommand) 1.7、测试 二、 Clap 使用方式二：derive feature 2.1、添加依赖 2.2、快速开始 2.3、配置解析器 2.3.1、配置解析器 2.3.2、默认值 2.3.3、Command::next_line_help 替代 2.4、添加参数 2.4.1、添加可选参数 2.4.2、添加多值参数 2.4.3、参数选项 2.4.3.1、短参数名称和长参数名称 2.4.3.2、开启和关闭 2.4.3.3、参数计数 2.4.3.4、参数默认值 2.4.3.5、参数枚举 2.4.3.6、参数校验 2.4.3.7、自定义解析 2.4.3.8、参数关系 2.4.3.9、自定义校验 2.5、子命令 三、如何选择 总结)
  • [2.4.2、添加多值参数](#文章目录 系列文章目录 @TOC 前言 一、 Clap 使用方式一：build构建 1.1、引入 clap 库 1.2、快速启动 1.3、配置解析器(Configuring the Parser) 1.3.1、使用 Command 构建解析器 1.3.2、使用 command! 构建解析器 1.3.2、使用 Command::next_line_help 方法 1.4、添加命令行参数(Adding Arguments) 1.4、设置参数行为 1.5、参数选项 1.5.1、参数选项 1.5.2、开启/关闭标志 1.5.3、参数调用计数 1.5.4、默认值 1.5.5、参数校验 1.5.5.1、默认情况 1.5.5.2、枚举值(Enumerated values) 1.5.5.3、校验值(Validated values) 1.5.5.4、自定义解析器(Custom Parser) 1.5.5.5、参数关系(Argument Relations) 1.5.5.6、自定义校验(Custom Validation) 1.6、子命令(Subcommand) 1.7、测试 二、 Clap 使用方式二：derive feature 2.1、添加依赖 2.2、快速开始 2.3、配置解析器 2.3.1、配置解析器 2.3.2、默认值 2.3.3、Command::next_line_help 替代 2.4、添加参数 2.4.1、添加可选参数 2.4.2、添加多值参数 2.4.3、参数选项 2.4.3.1、短参数名称和长参数名称 2.4.3.2、开启和关闭 2.4.3.3、参数计数 2.4.3.4、参数默认值 2.4.3.5、参数枚举 2.4.3.6、参数校验 2.4.3.7、自定义解析 2.4.3.8、参数关系 2.4.3.9、自定义校验 2.5、子命令 三、如何选择 总结)
  • [2.4.3、参数选项](#文章目录 系列文章目录 @TOC 前言 一、 Clap 使用方式一：build构建 1.1、引入 clap 库 1.2、快速启动 1.3、配置解析器(Configuring the Parser) 1.3.1、使用 Command 构建解析器 1.3.2、使用 command! 构建解析器 1.3.2、使用 Command::next_line_help 方法 1.4、添加命令行参数(Adding Arguments) 1.4、设置参数行为 1.5、参数选项 1.5.1、参数选项 1.5.2、开启/关闭标志 1.5.3、参数调用计数 1.5.4、默认值 1.5.5、参数校验 1.5.5.1、默认情况 1.5.5.2、枚举值(Enumerated values) 1.5.5.3、校验值(Validated values) 1.5.5.4、自定义解析器(Custom Parser) 1.5.5.5、参数关系(Argument Relations) 1.5.5.6、自定义校验(Custom Validation) 1.6、子命令(Subcommand) 1.7、测试 二、 Clap 使用方式二：derive feature 2.1、添加依赖 2.2、快速开始 2.3、配置解析器 2.3.1、配置解析器 2.3.2、默认值 2.3.3、Command::next_line_help 替代 2.4、添加参数 2.4.1、添加可选参数 2.4.2、添加多值参数 2.4.3、参数选项 2.4.3.1、短参数名称和长参数名称 2.4.3.2、开启和关闭 2.4.3.3、参数计数 2.4.3.4、参数默认值 2.4.3.5、参数枚举 2.4.3.6、参数校验 2.4.3.7、自定义解析 2.4.3.8、参数关系 2.4.3.9、自定义校验 2.5、子命令 三、如何选择 总结)
  • [2.4.3.1、短参数名称和长参数名称](#文章目录 系列文章目录 @TOC 前言 一、 Clap 使用方式一：build构建 1.1、引入 clap 库 1.2、快速启动 1.3、配置解析器(Configuring the Parser) 1.3.1、使用 Command 构建解析器 1.3.2、使用 command! 构建解析器 1.3.2、使用 Command::next_line_help 方法 1.4、添加命令行参数(Adding Arguments) 1.4、设置参数行为 1.5、参数选项 1.5.1、参数选项 1.5.2、开启/关闭标志 1.5.3、参数调用计数 1.5.4、默认值 1.5.5、参数校验 1.5.5.1、默认情况 1.5.5.2、枚举值(Enumerated values) 1.5.5.3、校验值(Validated values) 1.5.5.4、自定义解析器(Custom Parser) 1.5.5.5、参数关系(Argument Relations) 1.5.5.6、自定义校验(Custom Validation) 1.6、子命令(Subcommand) 1.7、测试 二、 Clap 使用方式二：derive feature 2.1、添加依赖 2.2、快速开始 2.3、配置解析器 2.3.1、配置解析器 2.3.2、默认值 2.3.3、Command::next_line_help 替代 2.4、添加参数 2.4.1、添加可选参数 2.4.2、添加多值参数 2.4.3、参数选项 2.4.3.1、短参数名称和长参数名称 2.4.3.2、开启和关闭 2.4.3.3、参数计数 2.4.3.4、参数默认值 2.4.3.5、参数枚举 2.4.3.6、参数校验 2.4.3.7、自定义解析 2.4.3.8、参数关系 2.4.3.9、自定义校验 2.5、子命令 三、如何选择 总结)
  • [2.4.3.2、开启和关闭](#文章目录 系列文章目录 @TOC 前言 一、 Clap 使用方式一：build构建 1.1、引入 clap 库 1.2、快速启动 1.3、配置解析器(Configuring the Parser) 1.3.1、使用 Command 构建解析器 1.3.2、使用 command! 构建解析器 1.3.2、使用 Command::next_line_help 方法 1.4、添加命令行参数(Adding Arguments) 1.4、设置参数行为 1.5、参数选项 1.5.1、参数选项 1.5.2、开启/关闭标志 1.5.3、参数调用计数 1.5.4、默认值 1.5.5、参数校验 1.5.5.1、默认情况 1.5.5.2、枚举值(Enumerated values) 1.5.5.3、校验值(Validated values) 1.5.5.4、自定义解析器(Custom Parser) 1.5.5.5、参数关系(Argument Relations) 1.5.5.6、自定义校验(Custom Validation) 1.6、子命令(Subcommand) 1.7、测试 二、 Clap 使用方式二：derive feature 2.1、添加依赖 2.2、快速开始 2.3、配置解析器 2.3.1、配置解析器 2.3.2、默认值 2.3.3、Command::next_line_help 替代 2.4、添加参数 2.4.1、添加可选参数 2.4.2、添加多值参数 2.4.3、参数选项 2.4.3.1、短参数名称和长参数名称 2.4.3.2、开启和关闭 2.4.3.3、参数计数 2.4.3.4、参数默认值 2.4.3.5、参数枚举 2.4.3.6、参数校验 2.4.3.7、自定义解析 2.4.3.8、参数关系 2.4.3.9、自定义校验 2.5、子命令 三、如何选择 总结)
  • [2.4.3.3、参数计数](#文章目录 系列文章目录 @TOC 前言 一、 Clap 使用方式一：build构建 1.1、引入 clap 库 1.2、快速启动 1.3、配置解析器(Configuring the Parser) 1.3.1、使用 Command 构建解析器 1.3.2、使用 command! 构建解析器 1.3.2、使用 Command::next_line_help 方法 1.4、添加命令行参数(Adding Arguments) 1.4、设置参数行为 1.5、参数选项 1.5.1、参数选项 1.5.2、开启/关闭标志 1.5.3、参数调用计数 1.5.4、默认值 1.5.5、参数校验 1.5.5.1、默认情况 1.5.5.2、枚举值(Enumerated values) 1.5.5.3、校验值(Validated values) 1.5.5.4、自定义解析器(Custom Parser) 1.5.5.5、参数关系(Argument Relations) 1.5.5.6、自定义校验(Custom Validation) 1.6、子命令(Subcommand) 1.7、测试 二、 Clap 使用方式二：derive feature 2.1、添加依赖 2.2、快速开始 2.3、配置解析器 2.3.1、配置解析器 2.3.2、默认值 2.3.3、Command::next_line_help 替代 2.4、添加参数 2.4.1、添加可选参数 2.4.2、添加多值参数 2.4.3、参数选项 2.4.3.1、短参数名称和长参数名称 2.4.3.2、开启和关闭 2.4.3.3、参数计数 2.4.3.4、参数默认值 2.4.3.5、参数枚举 2.4.3.6、参数校验 2.4.3.7、自定义解析 2.4.3.8、参数关系 2.4.3.9、自定义校验 2.5、子命令 三、如何选择 总结)
  • [2.4.3.4、参数默认值](#文章目录 系列文章目录 @TOC 前言 一、 Clap 使用方式一：build构建 1.1、引入 clap 库 1.2、快速启动 1.3、配置解析器(Configuring the Parser) 1.3.1、使用 Command 构建解析器 1.3.2、使用 command! 构建解析器 1.3.2、使用 Command::next_line_help 方法 1.4、添加命令行参数(Adding Arguments) 1.4、设置参数行为 1.5、参数选项 1.5.1、参数选项 1.5.2、开启/关闭标志 1.5.3、参数调用计数 1.5.4、默认值 1.5.5、参数校验 1.5.5.1、默认情况 1.5.5.2、枚举值(Enumerated values) 1.5.5.3、校验值(Validated values) 1.5.5.4、自定义解析器(Custom Parser) 1.5.5.5、参数关系(Argument Relations) 1.5.5.6、自定义校验(Custom Validation) 1.6、子命令(Subcommand) 1.7、测试 二、 Clap 使用方式二：derive feature 2.1、添加依赖 2.2、快速开始 2.3、配置解析器 2.3.1、配置解析器 2.3.2、默认值 2.3.3、Command::next_line_help 替代 2.4、添加参数 2.4.1、添加可选参数 2.4.2、添加多值参数 2.4.3、参数选项 2.4.3.1、短参数名称和长参数名称 2.4.3.2、开启和关闭 2.4.3.3、参数计数 2.4.3.4、参数默认值 2.4.3.5、参数枚举 2.4.3.6、参数校验 2.4.3.7、自定义解析 2.4.3.8、参数关系 2.4.3.9、自定义校验 2.5、子命令 三、如何选择 总结)
  • [2.4.3.5、参数枚举](#文章目录 系列文章目录 @TOC 前言 一、 Clap 使用方式一：build构建 1.1、引入 clap 库 1.2、快速启动 1.3、配置解析器(Configuring the Parser) 1.3.1、使用 Command 构建解析器 1.3.2、使用 command! 构建解析器 1.3.2、使用 Command::next_line_help 方法 1.4、添加命令行参数(Adding Arguments) 1.4、设置参数行为 1.5、参数选项 1.5.1、参数选项 1.5.2、开启/关闭标志 1.5.3、参数调用计数 1.5.4、默认值 1.5.5、参数校验 1.5.5.1、默认情况 1.5.5.2、枚举值(Enumerated values) 1.5.5.3、校验值(Validated values) 1.5.5.4、自定义解析器(Custom Parser) 1.5.5.5、参数关系(Argument Relations) 1.5.5.6、自定义校验(Custom Validation) 1.6、子命令(Subcommand) 1.7、测试 二、 Clap 使用方式二：derive feature 2.1、添加依赖 2.2、快速开始 2.3、配置解析器 2.3.1、配置解析器 2.3.2、默认值 2.3.3、Command::next_line_help 替代 2.4、添加参数 2.4.1、添加可选参数 2.4.2、添加多值参数 2.4.3、参数选项 2.4.3.1、短参数名称和长参数名称 2.4.3.2、开启和关闭 2.4.3.3、参数计数 2.4.3.4、参数默认值 2.4.3.5、参数枚举 2.4.3.6、参数校验 2.4.3.7、自定义解析 2.4.3.8、参数关系 2.4.3.9、自定义校验 2.5、子命令 三、如何选择 总结)
  • [2.4.3.6、参数校验](#文章目录 系列文章目录 @TOC 前言 一、 Clap 使用方式一：build构建 1.1、引入 clap 库 1.2、快速启动 1.3、配置解析器(Configuring the Parser) 1.3.1、使用 Command 构建解析器 1.3.2、使用 command! 构建解析器 1.3.2、使用 Command::next_line_help 方法 1.4、添加命令行参数(Adding Arguments) 1.4、设置参数行为 1.5、参数选项 1.5.1、参数选项 1.5.2、开启/关闭标志 1.5.3、参数调用计数 1.5.4、默认值 1.5.5、参数校验 1.5.5.1、默认情况 1.5.5.2、枚举值(Enumerated values) 1.5.5.3、校验值(Validated values) 1.5.5.4、自定义解析器(Custom Parser) 1.5.5.5、参数关系(Argument Relations) 1.5.5.6、自定义校验(Custom Validation) 1.6、子命令(Subcommand) 1.7、测试 二、 Clap 使用方式二：derive feature 2.1、添加依赖 2.2、快速开始 2.3、配置解析器 2.3.1、配置解析器 2.3.2、默认值 2.3.3、Command::next_line_help 替代 2.4、添加参数 2.4.1、添加可选参数 2.4.2、添加多值参数 2.4.3、参数选项 2.4.3.1、短参数名称和长参数名称 2.4.3.2、开启和关闭 2.4.3.3、参数计数 2.4.3.4、参数默认值 2.4.3.5、参数枚举 2.4.3.6、参数校验 2.4.3.7、自定义解析 2.4.3.8、参数关系 2.4.3.9、自定义校验 2.5、子命令 三、如何选择 总结)
  • [2.4.3.7、自定义解析](#文章目录 系列文章目录 @TOC 前言 一、 Clap 使用方式一：build构建 1.1、引入 clap 库 1.2、快速启动 1.3、配置解析器(Configuring the Parser) 1.3.1、使用 Command 构建解析器 1.3.2、使用 command! 构建解析器 1.3.2、使用 Command::next_line_help 方法 1.4、添加命令行参数(Adding Arguments) 1.4、设置参数行为 1.5、参数选项 1.5.1、参数选项 1.5.2、开启/关闭标志 1.5.3、参数调用计数 1.5.4、默认值 1.5.5、参数校验 1.5.5.1、默认情况 1.5.5.2、枚举值(Enumerated values) 1.5.5.3、校验值(Validated values) 1.5.5.4、自定义解析器(Custom Parser) 1.5.5.5、参数关系(Argument Relations) 1.5.5.6、自定义校验(Custom Validation) 1.6、子命令(Subcommand) 1.7、测试 二、 Clap 使用方式二：derive feature 2.1、添加依赖 2.2、快速开始 2.3、配置解析器 2.3.1、配置解析器 2.3.2、默认值 2.3.3、Command::next_line_help 替代 2.4、添加参数 2.4.1、添加可选参数 2.4.2、添加多值参数 2.4.3、参数选项 2.4.3.1、短参数名称和长参数名称 2.4.3.2、开启和关闭 2.4.3.3、参数计数 2.4.3.4、参数默认值 2.4.3.5、参数枚举 2.4.3.6、参数校验 2.4.3.7、自定义解析 2.4.3.8、参数关系 2.4.3.9、自定义校验 2.5、子命令 三、如何选择 总结)
  • [2.4.3.8、参数关系](#文章目录 系列文章目录 @TOC 前言 一、 Clap 使用方式一：build构建 1.1、引入 clap 库 1.2、快速启动 1.3、配置解析器(Configuring the Parser) 1.3.1、使用 Command 构建解析器 1.3.2、使用 command! 构建解析器 1.3.2、使用 Command::next_line_help 方法 1.4、添加命令行参数(Adding Arguments) 1.4、设置参数行为 1.5、参数选项 1.5.1、参数选项 1.5.2、开启/关闭标志 1.5.3、参数调用计数 1.5.4、默认值 1.5.5、参数校验 1.5.5.1、默认情况 1.5.5.2、枚举值(Enumerated values) 1.5.5.3、校验值(Validated values) 1.5.5.4、自定义解析器(Custom Parser) 1.5.5.5、参数关系(Argument Relations) 1.5.5.6、自定义校验(Custom Validation) 1.6、子命令(Subcommand) 1.7、测试 二、 Clap 使用方式二：derive feature 2.1、添加依赖 2.2、快速开始 2.3、配置解析器 2.3.1、配置解析器 2.3.2、默认值 2.3.3、Command::next_line_help 替代 2.4、添加参数 2.4.1、添加可选参数 2.4.2、添加多值参数 2.4.3、参数选项 2.4.3.1、短参数名称和长参数名称 2.4.3.2、开启和关闭 2.4.3.3、参数计数 2.4.3.4、参数默认值 2.4.3.5、参数枚举 2.4.3.6、参数校验 2.4.3.7、自定义解析 2.4.3.8、参数关系 2.4.3.9、自定义校验 2.5、子命令 三、如何选择 总结)
  • [2.4.3.9、自定义校验](#文章目录 系列文章目录 @TOC 前言 一、 Clap 使用方式一：build构建 1.1、引入 clap 库 1.2、快速启动 1.3、配置解析器(Configuring the Parser) 1.3.1、使用 Command 构建解析器 1.3.2、使用 command! 构建解析器 1.3.2、使用 Command::next_line_help 方法 1.4、添加命令行参数(Adding Arguments) 1.4、设置参数行为 1.5、参数选项 1.5.1、参数选项 1.5.2、开启/关闭标志 1.5.3、参数调用计数 1.5.4、默认值 1.5.5、参数校验 1.5.5.1、默认情况 1.5.5.2、枚举值(Enumerated values) 1.5.5.3、校验值(Validated values) 1.5.5.4、自定义解析器(Custom Parser) 1.5.5.5、参数关系(Argument Relations) 1.5.5.6、自定义校验(Custom Validation) 1.6、子命令(Subcommand) 1.7、测试 二、 Clap 使用方式二：derive feature 2.1、添加依赖 2.2、快速开始 2.3、配置解析器 2.3.1、配置解析器 2.3.2、默认值 2.3.3、Command::next_line_help 替代 2.4、添加参数 2.4.1、添加可选参数 2.4.2、添加多值参数 2.4.3、参数选项 2.4.3.1、短参数名称和长参数名称 2.4.3.2、开启和关闭 2.4.3.3、参数计数 2.4.3.4、参数默认值 2.4.3.5、参数枚举 2.4.3.6、参数校验 2.4.3.7、自定义解析 2.4.3.8、参数关系 2.4.3.9、自定义校验 2.5、子命令 三、如何选择 总结)
  • [2.5、子命令](#文章目录 系列文章目录 @TOC 前言 一、 Clap 使用方式一：build构建 1.1、引入 clap 库 1.2、快速启动 1.3、配置解析器(Configuring the Parser) 1.3.1、使用 Command 构建解析器 1.3.2、使用 command! 构建解析器 1.3.2、使用 Command::next_line_help 方法 1.4、添加命令行参数(Adding Arguments) 1.4、设置参数行为 1.5、参数选项 1.5.1、参数选项 1.5.2、开启/关闭标志 1.5.3、参数调用计数 1.5.4、默认值 1.5.5、参数校验 1.5.5.1、默认情况 1.5.5.2、枚举值(Enumerated values) 1.5.5.3、校验值(Validated values) 1.5.5.4、自定义解析器(Custom Parser) 1.5.5.5、参数关系(Argument Relations) 1.5.5.6、自定义校验(Custom Validation) 1.6、子命令(Subcommand) 1.7、测试 二、 Clap 使用方式二：derive feature 2.1、添加依赖 2.2、快速开始 2.3、配置解析器 2.3.1、配置解析器 2.3.2、默认值 2.3.3、Command::next_line_help 替代 2.4、添加参数 2.4.1、添加可选参数 2.4.2、添加多值参数 2.4.3、参数选项 2.4.3.1、短参数名称和长参数名称 2.4.3.2、开启和关闭 2.4.3.3、参数计数 2.4.3.4、参数默认值 2.4.3.5、参数枚举 2.4.3.6、参数校验 2.4.3.7、自定义解析 2.4.3.8、参数关系 2.4.3.9、自定义校验 2.5、子命令 三、如何选择 总结)
  • [三、如何选择](#文章目录 系列文章目录 @TOC 前言 一、 Clap 使用方式一：build构建 1.1、引入 clap 库 1.2、快速启动 1.3、配置解析器(Configuring the Parser) 1.3.1、使用 Command 构建解析器 1.3.2、使用 command! 构建解析器 1.3.2、使用 Command::next_line_help 方法 1.4、添加命令行参数(Adding Arguments) 1.4、设置参数行为 1.5、参数选项 1.5.1、参数选项 1.5.2、开启/关闭标志 1.5.3、参数调用计数 1.5.4、默认值 1.5.5、参数校验 1.5.5.1、默认情况 1.5.5.2、枚举值(Enumerated values) 1.5.5.3、校验值(Validated values) 1.5.5.4、自定义解析器(Custom Parser) 1.5.5.5、参数关系(Argument Relations) 1.5.5.6、自定义校验(Custom Validation) 1.6、子命令(Subcommand) 1.7、测试 二、 Clap 使用方式二：derive feature 2.1、添加依赖 2.2、快速开始 2.3、配置解析器 2.3.1、配置解析器 2.3.2、默认值 2.3.3、Command::next_line_help 替代 2.4、添加参数 2.4.1、添加可选参数 2.4.2、添加多值参数 2.4.3、参数选项 2.4.3.1、短参数名称和长参数名称 2.4.3.2、开启和关闭 2.4.3.3、参数计数 2.4.3.4、参数默认值 2.4.3.5、参数枚举 2.4.3.6、参数校验 2.4.3.7、自定义解析 2.4.3.8、参数关系 2.4.3.9、自定义校验 2.5、子命令 三、如何选择 总结)
  • [总结](#文章目录 系列文章目录 @TOC 前言 一、 Clap 使用方式一：build构建 1.1、引入 clap 库 1.2、快速启动 1.3、配置解析器(Configuring the Parser) 1.3.1、使用 Command 构建解析器 1.3.2、使用 command! 构建解析器 1.3.2、使用 Command::next_line_help 方法 1.4、添加命令行参数(Adding Arguments) 1.4、设置参数行为 1.5、参数选项 1.5.1、参数选项 1.5.2、开启/关闭标志 1.5.3、参数调用计数 1.5.4、默认值 1.5.5、参数校验 1.5.5.1、默认情况 1.5.5.2、枚举值(Enumerated values) 1.5.5.3、校验值(Validated values) 1.5.5.4、自定义解析器(Custom Parser) 1.5.5.5、参数关系(Argument Relations) 1.5.5.6、自定义校验(Custom Validation) 1.6、子命令(Subcommand) 1.7、测试 二、 Clap 使用方式二：derive feature 2.1、添加依赖 2.2、快速开始 2.3、配置解析器 2.3.1、配置解析器 2.3.2、默认值 2.3.3、Command::next_line_help 替代 2.4、添加参数 2.4.1、添加可选参数 2.4.2、添加多值参数 2.4.3、参数选项 2.4.3.1、短参数名称和长参数名称 2.4.3.2、开启和关闭 2.4.3.3、参数计数 2.4.3.4、参数默认值 2.4.3.5、参数枚举 2.4.3.6、参数校验 2.4.3.7、自定义解析 2.4.3.8、参数关系 2.4.3.9、自定义校验 2.5、子命令 三、如何选择 总结)

前言

本章节内容讲解 Rust 的第三方库 Clap，这是一个命令行参数解析库。使用API创建解析的方式有两种：Derive 方式、Builder方式。

主要教材参考 《The Rust Programming Language》
主要教材参考 《Rust For Rustaceans》
主要教材参考 《The Rustonomicon》
主要教材参考 《Rust 高级编程》
主要教材参考 《Cargo 指南》

一、 Clap 使用方式一：build构建

1.1、引入 clap 库

rust 复制代码 
cargo add clap -- features 	cargo

需要注意：如果不启用 cargo feature ，则会报如下错误。

rust 复制代码 
requires `cargo` feature

1.2、快速启动

rust 复制代码 
//main.rs
use std::path::PathBuf;

use clap::{arg, command, value_parser, ArgAction, Command};

fn main() {
    let matches = command!() // requires `cargo` feature
        .arg(arg!([name] "Optional name to operate on"))
        .arg(
            arg!(
                -c --config <FILE> "Sets a custom config file"
            )
            // We don't have syntax yet for optional options, so manually calling `required`
            .required(false)
            .value_parser(value_parser!(PathBuf)),
        )
        .arg(arg!(
            -d --debug ... "Turn debugging information on"
        ))
        .subcommand(
            Command::new("test")
                .about("does testing things")
                .arg(arg!(-l --list "lists test values").action(ArgAction::SetTrue)),
        )
        .get_matches();

    // You can check the value provided by positional arguments, or option arguments
    if let Some(name) = matches.get_one::<String>("name") {
        println!("Value for name: {name}");
    }

    if let Some(config_path) = matches.get_one::<PathBuf>("config") {
        println!("Value for config: {}", config_path.display());
    }

    // You can see how many times a particular flag or argument occurred
    // Note, only flags can have multiple occurrences
    match matches
        .get_one::<u8>("debug")
        .expect("Count's are defaulted")
    {
        0 => println!("Debug mode is off"),
        1 => println!("Debug mode is kind of on"),
        2 => println!("Debug mode is on"),
        _ => println!("Don't be crazy"),
    }

    // You can check for the existence of subcommands, and if found use their
    // matches just as you would the top level cmd
    if let Some(matches) = matches.subcommand_matches("test") {
        // "$ myapp test" was run
        if matches.get_flag("list") {
            // "$ myapp test -l" was run
            println!("Printing testing lists...");
        } else {
            println!("Not printing testing lists...");
        }
    }

    // Continued program logic goes here...
}

1、默认执行情况

rust 复制代码 
cargo run
Debug mode is off

2、参看帮助文档

rust 复制代码 
cargo run --help
Run a binary or example of the local package

Usage: cargo run [OPTIONS] [args]...

Arguments:
  [args]...  Arguments for the binary or example to run

Options:
  -q, --quiet                   Do not print cargo log messages
      --bin [<NAME>]            Name of the bin target to run
      --example [<NAME>]        Name of the example target to run
  -p, --package [<SPEC>]        Package with the target to run
  -j, --jobs <N>                Number of parallel jobs, defaults to # of CPUs.
      --keep-going              Do not abort the build as soon as there is an error (unstable)
  -r, --release                 Build artifacts in release mode, with optimizations
      --profile <PROFILE-NAME>  Build artifacts with the specified profile
  -F, --features <FEATURES>     Space or comma separated list of features to activate
      --all-features            Activate all available features
      --no-default-features     Do not activate the `default` feature
      --target <TRIPLE>         Build for the target triple
      --target-dir <DIRECTORY>  Directory for all generated artifacts
      --manifest-path <PATH>    Path to Cargo.toml
      --message-format <FMT>    Error format
      --unit-graph              Output build graph in JSON (unstable)
      --ignore-rust-version     Ignore `rust-version` specification in packages
      --timings[=<FMTS>]        Timing output formats (unstable) (comma separated): html, json
  -h, --help                    Print help
  -v, --verbose...              Use verbose output (-vv very verbose/build.rs output)
      --color <WHEN>            Coloring: auto, always, never
      --frozen                  Require Cargo.lock and cache are up to date
      --locked                  Require Cargo.lock is up to date
      --offline                 Run without accessing the network
      --config <KEY=VALUE>      Override a configuration value
  -Z <FLAG>                     Unstable (nightly-only) flags to Cargo, see 'cargo -Z help' for details

Run `cargo help run` for more detailed information.

3、使用 -dd 参数

rust 复制代码 
cargo run -- -dd test 
Debug mode is on
Not printing testing lists...

1.3、配置解析器(Configuring the Parser)

1.3.1、使用 Command 构建解析器

你可以使用 Command 开始构建一个解析器。

rust 复制代码 
use clap::{arg, Command};

fn main() {
    let matches = Command::new("MyApp")
        .version("1.0")
        .author("Kevin K. <kbknapp@gmail.com>")
        .about("Does awesome things")
        .arg(arg!(--two <VALUE>).required(true))
        .arg(arg!(--one <VALUE>).required(true))
        .get_matches();

        println!(
            "two: {:?}",
            matches.get_one::<String>("two").expect("required")
        );
        println!(
            "one: {:?}",
            matches.get_one::<String>("one").expect("required")
        );
}

1、查看帮助文档

rust 复制代码 
cargo run -- --help

Does awesome things

Usage: hello_world --two <VALUE> --one <VALUE>

Options:
      --two <VALUE>  
      --one <VALUE>  
  -h, --help         Print help
  -V, --version      Print version

1.3.2、使用 command! 构建解析器

你也可以使用 command! 宏 构建解析器，不过要想使用 command! 宏，你需要开启 cargo feature。

rust 复制代码 
use clap::{arg, command};

fn main() {
    // requires `cargo` feature, reading name, version, author, and description from `Cargo.toml`
    let matches = command!()
        .arg(arg!(--two <VALUE>).required(true))
        .arg(arg!(--one <VALUE>).required(true))
        .get_matches();

    println!(
        "two: {:?}",
        matches.get_one::<String>("two").expect("required")
    );
    println!(
        "one: {:?}",
        matches.get_one::<String>("one").expect("required")
    );
}

1、查看帮助文档

bash 复制代码 
cargo run -- --help

Usage: hello_world --two <VALUE> --one <VALUE>

Options:
      --two <VALUE>  
      --one <VALUE>  
  -h, --help         Print help
  -V, --version      Print version

1.3.2、使用 Command::next_line_help 方法

使用 Command::next_line_help 方法 可以修改参数打印行为

rust 复制代码 
use clap::{arg, command, ArgAction};

fn main() {
    let matches = command!() // requires `cargo` feature
        .next_line_help(true)
        .arg(arg!(--two <VALUE>).required(true).action(ArgAction::Set))
        .arg(arg!(--one <VALUE>).required(true).action(ArgAction::Set))
        .get_matches();

    println!(
        "two: {:?}",
        matches.get_one::<String>("two").expect("required")
    );
    println!(
        "one: {:?}",
        matches.get_one::<String>("one").expect("required")
    );
}

1、显示帮助文档

bash 复制代码 
cargo run -- --help

Usage: hello_world --two <VALUE> --one <VALUE>

Options:
      --two <VALUE>
          
      --one <VALUE>
          
  -h, --help
          Print help
  -V, --version
          Print version

效果就是：参数的描述和参数是分行的，描述信息在参数下一行。

1.4、添加命令行参数(Adding Arguments)

我们可以使用 Command::arg 方法来添加 Arg 对象来添加命令行参数

rust 复制代码 
use clap::{command, Arg};

fn main() {
    let matches = command!() // requires `cargo` feature
        .arg(Arg::new("name"))
        .get_matches();

    println!("name: {:?}", matches.get_one::<String>("name"));
}

1、查看帮助文档

bash 复制代码 
cargo run -- --help

Usage: hello_world [name]

Arguments:
  [name]  

Options:
  -h, --help     Print help
  -V, --version  Print version

2、使用 name 参数：默认

bash 复制代码 
cargo run
name: None

3、使用 name 参数：blob

bash 复制代码 
cargo run bob
name: Some("bob")

1.4、设置参数行为

需要注意：参数默认值是一个 Set 类型

我们可以使用 Command::action 方法来设置 参数行为。如果可以添加多个只，我们可以使用 ArgAction::Append

rust 复制代码 
use clap::{command, Arg, ArgAction};

fn main() {
    let matches = command!() // requires `cargo` feature
        .arg(Arg::new("name").action(ArgAction::Append))
        .get_matches();

    let args = matches
        .get_many::<String>("name")
        .unwrap_or_default()
        .map(|v| v.as_str())
        .collect::<Vec<_>>();

    println!("names: {:?}", &args);
}

1.5、参数选项

1.5.1、参数选项

一个参数行为的标志：

  • 顺序无关
  • 可选参数
  • 意图清晰
rust 复制代码 
use clap::{command, Arg};

fn main() {
    let matches = command!() // requires `cargo` feature
        .arg(Arg::new("name").short('n').long("name"))
        .get_matches();

    println!("name: {:?}", matches.get_one::<String>("name"));
}

上述代码：我们定义了一个name参数，缩写是n，全拼是name，也就是如下形式

bash 复制代码 
-n, --name <name>

我们使用方式就有如下几种

rust 复制代码 
cargo run -- --name blo
cargo run -- --name=blob
cargo run -- -n blob
cargo run -- -n=blob
cargo run -- -nblob

1.5.2、开启/关闭标志

我们可以是 ArgAction::SetTrue 开启参数

rust 复制代码 
use clap::{command, Arg, ArgAction};

fn main() {
    let matches = command!() // requires `cargo` feature
        .arg(
            Arg::new("verbose")
                .short('v')
                .long("verbose")
                .action(ArgAction::SetTrue),
        )
        .get_matches();

    println!("verbose: {:?}", matches.get_flag("verbose"));
}

1.5.3、参数调用计数

我们可以使用 ArgAction::Count

rust 复制代码 
use clap::{command, Arg, ArgAction};

fn main() {
    let matches = command!() // requires `cargo` feature
        .arg(
            Arg::new("verbose")
                .short('v')
                .long("verbose")
                .action(ArgAction::Count),
        )
        .get_matches();

    println!("verbose: {:?}", matches.get_count("verbose"));
}

默认值是0，多次使用参数就会计数

1.5.4、默认值

我们前面设置的参数都是必选的，但是也可以使用可选的，如果是可选的，我们可以使用 Option 并且可以使用 unwrap_or 方法，也可以使用 Arg::default_value 方法设置默认值。

rust 复制代码 
use clap::{arg, command, value_parser};

fn main() {
    let matches = command!() // requires `cargo` feature
        .arg(
            arg!([PORT])
                .value_parser(value_parser!(u16))
                .default_value("2023"),
        )
        .get_matches();

    println!(
        "port: {:?}",
        matches
            .get_one::<u16>("PORT")
            .expect("default ensures there is always a value")
    );
}

1.5.5、参数校验

1.5.5.1、默认情况

默认情况下，参数被认为是 String，并且使用 UTF-8 校验。

1.5.5.2、枚举值(Enumerated values)

如果你的参数有多个特定的值，我们可以使用 PossibleValuesParser 解析器 或者使用 Arg::value_parser(["val1", ...]) 进行设置。

rust 复制代码 
use clap::{arg, command};

fn main() {
    let matches = command!() // requires `cargo` feature
        .arg(
            arg!(<MODE>)
                .help("What mode to run the program in")
                .value_parser(["fast", "slow"]),
        )
        .get_matches();

    // Note, it's safe to call unwrap() because the arg is required
    match matches
        .get_one::<String>("MODE")
        .expect("'MODE' is required and parsing will fail if its missing")
        .as_str()
    {
        "fast" => {
            println!("Hare");
        }
        "slow" => {
            println!("Tortoise");
        }
        _ => unreachable!(),
    }
}

如果我们开启了 derive feature， 则我们也可以实现 ValueEnum 特征实现相同的功能

rust 复制代码 
use clap::{arg, builder::PossibleValue, command, value_parser, ValueEnum};

#[derive(Copy, Clone, PartialEq, Eq, PartialOrd, Ord)]
enum Mode {
    Fast,
    Slow,
}

// Can also be derived with feature flag `derive`
impl ValueEnum for Mode {
    fn value_variants<'a>() -> &'a [Self] {
        &[Mode::Fast, Mode::Slow]
    }

    fn to_possible_value<'a>(&self) -> Option<PossibleValue> {
        Some(match self {
            Mode::Fast => PossibleValue::new("fast").help("Run swiftly"),
            Mode::Slow => PossibleValue::new("slow").help("Crawl slowly but steadily"),
        })
    }
}

impl std::fmt::Display for Mode {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        self.to_possible_value()
            .expect("no values are skipped")
            .get_name()
            .fmt(f)
    }
}

impl std::str::FromStr for Mode {
    type Err = String;

    fn from_str(s: &str) -> Result<Self, Self::Err> {
        for variant in Self::value_variants() {
            if variant.to_possible_value().unwrap().matches(s, false) {
                return Ok(*variant);
            }
        }
        Err(format!("invalid variant: {s}"))
    }
}

fn main() {
    let matches = command!() // requires `cargo` feature
        .arg(
            arg!(<MODE>)
                .help("What mode to run the program in")
                .value_parser(value_parser!(Mode)),
        )
        .get_matches();

    // Note, it's safe to call unwrap() because the arg is required
    match matches
        .get_one::<Mode>("MODE")
        .expect("'MODE' is required and parsing will fail if its missing")
    {
        Mode::Fast => {
            println!("Hare");
        }
        Mode::Slow => {
            println!("Tortoise");
        }
    }
}

1.5.5.3、校验值(Validated values)

我们可以使用 Arg::value_parser 验证并解析成我们需要的任何类型。

rust 复制代码 
use clap::{arg, command, value_parser};

fn main() {
    let matches = command!() // requires `cargo` feature
        .arg(
            arg!(<PORT>)
                .help("Network port to use")
                .value_parser(value_parser!(u16).range(1..)),
        )
        .get_matches();

    // Note, it's safe to call unwrap() because the arg is required
    let port: u16 = *matches
        .get_one::<u16>("PORT")
        .expect("'PORT' is required and parsing will fail if its missing");
    println!("PORT = {port}");
}

1.5.5.4、自定义解析器(Custom Parser)

我们也可以使用自定义解析器用于改进错误信息提示和额外的验证。

rust 复制代码 
use std::ops::RangeInclusive;

use clap::{arg, command};

fn main() {
    let matches = command!() // requires `cargo` feature
        .arg(
            arg!(<PORT>)
                .help("Network port to use")
                .value_parser(port_in_range),
        )
        .get_matches();

    // Note, it's safe to call unwrap() because the arg is required
    let port: u16 = *matches
        .get_one::<u16>("PORT")
        .expect("'PORT' is required and parsing will fail if its missing");
    println!("PORT = {port}");
}

const PORT_RANGE: RangeInclusive<usize> = 1..=65535;

fn port_in_range(s: &str) -> Result<u16, String> {
    let port: usize = s
        .parse()
        .map_err(|_| format!("`{s}` isn't a port number"))?;
    if PORT_RANGE.contains(&port) {
        Ok(port as u16)
    } else {
        Err(format!(
            "port not in range {}-{}",
            PORT_RANGE.start(),
            PORT_RANGE.end()
        ))
    }
}

1.5.5.5、参数关系(Argument Relations)

我们可以声明 Arg 和 ArgGroup。ArgGroup 用于声明参数关系。

rust 复制代码 
use std::path::PathBuf;

use clap::{arg, command, value_parser, ArgAction, ArgGroup};

fn main() {
    // Create application like normal
    let matches = command!() // requires `cargo` feature
        // Add the version arguments
        .arg(arg!(--"set-ver" <VER> "set version manually"))
        .arg(arg!(--major         "auto inc major").action(ArgAction::SetTrue))
        .arg(arg!(--minor         "auto inc minor").action(ArgAction::SetTrue))
        .arg(arg!(--patch         "auto inc patch").action(ArgAction::SetTrue))
        // Create a group, make it required, and add the above arguments
        .group(
            ArgGroup::new("vers")
                .required(true)
                .args(["set-ver", "major", "minor", "patch"]),
        )
        // Arguments can also be added to a group individually, these two arguments
        // are part of the "input" group which is not required
        .arg(
            arg!([INPUT_FILE] "some regular input")
                .value_parser(value_parser!(PathBuf))
                .group("input"),
        )
        .arg(
            arg!(--"spec-in" <SPEC_IN> "some special input argument")
                .value_parser(value_parser!(PathBuf))
                .group("input"),
        )
        // Now let's assume we have a -c [config] argument which requires one of
        // (but **not** both) the "input" arguments
        .arg(
            arg!(config: -c <CONFIG>)
                .value_parser(value_parser!(PathBuf))
                .requires("input"),
        )
        .get_matches();

    // Let's assume the old version 1.2.3
    let mut major = 1;
    let mut minor = 2;
    let mut patch = 3;

    // See if --set-ver was used to set the version manually
    let version = if let Some(ver) = matches.get_one::<String>("set-ver") {
        ver.to_owned()
    } else {
        // Increment the one requested (in a real program, we'd reset the lower numbers)
        let (maj, min, pat) = (
            matches.get_flag("major"),
            matches.get_flag("minor"),
            matches.get_flag("patch"),
        );
        match (maj, min, pat) {
            (true, _, _) => major += 1,
            (_, true, _) => minor += 1,
            (_, _, true) => patch += 1,
            _ => unreachable!(),
        };
        format!("{major}.{minor}.{patch}")
    };

    println!("Version: {version}");

    // Check for usage of -c
    if matches.contains_id("config") {
        let input = matches
            .get_one::<PathBuf>("INPUT_FILE")
            .unwrap_or_else(|| matches.get_one::<PathBuf>("spec-in").unwrap())
            .display();
        println!(
            "Doing work using input {} and config {}",
            input,
            matches.get_one::<PathBuf>("config").unwrap().display()
        );
    }
}

此时 --set-ver <VER>|--major|--minor|--patch 是一个组的参数。

1.5.5.6、自定义校验(Custom Validation)

我们可以创建自定义校验错误 Command::error 方法可以返回指定错误 Error和自定义错误信息

rust 复制代码 
use std::path::PathBuf;

use clap::error::ErrorKind;
use clap::{arg, command, value_parser, ArgAction};

fn main() {
    // Create application like normal
    let mut cmd = command!() // requires `cargo` feature
        // Add the version arguments
        .arg(arg!(--"set-ver" <VER> "set version manually"))
        .arg(arg!(--major         "auto inc major").action(ArgAction::SetTrue))
        .arg(arg!(--minor         "auto inc minor").action(ArgAction::SetTrue))
        .arg(arg!(--patch         "auto inc patch").action(ArgAction::SetTrue))
        // Arguments can also be added to a group individually, these two arguments
        // are part of the "input" group which is not required
        .arg(arg!([INPUT_FILE] "some regular input").value_parser(value_parser!(PathBuf)))
        .arg(
            arg!(--"spec-in" <SPEC_IN> "some special input argument")
                .value_parser(value_parser!(PathBuf)),
        )
        // Now let's assume we have a -c [config] argument which requires one of
        // (but **not** both) the "input" arguments
        .arg(arg!(config: -c <CONFIG>).value_parser(value_parser!(PathBuf)));
    let matches = cmd.get_matches_mut();

    // Let's assume the old version 1.2.3
    let mut major = 1;
    let mut minor = 2;
    let mut patch = 3;

    // See if --set-ver was used to set the version manually
    let version = if let Some(ver) = matches.get_one::<String>("set-ver") {
        if matches.get_flag("major") || matches.get_flag("minor") || matches.get_flag("patch") {
            cmd.error(
                ErrorKind::ArgumentConflict,
                "Can't do relative and absolute version change",
            )
            .exit();
        }
        ver.to_string()
    } else {
        // Increment the one requested (in a real program, we'd reset the lower numbers)
        let (maj, min, pat) = (
            matches.get_flag("major"),
            matches.get_flag("minor"),
            matches.get_flag("patch"),
        );
        match (maj, min, pat) {
            (true, false, false) => major += 1,
            (false, true, false) => minor += 1,
            (false, false, true) => patch += 1,
            _ => {
                cmd.error(
                    ErrorKind::ArgumentConflict,
                    "Can only modify one version field",
                )
                .exit();
            }
        };
        format!("{major}.{minor}.{patch}")
    };

    println!("Version: {version}");

    // Check for usage of -c
    if matches.contains_id("config") {
        let input = matches
            .get_one::<PathBuf>("INPUT_FILE")
            .or_else(|| matches.get_one::<PathBuf>("spec-in"))
            .unwrap_or_else(|| {
                cmd.error(
                    ErrorKind::MissingRequiredArgument,
                    "INPUT_FILE or --spec-in is required when using --config",
                )
                .exit()
            })
            .display();
        println!(
            "Doing work using input {} and config {}",
            input,
            matches.get_one::<PathBuf>("config").unwrap().display()
        );
    }
}

1.6、子命令(Subcommand)

我们可以使用 Command::subcommand 方法添加子命令。每一个子命令都自己的版本、作者、参数和它的子命令。

rust 复制代码 
use clap::{arg, command, Command};

fn main() {
    let matches = command!() // requires `cargo` feature
        .propagate_version(true)
        .subcommand_required(true)
        .arg_required_else_help(true)
        .subcommand(
            Command::new("add")
                .about("Adds files to myapp")
                .arg(arg!([NAME])),
        )
        .get_matches();

    match matches.subcommand() {
        Some(("add", sub_matches)) => println!(
            "'myapp add' was used, name is: {:?}",
            sub_matches.get_one::<String>("NAME")
        ),
        _ => unreachable!("Exhausted list of subcommands and subcommand_required prevents `None`"),
    }
}
  • 我们使用 Command::arg_required_else_help 如果参数不存在，优雅的退出。
  • 使用 Command::propagate_version 可以打印命令的版本号

1.7、测试

我们可以使用 debug_assert! 宏 或者 使用 Command::debug_assert 方法。

rust 复制代码 
use clap::{arg, command, value_parser};

fn main() {
    let matches = cmd().get_matches();

    // Note, it's safe to call unwrap() because the arg is required
    let port: usize = *matches
        .get_one::<usize>("PORT")
        .expect("'PORT' is required and parsing will fail if its missing");
    println!("PORT = {port}");
}

fn cmd() -> clap::Command {
    command!() // requires `cargo` feature
        .arg(
            arg!(<PORT>)
                .help("Network port to use")
                .value_parser(value_parser!(usize)),
        )
}

#[test]
fn verify_cmd() {
    cmd().debug_assert();
}

二、 Clap 使用方式二：derive feature

2.1、添加依赖

rust 复制代码 
cargo add clap --features derive

使用这种方式，更加符合我们面向对象的设计方案。

2.2、快速开始

rust 复制代码 
use std::path::PathBuf;

use clap::{Parser, Subcommand};

#[derive(Parser)]
#[command(author, version, about, long_about = None)]
struct Cli {
    /// Optional name to operate on
    name: Option<String>,

    /// Sets a custom config file
    #[arg(short, long, value_name = "FILE")]
    config: Option<PathBuf>,

    /// Turn debugging information on
    #[arg(short, long, action = clap::ArgAction::Count)]
    debug: u8,

    #[command(subcommand)]
    command: Option<Commands>,
}

#[derive(Subcommand)]
enum Commands {
    /// does testing things
    Test {
        /// lists test values
        #[arg(short, long)]
        list: bool,
    },
}

fn main() {
    let cli = Cli::parse();

    // You can check the value provided by positional arguments, or option arguments
    if let Some(name) = cli.name.as_deref() {
        println!("Value for name: {name}");
    }

    if let Some(config_path) = cli.config.as_deref() {
        println!("Value for config: {}", config_path.display());
    }

    // You can see how many times a particular flag or argument occurred
    // Note, only flags can have multiple occurrences
    match cli.debug {
        0 => println!("Debug mode is off"),
        1 => println!("Debug mode is kind of on"),
        2 => println!("Debug mode is on"),
        _ => println!("Don't be crazy"),
    }

    // You can check for the existence of subcommands, and if found use their
    // matches just as you would the top level cmd
    match &cli.command {
        Some(Commands::Test { list }) => {
            if *list {
                println!("Printing testing lists...");
            } else {
                println!("Not printing testing lists...");
            }
        }
        None => {}
    }

    // Continued program logic goes here...
}

2.3、配置解析器

2.3.1、配置解析器

我们可以是 Parse 属性开启构建解析器

rust 复制代码 
use clap::Parser;

#[derive(Parser)]
#[command(name = "MyApp")]
#[command(author = "xiaojia")]
#[command(version = "1.0")]
#[command(about = "完成一些事情", long_about = None)]
struct Cli {
    #[arg(long)]
    two: String,
    #[arg(long)]
    one: String,
}

fn main() {
    let cli = Cli::parse();

    println!("two: {:?}", cli.two);
    println!("one: {:?}", cli.one);
}

2.3.2、默认值

我们也可使用使用 #[command(author, version, about)] 形式从 Cargo.toml 读取配置消息

rust 复制代码 
use clap::Parser;

#[derive(Parser)]
#[command(author, version, about, long_about = None)] // Read from `Cargo.toml`
struct Cli {
    #[arg(long)]
    two: String,
    #[arg(long)]
    one: String,
}

fn main() {
    let cli = Cli::parse();

    println!("two: {:?}", cli.two);
    println!("one: {:?}", cli.one);
}

2.3.3、Command::next_line_help 替代

我们可以使用 #[command(next_line_help = true)] 方法替代 Command::next_line_help

rust 复制代码 
use clap::Parser;

#[derive(Parser)]
#[command(author, version, about, long_about = None)]
#[command(next_line_help = true)]
struct Cli {
    #[arg(long)]
    two: String,
    #[arg(long)]
    one: String,
}

fn main() {
    let cli = Cli::parse();

    println!("two: {:?}", cli.two);
    println!("one: {:?}", cli.one);
}

2.4、添加参数

2.4.1、添加可选参数

rust 复制代码 
use clap::Parser;

#[derive(Parser)]
#[command(author, version, about, long_about = None)]
struct Cli {
    name: Option<String>,
}

fn main() {
    let cli = Cli::parse();

    println!("name: {:?}", cli.name.as_deref());
}

2.4.2、添加多值参数

rust 复制代码 
use clap::Parser;

#[derive(Parser)]
#[command(author, version, about, long_about = None)]
struct Cli {
    name: Vec<String>,
}

fn main() {
    let cli = Cli::parse();

    println!("name: {:?}", cli.name);
}

2.4.3、参数选项

2.4.3.1、短参数名称和长参数名称

我们可以使用 #[arg(short = 'n')] 和 #[arg(long = "name")] 属性设置参数的短名称和长名称

rust 复制代码 
use clap::Parser;

#[derive(Parser)]
#[command(author, version, about, long_about = None)]
struct Cli {
    #[arg(short, long)]
    name: Option<String>,
}

fn main() {
    let cli = Cli::parse();

    println!("name: {:?}", cli.name.as_deref());
}

2.4.3.2、开启和关闭

rust 复制代码 
use clap::Parser;

#[derive(Parser)]
#[command(author, version, about, long_about = None)]
struct Cli {
    #[arg(short, long)]
    verbose: bool,
}

fn main() {
    let cli = Cli::parse();

    println!("verbose: {:?}", cli.verbose);
}

需要注意我们默认调用的是clap::ArgAction::SetTrue

2.4.3.3、参数计数

rust 复制代码 
use clap::Parser;

#[derive(Parser)]
#[command(author, version, about, long_about = None)]
struct Cli {
    #[arg(short, long, action = clap::ArgAction::Count)]
    verbose: u8,
}

fn main() {
    let cli = Cli::parse();

    println!("verbose: {:?}", cli.verbose);
}

2.4.3.4、参数默认值

我们使用 #[arg(default_value_t)] 属性来给参数设置默认值

rust 复制代码 
use clap::Parser;

#[derive(Parser)]
#[command(author, version, about, long_about = None)]
struct Cli {
    #[arg(default_value_t = 2020)]
    port: u16,
}

fn main() {
    let cli = Cli::parse();

    println!("port: {:?}", cli.port);
}

2.4.3.5、参数枚举

我们使用 #[arg(value_enum)] 设置参数枚举 结合枚举类

rust 复制代码 
use clap::{Parser, ValueEnum};

#[derive(Parser)]
#[command(author, version, about, long_about = None)]
struct Cli {
    /// What mode to run the program in
    #[arg(value_enum)]
    mode: Mode,
}

#[derive(Copy, Clone, PartialEq, Eq, PartialOrd, Ord, ValueEnum)]
enum Mode {
    /// Run swiftly
    Fast,
    /// Crawl slowly but steadily
    ///
    /// This paragraph is ignored because there is no long help text for possible values.
    Slow,
}

fn main() {
    let cli = Cli::parse();

    match cli.mode {
        Mode::Fast => {
            println!("Hare");
        }
        Mode::Slow => {
            println!("Tortoise");
        }
    }
}

2.4.3.6、参数校验

rust 复制代码 
use clap::Parser;

#[derive(Parser)]
#[command(author, version, about, long_about = None)]
struct Cli {
    /// Network port to use
    #[arg(value_parser = clap::value_parser!(u16).range(1..))]
    port: u16,
}

fn main() {
    let cli = Cli::parse();

    println!("PORT = {}", cli.port);
}

2.4.3.7、自定义解析

rust 复制代码 
use std::ops::RangeInclusive;

use clap::Parser;

#[derive(Parser)]
#[command(author, version, about, long_about = None)]
struct Cli {
    /// Network port to use
    #[arg(value_parser = port_in_range)]
    port: u16,
}

fn main() {
    let cli = Cli::parse();

    println!("PORT = {}", cli.port);
}

const PORT_RANGE: RangeInclusive<usize> = 1..=65535;

fn port_in_range(s: &str) -> Result<u16, String> {
    let port: usize = s
        .parse()
        .map_err(|_| format!("`{s}` isn't a port number"))?;
    if PORT_RANGE.contains(&port) {
        Ok(port as u16)
    } else {
        Err(format!(
            "port not in range {}-{}",
            PORT_RANGE.start(),
            PORT_RANGE.end()
        ))
    }
}

2.4.3.8、参数关系

rust 复制代码 
use clap::{Args, Parser};

#[derive(Parser)]
#[command(author, version, about, long_about = None)]
struct Cli {
    #[command(flatten)]
    vers: Vers,

    /// some regular input
    #[arg(group = "input")]
    input_file: Option<String>,

    /// some special input argument
    #[arg(long, group = "input")]
    spec_in: Option<String>,

    #[arg(short, requires = "input")]
    config: Option<String>,
}

#[derive(Args)]
#[group(required = true, multiple = false)]
struct Vers {
    /// set version manually
    #[arg(long, value_name = "VER")]
    set_ver: Option<String>,

    /// auto inc major
    #[arg(long)]
    major: bool,

    /// auto inc minor
    #[arg(long)]
    minor: bool,

    /// auto inc patch
    #[arg(long)]
    patch: bool,
}

fn main() {
    let cli = Cli::parse();

    // Let's assume the old version 1.2.3
    let mut major = 1;
    let mut minor = 2;
    let mut patch = 3;

    // See if --set_ver was used to set the version manually
    let vers = &cli.vers;
    let version = if let Some(ver) = vers.set_ver.as_deref() {
        ver.to_string()
    } else {
        // Increment the one requested (in a real program, we'd reset the lower numbers)
        let (maj, min, pat) = (vers.major, vers.minor, vers.patch);
        match (maj, min, pat) {
            (true, _, _) => major += 1,
            (_, true, _) => minor += 1,
            (_, _, true) => patch += 1,
            _ => unreachable!(),
        };
        format!("{major}.{minor}.{patch}")
    };

    println!("Version: {version}");

    // Check for usage of -c
    if let Some(config) = cli.config.as_deref() {
        let input = cli
            .input_file
            .as_deref()
            .unwrap_or_else(|| cli.spec_in.as_deref().unwrap());
        println!("Doing work using input {input} and config {config}");
    }
}

2.4.3.9、自定义校验

rust 复制代码 
use clap::error::ErrorKind;
use clap::{CommandFactory, Parser};

#[derive(Parser)]
#[command(author, version, about, long_about = None)]
struct Cli {
    /// set version manually
    #[arg(long, value_name = "VER")]
    set_ver: Option<String>,

    /// auto inc major
    #[arg(long)]
    major: bool,

    /// auto inc minor
    #[arg(long)]
    minor: bool,

    /// auto inc patch
    #[arg(long)]
    patch: bool,

    /// some regular input
    input_file: Option<String>,

    /// some special input argument
    #[arg(long)]
    spec_in: Option<String>,

    #[arg(short)]
    config: Option<String>,
}

fn main() {
    let cli = Cli::parse();

    // Let's assume the old version 1.2.3
    let mut major = 1;
    let mut minor = 2;
    let mut patch = 3;

    // See if --set-ver was used to set the version manually
    let version = if let Some(ver) = cli.set_ver.as_deref() {
        if cli.major || cli.minor || cli.patch {
            let mut cmd = Cli::command();
            cmd.error(
                ErrorKind::ArgumentConflict,
                "Can't do relative and absolute version change",
            )
            .exit();
        }
        ver.to_string()
    } else {
        // Increment the one requested (in a real program, we'd reset the lower numbers)
        let (maj, min, pat) = (cli.major, cli.minor, cli.patch);
        match (maj, min, pat) {
            (true, false, false) => major += 1,
            (false, true, false) => minor += 1,
            (false, false, true) => patch += 1,
            _ => {
                let mut cmd = Cli::command();
                cmd.error(
                    ErrorKind::ArgumentConflict,
                    "Can only modify one version field",
                )
                .exit();
            }
        };
        format!("{major}.{minor}.{patch}")
    };

    println!("Version: {version}");

    // Check for usage of -c
    if let Some(config) = cli.config.as_deref() {
        let input = cli
            .input_file
            .as_deref()
            // 'or' is preferred to 'or_else' here since `Option::as_deref` is 'const'
            .or(cli.spec_in.as_deref())
            .unwrap_or_else(|| {
                let mut cmd = Cli::command();
                cmd.error(
                    ErrorKind::MissingRequiredArgument,
                    "INPUT_FILE or --spec-in is required when using --config",
                )
                .exit()
            });
        println!("Doing work using input {input} and config {config}");
    }
}

2.5、子命令

我们使用 #[command(subcommand)] 属性和#[derive(Subcommand)] 联合起来使用声明子命令。

rust 复制代码 
use clap::{Parser, Subcommand};

#[derive(Parser)]
#[command(author, version, about, long_about = None)]
#[command(propagate_version = true)]
struct Cli {
    #[command(subcommand)]
    command: Commands,
}

#[derive(Subcommand)]
enum Commands {
    /// Adds files to myapp
    Add { name: Option<String> },
}

fn main() {
    let cli = Cli::parse();

    // You can check for the existence of subcommands, and if found use their
    // matches just as you would the top level cmd
    match &cli.command {
        Commands::Add { name } => {
            println!("'myapp add' was used, name is: {name:?}")
        }
    }
}

三、如何选择

我们需要注意 clap 的yaml 支持在新版本之中转移到了 clap_serde 库了。 我们建议使用 derive APi，因为此种方式跟容易阅读、修改；更加保持参数声明和参数读取同步；更容易复用，符合面向对象设计。

我们也可以使用 fncmd 库来实现命令行接口像函数一样使用。

总结

相关推荐
晓纪同学1 小时前
QT-简单视觉框架代码
开发语言·qt
威桑1 小时前
Qt SizePolicy详解：minimum 与 minimumExpanding 的区别
开发语言·qt·扩张策略
飞飞-躺着更舒服1 小时前
【QT】实现电子飞行显示器（简易版）
开发语言·qt
明月看潮生1 小时前
青少年编程与数学 02-004 Go语言Web编程 16课题、并发编程
开发语言·青少年编程·并发编程·编程与数学·goweb
明月看潮生1 小时前
青少年编程与数学 02-004 Go语言Web编程 17课题、静态文件
开发语言·青少年编程·编程与数学·goweb
Java Fans1 小时前
C# 中串口读取问题及解决方案
开发语言·c#
盛派网络小助手1 小时前
微信 SDK 更新 Sample，NCF 文档和模板更新，更多更新日志，欢迎解锁
开发语言·人工智能·后端·架构·c#
∝请叫*我简单先生2 小时前
java如何使用poi-tl在word模板里渲染多张图片
java·后端·poi-tl
Chinese Red Guest2 小时前
python
开发语言·python·pygame
一棵星2 小时前
Java模拟Mqtt客户端连接Mqtt Broker
java·开发语言
热门推荐
01Cube-Studio：开源大模型全链路一站式中台02ARM学习（31）编译器对overlay方式的支持03玄机平台应急响应—webshell查杀04Ubuntu 20.04使用Livox mid 360 测试 FAST_LIO05校验 GPT-4 真实性的三个经典问题：快速区分 GPT-3.5 与 GPT-4，并提供免费测试网站06Docker 夺命连环 15 问07构建高效的广告投放系统：应用架构的设计与实现08基于大语言模型（LLM）的合成数据生成、策展和评估的综述09(欧拉)openEuler系统添加网卡文件配置流程、(欧拉)openEuler系统手动配置ipv6地址流程、(欧拉)openEuler系统网络管理说明10【一文读懂】NTN（非地面网络）技术介绍