rich-terminal-output

リッチターミナル出力スキル

有効にするタイミング

以下の場合にこのスキルを有効にします：

• CLI アプリケーションを構築するとき
• 構造化データ（テーブル）を表示するとき
• 時間のかかる処理の進捗を表示するとき
• エラー／ステータスパネルを作成するとき
• デバッグ用にオブジェクトを見やすく整形するとき
• ログ出力を見やすくするとき

インストール

uv add rich

# Quick test
python -c "from rich import print; print('[bold green]Rich working![/]')"

基本概念

Console オブジェクト

from rich.console import Console

console = Console()

# Basic output
console.print("Hello, World!")

# Styled output
console.print("[bold red]Error:[/] Something went wrong")
console.print("[green]Success![/] Operation completed")

マークアップ構文

"[bold]Bold[/]"
"[italic]Italic[/]"
"[red]Red text[/]"
"[blue on white]Blue on white background[/]"
"[bold red]Combined styles[/]"
"[link=https://example.com]Click here[/]"

print の置き換え

from rich import print

print("[bold cyan]Styled text[/]")
print({"key": "value"})  # Auto-pretty-prints

テーブル

from rich.console import Console
from rich.table import Table

console = Console()

table = Table(title="User List")

table.add_column("ID", style="cyan", justify="right")
table.add_column("Name", style="magenta")
table.add_column("Email", style="green")
table.add_column("Status", justify="center")

table.add_row("1", "Alice", "[email protected]", "✓ Active")
table.add_row("2", "Bob", "[email protected]", "✓ Active")
table.add_row("3", "Charlie", "[email protected]", "✗ Inactive")

console.print(table)

パネル

from rich.console import Console
from rich.panel import Panel

console = Console()

# Simple panel
console.print(Panel("Operation completed!"))

# Styled panel
console.print(Panel(
    "[green]All tests passed![/]\n\n"
    "Total: 42 tests\n"
    "Time: 3.2s",
    title="Test Results",
    border_style="green"
))

# Error panel
console.print(Panel(
    "[red]Connection refused[/]\n\n"
    "Host: localhost:5432",
    title="[bold red]Error[/]",
    border_style="red"
))

プログレスバー

シンプルなプログレス

from rich.progress import track
import time

for item in track(range(100), description="Processing..."):
    time.sleep(0.01)

複数のタスク

from rich.progress import Progress

with Progress() as progress:
    task1 = progress.add_task("[red]Downloading...", total=100)
    task2 = progress.add_task("[green]Processing...", total=100)

    while not progress.finished:
        progress.update(task1, advance=0.9)
        progress.update(task2, advance=0.6)
        time.sleep(0.02)

構文ハイライト

from rich.console import Console
from rich.syntax import Syntax

console = Console()

code = '''
def hello():
    print("Hello, World!")
'''

syntax = Syntax(code, "python", theme="monokai", line_numbers=True)
console.print(syntax)

ツリー表示

from rich.console import Console
from rich.tree import Tree

console = Console()

tree = Tree("[bold blue]MyProject/[/]")
src = tree.add("[bold]src/[/]")
src.add("main.py")
src.add("config.py")

tests = tree.add("[bold]tests/[/]")
tests.add("test_main.py")

console.print(tree)

ログ連携

import logging
from rich.logging import RichHandler

logging.basicConfig(
    level=logging.INFO,
    format="%(message)s",
    handlers=[RichHandler(rich_tracebacks=True)]
)

logger = logging.getLogger("myapp")
logger.info("Application started")
logger.error("Connection failed")

見やすいトレースバック

from rich.traceback import install

# Call once at startup
install(show_locals=True)

# All exceptions now have beautiful tracebacks

よくある落とし穴

Console インスタンスを再利用する

# ❌ Bad
def show(msg):
    Console().print(msg)  # Creates new instance each time

# ✅ Good
console = Console()
def show(msg):
    console.print(msg)

ユーザー入力をエスケープする

from rich.markup import escape

username = "user[admin]"

# ❌ Bad - brackets break markup
console.print(f"[blue]{username}[/]")

# ✅ Good
console.print(f"[blue]{escape(username)}[/]")

TTY 以外に対応する

import sys

console = Console(force_terminal=sys.stdout.isatty())

CLI アプリケーションのパターン

import click
from rich.console import Console
from rich.panel import Panel

console = Console()

@click.command()
@click.argument('filename')
def process(filename):
    console.print(f"[bold]Processing:[/] {filename}")

    with console.status("[bold green]Working..."):
        result = do_work(filename)

    if result.success:
        console.print(Panel(
            f"[green]Processed {result.count} items[/]",
            title="Success"
        ))
    else:
        console.print(f"[red]Error:[/] {result.error}")

Rich を使わない場合

• 非対話型スクリプト（出力がパイプに渡される場合）
• サーバーサイドのログ記録
• パフォーマンスが重要なループ
• 依存関係を最小限に抑える必要がある場合

関連リソース

詳細なドキュメントについては、AgentUsage/rich_formatting.md を参照してください。以下の内容が含まれます：

• 高度なテーブルのカスタマイズ
• スピナーとステータス表示
• Console の記録
• 連携パターン