clap教程：第2章

最新推荐文章于 2024-10-18 21:11:05 发布
最新推荐文章于 2024-10-18 21:11:05 发布
阅读量594 收藏 7
点赞数 10
分类专栏： 编程开发 # Rust 文章标签： 开发语言 rust
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/dnncool/article/details/136617092
版权

官方参考： https://docs.rs/clap/4.5.1/clap/_derive/_tutorial/chapter_2

附加参数

  1. Postitionals, 位置参数
  2. Options, 选项参数
  3. Flags, 标志参数
  4. Subcommands, 子命令
  5. Defaults, 默认值

位置参数

你可以让用户按其在命令行上的位置指定值：

use clap::Parser;

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

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

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

$ 03_03_positional_derive --help
用法: 03_03_positional_derive[EXE] [名称]

参数:
  [名称]  

选项:
  -h, --help     打印帮助信息
  -V, --version  打印版本号

$ 03_03_positional_derive
name: None

$ 03_03_positional_derive bob
name: Some("bob")

需要注意默认的参数动作是设置（Set）。如果要接受多个值，则可以通过使用 Append 动作并通过 Vec 类型进行重写：

use clap::Parser;

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

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

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

$ 03_03_positional_mult_derive --help
用法: 03_03_positional_mult_derive[EXE] [名称]...

参数:
  [名称]...  

选项:
  -h, --help     打印帮助信息
  -V, --version  打印版本号

$ 03_03_positional_mult_derive
name: []

$ 03_03_positional_mult_derive bob
name: ["bob"]

$ 03_03_positional_mult_derive bob john
name: ["bob", "john"]

选项参数

你可以使用标志为参数命名：

  • 顺序不重要
  • 可选的
  • 意图清晰

要为参数指定标志，可以在字段上使用 #[arg(short = 'n')] 和（或） #[arg(long = "name")] 属性。当没有给出值时（例如 #[arg(short)]），标志将从字段的名称推断。

use clap::Parser;

#[derive(Parser)]
#[command(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());
}

$ 03_02_option_derive --help
用法: 03_02_option_derive[EXE] [选项]

选项:
  -n, --name <名称>  
  -h, --help         打印帮助信息
  -V, --version      打印版本号

$ 03_02_option_derive
name: None

$ 03_02_option_derive --name bob
name: Some("bob")

$ 03_02_option_derive --name=bob
name: Some("bob")

$ 03_02_option_derive -n bob
name: Some("bob")

$ 03_02_option_derive -n=bob
name: Some("bob")

$ 03_02_option_derive -nbob
name: Some("bob")

需要注意默认的参数动作是设置（Set）。如果要接受多个值，则可以通过使用 Append 动作并通过 Vec 类型进行重写：

use clap::Parser;

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

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

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

$ 03_02_option_mult_derive --help
用法: 03_02_option_mult_derive[EXE] [选项]

选项:
  -n, --name <名称>  
  -h, --help         打印帮助信息
  -V, --version      打印版本号

$ 03_02_option_mult_derive
name: []

$ 03_02_option_mult_derive --name bob
name: ["bob"]

$ 03_02_option_mult_derive --name=bob
name: ["bob"]

$ 03_02_option_mult_derive -n bob
name: ["bob"]

$ 03_02_option_mult_derive -n=bob
name: ["bob"]

$ 03_02_option_mult_derive -nbob
name: ["bob"]

标志参数

标志参数也可以是开关，可以是开或关：

use clap::Parser;

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

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

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

$ 03_01_flag_bool_derive --help
用法: 03_01_flag_bool_derive[EXE] [选项]

选项:
  -v, --verbose  
  -h, --help     打印帮助信息
  -V, --version  打印版本号

$ 03_01_flag_bool_derive
verbose: false

$ 03_01_flag_bool_derive --verbose
verbose: true

$ 03_01_flag_bool_derive --verbose --verbose
? 失败
错误：参数 '--verbose' 不能多次使用

用法: 03_01_flag_bool_derive[EXE] [选项]

获取更多信息，请尝试 '--help'。

