censer 0.1.0

Beautiful, structured logging for the terminal ⚒️
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99


<h1 align="center">🔥 Censer</h1>

<p align="center">
  <strong>Beautiful, structured logging for the terminal.</strong>
</p>

<p align="center">
  <a href="https://crates.io/crates/censer"><img src="https://img.shields.io/crates/v/censer.svg?style=flat-square&logo=rust" alt="Crates.io"></a>
  <a href="https://docs.rs/censer"><img src="https://img.shields.io/docsrs/censer?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 Censer?

A **censer** burns incense, producing beautiful, visible output. This crate does the same for your logs—gorgeous, human-readable output with colors and structure.

---

## Quick Start

```rust
use censer::{info, warn, error, debug};

// Simple logging
info!("Server started");
warn!("Low disk space");
error!("Connection failed");

// With key-value pairs
info!("Request received"; "method" => "GET", "path" => "/api/users");
// INFO Request received method=GET path=/api/users
```

---

## Custom Logger

```rust
use censer::{Logger, Level};

let logger = Logger::new()
    .with_timestamp()
    .with_icons()
    .min_level(Level::Info);

logger.info("Application started");
// 14:30:45 ℹ️  INFO Application started
```

---

## Log Levels

| Level | Color | Icon |
|-------|-------|------|
| DEBUG | Gray | 🔍 |
| INFO | Blue | ℹ️ |
| WARN | Amber | ⚠️ |
| ERROR | Red | ❌ |
| FATAL | Dark Red | 💀 |

---

## Installation

```bash
cargo add censer
```

---

## 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](https://crates.io/crates/chant) | Shell glamour |
| [aglow](https://crates.io/crates/aglow) | Markdown renderer |
| **censer** | Pretty logging (you are here) |

---

## License

MIT OR Apache-2.0

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