scripts/run_resource_cycle.py

"""Run the Pashto resource update cycle in a repeatable way.

This script is a command wrapper around existing resource scripts so maintainers
do not need to remember the full sequence.

Usage:
    python scripts/run_resource_cycle.py
    python scripts/run_resource_cycle.py --limit 30
    python scripts/run_resource_cycle.py --skip-pytest
    python scripts/run_resource_cycle.py --discover-only
"""

from __future__ import annotations

import argparse
import shlex
import subprocess
import sys
from pathlib import Path


def _run(command: list[str], cwd: Path) -> int:
    print(f"[run] {shlex.join(command)}")
    completed = subprocess.run(command, cwd=str(cwd), check=False)
    return completed.returncode


def main() -> int:
    parser = argparse.ArgumentParser()
    parser.add_argument("--limit", type=int, default=25, help="Candidate fetch limit per source")
    parser.add_argument("--skip-pytest", action="store_true", help="Skip pytest step")
    parser.add_argument("--discover-only", action="store_true", help="Only sync candidates and stop")
    args = parser.parse_args()

    repo_root = Path(__file__).resolve().parents[1]
    steps: list[list[str]] = [
        ["python", "scripts/sync_resources.py", "--limit", str(args.limit)],
    ]

    if not args.discover_only:
        steps.extend(
            [
                ["python", "scripts/validate_resource_catalog.py"],
                ["python", "scripts/generate_resource_views.py"],
                ["python", "scripts/check_links.py"],
            ]
        )
        if not args.skip_pytest:
            steps.append(["python", "-m", "pytest", "-q"])

    for command in steps:
        code = _run(command, repo_root)
        if code != 0:
            print(f"[fail] Step failed with exit code {code}")
            return code

    print("[ok] Resource cycle completed")
    if args.discover_only:
        print(
            "Next: review resources/catalog/pending_candidates.json and promote approved "
            "entries into resources/catalog/resources.json."
        )
    else:
        print("Next: commit updated catalog/generated files and push.")
    return 0


if __name__ == "__main__":
    raise SystemExit(main())