cliux

Crates.io	cliux
lib.rs	cliux
version	0.5.1
created_at	2025-10-30 10:19:54.377299+00
updated_at	2025-12-23 10:48:29.673724+00
description	Styled terminal output made simple — boxes, sections, dividers, and emoji-aware padding for CLI tools.
homepage
repository	https://github.com/Pjdur/cliux
max_upload_size
id	1907931
size	477,733

Pjdur (Pjdur)

documentation

README

cliux

Styled terminal output made simple.

cliux is a lightweight Rust crate for formatting terminal output with clean, readable components — no TUI required. It helps CLI tools present information with structure and style using boxes, sections, dividers, lists, tags, and smart padding.

✨ Features

Boxed — bordered containers with titles and content
Section — titled blocks with horizontal dividers
Divider — customizable horizontal lines
List — bullet-pointed lists with customizable styles
Tag — colored tags with customizable styles
Padding — Unicode-aware padding (emoji-safe)
Input — interactive input fields with customizable styles
Confirm — interactive confirmation prompts with customizable styles

Examples

Boxed

use cliux::Boxed;

fn main() {
    Boxed::new("Cliux Boxed")
        .content("This code uses the cliux library to create a boxed section.")
        .width(61)
        .print();
}

Label

use cliux::Label;

fn main() {
    Label::new("INFO").style("info").print();
    Label::new("✓ Done").style("success").print();
    Label::new("ERROR").style("error").print();
}

Section

use cliux::Section;

fn main() {
    Section::new("Wrapped Section")
        .content("This is a long sentence that will be wrapped intelligently across multiple lines.")
        .width(40)
        .wrap(true)
        .style('─')
        .print();
}

Divider

use cliux::Divider;

fn main() {
    Divider::new(30).style('=').print();
}

List

use cliux::List;

fn main() {
    List::new(vec!["First item", "Second item", "Third item"])
        .bullet("*")
        .width(40)
        .print();

    List::new(vec!["One", "Two", "Three"])
        .numbered()
        .print();
}

Tag

use cliux::Tag;

fn main() {
    Tag::new("beta").rounded().color("yellow").bold(true).print();
    Tag::new("admin").curly().color("red").print();
    Tag::new("draft").print();
}

Table

use cliux::Table;

fn main() {
    Table::new()
        .headers(&["Name", "Status"])
        .row(&["cliux", "active"])
        .row(&["other", "pending"])
        .widths(&[20, 10])
        .bordered(true)
        .print();
}

Note

use cliux::Note;

fn main() {
    Note::new("Be careful with this setting.")
        .kind("warning")
        .style("rounded")
        .width(40)
        .print();

    Note::new("Tip: You can use --force here.")
        .kind("info")
        .style("+")
        .width(40)
        .print();
}

Input

use cliux::Input;

fn main() {
    let name = Input::new("What's your name?")
        .default("Anonymous")
        .bold(true)
        .color("cyan")
        .style("rounded")
        .width(40)
        .prompt();

    println!("Hello, {}!", name);
}

Confirm

use cliux::Confirm;

fn main() {
    let confirmed = Confirm::new("Delete file?")
        .color("red")
        .bold(true)
        .style("square")
        .width(40)
        .default(false)
        .prompt();

    if confirmed {
        println!("File deleted.");
    } else {
        println!("Operation cancelled.");
    }
}