#command-line #pretty #parse #parser #cli-parser #terminal

scalp

一个用于美观且高度可定制的命令行界面的声明式解析库

13 个不稳定版本 (3 个重大更改)

0.4.3 2024年3月31日
0.4.2 2024年3月30日
0.4.0 2024年2月28日
0.3.1 2024年2月24日
0.1.1 2024年2月2日

#486命令行界面

Download history 1/week @ 2024-05-25

1,033 每月下载次数

MIT 许可证

140KB
4K SLoC

scalp


一个用于美观且高度可定制的命令行界面的声明式解析库。它提供了一个可组合和可扩展的 `Parse` 特性,确保与宏全量方法具有可比的性能,同时提供更大的灵活性和可理解性。

更少魔法,更多控制,同样的速度。


入门指南

extern crate scalp;

use std::fs;
use scalp::*;

fn main() -> Result<(), Error> {
    #[derive(Debug, PartialEq, Eq)]
    enum Command {
        Run { settings: Option<String>, path: String },
        Show,
    }

    struct Root {
        debug: bool,
        yes: bool,
        force: bool,
        recurse: bool,
        command: Command,
    }

    let parser = Parser::builder()
        .case(Case::Kebab { upper: false })
        .option(|option| option.name("d").name("debug").help("Debug mode.").default(false))
        .option(|option| option.name("y").name("yes").swizzle().default(false))
        .option(|option| option.name("f").name("force").swizzle().default(false))
        .option(|option| option.name("r").name("recurse").swizzle().default(false))
        .options([Options::version(true, true), Options::help(true, true)])
        .group(|group| group
            .verb(|verb| verb.name("run")
                .usage("example run [OPTIONS]")
                .option(|option| option.position().require())
                .option(|option| option.name("s").name("settings").parse::<String>().map(|path| fs::read_to_string(path?).ok()))
                .map(|(file, settings)| Command::Run { path: file, settings }))
            .verb(|verb| verb.name("show").map(|_| Command::Show))
            .any()
            .require()
        )
        .map(|(debug, yes, force, recurse, command)| Root { debug, yes, recurse, force, command })
        .line()
        .note("Documentation: https://docs.rs/scalp/latest/scalp/")
        .build()?;

    let root = parser.parse_with(["--debug", "-fyr", "run", "./", "-s", "./settings.json"], [("", "")])?;
    assert!(root.debug);
    assert!(root.force);
    assert!(root.yes);
    assert!(root.recurse);

    let Command::Run { path, .. } = root.command else { panic!(); };
    assert_eq!(path, "./");
    Ok(())
}

依赖项

~2.3–4.5MB
~76K SLoC