raztint 0.7.0

A zero-dependency Python library for ANSI coloring and smart CLI icons with automatic environment detection

A zero-dependency Python library for ANSI coloring and smart CLI icons that automatically adapt to your environment.

Preview

ASCII Icons	Nerd Font Icons	Unicode Icons

---

Why RazTint?

• Zero dependencies — Python ≥ 3.10 standard library only
• Smart icons — Nerd Font → Unicode → ASCII fallback, detected automatically
• Cross-platform behavior — Linux, macOS, and Windows, including CI
• Minimal setup — import and use; detection is cached and fast

---

Features

• 🎨 Full ANSI 16-color foreground and background support
• ✨ Text styles: bold, dim, italic, underline, strikethrough
• 🔍 Status icons with three-tier fallback and environment-aware detection
• 🖌️ paint() — one call for color, background, styles, and icons
• 🎯 Intents — semantic presets (success, danger, warning, …)
• 🔒 Redaction — mask secrets in logs before printing
• 💡 Fully type-hinted public API (py.typed, IDE autocompletion)
• ⚙️ Configurable via environment variables (NO_COLOR, RAZTINT_FORCE_COLOR, …)

---

Requirements

• Python 3.10 or newer

---

Installation

pip install raztint

From source:

git clone https://github.com/razbuild/raztint.git
cd raztint
uv sync

---

Quick Start

from raztint import green, ok, paint

print(green("Success!"))          # green text
print(f"{ok()} File saved.")      # ✓  File saved.
print(paint("Connection failed.", color="red", icon="err"))  # ✗  Connection failed.

# Semantic intents
print(paint("Deployment complete.", intent="success"))

# Mask secrets before logging
print(paint("password=1234", intent="debug", redact=True))  # password=****

Standalone redaction without formatting:

from raztint import redact

print(redact("password=supersecret api_key=ghp_abc123"))
# password=**** api_key=****

See Getting Started for more examples.

---

Documentation

Guide	Description
Getting Started	Functional usage, paint(), and the tint instance
API Reference	Colors, styles, icons, and RazTint class methods
Intents	Semantic presets for common CLI messages
Security & Redaction	Masking tokens, credentials, and custom rules
Icons & Detection	Icon modes and font/color detection logic
Configuration	Environment variables and runtime toggles
Development	Local setup, tests, and linting

---

Contributing

PRs and issues are welcome. If you find a bug or want to add a feature, open an issue first so we can discuss it. See CONTRIBUTING.md for setup and guidelines.

---

License

MIT License