ASCII-Art | Text to ASCII Art Generator

🚀 TL;DR Overview

ASCII-Art is a command-line tool that converts regular text into stylized ASCII art using predefined banner templates. Built with Go's standard library for maximum performance and portability.

Perfect for: creating eye-catching headers, banners, terminal art, or learning Go project structure with comprehensive testing.

⚡ Quick Start

git clone https://github.com/g-laliotis/ascii-art.git cd ascii-art go run ./cmd/ascii-art "Hello World" # Using Makefile make build ./ascii-art "Your Text Here" # Run tests make test

🎨 Features & Capabilities

📝 Standard Banner

High-quality ASCII art using standard banner template with support for all printable ASCII characters

🌈 Color Support

Colorize entire output or specific substrings with ANSI colors (red, green, blue, yellow, magenta, cyan, white, orange)

🔄 Multi-line Support

Handle newlines (\n) for complex layouts and multi-line ASCII art compositions

⚡ Lightning Fast

Zero dependencies - uses only Go standard library for maximum performance and portability

🎯 Character Perfect

Supports letters, numbers, spaces, and special characters with precise 8-line formatting

📱 Terminal Adaptive

Automatic terminal width detection and smart text wrapping for any screen size

🧪 Testing & Quality

Comprehensive test suite with 50+ test cases covering unit tests, integration tests, edge cases, and all ASCII characters. Automated CI/CD ensures reliability.

make test # Run all tests with verbose output make test-coverage # Run tests with coverage report make build # Build optimized binary make help # Show all available commands

🛠️ Professional Architecture

📁 Clean Structure

Standard Go project layout with cmd/ and internal/ directories

🧪 100% Coverage

Comprehensive test suite covering all functionality and edge cases

🔧 Makefile Build

Professional build system with test, build, install, and clean targets

📋 Open Source

MIT licensed with contributing guidelines and GitHub Actions CI

📚 Usage Examples

# Basic text go run ./cmd/ascii-art "Hello" # Color entire output go run ./cmd/ascii-art --color=red "Hello" # Color specific substring go run ./cmd/ascii-art --color=blue kit "a king kitten have kit" # Multi-line text go run ./cmd/ascii-art "Hello\nWorld" # Special characters and numbers go run ./cmd/ascii-art "Hello There! 123" # Available colors: red, green, yellow, blue, magenta, cyan, white, orange

📖 Documentation

Complete documentation and development resources:

README Contributing License Issues

🎨 ASCII-Art