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 在 命令行界面 中
1,033 每月下载次数
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