请注意，默认的 ArgAction 对于 bool 字段是 SetTrue。要

接受多个标志，请通过 Count 来重写 action 属性：

use clap::Parser;

#[derive(Parser)]
#[command(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);
}

$ 03_01_flag_count_derive --help
用法: 03_01_flag_count_derive[EXE] [选项]

选项:
  -v, --verbose...  
  -h, --help        打印帮助信息
  -V, --version     打印版本号

$ 03_01_flag_count_derive
verbose: 0

$ 03_01_flag_count_derive --verbose
verbose: 1

$ 03_01_flag_count_derive --verbose --verbose
verbose: 2

这还表明任何 Arg 方法都可以用作属性。

子命令

子命令使用 #[derive(Subcommand)] 派生，通过在使用该类型的字段上使用 #[command(subcommand)] 属性添加。每个 Subcommand 实例都可以有自己的版本、作者、参数，甚至可以有自己的子命令。

use clap::{Parser, Subcommand};

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

#[derive(Subcommand)]
enum Commands {
    /// 添加文件到 myapp
    Add { name: Option<String> },
}

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

    // 你可以检查是否存在子命令，并在找到时使用它们的匹配，就像处理顶级命令一样
    match &cli.command {
        Commands::Add { name } => {
            println!("'myapp add' 被使用，名称是: {name:?}")
        }
    }
}

我们使用了结构体变体来定义 add 子命令。或者，你也可以使用结构体来定义子命令的参数：

use clap::{Args, Parser, Subcommand};

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

#[derive(Subcommand)]
enum Commands {
    /// 添加文件到 myapp
    Add(AddArgs),
}

#[derive(Args)]
struct AddArgs {
    name: Option<String>,
}

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

    // 你可以检查是否存在子命令，并在找到时使用它们的匹配，就像处理顶级命令一样
    match &cli.command {
        Commands::Add(name) => {
            println!("'myapp add' 被使用，名称是: {:?}", name.name)
        }
    }
}

$ 03_04_subcommands_derive help
用法: 03_04_subcommands_derive[EXE] <命令>

命令:
  add   添加文件到 myapp
  help  打印此消息或给定子命令的帮助信息

选项:
  -h, --help     打印帮助信息
  -V, --version  打印版本号

$ 03_04_subcommands_derive help add
添加文件到 myapp

用法: 03_04_subcommands_derive[EXE] add [名称]

参数:
  [名称]  

选项:
  -h, --help     打印帮助信息
  -V, --version  打印版本号

$ 03_04_subcommands_derive add bob
'myapp add' 被使用，名称是: Some("bob")

当指定命令时，它们是必需的。或者，你可以使用 command: Option<Commands> 来使其可选。

$ 03_04_subcommands_derive
? 失败
用法: 03_04_subcommands_derive[EXE] <命令>

命令:
  add   添加文件到 myapp
  help  打印此消息或给定子命令的帮助信息

选项:
  -h, --help     打印帮助信息
  -V, --version  打印版本号

由于我们指定了 #[command(propagate_version = true)]，因此 --version 标志在所有子命令中都可用：

$ 03_04_subcommands_derive --version
clap [..]

$ 03_04_subcommands_derive add --version
clap-add [..]

默认值

我们之前展示了参数可以是 required 或可选的。当可选时，你可以使用 Option 并且可以 unwrap_or。或者，你可以设置 #[arg(default_value_t)]。

use clap::Parser;

#[derive(Parser)]
#[command(version, about, long_about = None)]
struct Cli

 {
    #[arg(default_value_t = 2020)]
    port: u16,
}

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

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

$ 03_05_default_values_derive --help
用法: 03_05_default_values_derive[EXE] [端口]

参数:
  [端口]  [默认值: 2020]

选项:
  -h, --help     打印帮助信息
  -V, --version  打印版本号

$ 03_05_default_values_derive
port: 2020

