gaji – GitHub Actions sicher mit TS schreiben, inklusive Codegen

Kürzlich hatte ich mit mehreren Dutzend GitHub Actions zu tun. Dabei sind mir drei Probleme aufgefallen.

1. YAML ist eine Sprache zur Datenbeschreibung und nicht gut geeignet, um Verhalten auszudrücken.
2. Es gibt keine Typprüfung. Man ist oft auf externe Repositories angewiesen (actions/checkout@v5 ist bereits ein externes Repository), aber es gibt keinerlei Validierung für die Eingaben, die diese erwarten. Nutzer müssen selbst in die Dokumentation schauen und jede Eingabe einzeln im passenden Format angeben.
3. Es ist schwer, das lokal zu reproduzieren.

gaji löst Problem 1 und 2. Es lädt automatisch action.yml aus den verwendeten Actions und wandelt sie in TypeScript-Typen um. Auf dieser Basis kann man Workflows in TS schreiben und diese kompilieren, um YAML-Dateien zu erhalten.

Wenn ihr mehr über die Motivation hinter dem Projekt und diese drei Probleme erfahren möchtet, schaut euch bitte Warum gaji? - GitHub Actions sicher mit TS schreiben an.