#!/usr/bin/env python3 """Attach the packaged release artifacts to the Gitea release of one tag. The release workflow builds the archives, the checksums file and the SBOM into `dist/`; this script is what makes them durable: it upserts the release entry of the tag and uploads every artifact to it, so a published version keeps its artifacts and checksums after the runner workspace is gone. The token is read from `GITEA_TOKEN` only; it is never printed, logged or written to disk. """ from __future__ import annotations import argparse import json import mimetypes import os import sys import urllib.error import urllib.request from pathlib import Path TIMEOUT_SECONDS = 120 def _json(url: str, token: str, method: str = "GET", payload: dict | None = None) -> dict: headers = {"Authorization": f"token {token}", "Accept": "application/json"} data = None if payload is not None: data = json.dumps(payload).encode("utf-8") headers["Content-Type"] = "application/json" request = urllib.request.Request(url, data=data, headers=headers, method=method) with urllib.request.urlopen(request, timeout=TIMEOUT_SECONDS) as response: return json.loads(response.read() or b"{}") def _upload(url: str, token: str, path: Path) -> dict: headers = { "Authorization": f"token {token}", "Content-Type": mimetypes.guess_type(path.name)[0] or "application/octet-stream", } request = urllib.request.Request(url, data=path.read_bytes(), headers=headers, method="POST") with urllib.request.urlopen(request, timeout=TIMEOUT_SECONDS) as response: return json.loads(response.read() or b"{}") def release_artifacts(dist: Path) -> list[Path]: """Every regular file directly in `dist/`, in a stable order; nested build dirs are ignored.""" return sorted(path for path in dist.iterdir() if path.is_file() and not path.name.startswith(".")) def publish(api: str, repo: str, tag: str, title: str, notes: Path, dist: Path, prerelease: bool, token: str) -> int: base = f"{api.rstrip('/')}/repos/{repo}" # The notes file is the release body, not an artifact of the release. artifacts = [path for path in release_artifacts(dist) if path.name != notes.name] if not artifacts: print(f"no release artifacts in {dist}", file=sys.stderr) return 2 try: release = _json(f"{base}/releases/tags/{tag}", token) except urllib.error.HTTPError as error: if error.code != 404: raise release = _json( f"{base}/releases", token, "POST", { "tag_name": tag, "name": title, "body": notes.read_text(encoding="utf-8"), "draft": False, "prerelease": prerelease, }, ) existing = {asset["name"] for asset in release.get("assets") or []} for path in artifacts: if path.name in existing: print(f"skip existing asset {path.name}") continue uploaded = _upload(f"{base}/releases/{release['id']}/assets?name={path.name}", token, path) print(f"uploaded {path.name} -> {uploaded.get('browser_download_url', 'ok')}") print(f"release {tag} id={release['id']} artifacts={len(artifacts)}") return 0 def main() -> int: parser = argparse.ArgumentParser(description=__doc__) parser.add_argument("--api", required=True, help="API root, e.g. https://git.itexp.me/api/v1") parser.add_argument("--repo", required=True, help="owner/name") parser.add_argument("--tag", required=True) parser.add_argument("--title", required=True) parser.add_argument("--notes-file", type=Path, required=True) parser.add_argument("--dist", type=Path, required=True) parser.add_argument("--prerelease", action="store_true") args = parser.parse_args() token = os.environ.get("GITEA_TOKEN", "") if not token: print("GITEA_TOKEN is required to publish release artifacts", file=sys.stderr) return 2 return publish(args.api, args.repo, args.tag, args.title, args.notes_file, args.dist, args.prerelease, token) if __name__ == "__main__": raise SystemExit(main())