@codebend3r/che 1.0.0

package/bin/system/btop-launch.py

@@ -0,0 +1,114 @@
+#!/usr/bin/env python3
+"""🖥️  Launch btop with a gruvbox theme that follows the macOS appearance.
+
+Light mode uses ``gruvbox_light``, Dark mode ``gruvbox_dark_v2``. The chosen
+theme is written into ``btop.conf`` before launch, because btop reads its
+config once at start.
+
+Usage:
+  btop-launch.py [btop-args...]
+
+Any extra arguments are passed straight through to btop.
+"""
+
+from __future__ import annotations
+
+import os
+import re
+import sys
+from pathlib import Path
+
+sys.path.insert(0, str(Path(__file__).resolve().parent.parent))
+
+from utils import info, require_binary, run, warning
+
+__version__ = "1.0.1"
+
+CONF = Path.home() / ".config" / "btop" / "btop.conf"
+LIGHT_THEME = "gruvbox_light"
+DARK_THEME = "gruvbox_dark_v2"
+
+USAGE = f"""Usage:
+  btop-launch.py [btop-args...]
+
+Description:
+  🖥️  Set btop's color_theme to match the current macOS appearance
+  ({LIGHT_THEME} in Light mode, {DARK_THEME} in Dark mode), then exec btop.
+  Any extra arguments are passed straight through to btop.
+"""
+
+# `[^\S\n]` rather than `\s`: \s matches newlines, so a config with a line
+# break between "color_theme" and "=" would have two lines collapsed into one.
+# perl -p works a line at a time and cannot do that.
+_COLOR_THEME_RE = re.compile(r"^color_theme[^\S\n]*=.*$", re.MULTILINE)
+
+
+def current_theme() -> str:
+    """Pick the theme matching the macOS appearance.
+
+    ``defaults read -g AppleInterfaceStyle`` prints "Dark" in Dark mode and
+    exits non-zero (the key is absent) in Light mode.
+    """
+    completed = run(["defaults", "read", "-g", "AppleInterfaceStyle"], check=False, capture=True)
+    value = (completed.stdout or "").strip() if completed.returncode == 0 else ""
+    return DARK_THEME if value == "Dark" else LIGHT_THEME
+
+
+def apply_theme(theme: str) -> None:
+    """Rewrite the ``color_theme`` line in btop.conf, leaving the rest alone."""
+    if not CONF.is_file():
+        warning(f"btop config not found at {CONF}; launching with existing theme")
+        return
+
+    try:
+        # newline="" so existing CRLF (or CR) line endings survive the
+        # round-trip; read_text/write_text would rewrite every line ending in
+        # the file, where `perl -i` only ever touched the matched line.
+        # surrogateescape so a config carrying non-UTF-8 bytes still round-trips
+        # instead of raising and leaving btop unlaunchable.
+        with CONF.open("r", encoding="utf-8", errors="surrogateescape", newline="") as handle:
+            original = handle.read()
+    except OSError as exc:
+        warning(f"Could not read {CONF}: {exc}; launching with existing theme")
+        return
+
+    updated, count = _COLOR_THEME_RE.subn(f'color_theme = "{theme}"', original)
+    if count == 0:
+        warning(f"No color_theme line in {CONF}; launching with existing theme")
+        return
+
+    if updated != original:
+        try:
+            with CONF.open("w", encoding="utf-8", errors="surrogateescape", newline="") as handle:
+                handle.write(updated)
+        except OSError as exc:
+            warning(f"Could not write {CONF}: {exc}; launching with existing theme")
+            return
+
+    info(f"btop theme -> {theme}")
+
+
+def main(argv: list[str] | None = None) -> int:
+    args = list(sys.argv[1:] if argv is None else argv)
+
+    if args and args[0] in ("-h", "--help"):
+        print(USAGE)
+        return 0
+
+    # Theme first, then the binary check: the shell version rewrote the config
+    # even when btop was missing, so re-ordering would silently stop the theme
+    # tracking the system appearance on a machine where btop is not installed.
+    apply_theme(current_theme())
+
+    btop = require_binary("btop", hint="Install it with `brew install btop`.")
+
+    # exec, not spawn: btop is a full-screen TUI and this process has nothing
+    # left to do. Replacing the image keeps signal handling and the exit code
+    # identical to running btop directly, exactly like `exec btop "$@"`.
+    # argv[0] stays the bare name, which is what btop echoes in its own usage.
+    os.execv(btop, ["btop", *args])  # noqa: S606 - absolute path, no shell
+    return 0  # unreachable; execv never returns
+
+
+if __name__ == "__main__":
+    sys.exit(main())

package/bin/system/update-brew.py

