dirplot 0.3.2__tar.gz → 0.3.3__tar.gz

{dirplot-0.3.2 → dirplot-0.3.3}/CHANGELOG.md

@@ -7,6 +7,20 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.3.3] - 2026-03-14
+
+### Added
+
+- **Breadcrumbs mode** (`--breadcrumbs/--no-breadcrumbs`, `-b/-B`, on by default): directories
+  that form a single-child chain (one subdirectory, no files) are collapsed into a single tile
+  whose header shows the full path separated by ` / ` (e.g. `src / dirplot / fonts`). When the
+  label is too wide, middle segments are replaced with `…` (`src / … / fonts`). The root tile
+  is never collapsed. Disable with `-B` or `--no-breadcrumbs`.
+- **Tree depth in root label**: the root tile header now includes `depth: N` alongside the
+  file, directory, and size summary (e.g. `myproject — 124 files, 18 dirs, 4.0 MB (…), depth: 6`).
+  The depth reflects the original tree structure and is invariant to whether breadcrumbs mode
+  is active.
+
 ## [0.3.2] - 2026-03-13
 
 ### Added

{dirplot-0.3.2 → dirplot-0.3.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dirplot
-Version: 0.3.2
+Version: 0.3.3
 Summary: Static treemap bitmaps for directory trees and archives, displayed as inline terminal images
 Project-URL: Repository, https://github.com/deeplook/dirplot
 License: MIT
@@ -78,6 +78,8 @@ Description-Content-Type: text/markdown
 - Works on macOS, Linux, and Windows; WSL2 fully supported.
 - Scan remote hosts over SSH (`pip install "dirplot[ssh]"`), AWS S3 buckets (`pip install "dirplot[s3]"`), any public/private GitHub repository (including specific branch, tag, commit SHA, or subdirectory), **running Docker containers**, or **Kubernetes pods** — all without extra dependencies beyond the respective CLI/SDK. See [EXAMPLES.md](docs/EXAMPLES.md).
 - Optional **file-count legend** (`--legend`) — a corner overlay listing the top extensions by number of files, with coloured swatches and counts, automatically sized to fit the image.
+- **Breadcrumbs mode** (on by default) — single-child directory chains are collapsed into one tile with a `foo / bar / baz` header label. Middle segments are replaced with `…` when the tile is too narrow. Disable with `-B` / `--no-breadcrumbs`.
+- **Tree depth** shown in the root tile header alongside the file count and total size (e.g. `myproject — 124 files, 18 dirs, 4.0 MB (…), depth: 6`).
 - **Wide archive support** — reads zip, tar (gz/bz2/xz/zst), 7z, rar, and via libarchive: iso, cpio, rpm, cab, lha/lzh, xar/pkg, a/ar, and all ZIP-based formats (jar, whl, apk, nupkg, vsix, ipa, …) as virtual directory trees without unpacking. Encrypted archives are handled gracefully: metadata-only reads work without a password for most formats; a password can be supplied with `--password` or entered interactively when needed.
 
 ## How It Works
@@ -158,6 +160,9 @@ dirplot map . --legend
 # Show a file-count legend limited to 10 entries
 dirplot map . --legend 10
 
+# Disable breadcrumbs (show full nested hierarchy instead of collapsed chains)
+dirplot map . -B
+
 # Save as an interactive SVG (hover highlight + floating tooltip)
 dirplot map . --output treemap.svg --no-show
 
@@ -182,6 +187,7 @@ dirplot map . --format svg --output treemap.svg --no-show
 | `--header/--no-header` | | `--header` | Print info lines before rendering |
 | `--cushion/--no-cushion` | | `--cushion` | Apply van Wijk cushion shading for a raised 3-D look |
 | `--log/--no-log` | | `--no-log` | Use log of file sizes for layout, making small files more visible |
+| `--breadcrumbs/--no-breadcrumbs` | `-b`/`-B` | `--breadcrumbs` | Collapse single-child directory chains into `foo / bar / baz` labels |
 | `--password` | | — | Password for encrypted archives; prompted interactively if not supplied and needed |
 | `--github-token` | | `$GITHUB_TOKEN` | GitHub personal access token for private repos or higher rate limits |
 

{dirplot-0.3.2 → dirplot-0.3.3}/README.md

@@ -28,6 +28,8 @@
 - Works on macOS, Linux, and Windows; WSL2 fully supported.
 - Scan remote hosts over SSH (`pip install "dirplot[ssh]"`), AWS S3 buckets (`pip install "dirplot[s3]"`), any public/private GitHub repository (including specific branch, tag, commit SHA, or subdirectory), **running Docker containers**, or **Kubernetes pods** — all without extra dependencies beyond the respective CLI/SDK. See [EXAMPLES.md](docs/EXAMPLES.md).
 - Optional **file-count legend** (`--legend`) — a corner overlay listing the top extensions by number of files, with coloured swatches and counts, automatically sized to fit the image.
+- **Breadcrumbs mode** (on by default) — single-child directory chains are collapsed into one tile with a `foo / bar / baz` header label. Middle segments are replaced with `…` when the tile is too narrow. Disable with `-B` / `--no-breadcrumbs`.
+- **Tree depth** shown in the root tile header alongside the file count and total size (e.g. `myproject — 124 files, 18 dirs, 4.0 MB (…), depth: 6`).
 - **Wide archive support** — reads zip, tar (gz/bz2/xz/zst), 7z, rar, and via libarchive: iso, cpio, rpm, cab, lha/lzh, xar/pkg, a/ar, and all ZIP-based formats (jar, whl, apk, nupkg, vsix, ipa, …) as virtual directory trees without unpacking. Encrypted archives are handled gracefully: metadata-only reads work without a password for most formats; a password can be supplied with `--password` or entered interactively when needed.
 
 ## How It Works
@@ -108,6 +110,9 @@ dirplot map . --legend
 # Show a file-count legend limited to 10 entries
 dirplot map . --legend 10
 
+# Disable breadcrumbs (show full nested hierarchy instead of collapsed chains)
+dirplot map . -B
+
 # Save as an interactive SVG (hover highlight + floating tooltip)
 dirplot map . --output treemap.svg --no-show
 
@@ -132,6 +137,7 @@ dirplot map . --format svg --output treemap.svg --no-show
 | `--header/--no-header` | | `--header` | Print info lines before rendering |
 | `--cushion/--no-cushion` | | `--cushion` | Apply van Wijk cushion shading for a raised 3-D look |
 | `--log/--no-log` | | `--no-log` | Use log of file sizes for layout, making small files more visible |
+| `--breadcrumbs/--no-breadcrumbs` | `-b`/`-B` | `--breadcrumbs` | Collapse single-child directory chains into `foo / bar / baz` labels |
 | `--password` | | — | Password for encrypted archives; prompted interactively if not supplied and needed |
 | `--github-token` | | `$GITHUB_TOKEN` | GitHub personal access token for private repos or higher rate limits |
 

{dirplot-0.3.2 → dirplot-0.3.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "dirplot"
-version = "0.3.2"
+version = "0.3.3"
 description = "Static treemap bitmaps for directory trees and archives, displayed as inline terminal images"
 readme = "README.md"
 license = {text = "MIT"}

{dirplot-0.3.2 → dirplot-0.3.3}/src/dirplot/main.py

@@ -19,10 +19,12 @@ from dirplot.render import create_treemap
 from dirplot.s3 import build_tree_s3, is_s3_path, make_s3_client, parse_s3_path
 from dirplot.scanner import (
     Node,
+    apply_breadcrumbs,
     apply_log_sizes,
     build_tree,
     build_tree_multi,
     collect_extensions,
+    max_depth,
     prune_to_subtrees,
 )
 from dirplot.ssh import build_tree_ssh, connect, is_ssh_path, parse_ssh_path
@@ -175,50 +177,65 @@ def watch_cmd(
 
 @app.command(name="read-meta")
 def read_meta(
-    file: Path = typer.Argument(..., help="PNG or SVG file to read dirplot metadata from"),
+    files: list[Path] = typer.Argument(
+        ..., help="PNG or SVG file(s) to read dirplot metadata from"
+    ),
 ) -> None:
-    """Read dirplot metadata embedded in a PNG or SVG file."""
-    if not file.exists():
-        typer.echo(f"Error: file not found: {file}", err=True)
-        raise typer.Exit(1)
-
-    suffix = file.suffix.lower()
-
-    if suffix == ".png":
-        from PIL import Image
-
-        img = Image.open(file)
-        info = img.info
-        meta_keys = {"Date", "Software", "URL", "Python", "OS", "Command"}
-        found = {k: v for k, v in info.items() if k in meta_keys}
-        if not found:
-            typer.echo("No dirplot metadata found in PNG.", err=True)
-            raise typer.Exit(1)
-        for k, v in found.items():
-            typer.echo(f"{k}: {v}")
+    """Read dirplot metadata embedded in one or more PNG or SVG files."""
+    any_error = False
+
+    for file in files:
+        if len(files) > 1:
+            typer.echo(f"==> {file} <==")
+
+        if not file.exists():
+            typer.echo(f"Error: file not found: {file}", err=True)
+            any_error = True
+            continue
+
+        suffix = file.suffix.lower()
+
+        if suffix == ".png":
+            from PIL import Image
+
+            img = Image.open(file)
+            info = img.info
+            meta_keys = {"Date", "Software", "URL", "Python", "OS", "Command"}
+            found = {k: v for k, v in info.items() if k in meta_keys}
+            if not found:
+                typer.echo("No dirplot metadata found in PNG.", err=True)
+                any_error = True
+                continue
+            for k, v in found.items():
+                typer.echo(f"{k}: {v}")
+
+        elif suffix == ".svg":
+            content = file.read_text(encoding="utf-8")
+            try:
+                root = ET.fromstring(content)
+            except ET.ParseError as exc:
+                typer.echo(f"Error parsing SVG: {exc}", err=True)
+                any_error = True
+                continue
+            svg_meta: dict[str, str] = {}
+            for desc in root.iter("{http://www.w3.org/1999/02/22-rdf-syntax-ns#}Description"):
+                for child in desc:
+                    local = child.tag.split("}")[-1] if "}" in child.tag else child.tag
+                    ns_uri = child.tag.split("}")[0].lstrip("{") if "}" in child.tag else ""
+                    if ns_uri == "https://github.com/deeplook/dirplot#" and child.text:
+                        svg_meta[local] = child.text
+            if not svg_meta:
+                typer.echo("No dirplot metadata found in SVG.", err=True)
+                any_error = True
+                continue
+            for k, v in svg_meta.items():
+                typer.echo(f"{k}: {v}")
 
-    elif suffix == ".svg":
-        content = file.read_text(encoding="utf-8")
-        try:
-            root = ET.fromstring(content)
-        except ET.ParseError as exc:
-            typer.echo(f"Error parsing SVG: {exc}", err=True)
-            raise typer.Exit(1) from exc
-        svg_meta: dict[str, str] = {}
-        for desc in root.iter("{http://www.w3.org/1999/02/22-rdf-syntax-ns#}Description"):
-            for child in desc:
-                local = child.tag.split("}")[-1] if "}" in child.tag else child.tag
-                ns_uri = child.tag.split("}")[0].lstrip("{") if "}" in child.tag else ""
-                if ns_uri == "https://github.com/deeplook/dirplot#" and child.text:
-                    svg_meta[local] = child.text
-        if not svg_meta:
-            typer.echo("No dirplot metadata found in SVG.", err=True)
-            raise typer.Exit(1)
-        for k, v in svg_meta.items():
-            typer.echo(f"{k}: {v}")
+        else:
+            typer.echo(f"Unsupported file type: {suffix!r}. Expected .png or .svg", err=True)
+            any_error = True
 
-    else:
-        typer.echo(f"Unsupported file type: {suffix!r}. Expected .png or .svg", err=True)
+    if any_error:
         raise typer.Exit(1)
 
 
@@ -331,6 +348,15 @@ def main(
         "--password",
         help="Password for encrypted archives. Prompted interactively if not supplied and needed.",
     ),
+    breadcrumbs: bool = typer.Option(
+        True,
+        "--breadcrumbs/--no-breadcrumbs",
+        "-b/-B",
+        help=(
+            "Collapse single-subdirectory chains into breadcrumb labels"
+            " (e.g. foo / bar / baz). Default: on."
+        ),
+    ),
 ) -> None:
     """Create a nested treemap bitmap for a directory tree."""
     if not roots:
@@ -544,6 +570,11 @@ def main(
     if subtrees:
         root_node = prune_to_subtrees(root_node, set(subtrees))
 
+    tree_depth = max_depth(root_node)
+
+    if breadcrumbs:
+        root_node = apply_breadcrumbs(root_node)
+
     t_scan = time.monotonic() - t_scan_start
     if log:
         apply_log_sizes(root_node)
@@ -587,10 +618,12 @@ def main(
     t_render_start = time.monotonic()
     if use_svg:
         buf = create_treemap_svg(
-            root_node, width_px, height_px, font_size, colormap, legend, cushion
+            root_node, width_px, height_px, font_size, colormap, legend, cushion, tree_depth
         )
     else:
-        buf = create_treemap(root_node, width_px, height_px, font_size, colormap, legend, cushion)
+        buf = create_treemap(
+            root_node, width_px, height_px, font_size, colormap, legend, cushion, tree_depth
+        )
     t_render = time.monotonic() - t_render_start
 
     if output is not None:

{dirplot-0.3.2 → dirplot-0.3.3}/src/dirplot/render.py

@@ -14,7 +14,7 @@ import squarify
 from PIL import Image, ImageDraw, ImageFont, PngImagePlugin
 
 from dirplot.colors import RGBAColor, assign_colors
-from dirplot.scanner import Node, collect_extensions, count_nodes
+from dirplot.scanner import Node, collect_extensions, count_nodes, max_depth
 
 DIRPLOT_URL = "https://github.com/deeplook/dirplot"
 
@@ -160,6 +160,26 @@ def _truncate(
     return name[:lo] + ellipsis
 
 
+def _truncate_breadcrumb(
+    name: str, draw: ImageDraw.ImageDraw, font: ImageFont.FreeTypeFont, max_w: int
+) -> str:
+    """Truncate a breadcrumb label (`` / ``-separated parts) to fit *max_w* pixels.
+
+    Tries the full label first, then collapses middle segments to ``…``, and
+    finally falls back to ``_truncate`` for plain names or when even the
+    ``first / … / last`` form is too long.
+    """
+    parts = name.split(" / ")
+    if len(parts) <= 1:
+        return _truncate(name, draw, font, max_w)
+    if _text_w(draw, name, font) <= max_w:
+        return name
+    candidate = parts[0] + " / … / " + parts[-1]
+    if _text_w(draw, candidate, font) <= max_w:
+        return candidate
+    return _truncate(candidate, draw, font, max_w)
+
+
 def _apply_cushion(img: Image.Image, x: int, y: int, w: int, h: int) -> None:
     """Apply van Wijk-style quadratic cushion shading to a tile in-place."""
     if w < 4 or h < 4:
@@ -233,30 +253,39 @@ def draw_node(
             draw.rectangle([x, y, x + w - 1, y + h - 1], outline=dark)
         # Adaptive label: largest font that fits the tile without overflow
         if w > 20 and h > 10:
+            # Try horizontal first
+            ffont_h, label_h = _fit_font(node.name, draw, font_size + 2, w - 4, h - 4)
+            # For tall narrow tiles, also try vertical; prefer whichever wraps less
+            use_vertical = False
             if h >= w * 2 and img is not None:
+                ffont_v, label_v = _fit_font(node.name, draw, font_size + 2, h - 4, w - 4)
+                if label_v:
+                    h_lines = label_h.count("\n") + 1 if label_h else 999
+                    v_lines = label_v.count("\n") + 1
+                    if v_lines < h_lines or (v_lines == h_lines and ffont_v.size > ffont_h.size):
+                        use_vertical = True
+            if use_vertical:
                 # Tall, narrow tile — rotate label 90° CCW so it runs along the height
-                # available text-run = h-4, constraining dim = w-4
-                ffont, label = _fit_font(node.name, draw, font_size + 2, h - 4, w - 4)
                 tmp = Image.new("RGBA", (h, w), (0, 0, 0, 0))
                 ImageDraw.Draw(tmp).text(
                     (h // 2, w // 2),
-                    label,
+                    label_v,
                     fill=_label_color(rgb),
-                    font=ffont,
+                    font=ffont_v,
                     anchor="mm",
                     align="center",
                     spacing=0,
                 )
                 rotated = tmp.rotate(90, expand=True)
+                assert img is not None
                 img.paste(rotated, (x, y), mask=rotated)
             else:
                 # Horizontal label: available text-run = w-4, constraining dim = h-4
-                ffont, label = _fit_font(node.name, draw, font_size + 2, w - 4, h - 4)
                 draw.text(
                     (x + w // 2, y + h // 2),
-                    label,
+                    label_h,
                     fill=_label_color(rgb),
-                    font=ffont,
+                    font=ffont_h,
                     anchor="mm",
                     align="center",
                     spacing=0,
@@ -271,7 +300,9 @@ def draw_node(
     # Header label — height driven by the font size
     header_h = font.size + 4
     if h > 2 + header_h:
-        label = _truncate(root_label if root_label is not None else node.name, draw, font, w - 8)
+        label = _truncate_breadcrumb(
+            root_label if root_label is not None else node.name, draw, font, w - 8
+        )
         draw.text(
             (x + w // 2, y + 2 + header_h // 2),
             label,
@@ -436,6 +467,7 @@ def create_treemap(
     colormap: str = "tab20",
     legend: int | None = None,
     cushion: bool = True,
+    tree_depth: int | None = None,
 ) -> io.BytesIO:
     """Render a nested squarified treemap and return it as a PNG in a BytesIO buffer.
 
@@ -459,9 +491,10 @@ def create_treemap(
 
     n_files, n_dirs = count_nodes(root_node)
     total_bytes = root_node.original_size if root_node.original_size > 0 else root_node.size
+    depth = tree_depth if tree_depth is not None else max_depth(root_node)
     root_label = (
         f"{root_node.name} \u2014 {n_files:,} files, {n_dirs:,} dirs,"
-        f" {_human_bytes(total_bytes)} ({total_bytes:,} bytes)"
+        f" {_human_bytes(total_bytes)} ({total_bytes:,} bytes), depth: {depth}"
     )
     draw_node(
         idraw,

{dirplot-0.3.2 → dirplot-0.3.3}/src/dirplot/scanner.py

@@ -182,6 +182,42 @@ def count_nodes(node: Node) -> tuple[int, int]:
     return files, dirs
 
 
+def _apply_breadcrumbs_recursive(node: Node) -> Node:
+    """Recursively collapse single-subdirectory chains (internal helper)."""
+    node.children = [_apply_breadcrumbs_recursive(c) for c in node.children]
+    dir_children = [c for c in node.children if c.is_dir]
+    file_children = [c for c in node.children if not c.is_dir]
+    if node.is_dir and len(dir_children) == 1 and len(file_children) == 0:
+        child = dir_children[0]
+        node.name = f"{node.name} / {child.name}"
+        node.children = child.children
+    return node
+
+
+def apply_breadcrumbs(node: Node) -> Node:
+    """Collapse single-subdirectory chains into one node with a combined name.
+
+    A directory that has exactly one directory child and no file children is
+    merged with that child: the names are joined with `` / `` and the child's
+    children become this node's children.  The process is bottom-up so chains
+    of any length accumulate naturally.
+
+    The root node itself is never collapsed — only its descendants are.
+    """
+    node.children = [_apply_breadcrumbs_recursive(c) for c in node.children]
+    return node
+
+
+def max_depth(node: Node) -> int:
+    """Return the maximum depth of the tree rooted at *node*.
+
+    A leaf node (no children) has depth 0.
+    """
+    if not node.children:
+        return 0
+    return 1 + max(max_depth(c) for c in node.children)
+
+
 def collect_extensions(node: Node) -> list[str]:
     """Return a flat list of file extensions under *node*."""
     if not node.is_dir:

{dirplot-0.3.2 → dirplot-0.3.3}/src/dirplot/svg_render.py

@@ -9,7 +9,7 @@ import squarify
 
 from dirplot.colors import RGBAColor, assign_colors
 from dirplot.render import _human_bytes, build_metadata
-from dirplot.scanner import Node, collect_extensions, count_nodes
+from dirplot.scanner import Node, collect_extensions, count_nodes, max_depth
 
 _CHAR_ASPECT = 0.6  # approximate width/height ratio for monospace font
 _FONT_FAMILY = "JetBrains Mono, Consolas, monospace"
@@ -247,6 +247,25 @@ def _truncate(name: str, font_size: int, max_w: float) -> str:
     return name[: max(0, max_chars - 1)] + "\u2026"
 
 
+def _truncate_breadcrumb_svg(name: str, font_size: int, max_w: float) -> str:
+    """Truncate a breadcrumb label (`` / ``-separated parts) to fit *max_w*.
+
+    Tries the full label first, then collapses middle segments to ``…``, and
+    finally falls back to ``_truncate`` for plain names or when even the
+    ``first / … / last`` form is too long.
+    """
+    char_w = font_size * _CHAR_ASPECT
+    parts = name.split(" / ")
+    if len(parts) <= 1:
+        return _truncate(name, font_size, max_w)
+    if len(name) * char_w <= max_w:
+        return name
+    candidate = parts[0] + " / \u2026 / " + parts[-1]
+    if len(candidate) * char_w <= max_w:
+        return candidate
+    return _truncate(candidate, font_size, max_w)
+
+
 # ---------------------------------------------------------------------------
 # Recursive draw
 # ---------------------------------------------------------------------------
@@ -367,7 +386,9 @@ def _draw_node_svg(
         )
         d.append(hdr)
 
-        label = _truncate(root_label if root_label is not None else node.name, font_size, w - 8)
+        label = _truncate_breadcrumb_svg(
+            root_label if root_label is not None else node.name, font_size, w - 8
+        )
         hclip = drawsvg.ClipPath()
         hclip.append(drawsvg.Rectangle(x + 2, y + 2, w - 4, header_h))
         d.append(hclip)
@@ -535,6 +556,7 @@ def create_treemap_svg(
     colormap: str = "tab20",
     legend: int | None = None,
     cushion: bool = True,
+    tree_depth: int | None = None,
 ) -> io.BytesIO:
     """Render a nested squarified treemap and return it as SVG in a BytesIO buffer.
 
@@ -598,9 +620,10 @@ def create_treemap_svg(
     # 4. Treemap tiles
     n_files, n_dirs = count_nodes(root_node)
     total_bytes = root_node.original_size if root_node.original_size > 0 else root_node.size
+    depth = tree_depth if tree_depth is not None else max_depth(root_node)
     root_label = (
         f"{root_node.name} \u2014 {n_files:,} files, {n_dirs:,} dirs,"
-        f" {_human_bytes(total_bytes)} ({total_bytes:,} bytes)"
+        f" {_human_bytes(total_bytes)} ({total_bytes:,} bytes), depth: {depth}"
     )
     _draw_node_svg(
         d,

{dirplot-0.3.2 → dirplot-0.3.3}/tests/test_cli.py

@@ -163,6 +163,27 @@ def test_read_meta_svg_no_metadata(tmp_path: Path) -> None:
     assert "No dirplot metadata" in result.output
 
 
+def test_read_meta_multiple_files(sample_tree: Path, tmp_path: Path) -> None:
+    out1 = tmp_path / "out1.png"
+    out2 = tmp_path / "out2.png"
+    runner.invoke(app, ["map", str(sample_tree), "--no-show", "--output", str(out1)])
+    runner.invoke(app, ["map", str(sample_tree), "--no-show", "--output", str(out2)])
+    result = runner.invoke(app, ["read-meta", str(out1), str(out2)])
+    assert result.exit_code == 0
+    assert f"==> {out1} <==" in result.output
+    assert f"==> {out2} <==" in result.output
+    assert result.output.count("Date:") == 2
+
+
+def test_read_meta_multiple_files_partial_error(sample_tree: Path, tmp_path: Path) -> None:
+    out1 = tmp_path / "out1.png"
+    runner.invoke(app, ["map", str(sample_tree), "--no-show", "--output", str(out1)])
+    result = runner.invoke(app, ["read-meta", str(out1), "/nonexistent/file.png"])
+    assert result.exit_code == 1
+    assert "Date:" in result.output
+    assert "file not found" in result.output
+
+
 def test_main_module() -> None:
     """__main__.py delegates to app."""
     from dirplot.__main__ import main

{dirplot-0.3.2 → dirplot-0.3.3}/tests/test_scanner.py

@@ -6,6 +6,7 @@ import pytest
 
 from dirplot.scanner import (
     Node,
+    apply_breadcrumbs,
     build_tree,
     build_tree_multi,
     collect_extensions,
@@ -229,3 +230,80 @@ def test_build_tree_multi_single_delegates(tmp_path: Path) -> None:
     root = build_tree_multi([tmp_path])
     assert root.path == tmp_path
     assert len(root.children) == 1
+
+
+# ---------------------------------------------------------------------------
+# apply_breadcrumbs
+# ---------------------------------------------------------------------------
+
+
+def _make_dir(name: str, children: list[Node] | None = None) -> Node:
+    return Node(name=name, path=Path(name), size=1, is_dir=True, children=children or [])
+
+
+def _make_file(name: str) -> Node:
+    return Node(name=name, path=Path(name), size=1, is_dir=False, extension=".txt")
+
+
+def test_breadcrumbs_collapses_chain() -> None:
+    # root → a → b → c → [file.txt]; root is never collapsed, but a/b/c merge
+    file_node = _make_file("file.txt")
+    c = _make_dir("c", [file_node])
+    b = _make_dir("b", [c])
+    a = _make_dir("a", [b])
+    root = _make_dir("root", [a])
+
+    result = apply_breadcrumbs(root)
+
+    assert result.name == "root"  # root itself is never collapsed
+    assert len(result.children) == 1
+    merged = result.children[0]
+    assert merged.name == "a / b / c"
+    assert len(merged.children) == 1
+    assert merged.children[0].name == "file.txt"
+
+
+def test_breadcrumbs_no_collapse_with_files() -> None:
+    # root → a → [file.txt, subdir]  — a has file child, must not collapse
+    file_node = _make_file("file.txt")
+    subdir = _make_dir("subdir", [_make_file("inner.txt")])
+    a = _make_dir("a", [file_node, subdir])
+    root = _make_dir("root", [a])
+
+    result = apply_breadcrumbs(root)
+
+    assert result.name == "root"
+    child = result.children[0]
+    assert child.name == "a"
+    assert {c.name for c in child.children} == {"file.txt", "subdir"}
+
+
+def test_breadcrumbs_no_collapse_multi_children() -> None:
+    # root → a → [dir1, dir2]  — a has two dir children, must not collapse
+    dir1 = _make_dir("dir1", [_make_file("x.txt")])
+    dir2 = _make_dir("dir2", [_make_file("y.txt")])
+    a = _make_dir("a", [dir1, dir2])
+    root = _make_dir("root", [a])
+
+    result = apply_breadcrumbs(root)
+
+    assert result.name == "root"
+    child = result.children[0]
+    assert child.name == "a"
+    assert {c.name for c in child.children} == {"dir1", "dir2"}
+
+
+def test_breadcrumbs_partial_chain() -> None:
+    # root → a → b → [dir1, dir2]  — b has two children, so a/b merges but stops there
+    dir1 = _make_dir("dir1", [_make_file("x.txt")])
+    dir2 = _make_dir("dir2", [_make_file("y.txt")])
+    b = _make_dir("b", [dir1, dir2])
+    a = _make_dir("a", [b])
+    root = _make_dir("root", [a])
+
+    result = apply_breadcrumbs(root)
+
+    assert result.name == "root"
+    child = result.children[0]
+    assert child.name == "a / b"
+    assert {c.name for c in child.children} == {"dir1", "dir2"}

{dirplot-0.3.2 → dirplot-0.3.3}/uv.lock

@@ -759,7 +759,7 @@ wheels = [
 
 [[package]]
 name = "dirplot"
-version = "0.3.2"
+version = "0.3.3"
 source = { editable = "." }
 dependencies = [
     { name = "drawsvg" },