chant 0.1.1

Shell glamour - beautiful prompts and output for scripts 🪄
Documentation

<h1 align="center">🪄 Chant</h1>

<p align="center">
  <strong>Shell glamour - beautiful prompts and output for scripts.</strong>
</p>

<p align="center">
  <a href="https://crates.io/crates/chant"><img src="https://img.shields.io/crates/v/chant.svg?style=flat-square&logo=rust" alt="Crates.io"></a>
  <a href="https://docs.rs/chant"><img src="https://img.shields.io/docsrs/chant?style=flat-square&logo=docs.rs" alt="Documentation"></a>
  <a href="#license"><img src="https://img.shields.io/badge/license-MIT%2FApache--2.0-blue?style=flat-square" alt="License"></a>
</p>

---

## What is Chant?

To **chant** is to speak magical words. This crate lets you speak beautifully to your users through interactive prompts and styled output.

---

## Features

```rust
use chant::{input, confirm, choose, spin};

// Get user input
let name = input("What's your name?")
    .placeholder("Enter name...")
    .run();

// Confirm an action
if confirm("Continue?").default(true).run() {
    // ...
}

// Choose from options
let choice = choose(&["Option A", "Option B", "Option C"])
    .header("Pick one:")
    .run();

// Show a spinner while working
spin("Loading...").run(|| {
    std::thread::sleep_ms(2000);
});
```

---

## CLI Usage

```bash
# Install
cargo install chant

# Use in scripts
NAME=$(chant input --prompt "Name:")
chant confirm "Deploy?" && ./deploy.sh
CHOICE=$(chant choose "dev" "staging" "prod")
chant spin "Installing..." --duration 3
```

---

## Installation

```bash
cargo add chant
```

---

## Ecosystem

Part of the **Molten Labs** open source ecosystem:

| Crate | Description |
|-------|-------------|
| [molten_brand]https://crates.io/crates/molten_brand | Design tokens & colors |
| [glyphs]https://crates.io/crates/glyphs | ANSI escape sequences |
| [lacquer]https://crates.io/crates/lacquer | Terminal styling |
| [tuyere]https://crates.io/crates/tuyere | TUI framework |
| [scoria]https://crates.io/crates/scoria | TUI components |
| **chant** | Shell glamour (you are here) |
| [aglow]https://crates.io/crates/aglow | Markdown renderer |
| [censer]https://crates.io/crates/censer | Pretty logging |

---

## License

MIT OR Apache-2.0

<p align="center">
  <sub>Built with 🪄 by <a href="https://github.com/moltenlabs">Molten Labs</a></sub>
</p>