setup-gmat v0.2 — Windows, macOS, and the R2022a/R2025a/R2026a matrix

[djankov]

setup-gmat v0.2 ships cross-platform coverage and the full version matrix. Drop one step into your CI on Linux, Windows, or macOS, against R2022a, R2025a, or R2026a, and get a working GMAT_ROOT and an importable gmatpy.

- uses: actions/setup-python@v5
  with:
    python-version: '3.12'
- uses: astro-tools/setup-gmat@v0
  with:
    version: R2026a
    cache: true

What's new in v0.2

• Windows + macOS runners. The action now dispatches per-OS — Linux tarball, Windows zip, macOS DMG (mounted read-only, copied off the mount, detached). Every step that was Linux-hardcoded in v0.1 is generalized (#48, #49).
• Full version matrix. R2022a, R2025a, R2026a — pick any. R2023a and R2024a are explicitly rejected with a pointer to the FAQ; NASA never released them (#47).
• Self-CI on every cell. {ubuntu-latest, windows-latest, macos-latest} × {R2022a, R2025a, R2026a} runs on every PR. The one excluded combo is macos-latest × R2022a — R2022a's macOS DMG ships x86_64-only gmatpy bindings that Apple Silicon runners cannot dlopen (#51).
• Weekly cron + drift detection. A Monday 06:00 UTC self-CI re-run on main plus a daily HEAD-only URL liveness check across every supported (version, OS) triple — SourceForge mirror drift fails the upstream watchdog before any consumer notices (#52, #53).
• Cache key folds the installer SHA-256. A re-uploaded installer at the same URL invalidates the cache cleanly without a version bump (#50).
• Docs surface for v0.2. A multi-version compatibility recipe, Python-ABI-per-GMAT-release table, troubleshooting entries for Windows/macOS failure modes, and the canonical FAQ entry on the R2023a/R2024a gap (#56, #57, #58).

v0.2 supports

Runner	R2022a	R2025a	R2026a
ubuntu-latest	✅	✅	✅
windows-latest	✅	✅	✅
macos-latest	❌ (x86_64-only DMG)	✅	✅

Pin Python to a version your chosen GMAT release ships gmatpy bindings for — see the Python ABI table in the README. R2022a's lowest common denominator across all OSes is 3.9.

Pinning

@v0 is the floating major tag — auto-picks v0.x.x patches. Pin to @v0.2.0 for an immutable SHA.

Links

• Marketplace: https://github.com/marketplace/actions/setup-gmat
• Docs: https://astro-tools.github.io/setup-gmat/
• Source: https://github.com/astro-tools/setup-gmat
• Release notes: https://github.com/astro-tools/setup-gmat/releases/tag/v0.2.0

Feedback wanted

• Did windows-latest or macos-latest install cleanly on your runner image? If not, which image and what failed?
• The cache key now folds the installer SHA-256 — anyone hit a stale-cache scenario in the wild that this fix is meant to cover?
• For v0.3, the next axes are a GHCR Docker image and semantic-release-managed tags — which is more useful to you first?