# 📦 ascii-builder-z

<p align="center">
  <img src="https://raw.githubusercontent.com/PKief/vscode-material-icon-theme/master/icons/python.svg" width="100" height="100" alt="icon" />
</p>

## 🚀 Introduction

**ascii-builder-z** is a professional, high-density ASCII art generator for Python. It converts strings into bold, horizontal block text while maintaining full compatibility with Python's standard `print()` functionality.

## ✨ Features

- █ **Thick Characters**: Bold A-Z and 0-9 character sets using high-density blocks.
- 🎨 **Color Support**: Red, Green, Blue, and Yellow terminal colors.
- 🌈 **Gradient System**: Smooth color transitions across your text.
- 📏 **Spacing Control**: Adjustable horizontal gaps between ASCII characters.
- 🔄 **Smart Printing**: Automatically detects when to use ASCII or standard printing.
- 🛡️ **Alias Mapping**: Special `az.set.name` configuration for custom text triggers.

## 🛠️ Installation

```bash
# Clean install/upgrade
pip install ascii-builder-z --upgrade
```

## 📖 Complete Usage Guide

### 1. Basic ASCII Printing
```python
import az

# Prints "HELLO" in thick ASCII blocks
az.print("HELLO")
```

### 2. Spacing Control
Adjust the gap between characters (default is 1).
```python
az.set.space = 3
az.print("WIDE")
```

### 3. Color Styling
Supports `red`, `green`, `blue`, and `yellow`.
```python
az.set.color = "red"
az.print("DANGER")
```

### 4. Custom Name Mapping
Users can define their own custom text triggers.
```python
# Map "APP123" trigger to print "REPLIT" in ASCII
az.set.name["REPLIT"] = "APP123"
az.print("APP123") 
```

### 5. Standard Print Compatibility
`az.print` acts like a drop-in replacement for the built-in `print`.
```python
# Multiple arguments (Prints normally)
az.print("System Status:", 200, "OK")
```

### 6. RGB Color Support
Use RGB tuples `(R, G, B)` or strings `"R,G,B"`.
```python
az.set.element_colors = {"A": (150, 50, 250)}
az.print("A")
```

### 7. Gradient Color Support
Create beautiful color transitions across your text.
```python
# Create a Red to Blue gradient
az.set.gradient = ((255, 0, 0), (0, 0, 255))
az.print("RAINBOW")
```

---
<p align="center">
  <b>Author:</b> 3xboiz | <b>License:</b> Proprietary (2026-3026) | <b>All Rights Reserved</b>
</p>
