voidx-cli 3.5.2__tar.gz

voidx_cli-3.5.2/PKG-INFO

@@ -0,0 +1,9 @@
+Metadata-Version: 2.4
+Name: voidx-cli
+Version: 3.5.2
+Summary: CLI / terminal UI frontend for voidx.
+Author: chikhamx
+License: MIT
+Requires-Python: >=3.11
+Requires-Dist: voidx==3.5.2
+Requires-Dist: rich>=13.9.0

voidx_cli-3.5.2/pyproject.toml

@@ -0,0 +1,21 @@
+[project]
+name = "voidx-cli"
+dynamic = ["version"]
+description = "CLI / terminal UI frontend for voidx."
+license = {text = "MIT"}
+authors = [{name = "chikhamx"}]
+requires-python = ">=3.11"
+dependencies = [
+    "voidx==3.5.2",
+    "rich>=13.9.0",
+]
+
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools.dynamic]
+version = {attr = "voidx_cli.__version__"}
+
+[tool.setuptools.packages.find]
+where = ["."]

voidx_cli-3.5.2/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

voidx_cli-3.5.2/tests/conftest.py

@@ -0,0 +1,4 @@
+import sys
+from pathlib import Path
+
+sys.path.insert(0, str(Path(__file__).parent))

voidx_cli-3.5.2/tests/test_frame_advanced.py

