tracedsa 1.0.0__py3-none-any.whl

tracedsa/__main__.py

@@ -0,0 +1,404 @@
+#!/usr/bin/env python3
+from textual.app import App, ComposeResult
+from textual.binding import Binding
+
+from tracedsa.screens.splash import SplashScreen
+from tracedsa.screens.confirm_dialog import ConfirmDialog
+
+import platform
+import os
+
+from tracedsa.bridge import DSBridge
+
+
+SHORTCUTS = {
+    "global": [
+        ("q", "Quit (with confirmation)", "All screens"),
+        ("h / ?", "Show this help screen", "All screens"),
+    ],
+    "splash": [
+        ("enter / s", "Start application", "SplashScreen"),
+    ],
+    "menu": [
+        ("/", "Focus search bar to filter modules", "MainMenu"),
+        ("escape", "Quit (with confirmation)", "MainMenu"),
+    ],
+    "trace": [
+        ("escape", "Return to main menu", "TraceWindow"),
+        ("Tab", "Cycle through buttons and inputs", "TraceWindow"),
+    ],
+}
+
+
+class TraceDSApp(App):
+    CSS_PATH = None
+
+    SHORTCUTS = SHORTCUTS
+
+    DEFAULT_CSS = """
+    /* === App & Screen === */
+    App {
+        background: #1a1a2e;
+        color: #e0e0e0;
+    }
+
+    Screen {
+        background: #1a1a2e;
+        height: 100%;
+    }
+
+    Static, Label {
+        color: #e0e0e0;
+    }
+
+    Container {
+        background: transparent;
+    }
+
+    /* === Main Menu === */
+    #main_menu_container {
+        layout: vertical;
+        width: 100%;
+        height: 100%;
+    }
+
+    #header-section {
+        layout: vertical;
+        align: center middle;
+        width: 100%;
+        height: auto;
+        background: #16213e;
+        border: round #0f3460;
+        padding: 1 2;
+        margin-bottom: 1;
+    }
+
+    #title {
+        color: #ffffff;
+        text-style: bold;
+        text-align: center;
+        width: 100%;
+    }
+
+    #search_input {
+        width: 40;
+        margin: 1 0;
+        background: #1a1a2e;
+        border: round #0f3460;
+        color: #e0e0e0;
+    }
+
+    #search_input:focus {
+        border: round #00d4ff;
+    }
+
+    #search_input > .input--placeholder {
+        color: #666680;
+    }
+
+    #middle_section {
+        layout: vertical;
+        align: center middle;
+        width: 100%;
+        height: auto;
+        background: #16213e;
+        border: round #0f3460;
+        padding: 1 2;
+        margin-bottom: 1;
+    }
+
+    #random_art {
+        color: #00d4ff;
+        text-align: center;
+        width: 100%;
+    }
+
+    #fun_fact {
+        color: #e0e0e0;
+        text-align: center;
+        text-style: italic;
+        width: 100%;
+        margin-top: 1;
+    }
+
+    #button_section {
+        layout: vertical;
+        align: center middle;
+        width: 100%;
+        height: 1fr;
+        padding: 1 2;
+        overflow-y: auto;
+        overflow-x: hidden;
+    }
+
+    #button_section Horizontal {
+        margin-bottom: 1;
+    }
+
+    /* === Buttons === */
+    Button {
+        background: #16213e;
+        color: #e0e0e0;
+        border: round #0f3460;
+        text-style: bold;
+    }
+
+    Button:hover {
+        background: #00d4ff;
+        color: #1a1a2e;
+    }
+
+    Button:focus {
+        border: round #00d4ff;
+        text-style: bold underline;
+    }
+
+    Button.primary {
+        color: #00d4ff;
+        border: round #00d4ff;
+    }
+
+    Button.primary:hover {
+        background: #00d4ff;
+        color: #1a1a2e;
+    }
+
+    Button.success {
+        color: #ffffff;
+        border: round #0f3460;
+    }
+
+    Button.success:hover {
+        background: #00d4ff;
+        color: #1a1a2e;
+    }
+
+    Button.default {
+        color: #666680;
+        border: round #0f3460;
+    }
+
+    Button.default:hover {
+        color: #e0e0e0;
+        border: round #00d4ff;
+    }
+
+    /* === Trace Window === */
+    #trace_window_container {
+        layout: vertical;
+        width: 100%;
+        height: 100%;
+    }
+
+    #trace_header {
+        layout: horizontal;
+        content-align: left middle;
+        width: 100%;
+        height: auto;
+        background: #16213e;
+        border: round #0f3460;
+        padding: 0 2;
+    }
+
+    #trace_header #back_button {
+        width: auto;
+        color: #666680;
+    }
+
+    #trace_header #back_button:hover {
+        color: #00d4ff;
+    }
+
+    #module_name {
+        color: #ffffff;
+        text-style: bold;
+        text-align: center;
+        width: 1fr;
+    }
+
+    #main_content {
+        layout: horizontal;
+        width: 100%;
+        height: 1fr;
+    }
+
+    #ascii_panel {
+        width: 60%;
+        height: 100%;
+        background: #16213e;
+        border: round #0f3460;
+        padding: 1 2;
+        overflow: auto;
+    }
+
+    #ascii_placeholder {
+        color: #666680;
+        text-align: center;
+    }
+
+    #ascii_panel Static {
+        width: 100%;
+        height: auto;
+    }
+
+    ASCIIArray, ASCIIBranchTree, ASCIIHeap {
+        width: 100%;
+        height: 100%;
+    }
+
+    #log_panel {
+        width: 40%;
+        height: 100%;
+        background: #16213e;
+        border: round #0f3460;
+        layout: vertical;
+        padding: 0 1;
+    }
+
+    #log_header {
+        color: #00d4ff;
+        text-style: bold;
+        width: 100%;
+        text-align: center;
+        padding: 1 0;
+    }
+
+    #log_panel RichLog {
+        background: #1a1a2e;
+        color: #e0e0e0;
+        width: 100%;
+        height: 1fr;
+    }
+
+    OpsLog {
+        width: 100%;
+        height: 1fr;
+    }
+
+    #button_container {
+        width: 100%;
+        height: auto;
+        background: #16213e;
+        border: round #0f3460;
+        padding: 1 2;
+        layout: horizontal;
+        overflow-x: auto;
+    }
+
+    #button_container Horizontal {
+        width: auto;
+        margin-right: 1;
+    }
+
+    #button_container Button {
+        margin: 0 1;
+    }
+
+    .clear-log {
+        margin-left: 3;
+    }
+
+    /* === Status Bar === */
+    #status_bar {
+        color: #666680;
+        text-style: italic;
+        width: 100%;
+        height: auto;
+        padding: 0 2;
+        background: #16213e;
+        border-top: solid #0f3460;
+    }
+
+    /* === Inputs === */
+    Input {
+        background: #1a1a2e;
+        color: #e0e0e0;
+        border: round #0f3460;
+        width: 12;
+        margin-right: 1;
+    }
+
+    Input:focus {
+        border: round #00d4ff;
+    }
+
+    Input > .input--placeholder {
+        color: #666680;
+    }
+
+    #button_container Input {
+        width: 12;
+        max-width: 16;
+        margin: 0 1;
+    }
+
+    /* === Scrollbar === */
+    ScrollBar {
+        background: #1a1a2e;
+    }
+
+    ScrollBar:hover {
+        background: #16213e;
+    }
+
+    ScrollBar > .scrollbar--thumb {
+        background: #00d4ff;
+    }
+
+    ScrollBar > .scrollbar--thumb:hover {
+        background: #ffffff;
+    }
+    """
+
+    TITLE = "TraceDSA"
+    SUB_TITLE = "Data Structures Visualization"
+
+    BINDINGS = [
+        Binding("q", "show_confirm_quit", "Quit", priority=True),
+        Binding("TAB", "cycle_focus", "Cycle Focus")
+    ]
+
+    def __init__(self):
+        super().__init__()
+        self.bridges = {}
+
+    def initialize_bridge(self, name: str) -> bool:
+        sysname = platform.system().lower()
+        binary_path = f"tracedsa/bins/{sysname}/{name}"
+        if os.path.exists(binary_path):
+            try:
+                self.bridges[name] = DSBridge(name)
+                return True
+            except Exception:
+                return False
+        return False
+
+    def get_bridge(self, name: str):
+        return self.bridges.get(name)
+
+    def compose(self) -> ComposeResult:
+        yield from []
+
+    def on_mount(self) -> None:
+        self.push_screen(SplashScreen())
+
+    def action_show_confirm_quit(self) -> None:
+        from tracedsa.screens.confirm_dialog import ConfirmDialog
+        if isinstance(self.screen, ConfirmDialog):
+            self.exit()
+        else:
+            self.push_screen(ConfirmDialog())
+
+    def action_quit(self) -> None:
+        for bridge in self.bridges.values():
+            bridge.close()
+        self.exit()
+
+
+def main():
+    app = TraceDSApp()
+    app.run()
+
+
+if __name__ == "__main__":
+    main()

