plotui 0.5.1__cp39-abi3-win_amd64.whl

plotui/__init__.py

@@ -0,0 +1,47 @@
+"""plotui — interactive 2D/3D terminal plots.
+
+The heavy lifting (data model, 3D camera, rasterization) lives in a Rust core
+exposed as the native ``plotui._plotui`` module. Python owns the event loop and
+input; the native side is a stateless-ish rendering engine.
+
+Quick start::
+
+    from plotui import Plot
+    plot = Plot()
+    h = plot.add_line(xs, ys, name="forecast") # 2D: axes/ticks/legend appear
+    plot.add_line(xs, costs, axis="y2")        # independent right-hand axis
+    plot.add_line(xs, temps, color="red")      # shorthands: "red", "#e63c78"
+    plot.set_colorway("vivid")                 # or a list of colors
+    plot.add_scatter3d(xs, ys, zs, name="A")   # any 3D trace -> orbit camera
+    plot.add_line3d(xs, ys, zs)                # 3D trajectory/curve
+    plot.add_surface3d(xs, ys, Z)              # grid surface, viridis by default
+    plot.extend(h, more_xs, more_ys)           # stream data by trace handle
+
+Pipelines and DAGs::
+
+    from plotui import LayeredLayout, Plot, from_dot, reachable
+    plot = from_dot("digraph { fetch -> clean -> publish }")  # a DOT subset
+    # or lay one out yourself and colour it live:
+    layout = LayeredLayout(n_nodes, edges)     # rankdir="TB" or "LR"
+    xs, ys = layout.positions()
+    h = plot.add_graph2d(xs, ys, edges, labels=names,
+                         routes=layout.routes())
+    plot.set_graph_colors(h, states)           # repaint as the run advances
+    lit = reachable(n_nodes, edges, hovered)   # everything it waits on
+    # In a raw loop: escape = plot.render_kitty(cols, rows, cell_w, cell_h)
+    # In Textual:   use plotui.textual.PlotWidget(plot)
+"""
+
+from ._plotui import (
+    ForceLayout,
+    LayeredLayout,
+    Plot,
+    __version__,
+    from_dot,
+    reachable,
+)
+
+# `__version__` comes from the native module, which takes it from the crate:
+# one number for the whole build. Repeating it here is how it drifted to
+# 0.3.0 while the crates were on 0.4.2.
+__all__ = ["ForceLayout", "LayeredLayout", "Plot", "__version__", "from_dot", "reachable"]

plotui/_cli.py

@@ -0,0 +1,33 @@
+"""The `plotui` console script: exec the bundled native CLI binary.
+
+Prebuilt wheels carry the compiled CLI at ``plotui/_bin/plotui`` (``.exe``
+on Windows); this
+entry point replaces the Python process with it, so ``plotui`` on the
+command line *is* the native binary. Source builds don't bundle it.
+"""
+
+import os
+import sys
+
+
+def main() -> None:
+    name = "plotui.exe" if sys.platform == "win32" else "plotui"
+    exe = os.path.join(os.path.dirname(__file__), "_bin", name)
+    if not os.path.exists(exe):
+        sys.stderr.write(
+            "plotui: this install does not bundle the CLI (source builds don't).\n"
+            "Use a prebuilt wheel, or another install method: https://plotui.xyz/#install\n"
+        )
+        raise SystemExit(1)
+    argv = [exe, *sys.argv[1:]]
+    if sys.platform == "win32":
+        # Windows has no exec: os.execv would spawn and detach, leaving the
+        # console to the shell while the CLI still reads it
+        import subprocess
+
+        raise SystemExit(subprocess.call(argv))
+    try:
+        os.execv(exe, argv)
+    except PermissionError:
+        os.chmod(exe, 0o755)
+        os.execv(exe, argv)