fix: move backup_repos.py into repo so CI tests can import it

backup_repos.py lived outside the repo at ~/Documents/localpibox, but
test_localpibox.py imported it, so the CI unit-test job failed with
ModuleNotFoundError. Move it to scripts/ (importable on the checked-out
tree), point the top-level backup-repos.sh wrapper at the repo copy, and
keep snapshots in the wrapper's ../backups dir as before.

Author: localpibox

scripts/backup_repos.py

@@ -0,0 +1,142 @@
+#!/usr/bin/env python3
+"""backup-repos — mirror all GitHub repos to a timestamped snapshot dir.
+
+Python port of backup-repos.sh. Uses the `gh` CLI (already authenticated) to
+list repos and `git clone --mirror` to snapshot each one.
+
+Usage:
+  backup-repos.py [--out DIR] [--account OWNER] [--limit N]
+"""
+
+from __future__ import annotations
+
+import argparse
+import datetime
+import re
+import sys
+from pathlib import Path
+
+_SELF_DIR = Path(__file__).resolve().parent
+for _c in (_SELF_DIR, _SELF_DIR.parent / "scripts"):
+    if (_c / "localpibox").is_dir():
+        sys.path.insert(0, str(_c))
+        break
+
+from localpibox import log  # noqa: E402
+from localpibox.cli import add_common_args, console_from_args, install_sigpipe_handler  # noqa: E402
+from localpibox.run import run_cmd, which  # noqa: E402
+
+_REPO_RE = re.compile(r"[\w.-]+/[\w.-]+")
+
+
+def parse_repo_list(text: str) -> list[str]:
+    """Parse `gh repo list` TSV output -> ``owner/name`` strings.
+
+    Ignores blank lines and any row whose first column is not a valid
+    ``owner/name`` pair (headers, error text, extra columns).
+    """
+    repos: list[str] = []
+    for line in text.splitlines():
+        if not line.strip():
+            continue
+        first = line.split("\t", 1)[0].strip()
+        if _REPO_RE.fullmatch(first):
+            repos.append(first)
+    return repos
+
+
+def list_repos(
+    account: str | None = None,
+    *,
+    limit: int = 500,
+    gh: str = "gh",
+    runner=None,
+) -> list[str]:
+    """List repos for *account* (or the authenticated user when None)."""
+    runner = runner or run_cmd
+    cmd = [gh, "repo", "list", "--limit", str(limit)]
+    if account:
+        cmd.insert(3, account)
+    out, err, code = runner(cmd, timeout=120)
+    if code:
+        raise RuntimeError(f"`gh repo list` failed: {err.strip() or out.strip()}")
+    return parse_repo_list(out)
+
+
+def mirror_repo(
+    repo: str,
+    dest: str | Path,
+    *,
+    git: str = "git",
+    runner=None,
+) -> bool:
+    """Mirror-clone *repo* into *dest*; True on success."""
+    runner = runner or run_cmd
+    out, err, code = runner(
+        [git, "clone", "--mirror", f"https://github.com/{repo}", str(dest)],
+        timeout=600,
+    )
+    if code:
+        log.warn(f"  failed to clone {repo}: {err.strip() or out.strip()}")
+        return False
+    return True
+
+
+def default_out_dir() -> Path:
+    """Default snapshot root: ``~/.localpibox/backups`` (matches lpb state dirs)."""
+    return Path.home() / ".localpibox" / "backups"
+
+
+def main(argv: list[str] | None = None) -> int:
+    install_sigpipe_handler()
+    parser = argparse.ArgumentParser(prog="backup-repos", description=__doc__)
+    add_common_args(parser)
+    parser.add_argument(
+        "--out", default=None,
+        help="snapshot dir (default: ~/.localpibox/backups/snapshot_<timestamp>)",
+    )
+    parser.add_argument(
+        "--account", default=None,
+        help="GitHub owner to back up (default: authenticated user)",
+    )
+    parser.add_argument("--limit", type=int, default=500, help="max repos to fetch")
+    args = parser.parse_args(argv)
+    cons = console_from_args(args)
+
+    if not which("gh"):
+        log.error("gh CLI not found — install it and run `gh auth login` first")
+        return 1
+    if not which("git"):
+        log.error("git not found")
+        return 1
+
+    out_dir = (
+        Path(args.out)
+        if args.out
+        else default_out_dir()
+        / f"snapshot_{datetime.datetime.now().strftime('%Y%m%d_%H%M%S')}"
+    )
+    out_dir.mkdir(parents=True, exist_ok=True)
+    cons.info(f"Backing up repos to {out_dir}")
+
+    try:
+        repos = list_repos(args.account, limit=args.limit)
+    except RuntimeError as exc:
+        log.error(str(exc))
+        return 1
+
+    ok = failed = 0
+    for repo in repos:
+        dest = out_dir / f"{repo.split('/', 1)[1]}.git"
+        cons.info(f"Backing up: {repo}")
+        if mirror_repo(repo, dest):
+            ok += 1
+        else:
+            failed += 1
+
+    cons.done(f"Backup complete: {ok} backed up, {failed} failed -> {out_dir}")
+    return 1 if failed else 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

scripts/test_localpibox.py

@@ -29,9 +29,8 @@
 SCRIPTS_DIR = Path(__file__).resolve().parent
 DEVSTACK_DIR = SCRIPTS_DIR.parent
 SUPPORT_DIR = DEVSTACK_DIR / "support"
-PARENT_DIR = DEVSTACK_DIR.parent  # /home/sp/Documents/localpibox
 
-for _d in (str(SCRIPTS_DIR), str(SUPPORT_DIR), str(PARENT_DIR)):
+for _d in (str(SCRIPTS_DIR), str(SUPPORT_DIR)):
     if _d not in sys.path:
         sys.path.insert(0, _d)