@codebend3r/che 1.1.0 → 1.2.0

package/bin/files/find-largest-files.py

@@ -14,8 +14,8 @@ Options:
 from __future__ import annotations
 
 import heapq
-import re
 import sys
+from collections.abc import Iterator
 from pathlib import Path
 
 sys.path.insert(0, str(Path(__file__).resolve().parent.parent))
@@ -26,15 +26,13 @@ from utils import (
     format_bytes,
     info,
     iter_files,
-    note,
+    note_settings,
+    parse_count,
     run_cli,
     scan_root,
-    warning,
 )
 
-__version__ = "2.0.4"
-
-_NON_NEGATIVE_INT = re.compile(r"[0-9]+")
+__version__ = "2.1.0"
 
 
 def main(argv: list[str] | None = None) -> int:
@@ -43,32 +41,29 @@ def main(argv: list[str] | None = None) -> int:
         description="📊 List the largest files under a path, biggest first.",
     )
     parser.add_argument("--path", default=".", metavar="DIR", help="Directory to scan (default: .)")
-    # Kept as a string, not `type=int`: argparse's int conversion would own the
-    # error and exit before the shell version's own message could be produced.
+    # A string, validated by parse_count below rather than `type=int`.
     parser.add_argument(
         "--length", default="10", metavar="N", help="How many files to list (default: 10)"
     )
-    add_bool_flag(parser, "--full-path", dest="full_path", help="Print the whole path")
+    add_bool_flag(parser, "--full-path", help="Print the whole path")
 
     info(f"Running command in {Path.cwd()}")
     args = parser.parse_args(argv)
 
-    if not _NON_NEGATIVE_INT.fullmatch(args.length):
-        warning("❌ --length must be a non-negative integer")
-        return 1
-    length = int(args.length)
-
-    if not args.path:
-        warning("❌ --path cannot be empty")
-        return 1
+    length = parse_count(args.length, "--length")
 
-    note(f"Searching in: {args.path}")
-    note(f"List length: {length}")
-    note(f"Show full path: {str(args.full_path).lower()}")
+    note_settings(
+        ("Searching in", args.path),
+        ("List length", length),
+        ("Show full path", args.full_path),
+        rule=False,
+    )
 
+    # An empty --path reads "--path is required" after the settings, where the
+    # shell version printed "--path cannot be empty" before them.
     root = scan_root(args.path)
 
-    def sized() -> list[tuple[int, str, Path]]:
+    def sized() -> Iterator[tuple[int, str, Path]]:
         for path in iter_files(root, skip_macos_metadata=False):
             try:
                 size = path.stat().st_size
@@ -80,10 +75,11 @@ def main(argv: list[str] | None = None) -> int:
             yield size, str(path), path
 
     # `sort -nr | head -n N` ties break on the whole line DESCENDING, because
-    # -r reverses the last-resort comparison too. nlargest on (size, str) gives
-    # the same ordering, and holds only N entries rather than the whole tree -
-    # a million-file media root would otherwise cost about a gigabyte.
-    top = heapq.nlargest(length, sized(), key=lambda item: (item[0], item[1]))
+    # -r reverses the last-resort comparison too. nlargest on (size, str, ...)
+    # gives the same ordering - the path string is unique, so the comparison
+    # never reaches the Path - and holds only N entries rather than the whole
+    # tree: a million-file media root would otherwise cost about a gigabyte.
+    top = heapq.nlargest(length, sized())
 
     for size, _, path in top:
         if args.full_path:

package/bin/files/list-permission.py

@@ -0,0 +1,40 @@
+#!/usr/bin/env python3
+"""🔐 Show the ownership and mode of a volume under ``/Volumes``.
+
+Usage:
+  list-permission.py [VOLUME]   (no VOLUME lists /Volumes itself)
+
+Options:
+  --help       Show help
+"""
+
+from __future__ import annotations
+
+import sys
+from pathlib import Path
+
+sys.path.insert(0, str(Path(__file__).resolve().parent.parent))
+
+from utils import build_parser, run, run_cli
+
+__version__ = "1.0.0"
+
+
+def main(argv: list[str] | None = None) -> int:
+    parser = build_parser(
+        prog="list-permission",
+        description="🔐 Show ownership and mode of a volume under /Volumes.",
+    )
+    parser.add_argument("volume", nargs="?", default="", help="Volume name (default: /Volumes)")
+    # DELIBERATE DIVERGENCE from the shell wrapper, `command ls -ld
+    # "/Volumes/$1"`, which ignored any argument after the first. A second one
+    # is an error here rather than silently dropped.
+    args = parser.parse_args(argv)
+
+    # `ls` runs as a program, so a user's `alias ls=eza` never replaces the
+    # `ls -l` listing - the reason the wrapper spelled it `command ls`.
+    return run(["ls", "-ld", f"/Volumes/{args.volume}"], check=False).returncode
+
+
+if __name__ == "__main__":
+    run_cli(main)

package/bin/files/make-alpha-dir.py

@@ -19,6 +19,8 @@ sys.path.insert(0, str(Path(__file__).resolve().parent.parent))
 
 from utils import build_parser, info, run_cli, warning
 
+__version__ = "1.0.0"
+
 BUCKETS = ("#", *string.ascii_uppercase)