Aargvark 是一个简单且一致的基于 derive 的命令行参数解析工具，与 Clap-derive 同属一类。它目前支持

• 命令行解析
• 帮助

一般来说，这是为了提供灵活、清晰和一致的命令行解析，而不是针对高级用户的优化最小长度解析。

它试图支持任意复杂的命令行参数解析。就像 Serde 一样，您可以以任何方式组合结构体、vec 和枚举。但仅仅因为您能够做到，并不意味着您应该这样做。

$ # This is an example help output, sans light ansi styling
$ spagh set -h
Usage: spagh set IDENTITY DATA

    IDENTITY: BACKED-IDENTITY-ARG       Identity to publish as
    DATA: <PATH> | -                    Data to publish.  Must be json in the structure `{KEY: {"ttl": MINUTES, "value": DATA}, ...}`

BACKED-IDENTITY-ARG: local | card

    An identity with its associated secret.

    local <PATH>                        A file containing a generated key
    card card                           PC/SC card with ED25519 key

card: PCSC-ID PIN

    PCSC-ID: <STRING>                   Card to register, using id per pcscd (not identity id)
    PIN: <STRING>                       Card pin

$

为什么或为什么不

为什么选择这个而不是 Clap？

• 它有一个超级简单的接口（只需在任何枚举/结构体上添加 #[derive(Aargvark)] 即可）
• 它可以解析更复杂的数据类型，如子结构的向量或枚举
• 它更一致

为什么不选择这个？

• 为了简化并保持自相似性，一些命令行解析约定被舍弃了。毕竟，许多命令行约定是不一致的或在嵌套事物时崩溃。
• 奇特的 CLI 解析通常不受支持：一些技巧（如 -v -vv -vvv）会破坏模式，可能永远不会实现。（其他事情只是由于缺乏时间而没有实现）

约定和用法

要将它添加到您的项目中，请运行

cargo add aargvark

要解析命令行参数

1. 定义您想要解析的数据类型，例如

   #[derive(Aargvark)]
   struct MyArgs {
     velociraptor: String,
     deadly: bool,
     color_pattern: Option<ColorPattern>,
   }
   

2. 变体它

   let args = aargvark::vark::<MyArgs>();
   

结构体中的可选字段变为可选参数（--long）。如果您想使用一个在指定时启用的 bool 标志（即不取值），请使用 Option<()>。

您可以派生结构体、枚举和元组，并且有 Vec、HashSet、Map 的实现，其中键和值是作为 K=V 参数的 FromString，以及大多数 Ip 和 SocketAddr 类型，以及内置的 PathBuf。

提供了一些额外的包装器来自动加载（和解析）文件

• AargvarkFile<T>
• AargvarkJson<T> 需要 serde_json 功能
• AargvarkYaml<T> 需要 serde_yaml 功能