Ejecutores de tareas más allá de make: just, npm scripts e Invoke para los comandos de un proyecto

Qué es

Un ejecutor de tareas ofrece al proyecto un único lugar para sus comandos (build, test, lint, db-reset), de modo que personas, agentes y CI invoquen lo mismo. make es la herramienta clásica, pero arrastra semánticas de sistema de compilación (objetivos basados en archivos, marcas de tiempo, recetas indentadas con tabuladores) que los comandos de un proyecto no necesitan. El manual de just indica que los comandos, llamados recetas, se guardan en un archivo llamado justfile con una sintaxis inspirada en make, y describe just como un ejecutor de comandos, no como un sistema de compilación, así que no hay lógica de actualización de archivos con la que pelear; las recetas aceptan parámetros, y just --list las muestra junto con el comentario que precede inmediatamente a cada receta. Los npm scripts viven en package.json; la documentación de npm describe los scripts de ciclo de vida y los hooks pre y post (pretest se ejecuta antes de test), y npm run añade al PATH los ejecutables instalados localmente, por lo que las herramientas no necesitan una instalación global. Invoke está hecho en Python: las funciones decoradas con @task en un tasks.py reciben un objeto de contexto, obtienen el análisis de argumentos y la ayuda generados automáticamente, y ejecutan comandos de shell a través del contexto.

Por qué importa

El valor está en el contrato, no en la herramienta: cualquier colaborador ejecuta just --list o npm run y ve todos los comandos admitidos, y CI llama a los mismos nombres. Cuando un comando cambia, cambia en un solo archivo, y no en un README, un archivo de workflow y varios historiales de shell.

Cómo aplicarlo

• Elige el ejecutor que corresponda al lenguaje principal del proyecto para no necesitar herramientas adicionales: npm scripts para proyectos Node, Invoke para Python, y just cuando el repositorio abarca varios lenguajes o no tiene un entorno de ejecución propio.
• Mantén las recetas cortas; todo lo que supere unas pocas líneas pasa a ser un script bajo scripts/ al que la receta llama, de modo que se pueda analizar con linters y probar.
• Da a cada receta una descripción de una línea: just muestra en just --list el comentario que precede a la receta, e Invoke imprime en invoke --list la primera línea del docstring de la tarea.
• Haz que las recetas funcionen desde cualquier directorio y sin solicitar entradas interactivas; define el shell de forma explícita y haz que fallen ante un error en las recetas que se apoyan en el shell.
• Replica los nombres entre repositorios (setup, test, lint, fmt, run) para que el conocimiento se traslade.
• Deja que CI llame a la receta, no a una copia de su contenido; consulta la metodología relacionada sobre cómo mantener idénticas las comprobaciones de CI y las locales.

Trampas

Los npm scripts son cadenas de shell, así que el uso de comillas y la portabilidad entre shells varían, y los hooks pre y post se ejecutan de forma implícita, lo que sorprende a quien lee. just debe instalarse por separado, un paso más para el script de arranque. El tasks.py de Invoke es Python corriente, por lo que un error de importación en el entorno donde se ejecuta también rompe la lista de tareas. Ninguna de las tres herramientas controla si los archivos están actualizados; para compilaciones incrementales usa una herramienta de compilación.