Lexopt

Lexopt 是一个 Rust 的参数解析器。它试图采用最简单的设计，同时确保正确性。它的简单性使得使用起来略显繁琐。

Lexopt 的特点：

• 小巧：单个文件，无依赖，无宏。易于审计或商业化。
• 正确：支持标准约定，避免歧义。经过测试和模糊测试。
• 严格：参数作为 OsString 返回，强制您显式转换。这可以让您处理坏编码的文件名。
• 命令式：选项按找到的顺序返回，无需预先声明。
• 简约：仅提供最基本的功能。
• 不友好：没有帮助生成，错误消息经常缺乏上下文。

示例

struct Args {
    thing: String,
    number: u32,
    shout: bool,
}

fn parse_args() -> Result<Args, lexopt::Error> {
    use lexopt::prelude::*;

    let mut thing = None;
    let mut number = 1;
    let mut shout = false;
    let mut parser = lexopt::Parser::from_env();
    while let Some(arg) = parser.next()? {
        match arg {
            Short('n') | Long("number") => {
                number = parser.value()?.parse()?;
            }
            Long("shout") => {
                shout = true;
            }
            Value(val) if thing.is_none() => {
                thing = Some(val.into_string()?);
            }
            Long("help") => {
                println!("Usage: hello [-n|--number=NUM] [--shout] THING");
                std::process::exit(0);
            }
            _ => return Err(arg.unexpected()),
        }
    }

    Ok(Args {
        thing: thing.ok_or("missing argument THING")?,
        number,
        shout,
    })
}

fn main() -> Result<(), lexopt::Error> {
    let args = parse_args()?;
    let mut message = format!("Hello {}", args.thing);
    if args.shout {
        message = message.to_uppercase();
    }
    for _ in 0..args.number {
        println!("{}", message);
    }
    Ok(())
}

让我们一步步来看

• 我们使用 Parser::from_env() 开始解析。
• 我们循环调用 parser.next() 以获取所有参数，直到它们用完。
• 我们对参数进行匹配。 Short 和 Long 指示一个选项。
• 要获取属于选项的值（如 10 在 -n 10 中）我们调用 parser.value()。
  • 这返回一个标准的 OsString。
  • 为了方便，使用use lexopt::prelude::*会添加一个类似于str::parse的.parse()方法。
• Value表示一个独立的参数。在这种情况下，是一个文件名。
  • if thing.is_none()是处理位置参数的一个有用模式。如果我们已经找到了thing，我们将它传递给另一个情况。
  • 它还包含一个OsString。
    • 标准的.into_string()方法可以将其解码为普通的String。
• 如果我们不知道如何处理一个参数，我们使用return Err(arg.unexpected())将其转换为错误消息。
• 字符串可以提升为错误以生成自定义错误消息。