ascii-builder-z 0.1.2

A thick ASCII art generator

📦 ascii-builder-z

🚀 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

# Clean install/upgrade
pip install . --upgrade

📖 Complete Usage Guide

1. Basic ASCII Printing

import az

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

2. Spacing Control

Adjust the gap between characters (default is 1).

az.set.space = 3
az.print("WIDE")

3. Color Styling

Supports red, green, blue, and yellow.

az.set.color = "red"
az.print("DANGER")

4. Custom Name Mapping

Users can define their own custom text triggers.

# 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.

# 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".

az.set.element_colors = {"A": (150, 50, 250)}
az.print("A")

7. Gradient Color Support

Create beautiful color transitions across your text.

# Create a Red to Blue gradient
az.set.gradient = ((255, 0, 0), (0, 0, 255))
az.print("RAINBOW")

---

Author: 3xboiz | License: Proprietary (2026-3026) | All Rights Reserved