@@ -0,0 +1,293 @@
+from tui_helpers import *  # noqa: F403
+
+import os
+import re
+import shutil
+import sys
+
+from rich.console import Console
+
+from voidx.ui.output.dock import dock
+
+
+def test_render_frame_pins_to_bottom_after_history_fills_terminal(tmp_path, monkeypatch):
+    class FakeStdout:
+        def __init__(self) -> None:
+            self.text = ""
+
+        def write(self, value: str) -> int:
+            self.text += value
+            return len(value)
+
+        def flush(self) -> None:
+            pass
+
+    fake_stdout = FakeStdout()
+    monkeypatch.setattr(sys, "stdout", fake_stdout)
+    monkeypatch.setattr(
+        shutil,
+        "get_terminal_size",
+        lambda fallback=None: os.terminal_size((80, 12)),
+    )
+
+    tui = _tui(tmp_path)
+    tui._tty = True
+    tui._console = Console(file=None, force_terminal=True, width=80, height=12, _environ={})
+    for index in range(20):
+        dock.tree.new_node(
+            parent=dock.tree.root,
+            node_type="message",
+            header=f"committed line {index}",
+            collapsed=False,
+        )
+    tui._committed_line_count = 20
+    tui._visible_committed_rows = 12
+
+    tui._render_frame()
+
+    assert tui._last_frame_start_row == max(12 - tui._last_frame_rows + 1, 1)
+    assert tui._last_frame_start_row < tui._committed_line_count + 1
+
+
+def test_render_frame_clips_long_transcript_to_terminal_height(tmp_path, monkeypatch):
+    class FakeStdout:
+        def __init__(self) -> None:
+            self.text = ""
+
+        def write(self, value: str) -> int:
+            self.text += value
+            return len(value)
+
+        def flush(self) -> None:
+            pass
+
+    fake_stdout = FakeStdout()
+    monkeypatch.setattr(sys, "stdout", fake_stdout)
+    monkeypatch.setattr(
+        shutil, "get_terminal_size",
+        lambda fallback=None: os.terminal_size((80, 12)),
+    )
+
+    tui = _tui(tmp_path)
+    tui._tty = True
+    tui._console = Console(file=None, force_terminal=True, width=80, height=12, _environ={})
+    for index in range(50):
+        dock.tree.new_node(
+            parent=dock.tree.root,
+            node_type="message",
+            header=f"frame line {index:02d}",
+            collapsed=False,
+        )
+
+    tui._render_frame()
+
+    assert tui._last_frame_rows <= 12
+    if sys.platform != "win32":
+        assert "frame line 41" in fake_stdout.text
+        assert "frame line 40" not in fake_stdout.text
+
+
+def test_render_frame_clips_single_wrapped_transcript_line_to_terminal_height(
+    tmp_path, monkeypatch
+):
+    class FakeStdout:
+        def __init__(self) -> None:
+            self.text = ""
+
+        def write(self, value: str) -> int:
+            self.text += value
+            return len(value)
+
+        def flush(self) -> None:
+            pass
+
+    fake_stdout = FakeStdout()
+    monkeypatch.setattr(sys, "stdout", fake_stdout)
+    monkeypatch.setattr(
+        shutil,
+        "get_terminal_size",
+        lambda fallback=None: os.terminal_size((80, 12)),
+    )
+
+    tui = _tui(tmp_path)
+    tui._tty = True
+    tui._console = Console(file=None, force_terminal=True, width=80, height=12, _environ={})
+    dock.tree.new_node(
+        parent=dock.tree.root,
+        node_type="message",
+        header="long " + ("x" * 2000),
+        collapsed=False,
+    )
+
+    tui._render_frame()
+
+    assert tui._last_frame_rows <= 12
+    assert "❯" in fake_stdout.text
+
+
+def test_render_frame_clips_long_choice_panel_to_terminal_height(tmp_path, monkeypatch):
+    class FakeStdout:
+        def __init__(self) -> None:
+            self.text = ""
+
+        def write(self, value: str) -> int:
+            self.text += value
+            return len(value)
+
+        def flush(self) -> None:
+            pass
+
+    fake_stdout = FakeStdout()
+    monkeypatch.setattr(sys, "stdout", fake_stdout)
+    monkeypatch.setattr(
+        shutil,
+        "get_terminal_size",
+        lambda fallback=None: os.terminal_size((80, 12)),
+    )
+
+    tui = _tui(tmp_path)
+    tui._tty = True
+    tui._busy = True
+    tui._busy_started_at = 0.0
+    tui._busy_activity_verb = "Ruminating"
+    tui._console = Console(file=None, force_terminal=True, width=80, height=12, _environ={})
+    tui._active_choice = [("approved", "approved", ""), ("modified", "modified", ""), ("rejected", "rejected", "")]
+    tui._choice_prompt = (
+        "Plan: 新增 `document` 工具，让 LLM 在 design 节点激活时能按需读取文档模板。\n\n"
+        "Steps:\n"
+        "1. 新增 src/voidx/tools/load_doc_template.py，用 importlib.resources 读取 "
+        "voidx.data/templates/{doc_type}.md，返回模板内容。\n"
+        "2. 在 orchestrator 的 AgentDef.tools 列表中加入 document。\n"
+        "3. 更新 design 节点 step 4 的描述。\n"
+        "4. 添加测试。\n"
+        "5. 跑测试确认无回归。\n\n"
+        "Affected files: src/voidx/tools/load_doc_template.py, "
+        "src/voidx/agent/agents.py, tests/test_tools/test_basic.py"
+    )
+    dock.begin_capture()
+    dock.ensure_agent()
+    for index in range(4):
+        dock.tree.new_node(
+            parent=dock.tree.root,
+            node_type="message",
+            header=f"active line {index}",
+            collapsed=False,
+        )
+
+    tui._render_frame()
+
+    assert tui._last_frame_rows <= (13 if sys.platform == "win32" else 12)
+    assert "approved" in fake_stdout.text
+    assert "rejected" in fake_stdout.text
+
+
+def test_input_display_rows_uses_frame_width_boundary(tmp_path):
+    tui = _tui(tmp_path)
+    tui._console = Console(file=None, force_terminal=True, width=80, height=24, _environ={})
+
+    width = tui._frame_width()
+    max_first_line_cells = width - tui._input_line_prefix_width(0) - 1
+
+    tui._input_lines = ["x" * max_first_line_cells]
+    tui._cursor_col = max_first_line_cells
+    assert tui._input_display_rows(width) == [1]
+
+    tui._input_lines = ["x" * (max_first_line_cells + 1)]
+    tui._cursor_col = max_first_line_cells + 1
+    assert tui._input_display_rows(width) == [2]
+
+
+def test_wrapped_input_keeps_prompt_on_first_content_row(tmp_path):
+    tui = _tui(tmp_path)
+    tui._console = Console(file=None, force_terminal=True, width=80, height=24, _environ={})
+    tui._input_lines = ["x" * 80]
+    tui._cursor_col = 80
+
+    ansi = tui._capture_renderable(tui._render_bottom_impl(), tui._frame_width())
+    plain_lines = [
+        re.sub(r"\x1b\[[0-9;]*[a-zA-Z]", "", line).rstrip()
+        for line in ansi.splitlines()
+    ]
+
+    prompt_line = next((l for l in plain_lines if l.startswith("❯")), "")
+    if sys.platform != "win32":
+        assert prompt_line.startswith("❯ x")
+
+
+def test_non_tty_flush_prints_transcript_without_live_frame_chrome(tmp_path, monkeypatch):
+    class FakeStdout:
+        def __init__(self) -> None:
+            self.text = ""
+
+        def write(self, value: str) -> int:
+            self.text += value
+            return len(value)
+
+        def flush(self) -> None:
+            pass
+
+    fake_stdout = FakeStdout()
+    monkeypatch.setattr(sys, "stdout", fake_stdout)
+
+    tui = _tui(tmp_path)
+    tui._tty = False
+    tui._console = Console(file=None, force_terminal=False, width=80, height=24, _environ={})
+    dock.tree.new_node(
+        parent=dock.tree.root,
+        node_type="startup",
+        header="[bold]Welcome[/bold]",
+        body_lines=["plain line"],
+        collapsed=False,
+    )
+
+    tui._flush_committed(force=True)
+
+    assert "Welcome" in fake_stdout.text
+    assert "plain line" in fake_stdout.text
+    assert "─" not in fake_stdout.text
+    assert "❯ " not in fake_stdout.text
+
+    fake_stdout.text = ""
+    tui._render_frame()
+
+    assert fake_stdout.text == ""
+
+
+def test_typing_redraws_input_region_without_rewriting_transcript(tmp_path, monkeypatch):
+    class FakeStdout:
+        def __init__(self) -> None:
+            self.text = ""
+
+        def write(self, value: str) -> int:
+            self.text += value
+            return len(value)
+
+        def flush(self) -> None:
+            pass
+
+    fake_stdout = FakeStdout()
+    monkeypatch.setattr(sys, "stdout", fake_stdout)
+    monkeypatch.setattr(
+        shutil, "get_terminal_size",
+        lambda fallback=None: os.terminal_size((80, 12)),
+    )
+
+    tui = _tui(tmp_path)
+    tui._tty = True
+    tui._console = Console(file=None, force_terminal=True, width=80, height=12, _environ={})
+    dock.tree.new_node(
+        parent=dock.tree.root,
+        node_type="message",
+        header="startup banner",
+        collapsed=False,
+    )
+
+    tui._render_frame()
+    assert "startup banner" in fake_stdout.text
+
+    fake_stdout.text = ""
+    assert tui._process_input(b"x") is True
+    tui._render_after_input()
+
+    assert "startup banner" not in fake_stdout.text
+    assert "x" in fake_stdout.text