#[Mìng Lìng]

A state-driven and data-driven CLI workflow orchestration framework

Documents GitHub →
scroll 

#[derive(Grouped)]
pub struct ResultHello(String);

#[command]
pub fn hello(args: Entry) -> ResultHello {
    let name = args
        .pick_or(&arg![String], || "World".into())
        .unwrap();
    ResultHello(name)
}

#[renderer(buffer)]
pub fn render_hello(hello: ResultHello) {
    r_println!("Hello, {}", hello.0);
}

One Command,
One Function.

✦ Command is just a Function,
✦ Renderer is just a Function,
✦ Mingling wires them together
✦ with no builder boilerplate.

  • #[command] turns a function into a subcommand
  • #[renderer] — output, decoupled from logic
  • pick / pick_or — typed args via arg-picker 
~# my-cli hello
Hello, World!
~# my-cli hello Mingling
Hello, Mingling!

#[command(entry = EntryHello)]
pub fn hello() { /* ... */ }

#[command]
pub fn bye() { /* ... */ }

#[completion(EntryHello)]
pub fn complete_hello(ctx: &ShellContext) -> Suggest {
    if ctx.previous_word == "hello" {
        suggest! {
            "Alice": "The Sender",
            "Bob": "The Receiver",
        }
    } else {
        suggest! {}
    }
}

Type, Tab,
Suggest.

✦ hello offers Alice & Bob,
✦ bye gets a friendly farewell,
✦ Mingling completes by context —
✦ suggestions born at runtime.

View Full Example →

✦ Ready to command your CLI?

You can choose a way to install

# Initialize your project
cargo init

# Add Mingling
cargo add mingling@0.4.0
# Add the Mingling dependency
[dependencies.mingling]
version = "0.4.0"
features = [
    "extras", # extra macro support
    "picker", # argument picker
]
# Download and install mingling-cli
# https://mingling-rs.github.io/mingling/dist/

mling proj-init 0.4.0@basic
nano checklist.toml # Edit

# Run `proj-init` again to deploy
mling proj-init