devcull 0.1.0__tar.gz → 0.2.0__tar.gz

{devcull-0.1.0 → devcull-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devcull
-Version: 0.1.0
+Version: 0.2.0
 Summary: remove stale dev cache directories
 License-Expression: MIT
 Project-URL: Repository, https://github.com/gnomecromancer/cull

devcull-0.2.0/cull/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.2.0"

{devcull-0.1.0 → devcull-0.2.0}/cull/cli.py

@@ -1,3 +1,4 @@
+import json
 import shutil
 import sys
 from datetime import datetime, timezone
@@ -67,11 +68,15 @@ def _show_table(hits: list[Hit]):
 @click.argument("path", default=".", type=click.Path(exists=True, file_okay=False))
 @click.option("--older-than", default=90, metavar="DAYS",
               help="only show caches not touched in N days (default: 90)")
+@click.option("--min-size", default=0, metavar="MB",
+              help="only show caches larger than N megabytes")
 @click.option("--delete", is_flag=True, help="interactively delete found caches")
 @click.option("--all", "delete_all", is_flag=True, help="delete everything without asking (use with care)")
 @click.option("--dry-run", is_flag=True, help="show what would be deleted but don't touch anything")
+@click.option("--report", "report_file", default=None, metavar="FILE",
+              help="write findings to a JSON file")
 @click.version_option(__version__, prog_name="cull")
-def cli(path, older_than, delete, delete_all, dry_run):
+def cli(path, older_than, min_size, delete, delete_all, dry_run, report_file):
     """Find and remove stale dev cache directories.
 
     Scans PATH (default: current directory) for node_modules, .venv,
@@ -95,18 +100,39 @@ def cli(path, older_than, delete, delete_all, dry_run):
         rprint("[green]nothing found, you're clean[/green]")
         return
 
-    # filter by age
-    now = datetime.now(tz=timezone.utc)
-    filtered = [h for h in hits if _age_days(h.last_used) >= older_than]
+    # filter by age and size
+    min_bytes = min_size * 1024 * 1024
+    filtered = [h for h in hits if _age_days(h.last_used) >= older_than and h.size >= min_bytes]
 
     if not filtered:
-        rprint(f"[green]found {len(hits)} cache dirs but all were touched in the last {older_than} days[/green]")
+        qualifier = f"touched in the last {older_than} days"
+        if min_size:
+            qualifier += f" or smaller than {min_size} MB"
+        rprint(f"[green]found {len(hits)} cache dirs but none match your filters ({qualifier})[/green]")
         return
 
     total = sum(h.size for h in filtered)
     rprint(f"\nfound [bold]{len(filtered)}[/bold] stale cache dirs totaling [yellow bold]{_fmt_size(total)}[/yellow bold]\n")
     _show_table(filtered)
 
+    if report_file:
+        data = {
+            "scanned": str(root),
+            "at": datetime.now(tz=timezone.utc).isoformat(),
+            "filters": {"older_than_days": older_than, "min_size_mb": min_size},
+            "hits": [
+                {
+                    "path": str(h.path),
+                    "size_bytes": h.size,
+                    "last_used": h.last_used.isoformat(),
+                    "project": str(h.project) if h.project else None,
+                }
+                for h in filtered
+            ],
+        }
+        Path(report_file).write_text(json.dumps(data, indent=2), encoding="utf-8")
+        rprint(f"[dim]report saved → {report_file}[/dim]")
+
     if dry_run:
         rprint("\n[dim](dry run — nothing deleted)[/dim]")
         return

{devcull-0.1.0 → devcull-0.2.0}/cull/scan.py

@@ -1,3 +1,4 @@
+import fnmatch
 import os
 import subprocess
 from dataclasses import dataclass, field
@@ -98,12 +99,37 @@ def _last_used(hit_path: Path, project: Path | None) -> datetime:
         return datetime.min.replace(tzinfo=timezone.utc)
 
 
+def _load_ignore(root: Path) -> list[str]:
+    ig = root / ".cullignore"
+    if not ig.exists():
+        return []
+    pats = []
+    for line in ig.read_text(encoding="utf-8", errors="replace").splitlines():
+        line = line.strip()
+        if line and not line.startswith("#"):
+            pats.append(line)
+    return pats
+
+
+def _is_ignored(hit: Path, root: Path, patterns: list[str]) -> bool:
+    if not patterns:
+        return False
+    rel = hit.relative_to(root).as_posix()
+    name = hit.name
+    for pat in patterns:
+        if fnmatch.fnmatch(name, pat) or fnmatch.fnmatch(rel, pat):
+            return True
+    return False
+
+
 def scan(root: Path, progress_cb=None) -> list[Hit]:
     """
     Walk root looking for cache directories. Doesn't recurse into found dirs.
     progress_cb(path) is called as we enter each directory, for spinner updates.
+    Respects .cullignore at root (gitignore-style patterns, matched against name or relative path).
     """
     hits = []
+    ignore_pats = _load_ignore(root)
     # TODO: handle junction points (windows symlink variant)
 
     for dirpath, dirnames, _ in os.walk(root, topdown=True, onerror=None, followlinks=False):
@@ -121,18 +147,20 @@ def scan(root: Path, progress_cb=None) -> list[Hit]:
 
             if d in CACHE_DIRS:
                 full = p / d
-                proj = _project_root(full)
-                h = Hit(path=full, project=proj)
-                hits.append(h)
                 prune.append(d)
+                if _is_ignored(full, root, ignore_pats):
+                    continue
+                proj = _project_root(full)
+                hits.append(Hit(path=full, project=proj))
                 continue
 
             if d in CONDITIONAL:
                 # only include 'target' if a build marker is in the immediate parent
                 if (p / "Cargo.toml").exists() or (p / "pom.xml").exists():
                     full = p / d
-                    hits.append(Hit(path=full, project=p))
                     prune.append(d)
+                    if not _is_ignored(full, root, ignore_pats):
+                        hits.append(Hit(path=full, project=p))
 
         for d in prune:
             dirnames.remove(d)

{devcull-0.1.0 → devcull-0.2.0}/devcull.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devcull
-Version: 0.1.0
+Version: 0.2.0
 Summary: remove stale dev cache directories
 License-Expression: MIT
 Project-URL: Repository, https://github.com/gnomecromancer/cull

{devcull-0.1.0 → devcull-0.2.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "devcull"
-version = "0.1.0"
+version = "0.2.0"
 description = "remove stale dev cache directories"
 readme = "README.md"
 requires-python = ">=3.10"

{devcull-0.1.0 → devcull-0.2.0}/tests/test_scan.py

@@ -65,6 +65,21 @@ def test_skips_recent_when_filtered(tmp_path):
     assert any(h.path.name == ".pytest_cache" for h in hits)
 
 
+def test_cullignore_skips_matching_dirs():
+    with tempfile.TemporaryDirectory() as tmp:
+        root = Path(tmp)
+        _make_tree(root, {
+            "app1": {"package.json": None, "node_modules": {"react": {"index.js": None}}},
+            "app2": {"package.json": None, "node_modules": {"vue": {"index.js": None}}},
+        })
+        # ignore app1's node_modules
+        (root / ".cullignore").write_text("app1/node_modules\n")
+        hits = scan(root)
+        paths = [str(h.path.relative_to(root)).replace("\\", "/") for h in hits]
+        assert "app2/node_modules" in paths
+        assert "app1/node_modules" not in paths
+
+
 def test_conditional_target_with_cargo():
     with tempfile.TemporaryDirectory() as tmp:
         root = Path(tmp)

devcull-0.1.0/cull/__init__.py

@@ -1 +0,0 @@
-__version__ = "0.1.0"