> ## Documentation Index
> Fetch the complete documentation index at: https://testhunch.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# testhunch

> Apprend de l'historique de votre CI quels tests un changement risque de casser, et les lance en premier.

testhunch lit les rapports **JUnit XML** que votre lanceur produit déjà, plus `git diff`. Rien
d'autre. C'est pour ça qu'il n'est lié à aucun langage : il est testé sur de vrais rapports de
pytest, Vitest, Jest, Go (gotestsum), Java (Maven Surefire) et Rust (cargo-nextest).

> [!NOTE]
>
> **Statut : pré-alpha.** L'ingestion, le stockage, les rapports et un classement explicable
> fonctionnent aujourd'hui, et un benchmark public les mesure. Un modèle appris a été mesuré contre
> l'heuristique actuelle : il ne la bat pas, il n'est donc pas livré, et la comparaison est publiée.

## Ce qu'il fait

1. **`ingest`** enregistre, après votre job de tests, le résultat de chaque test pour ce commit et
   les fichiers modifiés.
2. **`report`** montre les tests instables (réussis *et* échoués sur le même commit), les plus lents
   et ceux en échec.
3. **`prioritize`** ordonne les tests pour le changement en cours, et explique chaque place.
4. **`shadow`** mesure ce que sauter des tests *aurait* manqué, avant qu'on saute quoi que ce soit.

## Par où commencer

> [card] [Démarrer](https://testhunch.mintlify.site/docs/demarrer.md)
>
> Installer, ingérer un premier rapport, obtenir un premier classement.

> [card] [Comment le classement est calculé](https://testhunch.mintlify.site/docs/concepts/classement.md)
>
> Le score, ses raisons, et ce qu'il fait des tests qu'il ne connaît pas.

> [card] [L'Action GitHub](https://testhunch.mintlify.site/docs/ci/action.md)
>
> Classer avant les tests, enregistrer après, lire le résumé dans le job.

> [card] [Sauter des tests](https://testhunch.mintlify.site/docs/sauter/index.md)
>
> Les budgets, les six lanceurs, et ce qui tourne toujours quoi qu'il arrive.

## Sur les chiffres

testhunch n'avance pas de promesse de précision sans la mesure qui va avec. Les résultats sont
publiés projet par projet, **y compris là où testhunch s'en sort mal**. Ils sortent de commandes du
dépôt, ils ne sont pas écrits à la main :

* [Résultats du benchmark](https://github.com/amazing-source/testhunch/blob/main/benchmarks/results/README.md),
  20 projets Java sur de l'historique Travis CI réel, plus quatre projets rejoués commit par commit ;
* [L'étude du classement](https://github.com/amazing-source/testhunch/tree/main/benchmarks/results/study),
  comment cette version a été choisie et ce qu'elle vaut face à « les tests qui ont échoué le plus
  récemment d'abord » ;
* [Les décisions d'architecture](https://github.com/amazing-source/testhunch/tree/main/docs/adr),
  pourquoi les choses sont faites ainsi, y compris ce qui a été écarté.

Ce site ne recopie aucun de ces chiffres, il y renvoie. Un nombre mesuré vit dans un seul fichier,
celui qu'écrit la commande qui l'a calculé
([ADR 0019](https://github.com/amazing-source/testhunch/blob/main/docs/adr/0019-the-documentation-site-carries-no-number-of-its-own.md)).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.