A proc-macro based Rust CLI framework
++ A state-driven and data-driven CLI workflow + orchestration framework +
+#[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);
+}
+
- A proc-macro & type-system CLI framework for
- building complex command-line programs with many
- subcommands.
+ ✦ 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
~#
-use mingling::prelude::*;
-
-dispatcher!("greet", CMDGreet => EntryGreet);
-
-fn main() {
- let mut program = ThisProgram::new();
- program.with_dispatcher(CMDGreet);
- program.exec_and_exit();
-}
-
-pack!(ResultGreeting = String);
-
-#[chain]
-fn handle_greet(args: EntryGreet) -> Next {
- let name =
- args.pick_or((), "World").unpack();
- ResultGreeting::new(name)
+#[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! {}
+ }
}
-
-#[renderer]
-fn render_greet(result: ResultGreeting) -> RenderResult {
- let mut r = RenderResult::new();
- writeln!(r, "Hello, {}!", *result).ok();
- r
-}
-
-gen_program!();
- Decouple parsing, business logic, rendering, help - text, and completion — each is just a function with - the right attribute macro. -
-
- With the dispatch_tree feature, your
- subcommand structure is hardened into a prefix tree
- at compile time. O(len) lookup.
-
- Enable comp and get smart,
- context-aware shell completions for bash, zsh, fish,
- and pwsh — no manual registration.
-
- Minimal core dependencies. Pull in advanced features - (REPL, structured output, Clap binding) only when - you need them via feature flags. -
-
- Add general_renderer and your program
- gains --json /
- --yaml flags automatically. Great for
- scripting and pipe workflows.
-
+ ✦ hello offers Alice
+ & Bob,
+ ✦ bye gets a friendly
+ farewell,
+ ✦ Mingling completes by
+ context —
+ ✦ suggestions born at runtime.
+
- Call program.exec_repl() and your CLI
- becomes an interactive shell — perfect for debugging
- and exploration.
-