gaji – escribir GitHub Actions de forma segura con TS, y además con codegen

Recientemente tuve que trabajar con varias decenas de GitHub Actions. En ese momento sentí 3 problemas.

1. YAML es un lenguaje de representación de datos, y no es adecuado para expresar comportamiento.
2. No hay verificación de tipos. A menudo hay que depender de repositorios externos (actions/checkout@v5 también es un repositorio externo), pero no existe ninguna validación sobre las entradas que estos requieren. El usuario tiene que revisar la documentación y ajustar manualmente cada entrada al formato correcto.
3. Es difícil reproducirlo localmente.

gaji resuelve los problemas 1 y 2. Obtiene automáticamente action.yml de las actions que se usan y lo convierte en tipos de TypeScript. Con base en eso, se puede escribir el workflow en TS y compilarlo para obtener un archivo YAML.

Si quieren conocer más sobre la motivación de su creación y sobre estos 3 problemas en detalle, consulten ¿Por qué gaji? - Escribir GitHub Actions de forma segura con TS.