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

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

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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: trls-cli
-Version: 0.3.0
+Version: 0.4.0
 Summary: A modern tree-style CLI for humans and AI prompts.
 Author: Yonglin and Yuanben
 License: MIT
@@ -180,10 +180,9 @@ Clipboard copy output with `-c`:
 
 ```text
 project/
-paths: project/src/, project/src/trls/, project/src/trls/cli.py, project/README.md
-modified: project/README.md
-added: project/src/new_file.py
-removed: project/src/old_file.py
+src/trls/: cli.py
+root: ~README.md
+src/: +new_file.py, -old_file.py
 ```
 
 ## Python API
@@ -207,7 +206,7 @@ Diff markers:
 - `-` removed file or directory
 - `~` modified file or directory
 
-Current behavior in `v0.3.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
@@ -223,8 +222,9 @@ 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
-- later lines compress paths into small labeled blocks such as `paths:`, `modified:`, `added:`, and `removed:`
-- full root-prefixed paths are preserved to keep context for LLMs
+- 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
 
@@ -236,7 +236,7 @@ Clipboard behavior:
 - 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.3.0`
+## CLI contract for `v0.4.0`
 
 The first public release guarantees:
 
@@ -290,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.3.0 → trls_cli-0.4.0}/README.md

@@ -154,10 +154,9 @@ Clipboard copy output with `-c`:
 
 ```text
 project/
-paths: project/src/, project/src/trls/, project/src/trls/cli.py, project/README.md
-modified: project/README.md
-added: project/src/new_file.py
-removed: project/src/old_file.py
+src/trls/: cli.py
+root: ~README.md
+src/: +new_file.py, -old_file.py
 ```
 
 ## Python API
@@ -181,7 +180,7 @@ Diff markers:
 - `-` removed file or directory
 - `~` modified file or directory
 
-Current behavior in `v0.3.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
@@ -197,8 +196,9 @@ 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
-- later lines compress paths into small labeled blocks such as `paths:`, `modified:`, `added:`, and `removed:`
-- full root-prefixed paths are preserved to keep context for LLMs
+- 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
 
@@ -210,7 +210,7 @@ Clipboard behavior:
 - 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.3.0`
+## CLI contract for `v0.4.0`
 
 The first public release guarantees:
 
@@ -264,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.3.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.3.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.3.0
-git push origin v0.3.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.3.0` tag to trigger the production release.
+6. Push the `v0.4.0` tag to trigger the production release.

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

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "trls-cli"
-version = "0.3.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.3.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.3.0"
+__version__ = "0.4.0"
 
 __all__ = [
     "TreeNode",

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

@@ -96,29 +96,14 @@ def render_prompt(node: TreeNode) -> str:
 
 def render_compact_copy(node: TreeNode) -> str:
     lines = [node.display_name]
-    current_paths: list[str] = []
-    added_paths: list[str] = []
-    modified_paths: list[str] = []
-    removed_paths: list[str] = []
+    grouped_entries: dict[str, list[str]] = {}
 
     for child in node.children:
-        _collect_compact_copy_entries(
-            child,
-            prefix=node.display_name,
-            current_paths=current_paths,
-            added_paths=added_paths,
-            modified_paths=modified_paths,
-            removed_paths=removed_paths,
-        )
-
-    if current_paths:
-        lines.append(f"paths: {', '.join(current_paths)}")
-    if modified_paths:
-        lines.append(f"modified: {', '.join(modified_paths)}")
-    if added_paths:
-        lines.append(f"added: {', '.join(added_paths)}")
-    if removed_paths:
-        lines.append(f"removed: {', '.join(removed_paths)}")
+        _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)
 
@@ -180,36 +165,28 @@ def _append_prompt_lines(node: TreeNode, lines: list[str], depth: int) -> None:
         _append_prompt_lines(child, lines, depth + 1)
 
 
-def _collect_compact_copy_entries(
+def _collect_grouped_copy_entries(
     node: TreeNode,
     *,
-    prefix: str,
-    current_paths: list[str],
-    added_paths: list[str],
-    modified_paths: list[str],
-    removed_paths: list[str],
+    grouped_entries: dict[str, list[str]],
+    parent_dir: str,
 ) -> None:
-    full_path = f"{prefix}{node.name}/" if node.is_dir else f"{prefix}{node.name}"
-
-    if node.diff_status != "removed":
-        current_paths.append(full_path)
-    if node.diff_status == "added":
-        added_paths.append(full_path)
-    elif node.diff_status == "modified":
-        modified_paths.append(full_path)
-    elif node.diff_status == "removed":
-        removed_paths.append(full_path)
-
-    child_prefix = full_path if node.is_dir else prefix
-    for child in node.children:
-        _collect_compact_copy_entries(
-            child,
-            prefix=child_prefix,
-            current_paths=current_paths,
-            added_paths=added_paths,
-            modified_paths=modified_paths,
-            removed_paths=removed_paths,
-        )
+    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:

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

@@ -113,8 +113,8 @@ def test_cli_copy_writes_compact_clipboard_output(capsys, monkeypatch, tmp_path)
     assert "[dir] demo/" in captured.out
     clipboard_lines = copied["text"].splitlines()
     assert clipboard_lines[0] == "demo/"
-    assert clipboard_lines[1].startswith("paths: ")
-    assert "demo/src/main.py" in copied["text"]
+    assert "src/: main.py" in copied["text"]
+    assert "root: notes.md" in copied["text"]
     assert copied["text"] != captured.out.strip()
 
 
@@ -213,9 +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 "modified: " in copied["text"]
-    assert "demo/notes.md" in copied["text"]
-    assert "added: 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):

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

@@ -69,9 +69,9 @@ def test_renderers_produce_stable_outputs(tmp_path):
     payload = json.loads(json_output)
 
     assert compact_output.splitlines()[0] == "project/"
-    assert "paths: " in compact_output
-    assert "project/src/app.py" in compact_output
-    assert "project/photo.jpg" in compact_output
+    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
@@ -142,9 +142,6 @@ def test_snapshot_round_trip_and_diff_statuses(tmp_path):
 
     compact_output = render_compact_copy(diff_tree)
     assert compact_output.splitlines()[0] == "project/"
-    assert "paths: " in compact_output
-    assert "modified: " in compact_output
-    assert "project/README.md" in compact_output
-    assert "project/src/" in compact_output
-    assert "added: project/src/new.py" in compact_output
-    assert "removed: project/src/app.py" in compact_output
+    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