gaji – escrevendo GitHub Actions com segurança em TS, com codegen incluso

Recentemente, tive que lidar com algumas dezenas de GitHub Actions. Nessa ocasião, percebi 3 problemas.

1. YAML é uma linguagem de representação de dados e não é adequada para expressar comportamento.
2. Não há verificação de tipos. Muitas vezes é preciso depender de repositórios externos (actions/checkout@v5 também é um repositório externo), mas não existe nenhuma validação sobre as entradas que eles exigem. O usuário precisa consultar a documentação e inserir tudo manualmente no formato correto.
3. É difícil reproduzir localmente.

gaji resolve os problemas 1 e 2. Ele busca automaticamente o action.yml das actions utilizadas e o converte em tipos TypeScript. Com base nisso, é possível escrever o workflow em TS e compilá-lo para obter um arquivo YAML.

Se quiser saber mais detalhes sobre o criador e esses 3 problemas, consulte Por que gaji? - Escrevendo GitHub Actions com segurança em TS.