pyratatui 0.1.1

🚀🍀 PyRatatui — Professional Python bindings for ratatui 0.29 🦀🤩 | 💥🔥 High-performance Rust TUI engine for building rich terminal applications, interactive CLIs, dashboards, and text-based UIs 💯✨

🌟🚀💎 pyratatui 🐍⚡🔥

---

---

✨🚀💫 Maturin-based Python bindings for ratatui 0.29 🦀🌈🔥

---

---

💖🌟🌈 Partnered with: Alacritty 🔥⚡✨

---

pyratatui bridges Rust's ultra-fast terminal rendering engine 🦀💨 with Python's ergonomic and productive ecosystem 🐍💡💎.

• Native Rust rendering via ratatui 0.29 ⚡🚀
• Fully Pythonic API — fluent builders, snake_case, type stubs 🐍✨
• Async-ready — AsyncTerminal integrates seamlessly with asyncio ⚡💻
• Zero Rustisms in Python API ✅
• ABI3 wheels — one wheel per OS/arch, Python 3.10–3.13+ 💎🌟

---

Installation 💾🛠️

pip install pyratatui 🔥

Build from source (requires Rust stable + maturin 🦀):

pip install maturin
maturin develop --release 🚀

---

Hello World 👋🐀✨

from pyratatui import Terminal, Paragraph, Block, Style, Color

with Terminal() as term:
    while True:
        def ui(frame):
            frame.render_widget(
                Paragraph.from_string("Hello, pyratatui! 🐀💖")
                    .block(Block().bordered().title("Demo 🚀✨"))
                    .style(Style().fg(Color.cyan())),
                frame.area,
            )
        term.draw(ui)
        ev = term.poll_event(timeout_ms=100)
        if ev and ev.code == "q":
            break 🛑

---

Layout & Widgets 📊🖌️💎

from pyratatui import (
    Terminal, Layout, Constraint, Direction,
    Block, Paragraph, Gauge, List, ListItem, ListState,
    Table, Row, Cell, TableState,
    Style, Color,
)

with Terminal() as term:
    list_state = ListState()
    list_state.select(0)
    table_state = TableState()
    table_state.select(0)

    while True:
        def ui(frame):
            chunks = Layout().direction(Direction.Vertical).constraints([
                Constraint.length(3),
                Constraint.fill(1),
                Constraint.length(3),
            ]).split(frame.area)

            frame.render_widget(Block().bordered().title("pyratatui Dashboard 📊💡"), chunks[0])

            body = Layout().direction(Direction.Horizontal).constraints([
                Constraint.percentage(40), Constraint.fill(1)
            ]).split(chunks[1])

            items = [ListItem(f"Server {i+1} ⚡💻") for i in range(8)]
            frame.render_stateful_list(
                List(items)
                    .block(Block().bordered().title("Servers 🖥️🌟"))
                    .highlight_style(Style().fg(Color.yellow()).bold())
                    .highlight_symbol("▶✨"),
                body[0],
                list_state,
            )

            header = Row([Cell("Name 🏷️"), Cell("CPU 💻"), Cell("Mem 🧠")])
            rows = [Row.from_strings(["nginx ⚡", "0.2% 🔹", "128MB 💾"]),
                    Row.from_strings(["redis ⚡", "0.1% 🔹", "64MB 💾"])]
            frame.render_stateful_table(
                Table(rows, [Constraint.fill(1)]*3, header=header)
                    .block(Block().bordered().title("Processes 🧮💎"))
                    .highlight_style(Style().fg(Color.cyan())),
                body[1],
                table_state,
            )

            frame.render_widget(
                Gauge().percent(72).label("CPU: 72% 💚⚡")
                    .style(Style().fg(Color.green()))
                    .block(Block().bordered()),
                chunks[2],
            )

        term.draw(ui)
        ev = term.poll_event(timeout_ms=50)
        if ev:
            if ev.code == "q": break
            elif ev.code == "Down": list_state.select_next()
            elif ev.code == "Up": list_state.select_previous()

---

Async Usage ⚡💻🚀

import asyncio
from pyratatui import AsyncTerminal, Paragraph, Block, Style, Color

async def main():
    tick = 0
    async with AsyncTerminal() as term:
        async for ev in term.events(fps=30):
            def ui(frame, t=tick):
                frame.render_widget(
                    Paragraph.from_string(f"Tick: {t} ⏱️✨")
                        .block(Block().bordered().title("Async 🚀💡"))
                        .style(Style().fg(Color.magenta())),
                    frame.area,
                )
            term.draw(ui)
            tick += 1

asyncio.run(main())

---

API Overview 📚🛠️✨

Module	Types
style	Color, Modifier, Style 🖌️💎
text	Span, Line, Text ✍️✨
layout	Rect, Constraint, Direction, Alignment, Layout 🧩💡
buffer	Buffer 🔹⚡
widgets	Block, Paragraph, List, Table, Gauge, LineGauge, ... 🛠️🚀
terminal	Terminal, Frame, KeyEvent 🎛️💎
async	AsyncTerminal, run_app, run_app_async ⚡💻
errors	PyratatuiError, BackendError, LayoutError, RenderError, ... ❌🔥

Full reference: https://pyratatui.github.io/pyratatui

---

Contributing 🤝✨💡

git clone https://github.com/pyratatui/pyratatui.git
cd pyratatui
python -m venv .venv && source .venv/bin/activate
pip install maturin pytest pytest-asyncio ruff mypy
maturin develop
pytest tests/python/
cargo test 🚀

---

License 📜💎

MIT — see LICENSE

Built with ratatui 🐀💨 and PyO3 🦀⚡

---