<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
});
```
---
## 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:
| [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>