tracedsa/bridge.py

@@ -0,0 +1,74 @@
+import subprocess
+import platform
+import os
+
+def get_binary(name):
+    system = platform.system().lower()
+    ext = ".exe" if system == "windows" else ""
+    folder = "macos" if system == "darwin" else system
+    base = os.path.dirname(__file__)
+    return os.path.join(base, "bins", folder, f"{name}{ext}")
+
+class DSBridge:
+    def __init__(self, name):
+        self.name = name
+        self.proc = subprocess.Popen(
+            [get_binary(name)],
+            stdin=subprocess.PIPE,
+            stdout=subprocess.PIPE,
+            stderr=subprocess.PIPE,
+            text=True
+        )
+        ready_line = self.proc.stdout.readline().strip()
+        if not ready_line:
+            stderr_tail = self._read_stderr()
+            raise RuntimeError(
+                f"Binary '{name}' produced no output (crashed?). "
+                f"Stderr: {stderr_tail or '(empty)'}"
+            )
+        if ready_line != "READY":
+            raise RuntimeError(f"Expected READY from '{name}', got: {ready_line}")
+
+    def _read_stderr(self):
+        try:
+            return self.proc.stderr.read().strip()
+        except Exception:
+            return None
+
+    def is_alive(self) -> bool:
+        return self.proc.poll() is None
+
+    def send(self, command):
+        if not self.is_alive():
+            raise RuntimeError("Process terminated")
+
+        try:
+            self.proc.stdin.write(command + "\n")
+            self.proc.stdin.flush()
+        except (BrokenPipeError, OSError) as e:
+            raise RuntimeError(f"Failed to send command: {e}")
+
+        try:
+            response = self.proc.stdout.readline()
+        except (ValueError, OSError) as e:
+            raise RuntimeError(f"Failed to read response: {e}")
+
+        if not response:
+            stderr_tail = self._read_stderr()
+            detail = f" (stderr: {stderr_tail})" if stderr_tail else ""
+            raise RuntimeError(f"Binary '{self.name}' closed stdout — likely crashed{detail}")
+
+        return response.strip()
+
+    def close(self):
+        try:
+            if self.is_alive():
+                self.proc.stdin.write("EXIT\n")
+                self.proc.stdin.flush()
+        except (BrokenPipeError, OSError):
+            pass
+        finally:
+            try:
+                self.proc.terminate()
+            except ProcessLookupError:
+                pass

