Les exécuteurs de tâches au-delà de make : just, les scripts npm et Invoke pour les commandes de projet

Ce que c'est

Un exécuteur de tâches donne à un projet un endroit unique pour ses commandes (build, test, lint, db-reset), afin que les personnes, les agents et l'intégration continue invoquent la même chose. make est l'outil classique, mais il porte une sémantique de système de construction (cibles de fichiers, horodatages, recettes indentées à la tabulation) dont les commandes de projet n'ont pas besoin. Le manuel de just indique que les commandes, appelées recettes, sont stockées dans un fichier nommé justfile avec une syntaxe inspirée de make, et décrit just comme un exécuteur de commandes, pas un système de construction, si bien qu'il n'y a pas de logique de fraîcheur de fichier à combattre ; les recettes prennent des paramètres, et just --list les affiche avec le commentaire précédant immédiatement chaque recette. Les scripts npm vivent dans package.json ; la documentation npm décrit des scripts de cycle de vie et des hooks pre et post (pretest s'exécute avant test), et npm run ajoute les exécutables installés localement au PATH, si bien que les outils n'ont pas besoin d'installation globale. Invoke est en Python : des fonctions décorées avec @task dans un tasks.py reçoivent un objet de contexte, obtiennent une analyse d'arguments et une aide générées pour elles, et exécutent des commandes shell via le contexte.

Pourquoi c'est important

La valeur réside dans le contrat, pas dans l'outil : n'importe quel collaborateur exécute just --list ou npm run et voit toutes les commandes prises en charge, et l'intégration continue appelle les mêmes noms. Quand une commande change, elle change dans un seul fichier plutôt que dans un README, un fichier de workflow et plusieurs historiques shell.

Comment l'appliquer

• Choisir l'exécuteur qui correspond au langage principal du projet, afin de n'avoir besoin d'aucune chaîne d'outils supplémentaire : les scripts npm pour les projets Node, Invoke pour Python, just lorsque le dépôt couvre plusieurs langages ou n'a pas de runtime propre.
• Garder les recettes courtes ; tout ce qui dépasse quelques lignes devient un script sous scripts/ que la recette appelle, afin qu'il puisse être vérifié par un linter et testé.
• Donner à chaque recette une description d'une ligne : just affiche le commentaire précédant une recette dans just --list, et Invoke affiche la première ligne de la docstring d'une tâche dans invoke --list.
• Faire en sorte que les recettes fonctionnent depuis n'importe quel répertoire et sans invite interactive ; définir le shell explicitement et échouer en cas d'erreur dans les recettes adossées à un shell.
• Reprendre les mêmes noms d'un dépôt à l'autre (setup, test, lint, fmt, run) afin que les connaissances se transfèrent.
• Laisser l'intégration continue appeler la recette, et non une copie de son contenu ; voir la méthodologie connexe sur le fait de garder identiques les vérifications d'intégration continue et locales.

Pièges

Les scripts npm sont des chaînes shell, si bien que l'échappement et la portabilité entre shells varient, et les hooks pre et post s'exécutent implicitement, ce qui surprend les lecteurs. just doit être installé séparément, une étape supplémentaire pour le script d'amorçage. Le tasks.py d'Invoke est du Python ordinaire, si bien qu'une erreur d'import dans l'environnement où il s'exécute casse aussi la liste des tâches. Aucun des trois ne suit la fraîcheur des fichiers ; utiliser un outil de construction pour des constructions incrémentales.