Files
computer-playbook/cli/contributing/mirror/wait/__main__.py
T
kevinveenbirkenbachandClaude Opus 5 5137465c6f style: delete every comment the comments-valid policy rejects
3529 invalid comments in 528 files, grandfathered in while the linter
only saw the working-tree diff. Removal ran through the linter's own
collectors, so detection and deletion cannot drift: a comment whose
opener line is blank before it and whose closer line is blank after it
loses all its lines, anything else loses only the comment region, and a
line left holding a bare delimiter goes with it.

Five files keep their comments behind a nocheck marker instead. Four are
upstream configs whose inline docs are upstream's own (mautrix, systemd
journald, nextcloud-oidc-login, MediaWiki). In littlejs the
commented-out entries ARE the deactivation mechanism for an example
tile, so deleting them would delete configuration.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-18 03:22:02 +02:00

89 lines
2.6 KiB
Python

from __future__ import annotations
import argparse
import sys
import time
from pathlib import Path
from cli.contributing.mirror.providers import GHCRProvider
from utils.docker.image.discovery import ImageRef, iter_role_images
def _validate_positive_int(value: str) -> int:
try:
n = int(value)
except ValueError as e:
raise argparse.ArgumentTypeError("must be an integer") from e
if n <= 0:
raise argparse.ArgumentTypeError("must be > 0")
return n
def main() -> int:
parser = argparse.ArgumentParser(
description=(
"Wait until every role-declared image has been mirrored to the "
"configured GHCR registry. Used on fork pull_request runs that depend "
"on a pull_request_target mirror job populating the destination first."
),
)
parser.add_argument("--repo-root", default=".")
GHCRProvider.add_args(parser)
parser.add_argument(
"--attempts",
type=_validate_positive_int,
required=True,
help="Maximum number of polling attempts before giving up.",
)
parser.add_argument(
"--sleep-seconds",
type=_validate_positive_int,
required=True,
help="Seconds to wait between polling attempts.",
)
args = parser.parse_args()
provider = GHCRProvider.from_args(args)
repo_root = Path(args.repo_root).resolve()
refs: dict[str, ImageRef] = {}
for img in iter_role_images(repo_root):
refs.setdefault(f"{provider.image_base(img)}:{img.version}", img)
total = len(refs)
if total == 0:
print("No mirror refs found. Nothing to wait for.")
return 0
print(
"Fork pull_request detected; waiting for mirrored images from "
"pull_request_target."
)
print(f"Need {total} mirror refs.")
missing: list[str] = []
for attempt in range(1, args.attempts + 1):
missing = [ref for ref, img in refs.items() if not provider.tag_exists(img)]
if not missing:
print("All mirrored images are available.")
return 0
print(
f"[{attempt}/{args.attempts}] Missing {len(missing)}/{total} mirror refs. "
f"Waiting {args.sleep_seconds}s...",
flush=True,
)
print(f"Example missing: {missing[0]}", flush=True)
if attempt < args.attempts:
time.sleep(args.sleep_seconds)
print("Timed out waiting for mirrored images.", file=sys.stderr)
print("Still missing (first 20):", file=sys.stderr)
for ref in missing[:20]:
print(f" - {ref}", file=sys.stderr)
return 1
if __name__ == "__main__":
raise SystemExit(main())