Skip to main content
L’Action fait deux choses et rien d’autre : prioritize avant vos tests, ingest après. Elle ne saute aucun test. Sauter se décide ailleurs, et volontairement (voir le filet de sécurité).

Un workflow complet

Le if: ${{ !cancelled() }} compte. Sans lui, l’étape ingest est sautée quand les tests échouent, c’est-à-dire précisément quand il y a quelque chose à apprendre.

Les entrées

Les motifs glob sont transmis entre guillemets et développés par testhunch lui-même, pas par le shell du runner. Le même motif donne donc les mêmes fichiers sur Linux, macOS et Windows.

Les sorties

prioritize produit deux fichiers :
  • ranking-json : le chemin d’un JSON avec chaque test, son score et ses raisons ;
  • ranking-keys : le chemin d’un fichier texte, une clé de test par ligne, du plus au moins susceptible d’échouer.

Ce que vous verrez dans le job

prioritize écrit les tests les mieux classés dans le résumé du job. ingest y écrit deux choses : le rapport des tests instables, lents et en échec, puis le rapport du mode fantôme, c’est-à-dire ce que sauter les tests les moins bien classés aurait manqué. Sur les premiers builds, ce dernier n’a rien à dire, il lui faut de l’historique.

Garder l’historique

Sans database-url, l’historique ne survit pas d’une exécution à l’autre, et testhunch repart de zéro à chaque job. C’est utile pour essayer, inutile pour s’en servir. Pour un vrai usage, passez l’URL d’une base Postgres depuis un secret.

Sur la version

L’Action construit le paquet depuis son propre checkout, donc @v0.6.0 fait tourner testhunch 0.6.0 : l’Action et la CLI ne peuvent pas diverger. Pour une garantie plus forte qu’un tag, épinglez le SHA du commit.
Les entrées arrivent au script par des variables d’environnement, jamais interpolées dans un run:. Une valeur fabriquée ne peut donc pas exécuter de commandes sur votre runner.

Envoyer à un testhunch hébergé

Au lieu d’une base que votre job doit joindre, api-url envoie le run au service :
Les rapports partent tels quels et c’est le serveur qui les analyse. Une adresse en http:// qui n’est pas la boucle locale est refusée, pour que le jeton ne circule jamais en clair. Demandez à l’exploitant du service un jeton qui n’ouvre que votre dépôt plutôt que le sien, qui les ouvre tous. Avec api-url, prioritize demande aussi le classement au serveur, qui garde ce qu’il a servi quand record est actif. Le classement et le run qui suit vivent donc dans la même base, et le mode fantôme a de quoi comparer (ADR 0023). Le résumé du job montre alors le rapport du mode fantôme tel que le serveur le calcule : c’est chez lui que vivent les deux moitiés qu’il compare, le classement qu’il a servi et les résultats qu’on lui a envoyés.