rootle 0.3.1

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
72
73
74
75
76
77
78
79

"""Shared fixtures: build the binary once, one hermetic Tui per test,
plus the fs stdio provider (plans/0005) for offline provider-path e2e."""

from pathlib import Path

import pytest

from tui import ROOT, Tui, build


@pytest.fixture(scope="session")
def binary():
    return build()


@pytest.fixture
def tui(binary):
    with Tui(binary) as t:
        yield t


def dismiss_launch_popup(tui: Tui) -> None:
    """rootle opens on the repo search popup; close it (INSERT→NORMAL→close).
    ESCs go one call at a time — merged bytes parse as Alt+<key>."""
    tui.expect("search github")
    tui.key("ESC")
    tui.key("ESC")
    tui.expect_gone("search github")


# --- fs stdio provider (plans/0005) --------------------------------------

FS_PROVIDER = ROOT / "examples" / "providers" / "fs_provider.py"


def make_fs_root(tmp: Path) -> Path:
    """Two repos: alpha (rust, mentions render), beta (notes only)."""
    root = tmp / "code"
    alpha = root / "alpha"
    (alpha / "src").mkdir(parents=True)
    (alpha / "src" / "main.rs").write_text(
        "fn main() {\n"
        "    let view = render();\n"
        "    println!(\"{view}\");\n"
        "}\n"
        "\n"
        "fn render() -> &'static str {\n"
        "    \"rootle\"\n"
        "}\n"
    )
    (alpha / "README.md").write_text("# alpha\nrender docs\n")
    beta = root / "beta"
    beta.mkdir(parents=True)
    (beta / "notes.txt").write_text("nothing to see\n")
    return root


@pytest.fixture
def provider_tui(tmp_path, binary):
    """rootle on the fs stdio provider over a temp root, launch popup open."""
    root = make_fs_root(tmp_path)
    config = tmp_path / "provider.toml"
    config.write_text(
        "[provider]\n"
        'kind = "stdio"\n'
        f'command = ["python3", "{FS_PROVIDER}", "{root}"]\n'
    )
    t = Tui(binary, cols=110, rows=30, args=["--config", str(config)]).start()
    yield t
    t.stop()


def open_fs_repo(tui: Tui) -> None:
    """Search alpha, open its tree: lands browsing local/alpha."""
    tui.type_query("alpha")
    tui.key("ENTER")
    tui.expect("local/alpha")
    tui.key("ENTER")
    tui.expect("README.md")