Task runners além do make: just, npm scripts e Invoke para comandos de projeto

O que é

Um task runner reúne os comandos de um projeto (build, test, lint, db-reset) em um só lugar, para que pessoas, agentes e CI executem a mesma coisa. O make é a ferramenta clássica, mas traz semântica de sistema de build (alvos que são arquivos, timestamps, receitas indentadas com tabulação) de que os comandos de um projeto não precisam. O manual do just afirma que os comandos, chamados de receitas (recipes), ficam em um arquivo chamado justfile, com sintaxe inspirada no make, e descreve o just como um executor de comandos, não como um sistema de build; assim, não há lógica de atualização de arquivos com que lidar. As receitas aceitam parâmetros, e just --list as exibe junto com o comentário que vem imediatamente antes de cada uma. Os npm scripts ficam no package.json; a documentação do npm descreve scripts de ciclo de vida e hooks pre e post (pretest roda antes de test), e o npm run adiciona ao PATH os executáveis instalados localmente, de modo que as ferramentas não precisam de instalação global. O Invoke é em Python: funções decoradas com @task em um tasks.py recebem um objeto de contexto, ganham parsing de argumentos e ajuda gerados automaticamente e executam comandos de shell por meio desse contexto.

Por que importa

O valor está no contrato, não na ferramenta: qualquer colaborador executa just --list ou npm run e vê todos os comandos suportados, e o CI chama os mesmos nomes. Quando um comando muda, a mudança é feita em um único arquivo, e não em um README, em um arquivo de workflow e em vários históricos de shell.

Como aplicar

• Escolha o runner que corresponde à linguagem principal do projeto, para não precisar de toolchain extra: npm scripts para projetos Node, Invoke para Python e just quando o repositório abrange várias linguagens ou não tem runtime próprio.
• Mantenha as receitas curtas; o que passar de poucas linhas vira um script em scripts/ que a receita chama, para que possa passar por lint e testes.
• Dê a cada receita uma descrição de uma linha: o just mostra o comentário que precede a receita em just --list, e o Invoke imprime a primeira linha da docstring da tarefa em invoke --list.
• Faça as receitas funcionarem a partir de qualquer diretório e sem prompts; defina o shell explicitamente e faça as receitas baseadas em shell falharem em caso de erro.
• Repita os nomes entre repositórios (setup, test, lint, fmt, run) para que o conhecimento seja transferível.
• Deixe o CI chamar a receita, e não uma cópia do conteúdo dela; veja a metodologia relacionada sobre manter idênticas as verificações do CI e as locais.

Armadilhas

Os npm scripts são strings de shell, então o uso de aspas e a portabilidade entre shells variam, e os hooks pre e post rodam de forma implícita, o que surpreende quem lê. O just precisa ser instalado separadamente, mais um passo para o script de bootstrap. O tasks.py do Invoke é Python comum, então um erro de importação no ambiente em que ele roda também quebra a lista de tarefas. Nenhum dos três acompanha a atualização de arquivos; use uma ferramenta de build para builds incrementais.