trls-cli 0.2.0__tar.gz → 0.4.0__tar.gz

{trls_cli-0.2.0 → trls_cli-0.4.0}/.gitignore

@@ -1,4 +1,5 @@
 .pytest_cache/
+.env
 .venv/
 build/
 dist/

{trls_cli-0.2.0 → trls_cli-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: trls-cli
-Version: 0.2.0
+Version: 0.4.0
 Summary: A modern tree-style CLI for humans and AI prompts.
 Author: Yonglin and Yuanben
 License: MIT
@@ -41,6 +41,8 @@ Classic `tree` output is useful, but `trls` focuses on modern developer workflow
 - `prompt` output for AI-friendly, copy-pasteable directory snapshots
 - snapshot diff by default, so each run shows what changed since last time
 - `-c` clipboard copy for a compact, paste-ready LLM format
+- always-on progress feedback during scans in interactive terminals
+- richer colors for common media, office, and data files
 - `text` output for universal shell compatibility
 - `markdown` output for docs and prompt sharing
 - `json` output for tooling and automation
@@ -75,6 +77,8 @@ Copy a compact LLM-friendly version to the clipboard while keeping the normal te
 trls . -c
 ```
 
+In interactive terminals, `trls` also shows live scan progress so large trees do not feel stuck.
+
 Snapshots are saved automatically after each run. If you want to refresh the baseline without showing any diff markers, force-save it explicitly:
 
 ```bash
@@ -176,12 +180,9 @@ Clipboard copy output with `-c`:
 
 ```text
 project/
-project/src/
-project/src/trls/
-project/src/trls/cli.py
-~ project/README.md
-+ project/src/new_file.py
-- project/src/old_file.py
+src/trls/: cli.py
+root: ~README.md
+src/: +new_file.py, -old_file.py
 ```
 
 ## Python API
@@ -205,7 +206,7 @@ Diff markers:
 - `-` removed file or directory
 - `~` modified file or directory
 
-Current behavior in `v0.2.0`:
+Current behavior in `v0.4.0`:
 
 - every successful run updates the latest snapshot for that path
 - default `trls` output compares against the previous run for that path
@@ -221,11 +222,21 @@ Use `trls -c` to keep the normal terminal render while also copying a compact pr
 Clipboard behavior:
 
 - the first line keeps the root directory name
-- every later line uses a full root-prefixed path
-- `+`, `-`, and `~` diff markers are preserved
+- later lines group entries by directory, such as `src/: cli.py, tree.py`
+- top-level files are collected under `root:`
+- `+`, `-`, and `~` stay inline with each item to preserve diff meaning
 - the clipboard payload is intentionally different from the terminal render to save tokens
+- WSL-aware clipboard fallbacks are attempted before reporting an error
+
+## Progress And Color UX
 
-## CLI contract for `v0.2.0`
+- interactive runs show a transient progress indicator while scanning
+- image files such as `.jpg` and `.png` have their own color family
+- video files such as `.mp4` have their own color family
+- spreadsheet and office files such as `.xlsx`, `.csv`, `.docx`, and `.pptx` have their own color family
+- data-oriented files such as `.parquet` and `.ipynb` are also colorized
+
+## CLI contract for `v0.4.0`
 
 The first public release guarantees:
 
@@ -238,6 +249,7 @@ The first public release guarantees:
 - snapshots are automatically updated after successful runs
 - snapshot diffing is available via `-save`/`--save-snapshot`, `-diff`/`--diff-last`, `-compare`/`--compare-with`, and `-update`/`--update-snapshot`
 - clipboard copy is available via `-c`/`--copy`
+- interactive scans show live progress feedback
 - directories are listed before files and names are sorted case-insensitively
 - unreadable directories are reported in the output instead of crashing the renderers
 
@@ -278,4 +290,9 @@ Recommended flow:
 2. Verify `pip install`, `trls --version`, and one real CLI example.
 3. Publish the tagged release to PyPI with Trusted Publishing.
 
+Remove-Item -Recurse -Force .\dist
+python -m pytest
+python -m build
+python -m twine check dist/*
+python -m twine upload --disable-progress-bar dist/*
 See `RELEASING.md` and `.github/workflows/publish.yml` for the release checklist.

{trls_cli-0.2.0 → trls_cli-0.4.0}/README.md

@@ -15,6 +15,8 @@ Classic `tree` output is useful, but `trls` focuses on modern developer workflow
 - `prompt` output for AI-friendly, copy-pasteable directory snapshots
 - snapshot diff by default, so each run shows what changed since last time
 - `-c` clipboard copy for a compact, paste-ready LLM format
+- always-on progress feedback during scans in interactive terminals
+- richer colors for common media, office, and data files
 - `text` output for universal shell compatibility
 - `markdown` output for docs and prompt sharing
 - `json` output for tooling and automation
@@ -49,6 +51,8 @@ Copy a compact LLM-friendly version to the clipboard while keeping the normal te
 trls . -c
 ```
 
+In interactive terminals, `trls` also shows live scan progress so large trees do not feel stuck.
+
 Snapshots are saved automatically after each run. If you want to refresh the baseline without showing any diff markers, force-save it explicitly:
 
 ```bash
@@ -150,12 +154,9 @@ Clipboard copy output with `-c`:
 
 ```text
 project/
-project/src/
-project/src/trls/
-project/src/trls/cli.py
-~ project/README.md
-+ project/src/new_file.py
-- project/src/old_file.py
+src/trls/: cli.py
+root: ~README.md
+src/: +new_file.py, -old_file.py
 ```
 
 ## Python API
@@ -179,7 +180,7 @@ Diff markers:
 - `-` removed file or directory
 - `~` modified file or directory
 
-Current behavior in `v0.2.0`:
+Current behavior in `v0.4.0`:
 
 - every successful run updates the latest snapshot for that path
 - default `trls` output compares against the previous run for that path
@@ -195,11 +196,21 @@ Use `trls -c` to keep the normal terminal render while also copying a compact pr
 Clipboard behavior:
 
 - the first line keeps the root directory name
-- every later line uses a full root-prefixed path
-- `+`, `-`, and `~` diff markers are preserved
+- later lines group entries by directory, such as `src/: cli.py, tree.py`
+- top-level files are collected under `root:`
+- `+`, `-`, and `~` stay inline with each item to preserve diff meaning
 - the clipboard payload is intentionally different from the terminal render to save tokens
+- WSL-aware clipboard fallbacks are attempted before reporting an error
+
+## Progress And Color UX
 
-## CLI contract for `v0.2.0`
+- interactive runs show a transient progress indicator while scanning
+- image files such as `.jpg` and `.png` have their own color family
+- video files such as `.mp4` have their own color family
+- spreadsheet and office files such as `.xlsx`, `.csv`, `.docx`, and `.pptx` have their own color family
+- data-oriented files such as `.parquet` and `.ipynb` are also colorized
+
+## CLI contract for `v0.4.0`
 
 The first public release guarantees:
 
@@ -212,6 +223,7 @@ The first public release guarantees:
 - snapshots are automatically updated after successful runs
 - snapshot diffing is available via `-save`/`--save-snapshot`, `-diff`/`--diff-last`, `-compare`/`--compare-with`, and `-update`/`--update-snapshot`
 - clipboard copy is available via `-c`/`--copy`
+- interactive scans show live progress feedback
 - directories are listed before files and names are sorted case-insensitively
 - unreadable directories are reported in the output instead of crashing the renderers
 
@@ -252,4 +264,9 @@ Recommended flow:
 2. Verify `pip install`, `trls --version`, and one real CLI example.
 3. Publish the tagged release to PyPI with Trusted Publishing.
 
+Remove-Item -Recurse -Force .\dist
+python -m pytest
+python -m build
+python -m twine check dist/*
+python -m twine upload --disable-progress-bar dist/*
 See `RELEASING.md` and `.github/workflows/publish.yml` for the release checklist.

{trls_cli-0.2.0 → trls_cli-0.4.0}/RELEASING.md

@@ -6,7 +6,7 @@ This repository is prepared for a CLI-first PyPI release.
 
 - distribution name: `trls-cli`
 - import package: `trls`
-- version: `0.2.0`
+- version: `0.4.0`
 - release channel: TestPyPI first, then PyPI
 
 At the time of preparation, `https://pypi.org/project/trls-cli/` should be re-checked right before uploading.
@@ -79,8 +79,8 @@ The workflow already expects the `pypi` environment in GitHub Actions.
 After Trusted Publishing is configured:
 
 ```bash
-git tag v0.2.0
-git push origin v0.2.0
+git tag v0.4.0
+git push origin v0.4.0
 ```
 
 The GitHub Actions workflow will:
@@ -97,4 +97,4 @@ The GitHub Actions workflow will:
 3. Add the real repository URLs to `pyproject.toml`.
 4. Ensure README examples still match current CLI behavior.
 5. Upload to TestPyPI and validate installation.
-6. Push the `v0.2.0` tag to trigger the production release.
+6. Push the `v0.4.0` tag to trigger the production release.

{trls_cli-0.2.0 → trls_cli-0.4.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "trls-cli"
-version = "0.2.0"
+version = "0.4.0"
 description = "A modern tree-style CLI for humans and AI prompts."
 readme = "README.md"
 license = { text = "MIT" }

{trls_cli-0.2.0 → trls_cli-0.4.0}/src/trls/__init__.py

@@ -8,7 +8,7 @@ from trls.renderers import (
 )
 from trls.tree import TreeNode, scan_tree
 
-__version__ = "0.2.0"
+__version__ = "0.4.0"
 
 __all__ = [
     "TreeNode",

{trls_cli-0.2.0 → trls_cli-0.4.0}/src/trls/cli.py

@@ -6,6 +6,7 @@ from pathlib import Path
 from typing import Sequence
 
 from rich.console import Console
+from rich.progress import Progress, SpinnerColumn, TextColumn, TimeElapsedColumn
 
 from trls import __version__
 from trls.clipboard import copy_text
@@ -116,8 +117,8 @@ def main(argv: Sequence[str] | None = None) -> int:
     root_path = Path(args.path).expanduser().resolve()
     needs_fingerprints = True
 
-    current_tree = scan_tree(
-        root_path,
+    current_tree = _scan_tree_with_progress(
+        root_path=root_path,
         max_depth=args.depth,
         show_hidden=args.hidden,
         ignore_patterns=args.ignore,
@@ -160,6 +161,50 @@ def main(argv: Sequence[str] | None = None) -> int:
 
     return 0
 
+def _scan_tree_with_progress(
+    *,
+    root_path: Path,
+    max_depth: int | None,
+    show_hidden: bool,
+    ignore_patterns: list[str],
+    include_fingerprints: bool,
+):
+    if not sys.stderr.isatty():
+        return scan_tree(
+            root_path,
+            max_depth=max_depth,
+            show_hidden=show_hidden,
+            ignore_patterns=ignore_patterns,
+            include_fingerprints=include_fingerprints,
+        )
+
+    progress_console = Console(stderr=True)
+    with Progress(
+        SpinnerColumn(),
+        TextColumn("[progress.description]{task.description}"),
+        TextColumn("{task.completed} items"),
+        TimeElapsedColumn(),
+        console=progress_console,
+        transient=True,
+    ) as progress:
+        task_id = progress.add_task("Scanning...", total=None)
+
+        def on_visit(path: Path) -> None:
+            progress.update(
+                task_id,
+                advance=1,
+                description=f"Scanning {path.name or str(path)}",
+            )
+
+        return scan_tree(
+            root_path,
+            max_depth=max_depth,
+            show_hidden=show_hidden,
+            ignore_patterns=ignore_patterns,
+            include_fingerprints=include_fingerprints,
+            on_visit=on_visit,
+        )
+
 
 if __name__ == "__main__":
     raise SystemExit(main())

trls_cli-0.4.0/src/trls/clipboard.py

@@ -0,0 +1,108 @@
+from __future__ import annotations
+
+import os
+import platform
+import shutil
+import subprocess
+from pathlib import Path
+
+
+def copy_text(text: str) -> None:
+    backends = _clipboard_backends()
+    if not backends:
+        raise RuntimeError(
+            "No supported clipboard command was found. "
+            "On Linux/WSL, install wl-clipboard, xclip, or xsel."
+        )
+
+    errors: list[str] = []
+    for backend_name, command in backends:
+        try:
+            _run_clipboard_command(command, text)
+            return
+        except RuntimeError as exc:
+            errors.append(f"{backend_name}: {exc}")
+
+    attempted_names = ", ".join(name for name, _ in backends)
+    error_details = "; ".join(errors)
+    raise RuntimeError(
+        f"No clipboard backend succeeded. Tried: {attempted_names}. {error_details}"
+    )
+
+
+def _clipboard_backends() -> list[tuple[str, list[str]]]:
+    system = platform.system()
+    backends: list[tuple[str, list[str]]] = []
+
+    if system == "Windows":
+        command = _resolve_command("clip")
+        if command:
+            backends.append(("clip", [command]))
+        return backends
+
+    if system == "Darwin":
+        command = _resolve_command("pbcopy")
+        if command:
+            backends.append(("pbcopy", [command]))
+        return backends
+
+    if _is_wsl():
+        clip_exe = _resolve_command("clip.exe") or _resolve_windows_clip_path()
+        if clip_exe:
+            backends.append(("clip.exe", [clip_exe]))
+        powershell_exe = _resolve_command("powershell.exe")
+        if powershell_exe:
+            backends.append(
+                (
+                    "powershell.exe Set-Clipboard",
+                    [powershell_exe, "-NoProfile", "-Command", "Set-Clipboard"],
+                )
+            )
+
+    wl_copy = _resolve_command("wl-copy")
+    if wl_copy:
+        backends.append(("wl-copy", [wl_copy]))
+
+    xclip = _resolve_command("xclip")
+    if xclip:
+        backends.append(("xclip", [xclip, "-selection", "clipboard"]))
+
+    xsel = _resolve_command("xsel")
+    if xsel:
+        backends.append(("xsel", [xsel, "--clipboard", "--input"]))
+
+    return backends
+
+
+def _resolve_command(name: str) -> str | None:
+    return shutil.which(name)
+
+
+def _resolve_windows_clip_path() -> str | None:
+    candidate = Path("/mnt/c/Windows/System32/clip.exe")
+    return str(candidate) if candidate.exists() else None
+
+
+def _is_wsl() -> bool:
+    if os.environ.get("WSL_DISTRO_NAME"):
+        return True
+    try:
+        return "microsoft" in Path("/proc/version").read_text(encoding="utf-8").lower()
+    except OSError:
+        return False
+
+
+def _run_clipboard_command(command: list[str], text: str) -> None:
+    try:
+        subprocess.run(
+            command,
+            input=text,
+            text=True,
+            check=True,
+            capture_output=True,
+        )
+    except FileNotFoundError as exc:
+        raise RuntimeError(f"Clipboard command not found: {command[0]}") from exc
+    except subprocess.CalledProcessError as exc:
+        stderr = exc.stderr.strip() if exc.stderr else "unknown clipboard error"
+        raise RuntimeError(f"Clipboard command failed: {stderr}") from exc

{trls_cli-0.2.0 → trls_cli-0.4.0}/src/trls/renderers.py

@@ -16,6 +16,7 @@ FILE_STYLES = {
     ".md": "magenta",
     ".rst": "magenta",
     ".txt": "white",
+    ".csv": "bright_yellow",
     ".toml": "yellow",
     ".yaml": "yellow",
     ".yml": "yellow",
@@ -23,6 +24,25 @@ FILE_STYLES = {
     ".ini": "yellow",
     ".cfg": "yellow",
     ".lock": "yellow",
+    ".jpg": "bright_magenta",
+    ".jpeg": "bright_magenta",
+    ".png": "bright_magenta",
+    ".gif": "bright_magenta",
+    ".webp": "bright_magenta",
+    ".svg": "bright_magenta",
+    ".mp4": "bright_cyan",
+    ".mov": "bright_cyan",
+    ".mkv": "bright_cyan",
+    ".avi": "bright_cyan",
+    ".mp3": "bright_blue",
+    ".wav": "bright_blue",
+    ".flac": "bright_blue",
+    ".xlsx": "bright_green",
+    ".xls": "bright_green",
+    ".docx": "bright_white",
+    ".pptx": "bright_red",
+    ".parquet": "bright_yellow",
+    ".ipynb": "bright_yellow",
     ".sh": "bright_green",
     ".ps1": "bright_green",
     ".bat": "bright_green",
@@ -76,8 +96,15 @@ def render_prompt(node: TreeNode) -> str:
 
 def render_compact_copy(node: TreeNode) -> str:
     lines = [node.display_name]
+    grouped_entries: dict[str, list[str]] = {}
+
     for child in node.children:
-        _append_compact_copy_lines(child, lines, prefix=node.display_name)
+        _collect_grouped_copy_entries(child, grouped_entries=grouped_entries, parent_dir="")
+
+    for group_name in sorted(grouped_entries, key=lambda key: (key == "", key.lower())):
+        label = "root" if group_name == "" else f"{group_name}/"
+        lines.append(f"{label}: {', '.join(grouped_entries[group_name])}")
+
     return "\n".join(lines)
 
 
@@ -138,14 +165,28 @@ def _append_prompt_lines(node: TreeNode, lines: list[str], depth: int) -> None:
         _append_prompt_lines(child, lines, depth + 1)
 
 
-def _append_compact_copy_lines(node: TreeNode, lines: list[str], prefix: str) -> None:
-    marker = _diff_marker(node)
-    full_path = f"{prefix}{node.name}/" if node.is_dir else f"{prefix}{node.name}"
-    lines.append(f"{marker}{full_path}")
-
-    child_prefix = f"{full_path}" if node.is_dir else prefix
-    for child in node.children:
-        _append_compact_copy_lines(child, lines, child_prefix)
+def _collect_grouped_copy_entries(
+    node: TreeNode,
+    *,
+    grouped_entries: dict[str, list[str]],
+    parent_dir: str,
+) -> None:
+    if node.is_dir and node.children:
+        next_parent_dir = node.name if not parent_dir else f"{parent_dir}/{node.name}"
+        for child in node.children:
+            _collect_grouped_copy_entries(
+                child,
+                grouped_entries=grouped_entries,
+                parent_dir=next_parent_dir,
+            )
+        return
+
+    group_name = parent_dir
+    entry_name = node.display_name if node.is_dir else node.name
+    marker = _diff_marker(node).strip()
+    if marker:
+        entry_name = f"{marker}{entry_name}"
+    grouped_entries.setdefault(group_name, []).append(entry_name)
 
 
 def _prompt_tag(node: TreeNode) -> str:
@@ -166,6 +207,18 @@ def _prompt_tag(node: TreeNode) -> str:
             return "py"
         if suffix in {".md", ".rst", ".txt"}:
             return "doc"
+        if suffix in {".jpg", ".jpeg", ".png", ".gif", ".webp", ".svg"}:
+            return "image"
+        if suffix in {".mp4", ".mov", ".mkv", ".avi"}:
+            return "video"
+        if suffix in {".mp3", ".wav", ".flac"}:
+            return "audio"
+        if suffix in {".xlsx", ".xls", ".csv"}:
+            return "sheet"
+        if suffix in {".docx", ".pptx"}:
+            return "office"
+        if suffix in {".parquet", ".ipynb"}:
+            return "data"
         if suffix in {".toml", ".yaml", ".yml", ".json", ".ini", ".cfg", ".lock"}:
             return "meta"
         if suffix in {".sh", ".ps1", ".bat"}:

{trls_cli-0.2.0 → trls_cli-0.4.0}/src/trls/tree.py

@@ -4,7 +4,7 @@ import hashlib
 from dataclasses import dataclass, field
 from fnmatch import fnmatch
 from pathlib import Path
-from typing import Any, Literal
+from typing import Any, Callable, Literal
 
 DEFAULT_IGNORE_PATTERNS = (".venv", "dist", "__pycache__")
 DiffStatus = Literal["added", "removed", "modified", "unchanged"]
@@ -72,6 +72,7 @@ def scan_tree(
     show_hidden: bool = False,
     ignore_patterns: list[str] | None = None,
     include_fingerprints: bool = False,
+    on_visit: Callable[[Path], None] | None = None,
 ) -> TreeNode:
     root_path = Path(root).expanduser().resolve()
     if not root_path.exists():
@@ -86,6 +87,7 @@ def scan_tree(
         show_hidden=show_hidden,
         ignore_patterns=patterns,
         include_fingerprints=include_fingerprints,
+        on_visit=on_visit,
     )
 
 
@@ -98,9 +100,12 @@ def _scan_path(
     show_hidden: bool,
     ignore_patterns: tuple[str, ...],
     include_fingerprints: bool,
+    on_visit: Callable[[Path], None] | None,
 ) -> TreeNode:
     kind = "directory" if path.is_dir() else "file"
     node = TreeNode(name=path.name or str(path), path=str(path), kind=kind)
+    if on_visit:
+        on_visit(path)
 
     if not path.is_dir():
         if include_fingerprints:
@@ -137,6 +142,7 @@ def _scan_path(
                 show_hidden=show_hidden,
                 ignore_patterns=ignore_patterns,
                 include_fingerprints=include_fingerprints,
+                on_visit=on_visit,
             )
         )
 

{trls_cli-0.2.0 → trls_cli-0.4.0}/tests/test_cli.py

@@ -3,6 +3,7 @@ import json
 import pytest
 
 from trls import __version__
+import trls.clipboard as clipboard_module
 import trls.cli as cli_module
 from trls.cli import main
 from trls.snapshot import save_snapshot
@@ -110,8 +111,10 @@ def test_cli_copy_writes_compact_clipboard_output(capsys, monkeypatch, tmp_path)
 
     assert exit_code == 0
     assert "[dir] demo/" in captured.out
-    assert copied["text"].splitlines()[0] == "demo/"
-    assert "demo/src/main.py" in copied["text"]
+    clipboard_lines = copied["text"].splitlines()
+    assert clipboard_lines[0] == "demo/"
+    assert "src/: main.py" in copied["text"]
+    assert "root: notes.md" in copied["text"]
     assert copied["text"] != captured.out.strip()
 
 
@@ -210,8 +213,8 @@ def test_cli_copy_preserves_diff_markers_in_clipboard(capsys, monkeypatch, tmp_p
 
     assert exit_code == 0
     assert "~ [doc] notes.md" in captured.out
-    assert "~ demo/notes.md" in copied["text"]
-    assert "+ demo/src/helper.py" in copied["text"]
+    assert "root: ~notes.md" in copied["text"]
+    assert "+helper.py" in copied["text"]
 
 
 def test_cli_copy_reports_clipboard_failure(capsys, monkeypatch, tmp_path):
@@ -229,6 +232,38 @@ def test_cli_copy_reports_clipboard_failure(capsys, monkeypatch, tmp_path):
     assert "Failed to copy to clipboard: clipboard unavailable" in captured.err
 
 
+def test_cli_progress_runs_during_scan(capsys, monkeypatch, tmp_path):
+    root = create_project(tmp_path)
+    progress_updates = []
+
+    class FakeProgress:
+        def __init__(self, *args, **kwargs):
+            pass
+
+        def __enter__(self):
+            return self
+
+        def __exit__(self, exc_type, exc, tb):
+            return False
+
+        def add_task(self, description, total=None):
+            progress_updates.append(("task", description, total))
+            return 1
+
+        def update(self, task_id, advance=0, description=""):
+            progress_updates.append(("update", task_id, advance, description))
+
+    monkeypatch.setattr(cli_module, "Progress", FakeProgress)
+    monkeypatch.setattr(cli_module.sys.stderr, "isatty", lambda: True)
+
+    exit_code = main([str(root), "--format", "prompt"])
+    captured = capsys.readouterr()
+
+    assert exit_code == 0
+    assert "[dir] demo/" in captured.out
+    assert any(event[0] == "update" for event in progress_updates)
+
+
 def test_cli_can_compare_with_explicit_snapshot(capsys, tmp_path):
     root = create_project(tmp_path)
     snapshot_path = tmp_path / "baseline.json"
@@ -279,3 +314,39 @@ def test_cli_diff_last_first_run_creates_baseline_without_error(capsys, monkeypa
     assert "+ " not in captured.out
     assert "- " not in captured.out
     assert any(snapshot_dir.iterdir())
+
+
+def test_copy_text_uses_clip_exe_in_wsl(monkeypatch):
+    calls = []
+
+    monkeypatch.setattr(clipboard_module, "_is_wsl", lambda: True)
+    monkeypatch.setattr(clipboard_module.platform, "system", lambda: "Linux")
+    monkeypatch.setattr(
+        clipboard_module,
+        "_resolve_command",
+        lambda name: "clip.exe" if name == "clip.exe" else None,
+    )
+    monkeypatch.setattr(clipboard_module, "_resolve_windows_clip_path", lambda: None)
+    monkeypatch.setattr(
+        clipboard_module.subprocess,
+        "run",
+        lambda command, input, text, check, capture_output: calls.append((command, input)),
+    )
+
+    clipboard_module.copy_text("hello")
+
+    assert calls[0][0] == ["clip.exe"]
+    assert calls[0][1] == "hello"
+
+
+def test_copy_text_reports_install_hint_when_no_backend_exists(monkeypatch):
+    monkeypatch.delenv("WSL_DISTRO_NAME", raising=False)
+    monkeypatch.setattr(clipboard_module.platform, "system", lambda: "Linux")
+    monkeypatch.setattr(clipboard_module, "_is_wsl", lambda: False)
+    monkeypatch.setattr(clipboard_module, "_resolve_command", lambda name: None)
+    monkeypatch.setattr(clipboard_module, "_resolve_windows_clip_path", lambda: None)
+
+    with pytest.raises(RuntimeError) as exc_info:
+        clipboard_module.copy_text("hello")
+
+    assert "install wl-clipboard, xclip, or xsel" in str(exc_info.value)

{trls_cli-0.2.0 → trls_cli-0.4.0}/tests/test_tree.py

@@ -19,6 +19,9 @@ def create_sample_tree(tmp_path):
     (project / "src").mkdir()
     (project / "src" / "app.py").write_text("print('hello')\n", encoding="utf-8")
     (project / "README.md").write_text("# demo\n", encoding="utf-8")
+    (project / "photo.jpg").write_bytes(b"jpg")
+    (project / "movie.mp4").write_bytes(b"mp4")
+    (project / "sheet.xlsx").write_bytes(b"xlsx")
     (project / ".env").write_text("SECRET=1\n", encoding="utf-8")
     (project / ".venv").mkdir()
     (project / ".venv" / "pyvenv.cfg").write_text("home = C:/Python\n", encoding="utf-8")
@@ -65,8 +68,10 @@ def test_renderers_produce_stable_outputs(tmp_path):
     json_output = render_json(tree)
     payload = json.loads(json_output)
 
-    assert "project/" in compact_output
-    assert "project/src/app.py" in compact_output
+    assert compact_output.splitlines()[0] == "project/"
+    assert "src/: app.py" in compact_output
+    assert "root: " in compact_output
+    assert "photo.jpg" in compact_output
     assert "[dir] project/" in prompt_output
     assert "[doc] README.md" in prompt_output
     assert "README.md" in text_output
@@ -85,6 +90,9 @@ def test_rich_renderer_applies_styles_by_node_type(tmp_path):
     labels = {child.label.plain: child.label.spans[-1].style for child in rich_tree.children}
     assert labels["src/"] == "bold cyan"
     assert labels["README.md"] == "bright_magenta"
+    assert labels["photo.jpg"] == "bright_magenta"
+    assert labels["movie.mp4"] == "bright_cyan"
+    assert labels["sheet.xlsx"] == "bright_green"
 
 
 def test_snapshot_round_trip_and_diff_statuses(tmp_path):
@@ -133,7 +141,7 @@ def test_snapshot_round_trip_and_diff_statuses(tmp_path):
     assert "~ README.md" in text_output
 
     compact_output = render_compact_copy(diff_tree)
-    assert "project/" in compact_output
-    assert "~ project/README.md" in compact_output
-    assert "+ project/src/new.py" in compact_output
-    assert "- project/src/app.py" in compact_output
+    assert compact_output.splitlines()[0] == "project/"
+    assert "src/: +new.py, -app.py" in compact_output or "src/: -app.py, +new.py" in compact_output
+    assert "root: " in compact_output
+    assert "~README.md" in compact_output

trls_cli-0.2.0/src/trls/clipboard.py

@@ -1,42 +0,0 @@
-from __future__ import annotations
-
-import platform
-import shutil
-import subprocess
-
-
-def copy_text(text: str) -> None:
-    system = platform.system()
-    if system == "Windows":
-        _run_clipboard_command(["clip"], text)
-        return
-    if system == "Darwin":
-        _run_clipboard_command(["pbcopy"], text)
-        return
-    if shutil.which("wl-copy"):
-        _run_clipboard_command(["wl-copy"], text)
-        return
-    if shutil.which("xclip"):
-        _run_clipboard_command(["xclip", "-selection", "clipboard"], text)
-        return
-    if shutil.which("xsel"):
-        _run_clipboard_command(["xsel", "--clipboard", "--input"], text)
-        return
-
-    raise RuntimeError("No supported clipboard command was found on this system.")
-
-
-def _run_clipboard_command(command: list[str], text: str) -> None:
-    try:
-        subprocess.run(
-            command,
-            input=text,
-            text=True,
-            check=True,
-            capture_output=True,
-        )
-    except FileNotFoundError as exc:
-        raise RuntimeError(f"Clipboard command not found: {command[0]}") from exc
-    except subprocess.CalledProcessError as exc:
-        stderr = exc.stderr.strip() if exc.stderr else "unknown clipboard error"
-        raise RuntimeError(f"Clipboard command failed: {stderr}") from exc