@@ -0,0 +1,146 @@
+#!/usr/bin/env python3
+"""🍺 Update Homebrew, upgrade formulae and casks, then clean up.
+
+Usage:
+  update-brew.py [--dry-run] [--no-cask] [--no-cleanup] [--no-autoremove]
+                 [--greedy] [--doctor]
+
+Options:
+  --dry-run        Show what would be upgraded/removed, change nothing
+  --no-cask        Skip upgrading casks (apps)
+  --no-cleanup     Skip 'brew cleanup' at the end
+  --no-autoremove  Skip 'brew autoremove' (leave unused deps in place)
+  --greedy         Pass --greedy to cask upgrade (force-update self-updating apps)
+  --doctor         Run 'brew doctor' at the very end
+  --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 (
+    add_bool_flag,
+    build_parser,
+    info,
+    log,
+    note,
+    require_binary,
+    run,
+    run_cli,
+    success,
+    warning,
+)
+
+__version__ = "1.0.0"
+
+
+def brew(
+    argv: list[str],
+    *,
+    dry_run: bool,
+    dry_run_argv: list[str] | None = None,
+    echo: bool = False,
+) -> None:
+    """Run a brew subcommand, or its --dry-run form.
+
+    Homebrew's own ``--dry-run`` exits non-zero in some situations that are not
+    really failures, so the preview calls are non-fatal - the same ``|| true``
+    the shell version used. The real calls stay fatal.
+    """
+    if dry_run:
+        if dry_run_argv is None:
+            warning(f"  🪄 Would run: {' '.join(argv)}")
+            return
+        run(dry_run_argv, check=False)
+        return
+
+    # Only `brew update` echoed its command in the shell version; the other
+    # steps called brew directly, and brew narrates itself.
+    if echo:
+        log(f"  ▶ {' '.join(argv)}")
+    run(argv)
+
+
+def main(argv: list[str] | None = None) -> int:
+    parser = build_parser(
+        prog="update-brew",
+        description="🍺 Update Homebrew, upgrade formulae and casks, then clean up.",
+    )
+    add_bool_flag(parser, "--dry-run", help="Show what would change, change nothing")
+    add_bool_flag(parser, "--no-cask", dest="no_cask", help="Skip upgrading casks")
+    add_bool_flag(parser, "--no-cleanup", dest="no_cleanup", help="Skip 'brew cleanup'")
+    add_bool_flag(parser, "--no-autoremove", dest="no_autoremove", help="Skip 'brew autoremove'")
+    add_bool_flag(parser, "--greedy", help="Pass --greedy to cask upgrade")
+    add_bool_flag(parser, "--doctor", help="Run 'brew doctor' at the very end")
+    args = parser.parse_args(argv)
+
+    require_binary("brew", hint="Install Homebrew first: https://brew.sh")
+
+    dry = args.dry_run
+    header_suffix = " 🌵 (dry run)" if dry else ""
+    note("═══════════════════════════════════════════")
+    note(f"🍺  update-brew{header_suffix}")
+    note("═══════════════════════════════════════════")
+
+    # 1. Refresh Homebrew itself and tap metadata
+    info("📡 Updating Homebrew metadata...")
+    brew(["brew", "update"], dry_run=dry, echo=True)
+
+    # 2. Upgrade formulae
+    info("⬆️  Upgrading formulae...")
+    brew(["brew", "upgrade"], dry_run=dry, dry_run_argv=["brew", "upgrade", "--dry-run"])
+
+    # 3. Upgrade casks (apps)
+    if args.no_cask:
+        note("⏭️  Skipping cask upgrades (--no-cask)")
+    else:
+        info("📦 Upgrading casks...")
+        cask_argv = ["brew", "upgrade", "--cask"]
+        if args.greedy:
+            cask_argv.append("--greedy")
+        brew(cask_argv, dry_run=dry, dry_run_argv=[*cask_argv, "--dry-run"])
+
+    # 4. Remove unused dependencies
+    if args.no_autoremove:
+        note("⏭️  Skipping autoremove (--no-autoremove)")
+    else:
+        info("🧹 Removing unused dependencies...")
+        brew(
+            ["brew", "autoremove"],
+            dry_run=dry,
+            dry_run_argv=["brew", "autoremove", "--dry-run"],
+        )
+
+    # 5. Cleanup old versions + cache
+    if args.no_cleanup:
+        note("⏭️  Skipping cleanup (--no-cleanup)")
+    else:
+        info("🗑️  Cleaning up old versions and cache...")
+        brew(
+            ["brew", "cleanup", "-s"],
+            dry_run=dry,
+            dry_run_argv=["brew", "cleanup", "--dry-run", "-s"],
+        )
+
+    # 6. Optional doctor pass - advisory, never fatal
+    if args.doctor:
+        info("🩺 Running brew doctor...")
+        completed = run(["brew", "doctor"], check=False)
+        if completed.returncode != 0:
+            warning("⚠️  brew doctor reported issues (non-fatal)")
+
+    print()
+    note("─────────────────────────────────────────────")
+    if dry:
+        log("💡 Dry run complete. Nothing was actually changed.")
+    else:
+        success("🎉 Homebrew is up to date and tidy! 🍺✨")
+    return 0
+
+
+if __name__ == "__main__":
+    run_cli(main)