#prompt #command-line #console #terminal #npm-package #cli

cliclack

Beautiful, minimal, opinionated CLI prompts inspired by the Clack NPM package

25 releases

0.3.5 Sep 12, 2024
0.3.2 Jul 8, 2024
0.1.13 Feb 27, 2024
0.1.10 Dec 20, 2023
0.1.6 Jul 23, 2023

#44 in Command-line interface

Download history 1722/week @ 2024-08-18 2310/week @ 2024-08-25 2491/week @ 2024-09-01 2888/week @ 2024-09-08 4293/week @ 2024-09-15 3730/week @ 2024-09-22 3667/week @ 2024-09-29 7181/week @ 2024-10-06 5743/week @ 2024-10-13 5509/week @ 2024-10-20 5428/week @ 2024-10-27 5075/week @ 2024-11-03 5066/week @ 2024-11-10 4305/week @ 2024-11-17 4252/week @ 2024-11-24 3881/week @ 2024-12-01

17,713 downloads per month
Used in 24 crates (23 directly)

MIT license

255KB
2K SLoC

CliClack Logo

Effortlessly build beautiful command-line apps with Rust 🦀✨

github.com crates.io docs.rs license

Beautiful, minimal, opinionated CLI prompts inspired by the @clack/prompts npm package.

cargo add cliclack

cliclack in action

cargo run --example basic
cargo run --example log
CliClack Example

💎 Fancy minimal UI
✅ Simple API
🎨 Theme support

Setup

The intro and outro/outro_cancel functions will print a message to begin and end a prompt session respectively.

use cliclack::{intro, outro};

intro("create-my-app")?;
// Do stuff
outro("You're all set!")?;

Input

The input prompt accepts a single line of text trying to parse it into a target type. Multiline input can be enabled using the multiline() switch.

use cliclack::input;

let path: String = input("Where should we create your project?")
    .placeholder("./sparkling-solid")
    .validate(|input: &String| {
        if input.is_empty() {
            Err("Please enter a path.")
        } else if !input.starts_with("./") {
            Err("Please enter a relative path")
        } else {
            Ok(())
        }
    })
    .interact()?;

🎨 Theme

A custom theme can be applied for UI rendering. An example of theme customization:

cargo run --example theme
CliClack Magenta Theme

🚥 Progress Bar

Starting from cliclack = "0.2.3", progress bars and multi-progress bars are supported.

CliClack Multi Progress Bar

See more

Dependencies

~3–11MB
~107K SLoC