Recipes

Worked-example workflows for common shapes. Most recipes run as-is on ubuntu-latest against astro-tools/setup-gmat@v0 — no external dependencies, no secret-gated steps. Copy, adapt, ship.

• Run pytest against gmatpy — install GMAT and run a pytest suite whose tests import gmatpy. Sets PYTHONPATH on the test step.
• Run a mission script and upload its report — drive a .script file via gmatpy.LoadScript / RunScript from Python, write a report, and upload it as a build artifact.
• Skip the GMAT install on docs-only changes — use paths-ignore to keep the heavy install off PRs that only touch READMEs or docs/. Includes the inverse paths filter for docs-only jobs.
• Validate against every GMAT version on every OS — a {ubuntu, windows, macos} × {R2022a, R2025a, R2026a} matrix with fail-fast: false and matrix.exclude for the unsupported macos × R2022a combo.
• Run jobs in the GMAT container image — use ghcr.io/astro-tools/gmat:Rxxxxa as a jobs.*.container.image instead of running the action; trades cross-OS coverage and actions/setup-python flexibility for a pre-warmed environment.

For the underlying mechanics each recipe builds on, see Getting started, Inputs and outputs, and Troubleshooting.