6 releases
0.3.2 | Sep 24, 2023 |
---|---|
0.3.1 | Sep 24, 2023 |
0.2.2 | Sep 24, 2023 |
#350 in Template engine
22KB
453 lines
Introduction
This library performs batch-like expansions in strings, that is, to expand %VAR%
into their values inside some context. It's like a Windows version of shellexpand.
Aside from context variables, it can also expands number arguments (e.g %1
, %*
) syntax with a list of arguments provided by user.
Unlike shellexpand
, variables that do not exist will expand to empty string.
Usage
See example below on how to define a context. The library also provids a default cmdexpand::env_context
which can expand environment variable.
use cmdexpand::Expander;
fn mycontext(s: &str) -> Option<String> {
match s {
"NAME" => Some(String::from("Alice")),
"HOBBY" => Some(String::from("coding")),
_ => None,
}
}
assert_eq!(Expander::new(r#"echo "%NAME%'s hobby is %HOBBY%""#)
.add_context(&mycontext)
.expand()
.unwrap(),
r#"echo "Alice's hobby is coding""#);
You can provide a list of arguments too.
use cmdexpand::Expander;
assert_eq!(Expander::new("del %*")
.add_args(&["a.txt", "b.txt"])
.expand()
.unwrap(), "del a.txt b.txt");
Dependencies
~1–1.7MB
~36K SLoC