rootle 0.2.2

Modal TUI for browsing remote source-control systems (GitHub in-tree, any forge via stdio providers) from the terminal
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71

"""E2E for the provider seam (plans/0005): the full TUI running on an
external stdio provider — examples/providers/fs_provider.py serving a
temp directory. Proves the NDJSON-RPC protocol end to end, offline:
repo search, tree browsing, blob preview, and global-scope code search
all go through the child process."""

import subprocess
import time

from tui import Tui


def provider_pids(tui: Tui) -> list[str]:
    """fs provider children of THIS rootle instance — strays from other
    sessions never pollute the assertion."""
    out = subprocess.run(
        ["pgrep", "-P", str(tui._proc.pid), "-f", "fs_provider.py"],
        capture_output=True,
        text=True,
    ).stdout.split()
    return [p for p in out]


def test_fs_provider_search_to_tree_to_preview(provider_tui: Tui) -> None:
    tui = provider_tui
    # Search hits the provider over stdio; the repo opens, tree walks.
    tui.type_query("alpha")
    tui.key("ENTER")
    screen = tui.expect("local/alpha")
    assert "[repo]" in screen

    tui.key("ENTER")
    screen = tui.expect("README.md")
    assert "src/" in screen
    tui.expect("main.rs")

    # Preview is the blob fetched through the provider (content hash).
    tui.send("l")  # into src
    tui.expect("main.rs")
    screen = tui.expect("fn render")
    assert "rootle" in screen


def test_fs_provider_grep_over_stdio(provider_tui: Tui) -> None:
    tui = provider_tui
    # Close the launch popup: no repo open → global scope over the
    # provider's code search.
    tui.key("ESC")
    tui.key("ESC")
    tui.send(" ")
    tui.send("g")
    screen = tui.expect("grep")
    assert "global" in screen

    tui.type_query("render")
    tui.key("ENTER")
    screen = tui.expect("alpha/src/main.rs")
    assert "matches" in screen  # folded match-count badge
    assert "fn render() -> &'static str {" in screen  # located region


def test_provider_process_is_spawned_and_child(provider_tui: Tui) -> None:
    """The stdio child must exist while the app runs and die with it
    (it may take a beat to notice stdin EOF after the app exits)."""
    tui = provider_tui
    tui.expect("search github")
    assert provider_pids(tui), "provider child should be running"
    tui.stop()
    # rootle exits gracefully on SIGTERM → App drop kills the child
    # deterministically (kill + reap in StdioProvider::drop).
    assert not provider_pids(tui), "provider child should die with the app"