textual-plotext

What it is and what it does

textual-plotext bridges Plotext, a terminal plotting library, into Textual applications by providing a `PlotextPlot` widget. Instead of calling Plotext functions directly, you access them through the widget's `plt` property, which handles rendering within the Textual event loop and automatically manages plot display without needing explicit `show()` calls.

The widget supports most Plotext plotting functions (scatter, line, bar, etc.) and utility functions like `sin()` and `colorize()`, but excludes file I/O, interactive REPL features, and GIF/video playback. It includes custom themes prefixed with `textual-` that use RGB colors for consistent appearance across terminals, and automatically switches between dark and light mode themes when the Textual app changes modes.

Use it for:

• Build terminal dashboards that display live data plots alongside other Textual widgets.
• Create monitoring tools that render real-time metrics as terminal-based charts.
• Embed scatter, line, or bar plots in CLI applications without leaving the terminal UI framework.
• Visualize mathematical functions or test signals directly within a Textual TUI.
• Develop data exploration tools that combine Textual forms and navigation with Plotext visualizations.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Wraps the Plotext plotting library as a Textual widget, allowing terminal-based plots to be embedded and rendered within Textual applications.

Yes, if you are already using Textual and need terminal-based plotting. The package has low install friction, no security vulnerabilities, and a permissive license. However, note that it is dormant (622 days since last release); adopt it for stable use cases but verify compatibility with your Plotext version and monitor for any upstream breaking changes.

Install

textual-plotext on PyPI

pip install textual-plotext

uv add textual-plotext

poetry add textual-plotext

Installing textual-plotext

Before you install

Low install friction with only two runtime dependencies (plotext and textual). The package is dormant but has a stable last commit and no known vulnerabilities, making it safe to adopt for existing Textual projects.

License in practice

MIT license is permissive and imposes no significant restrictions on use, modification, or distribution in commercial or private projects.

Quickstart

from textual.app import App, ComposeResult
from textual_plotext import PlotextPlot

class PlotApp(App):
    def compose(self) -> ComposeResult:
        yield PlotextPlot()
    def on_mount(self) -> None:
        plt = self.query_one(PlotextPlot).plt
        plt.scatter(plt.sin())
        plt.title("Plot")

Requires Textual and Plotext as runtime dependencies; Python 3.8.1 or later.

Verify before relying

• Whether the dormant status (622 days since last release) indicates ongoing maintenance or abandonment risk.
• Performance characteristics when rendering large datasets or frequent plot updates in Textual apps.
• Compatibility with recent Plotext versions and any breaking changes since the last release.

Package facts

Evidence: textual_plotext-1.0.1-py3-none-any.whl

Tags

More Visualization packages