PythonのTextualでTUIアプリ開発！ターミナルでGUI並みの美しいツールを作ろう

# プロジェクトディレクトリの作成と初期化
mkdir my-tui-app
cd my-tui-app
uv init -p 3.13  # Python 3.13を指定

# Textualとdev用ツールのインストール
uv add textual textual-dev
uv sync

from textual.app import App
from textual.widgets import Static


class Hello(App):
    def compose(self):
        yield Static("Hello, TUI!")


Hello().run()

uv run textual run main.py

# 別のターミナルでコンソールを起動
uv run textual console

# メインターミナルで開発モードで実行
uv run textual run --dev main.py

from textual.app import App
from textual.widgets import Static

class StyledApp(App):
    CSS = """
    Static {
        background: blue;
        color: white;
        padding: 2;
    }
    """
    
    def compose(self):
        yield Static("スタイル付きTUIアプリ")

StyledApp().run()

uv add psutil

# sys_view.py
import psutil
from textual.app import App, ComposeResult
from textual.color import Gradient
from textual.containers import Container, Horizontal, Vertical
from textual.reactive import reactive
from textual.widgets import Footer, Header, ProgressBar, Sparkline, Static


# ---------- ウィジェット定義 ----------
class Gauge(Container):
    """ラベル + ProgressBar + Sparkline のセット"""

    percent = reactive(0.0)
    history = reactive(list)

    def __init__(self, title: str, *, gradient: Gradient, classes: str = "") -> None:
        super().__init__()
        self.title_text = title
        self.gradient = gradient
        self.classes = classes
        self.bar: ProgressBar = ProgressBar(
            total=100, show_eta=False, gradient=self.gradient
        )
        self.spark: Sparkline = Sparkline()

    def compose(self) -> ComposeResult:
        yield Static(self.title_text, classes="gauge-label")
        self.bar = ProgressBar(total=100, show_eta=False, gradient=self.gradient)
        self.spark = Sparkline()
        yield self.bar
        yield self.spark

    def watch_percent(self, value: float) -> None:
        self.bar.update(progress=value)

    def watch_history(self, data: list[int]) -> None:
        self.spark.data = data


# ---------- メイン部分 ----------
class SystemPulseApp(App):
    CSS = """
    Screen { layout: vertical; }
    Container.gauge { border: round #555555; padding: 1 2; height: auto; }
    .gauge-label { text-style: bold; margin-bottom: 1; }
    """

    def compose(self) -> ComposeResult:
        yield Header(show_clock=True)

        rainbow = Gradient.from_colors(
            "#881177",
            "#aa3355",
            "#cc6666",
            "#ee9944",
            "#eedd00",
            "#99dd55",
            "#44dd88",
            "#22ccbb",
            "#00bbcc",
            "#0099cc",
            "#3366bb",
            "#663399",
        )

        with Vertical():
            yield Static("CPU Usage (%)", classes="gauge-label")
            self.cpu_gauge = Gauge("CPU使用率 (%)", gradient=rainbow, classes="gauge")
            yield self.cpu_gauge
            self.mem_gauge = Gauge(
                "メモリ使用率 (%)", gradient=rainbow, classes="gauge"
            )
            yield self.mem_gauge
            with Container(classes="gauge"):
                yield Static("Network I/O (kB/s)", classes="gauge-label")
                self.net_up = Sparkline(id="up")
                yield self.net_up
                self.net_down = Sparkline(id="down")
                yield self.net_down
                with Horizontal():
                    yield Static("↑", classes="arrow")
                    yield self.net_up
                with Horizontal():
                    yield Static("↓", classes="arrow")
                    yield self.net_down

        yield Footer()

    # ---------- ランタイム ----------
    async def on_mount(self) -> None:
        self.cpu_hist, self.mem_hist = [], []
        self.net_hist_up, self.net_hist_down = [], []
        self.prev_net = psutil.net_io_counters()
        self.set_interval(1.0, self.refresh_stats)  # 1 秒ごと更新

    async def refresh_stats(self) -> None:
        # CPU / MEM
        cpu = psutil.cpu_percent()
        mem = psutil.virtual_memory().percent
        self.cpu_hist.append(cpu)
        self.mem_hist.append(mem)
        self.cpu_hist, self.mem_hist = self.cpu_hist[-60:], self.mem_hist[-60:]
        self.cpu_gauge.percent = cpu
        self.mem_gauge.percent = mem
        self.cpu_gauge.history = self.cpu_hist
        self.mem_gauge.history = self.mem_hist

        # NETWORK
        now = psutil.net_io_counters()
        up = (now.bytes_sent - self.prev_net.bytes_sent) / 1024  # kB/s
        down = (now.bytes_recv - self.prev_net.bytes_recv) / 1024
        self.prev_net = now
        self.net_hist_up.append(up)
        self.net_hist_down.append(down)
        self.net_hist_up, self.net_hist_down = (
            self.net_hist_up[-60:],
            self.net_hist_down[-60:],
        )
        self.net_up.data = self.net_hist_up
        self.net_down.data = self.net_hist_down


if __name__ == "__main__":
    SystemPulseApp().run()