$ 03_05_default_values_derive 22
port: 22
dnncool
关注
专栏目录
【Rust每周一库】Clap - 强大的命令行参数解析+帮助说明生成库
Rust语言学习交流
01-31 8664
命令行程序是工程师们最常用的程序形式之一，而编写一个方便使用的命令行程序最重要的就是参数的设置与易读的参数帮助说明。今天为大家搬运的就是专门处理命令性参数以及生成帮助说明的库。clap是...
Rust Clap库学习
yhb_csdn的博客
06-12 2117
Rust Clap库理解学习. 内容主要基于docs.rs的clap官方文档来学习. 以一个例子出发, 先介绍基础的使用流程,之后说明Clap的Attributes的概念和意义.
[RUST]命令行开发工具clap库使用指南
m0_64656053的博客
04-23 982
Rust的clap库是一个用于命令行接口应用程序的参数解析器，主要功能是帮助开发者更轻松、高效的创建具有复杂命令行选项、参数和子命令的应用程序。开发者可以定义命令的结构、所需参数、选项格式、默认值、规则等。除clap还有structopt、pico-args、getopts等库，不过只能提供较简单的命令解析，不如clap功能全面，如果仅做简单的命令行工具可以使用上述其他库。
clap教程：第0章
dnncool的专栏
03-07 987
的值输出相应的消息。接着检查是否存在子命令，并根据子命令的参数值执行相应的操作。时，由于没有提供任何命令行参数，所以程序会执行默认逻辑，即不执行任何操作。时，会根据提供的命令行参数执行相应的操作。它提供了程序的简要描述、用法说明、命令列表、参数说明和选项说明。你可以指定短选项、长选项、值的名称和是否需要值。：定义测试子命令的参数。时，打印出命令行参数的帮助信息。：一个布尔类型的参数，表示是否列出测试值。：一个可选的名称，用于在命令行中操作。参数的值，并输出相应的消息。：枚举值，表示测试子命令。
rust 使用第三方库构建mini命令行工具
ngd-b的博客
06-18 2413
扩展增加一些 crate 库。这些基础库在以后的编程工作中会常用到，他们作为基架存在于项目中，解决项目中的某个问题。
超详细markdown语法和typora教程
不曾留得桃花影
04-27 1780
一、Markdown语法 文章目录一、Markdown语法1.1 标题2.2 字体2.3 各种线2.4 列表2.5 区块2.6 代码2.7 链接2.8 图片2.9 表格三、Typora与数学公式3.1 如何插入数学公式3.2 上标下标3.3 根号3.4 上下水平线3.5 上下水平大括号3.6 向量符号3.7 分数3.8 积分运算符3.9 求和运算符3.10 连乘运算符3.11 特殊符号3.12 矩阵表示3.13 方程组3.14 分段函数四、Typora与HTML4.1 改变字体颜色及大小4.2 改变对齐方式
7.2 Sqoop2安装
王小雷-多面手
07-08 405
7.2 Sqoop2安装 “卜算子·大数据”一个开源、成体系的大数据学习教程。——每周日更新 本节主要内容： Sqoop2环境变量设置 Sqoop2配置文件修改 Sqoop2数据库初始化与验证 开启Sqoop2 关闭Sqoop2 在此之前已经部署好Hadoop（伪分布式或者完全分布式），并设置了Hadoop环境变量（参考第二章 Linux）。 7.2.1 Sqoop环境变量设置 ...
clap-clap:拍手切换背景
04-28
标签“js clap JavaScript”表明这个项目是用JavaScript语言编写的，特别是与声音相关的部分可能使用了Web Audio API或者第三方库如SpeechRecognition API，用于捕捉和解析用户的音频输入。"clap"则特指其主要的交互...
unresolved import `clap::App`
05-13
2. 您的 `clap` 模块版本过低或过高，导致找不到`App`模块。您可以通过在 `Cargo.toml` 文件中指定 `clap` 的版本来解决这个问题。例如，如果您需要使用 `clap` 的 `3.0.0` 版本，可以添加以下行到您的 `Cargo.toml`...
vim-clap：用于Vim和NeoVim的现代高性能通用查找程序和调度程序
02-01
如果没有Rust二进制文件，一些提供程序将无法正常工作或无法正常工作。 可扩展，易于添加新的源提供程序。 借助智能缓存策略可即时查找或分发任何内容。 避免触摸当前的窗口布局，以减少眼睛移动。 在结果列表...
zig-clap:简单的命令行参数解析库
08-04
支持可以多次指定的选项 ( -e 1 -e 2 -e 3 ) 打印来自参数规范的帮助消息。 将帮助消息解析为参数规范。 例子 clap.parse 使用这个库的最简单方法是调用clap.parse函数。 const clap = @import ( "clap" ); ...
Clap - 强大的命令行参数解析+帮助说明生成库
跨链技术践行者
08-03 3236
CLI,cli,command-line,commandline,命令行 命令行程序是工程师们最常用的程序形式之一，而编写一个方便使用的命令行程序最重要的就是参数的设置与易读的参数帮助说明。今天为大家搬运的就是专门处理命令性参数以及生成帮助说明的库。 clap是一个易于使用、高效且功能齐全的库，用于在编写控制台/终端应用程序时解析命令行参数和子命令。 关于 clap用于解析并验证用户在运行命令行程序时提供的命令行参数字符串。 你所需要做的只是提供有效参数的列表，clap会自动处理其余的繁杂工作。 这
开发语言最佳实践
AngelCryToo的专栏
10-13 1715
开发iOS最好的语言是。Swift是由苹果公司推出的一种现代编程语言，专门为iOS、macOS、watchOS和tvOS开发应用程序设计。它的语法简洁、安全性高、性能优越，非常适合构建高效和复杂的iOS应用。Swift支持面向对象和函数式编程，具有出色的可读性和开发效率。另一个常见的语言是，它曾是开发iOS应用的主要语言，但随着Swift的推出，Objective-C逐渐被Swift取代。尽管如此，Objective-C在一些老项目或与Swift互操作时仍然有用。
【02】Windows特殊权限-Trustedinstaller
五指山的网络员
10-17 593
知识点：“TrustedInstaller” 是 Windows 操作系统中的一个特殊账户，用于管理和保护重要的系统文件。它是 Windows 模块安装程序 (Windows Modules Installer) 的一部分，负责安装、修改和删除 Windows 更新和可选组件。默认情况下，许多系统文件和文件夹的所有权归这个账户所有，以防止用户或其他应用程序未经授权修改关键的系统文件。
华山论剑之Rust的Trait
最新发布
10-18 327
Rust的trait就像武林秘籍，它定义了一套行为规范。不同的结构体可以实现同一个trait，就像不同的人可以修炼同一种武功。通过trait，我们可以让我们的代码更加灵活、可复用。
TOML 格式配置文件：简洁与强大的选择
一只皮皮熊
10-16 1004
TOML（Tom's Obvious, Minimal Language）是一种被设计为易于阅读和编写的配置文件格式。它的目标是成为一种简洁、直观且功能强大的配置语言，适用于各种编程语言和应用场景。语法特点TOML 使用类似于 INI 文件的节（section）和键值对（key-value pairs）的结构。每个节以方括号括起来的名称开始，例如。键值对则以键名和值的形式出现，例如。值可以是字符串、整数、浮点数、布尔值、日期时间、数组或表格。字符串可以使用双引号或单引号括起来，也可以不使用引号。例如或。
Rust Reqwest+Rustls 自签名证书校验
bawomingtian123的专栏
10-17 310
所以这里必须保证reqwest引用的rustls库和本地工程一致。以上就是实现不校验签名的逻辑，后续自己可以在对应回调进行逻辑判断。
量化策略交易之PTrade量化软件如何获取逐笔委托行情！get_individual_entrust
WdVX_19162777832的博客
10-16 488
{股票代码(str): [[时间戳毫秒级(int), 价格(float), 委托数量(int), 委托编号(int), 委托方向(int)], ...], "fields": ["business_time", "hq_px", "business_amount", "order_no", "business_direction", "trans_kind"]}Major_axis axis: 数据索引为自然数列(DataFrame)；data_count: 数据条数，默认为50，最大为200(int)；
评论 1
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值