litprinter 0.3.0

The most sophisticated debug printing library for Python - IceCream + Rich fusion with syntax highlighting and beautiful tracebacks

🔥 LitPrinter

IceCream + Rich = LitPrinter — The ultimate debug printing library for Python

A powerful fusion of IceCream-style debugging with Rich-style formatting, syntax highlighting, and beautiful tracebacks.

🚀 Why LitPrinter?

LitPrinter is a drop-in replacement for IceCream with additional Rich-style features:

Feature	print()	IceCream	LitPrinter
Shows variable names	❌	✅	✅
Syntax highlighting	❌	✅	✅
Rich-style panels	❌	❌	✅
Pretty tracebacks	❌	❌	✅
Configurable colors	❌	❌	✅
Enable/disable toggle	❌	✅	✅

⚡ Quick Start

pip install litprinter

from litprinter import ic

x = 42
ic(x)  # Output: ic| x: 42

That's it! LitPrinter automatically shows both the variable name and its value with beautiful syntax highlighting.

🎯 IceCream-Compatible API

LitPrinter is fully compatible with IceCream's API:

from litprinter import ic

# Basic debugging
x, y = 10, 20
ic(x, y)  # ic| x: 10, y: 20

# Works with expressions
ic(x * 2)  # ic| x * 2: 20

# Configure output
ic.configureOutput(prefix='DEBUG| ')
ic.configureOutput(includeContext=True)

# Enable/disable
ic.disable()  # Silent, but still returns values
ic.enable()   # Re-enable output

# Format without printing
s = ic.format(x, y)

🎨 Color Themes

LitPrinter includes multiple color themes:

from litprinter import ic, set_style, SolarizedDark, LitStyle, CyberpunkStyle, MonokaiStyle

# Default is SolarizedDark (IceCream-compatible)
ic(x)

# Switch to vibrant LitStyle
set_style(LitStyle)
ic(x)

# Try neon Cyberpunk
set_style(CyberpunkStyle)
ic(x)

# Classic Monokai
set_style(MonokaiStyle)
ic(x)

Available Themes:

• SolarizedDark - IceCream-compatible (default)
• LitStyle - Vibrant and modern
• CyberpunkStyle - Neon pink, teal, green
• MonokaiStyle - Classic code editor theme

✨ Features

📊 Smart Object Formatting

data = {
    "users": ["alice", "bob"],
    "settings": {"theme": "dark"}
}
ic(data)  # Formatted with proper indentation and highlighting

🔍 Context-Aware Output

def calculate_total(a, b):
    ic(a, b, includeContext=True)
    # Output: ic| [script.py:3 in calculate_total()] >>> a: 10, b: 20
    return a + b

🧵 Inline Usage

# Use inline - ic() returns the value
result = ic(calculate(x))  # Prints AND returns the value

💥 Beautiful Tracebacks

from litprinter.traceback import install

install(
    theme="cyberpunk",
    show_locals=True,
    extra_lines=3
)

# Now all exceptions show beautiful tracebacks!

🖼️ Rich-Style Panels

from litprinter import Panel, Console

# Create bordered panels
panel = Panel("Hello, World!", title="Greeting")
print(panel)

# Rich-style console
console = Console()
console.print("[bold red]Error:[/bold red] Something went wrong!")

🔧 Configuration

Global Configuration

from litprinter import ic

ic.configureOutput(
    prefix='DEBUG| ',           # Custom prefix
    includeContext=True,        # Show file/line/function
    contextAbsPath=False,       # Use relative paths
    outputFunction=my_logger,   # Custom output function
)

Per-Call Override

ic(x, includeContext=True)  # Override for this call only

Custom Formatters

from litprinter import argumentToString

class MyClass:
    def __init__(self, name):
        self.name = name

@argumentToString.register(MyClass)
def format_myclass(obj):
    return f"MyClass({obj.name})"

ic(MyClass("test"))  # ic| MyClass(test)

🌐 Global Installation

Make ic() available everywhere without imports:

from litprinter.builtins import install

install()

# Now works anywhere!
ic(x)

📦 Migration from IceCream

Just change your import:

# Before
from icecream import ic

# After
from litprinter import ic

All IceCream features work identically, plus you get:

• Multiple color themes
• Rich-style panels and console
• Beautiful tracebacks
• Panel rendering

📚 API Reference

Main Functions

Function	Description
ic(*args)	Debug print with variable names
ic.configureOutput(...)	Configure output settings
ic.disable() / ic.enable()	Toggle output
ic.format(*args)	Format without printing
set_style(style)	Set color theme

Aliases

Alias	Same as
LIT	ic
litprint	ic
lit	ic

Traceback Functions

Function	Description
traceback.install(**kwargs)	Install pretty tracebacks
traceback.uninstall()	Restore default tracebacks
PrettyTraceback(...)	Create traceback formatter

🆕 What's New in v0.3.0

• IceCream-compatible API: Full ic.configureOutput(), ic.disable(), ic.enable() support
• Multiple color themes: SolarizedDark, LitStyle, CyberpunkStyle, MonokaiStyle
• Style switching: set_style() to change colors at runtime
• Rich-style features: Console, Panel, styled text
• Pretty tracebacks: Frame suppression, max_frames, Rich protocols
• Dynamic versioning: Version from __init__.py
• Cleaner codebase: Removed duplicate code, simplified architecture

🤝 Contributing

Contributions are welcome! See CONTRIBUTING.md for details.

---

Made with ❤️ by OEvortex