tracedsa/screens/confirm_dialog.py

@@ -0,0 +1,113 @@
+from textual.app import ComposeResult
+from textual.containers import Container, Horizontal
+from textual.widgets import Static, Button
+from textual.screen import Screen
+from textual.binding import Binding
+
+
+class ConfirmDialog(Screen):
+
+    DEFAULT_CSS = """
+    ConfirmDialog {
+        align: center middle;
+        background: rgba(0, 0, 0, 0.7);
+    }
+
+    #confirm-box {
+        width: 44;
+        height: auto;
+        padding: 2 4;
+        background: #16213e;
+        border: round #00d4ff;
+        align: center middle;
+    }
+
+    #confirm-title {
+        text-align: center;
+        width: 100%;
+        color: #ffffff;
+        text-style: bold;
+        margin-bottom: 1;
+    }
+
+    #confirm-subtitle {
+        text-align: center;
+        width: 100%;
+        color: #666680;
+        margin-bottom: 1;
+    }
+
+    #confirm-buttons {
+        align: center middle;
+        width: 100%;
+        height: auto;
+        margin-top: 1;
+    }
+
+    #confirm-y {
+        background: #16213e;
+        border: round #00d4ff;
+        color: #00d4ff;
+        width: 1;
+        margin-right: 1;
+    }
+
+    #confirm-y:hover {
+        background: #00d4ff;
+        color: #1a1a2e;
+    }
+
+    #confirm-n {
+        background: #16213e;
+        border: round #666680;
+        color: #666680;
+        width: 1;
+    }
+
+    #confirm-n:hover {
+        background: #666680;
+        color: #1a1a2e;
+    }
+    """
+
+    BINDINGS = [
+        Binding("y", "confirm", "Yes"),
+        Binding("n", "cancel", "No"),
+        Binding("escape", "cancel", "Cancel"),
+    ]
+
+    def __init__(self, title: str = "Exit TraceDSA?", message: str = "All unsaved state will be lost.", on_confirm = None):
+        super().__init__()
+        self._title = title
+        self._message = message
+        self._on_confirm = on_confirm
+
+    def compose(self) -> ComposeResult:
+        yield Container(
+            Static(self._title, id="confirm-title"),
+            Static(self._message, id="confirm-subtitle"),
+            Horizontal(
+                Button("Yes  [y]", id="confirm-y"),
+                Button("No   [n]", id="confirm-n"),
+                id="confirm-buttons"
+            ),
+            id="confirm-box"
+        )
+
+    def action_confirm(self) -> None:
+        if self._on_confirm:
+            self._on_confirm()
+        else:
+            self.app.exit()
+
+    def action_cancel(self) -> None:
+        self.app.pop_screen()
+
+    def on_button_pressed(self, event: Button.Pressed) -> None:
+        if event.button.id == "confirm-y":
+            if self._on_confirm:
+                self._on_confirm()
+            else:
+                self.app.exit()
+        else:
+            self.app.pop_screen()