pyfiglet renders text as ASCII art using FIGlet fonts. pip install pyfiglet. Basic: import pyfiglet; print(pyfiglet.figlet_format("Hello")). Font: pyfiglet.figlet_format("Hello", font="slant"). Width: pyfiglet.figlet_format("Hello", width=120). Justify: pyfiglet.figlet_format("Hi", justify="center") — left/right/center/auto. Class: from pyfiglet import Figlet; f = Figlet(font="doom"); f.renderText("Hello"). List fonts: pyfiglet.FigletFont.getFonts() — 150+ fonts. Common: standard, slant, banner, big, doom, cyberlarge, isometric3, letters, chunky, digital, ivrit, lean, mini, script, shadow, small, speed, starwars, stop, thin, 3-d, colossal, epic, fire, graffiti, larry3d, smslant, tinker-toy. Width: default 80; set to shutil.get_terminal_size().columns. Color: combine with colorama.Fore.GREEN + figlet_format(...) + colorama.Style.RESET_ALL. Rich: from rich.console import Console; Console().print(f"[green]{figlet_format('Hi')}[/green]"). Print centered: f.renderText("text").center(width). Multiline: newlines in input produce stacked letters. Custom: FigletFont.preloadFont("path/font.flf"). Claude Code generates pyfiglet CLI banners, version headers, and ASCII art startup screens.
CLAUDE.md for pyfiglet
## pyfiglet Stack
- Version: pyfiglet >= 1.0 | pip install pyfiglet
- Basic: pyfiglet.figlet_format("Hello", font="slant", width=80)
- Class: Figlet(font="doom", width=shutil.get_terminal_size().columns)
- Fonts: standard, slant, doom, big, banner, cyberlarge, starwars, isometric3, epic
- Justify: figlet_format("text", justify="center") | "left" | "right"
- List: pyfiglet.FigletFont.getFonts() → 150+ available fonts
- Color: combine with colorama or rich for colored ASCII art outputpyfiglet ASCII Art Banner Pipeline
# app/banners.py — pyfiglet ASCII art, colored banners, and CLI headers
from __future__ import annotations
import random
import shutil
from typing import Any
import pyfiglet
from pyfiglet import Figlet, FigletFont
# ─────────────────────────────────────────────────────────────────────────────
# 1. Core rendering helpers
# ─────────────────────────────────────────────────────────────────────────────
def render(
text: str,
font: str = "standard",
width: int | None = None,
justify: str = "auto",
) -> str:
"""
Render text as ASCII art.
font: any font from FigletFont.getFonts() — "slant", "doom", "big", etc.
width: column width (defaults to terminal width).
justify: "auto", "left", "right", "center"
"""
w = width or shutil.get_terminal_size((80, 24)).columns
return pyfiglet.figlet_format(text, font=font, width=w, justify=justify)
def render_centered(text: str, font: str = "slant", width: int | None = None) -> str:
"""Render centered ASCII art."""
return render(text, font=font, width=width, justify="center")
def render_to_width(text: str, font: str = "big") -> str:
"""Render at full terminal width."""
w = shutil.get_terminal_size((80, 24)).columns
return render(text, font=font, width=w)
# ─────────────────────────────────────────────────────────────────────────────
# 2. Font discovery
# ─────────────────────────────────────────────────────────────────────────────
def list_fonts() -> list[str]:
"""Return all available FIGlet fonts, sorted."""
return sorted(FigletFont.getFonts())
def preview_fonts(text: str = "Hello", fonts: list[str] | None = None) -> None:
"""
Print a preview of each font.
fonts: list to preview; defaults to a curated set.
"""
showcase = fonts or [
"standard", "slant", "doom", "big", "banner", "cyberlarge",
"isometric3", "letters", "starwars", "epic", "shadow", "lean",
]
for font in showcase:
try:
print(f"─── {font} ───")
print(render(text, font=font))
except Exception:
print(f" (failed to render {font!r})\n")
def random_font() -> str:
"""Return a random available font name."""
return random.choice(list_fonts())
# ─────────────────────────────────────────────────────────────────────────────
# 3. Colored banners (requires colorama or rich)
# ─────────────────────────────────────────────────────────────────────────────
def colorama_banner(
text: str,
font: str = "slant",
color: str = "GREEN",
bright: bool = True,
) -> str:
"""
Return a colored ASCII art string using colorama.
color: COLORAMA color name — "GREEN", "RED", "CYAN", "YELLOW", "BLUE", "WHITE"
"""
try:
from colorama import Fore, Style, init
init(autoreset=True)
art = render(text, font=font)
color_code = getattr(Fore, color.upper(), Fore.WHITE)
bright_code = Style.BRIGHT if bright else ""
return f"{bright_code}{color_code}{art}{Style.RESET_ALL}"
except ImportError:
return render(text, font=font)
def rich_banner(
text: str,
font: str = "slant",
style: str = "bold green",
) -> None:
"""Print a styled ASCII art banner using rich.Console."""
try:
from rich.console import Console
from rich.text import Text
console = Console()
art = render(text, font=font)
console.print(Text(art, style=style))
except ImportError:
print(render(text, font=font))
# ─────────────────────────────────────────────────────────────────────────────
# 4. CLI header patterns
# ─────────────────────────────────────────────────────────────────────────────
def cli_header(
title: str,
version: str = "",
subtitle: str = "",
font: str = "slant",
separator: str = "═",
) -> str:
"""
Generate a complete CLI application header:
ASCII art title
══════════════════
subtitle v1.0.0
"""
width = shutil.get_terminal_size((80, 24)).columns
art = render_centered(title, font=font, width=width)
sep = separator * width
parts = [art.rstrip(), sep]
if subtitle or version:
info = f" {subtitle}"
if version:
info = info.rstrip() + f" v{version}"
parts.append(info)
parts.append(sep)
return "\n".join(parts)
def startup_banner(
app_name: str,
version: str,
environment: str = "development",
font: str = "slant",
) -> str:
"""
Generate a startup banner for long-running services.
Shows app name, version, and environment.
"""
art = render_centered(app_name, font=font)
width = shutil.get_terminal_size((80, 24)).columns
sep = "─" * width
env_color_map = {
"production": "🔴 PRODUCTION",
"staging": "🟡 STAGING",
"development": "🟢 DEVELOPMENT",
}
env_label = env_color_map.get(environment.lower(), environment.upper())
lines = [
art.rstrip(),
sep,
f" Version: {version} Environment: {env_label}",
sep,
]
return "\n".join(lines)
def box_header(title: str, font: str = "standard") -> str:
"""Render title in a simple box frame."""
art = render(title, font=font).rstrip()
width = max(len(line) for line in art.split("\n")) + 4
top = "┌" + "─" * (width - 2) + "┐"
bot = "└" + "─" * (width - 2) + "┘"
lines = [top]
for line in art.split("\n"):
if line.strip():
lines.append("│ " + line.ljust(width - 4) + " │")
lines.append(bot)
return "\n".join(lines)
# ─────────────────────────────────────────────────────────────────────────────
# 5. Multi-line and multi-word helpers
# ─────────────────────────────────────────────────────────────────────────────
def word_stack(words: list[str], font: str = "slant") -> str:
"""Render each word on its own line with the same font."""
return "\n".join(render(w, font=font).rstrip() for w in words)
def font_sampler(text: str = "Hello", n: int = 10) -> dict[str, str]:
"""
Return ASCII art for `text` in `n` random fonts.
Returns {"font_name": "rendered art"}.
"""
fonts = random.sample(list_fonts(), min(n, len(list_fonts())))
return {font: render(text, font=font) for font in fonts}
# ─────────────────────────────────────────────────────────────────────────────
# Demo
# ─────────────────────────────────────────────────────────────────────────────
if __name__ == "__main__":
print("=== Basic render ===")
print(render("Hi"))
print("=== Font showcase ===")
showcase_fonts = ["slant", "doom", "big", "banner", "cyberlarge"]
for font in showcase_fonts:
print(f"[{font}]")
print(render("Claude", font=font))
print("=== CLI header ===")
print(cli_header("MyApp", version="2.1.0", subtitle="Fast Python CLI tool"))
print("\n=== Startup banner ===")
print(startup_banner("Paperclip", "1.0.0", environment="development"))
print("\n=== Box header ===")
print(box_header("OK"))
print("\n=== Available fonts count ===")
fonts = list_fonts()
print(f" {len(fonts)} fonts available")
print(f" Sample: {fonts[:10]}")
print("\n=== Centered render ===")
print(render_centered("Python", font="big"))For the art alternative — the art package provides text2art("Hello") with different styles and also exposes random art selection with tprint("Hello", "random"); pyfiglet has more fonts (150+ FIGlet fonts versus art’s smaller set) and is better at the standard FIGlet font ecosystem where most pre-made fonts live; both are suitable for CLI banners. For the figlet command-line tool alternative — figlet is the original C program that pyfiglet reimplements in pure Python; since pyfiglet ships the font files as Python data, your CLI tool has no external dependency and works on every OS without needing to install the figlet binary separately. The Claude Skills 360 bundle includes pyfiglet skill sets covering pyfiglet.figlet_format() with font/width/justify, Figlet() class, FigletFont.getFonts() font discovery, render()/render_centered()/render_to_width() helpers, colorama_banner() colored output, rich_banner() rich-styled output, cli_header() application startup banner, startup_banner() with environment indicator, box_header() framed output, word_stack() multi-word rendering, font_sampler() random font previewer, and preview_fonts() showcase. Start with the free tier to try ASCII art banner code generation.