> ## 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.

# La ligne de commande

> Les six commandes, leurs options, et ce que chacune écrit.

Toutes les commandes acceptent `--db` (ou `TESTHUNCH_DATABASE_URL`) et `--repo`. Sans `--repo`,
testhunch lit `GITHUB_REPOSITORY`, sinon le dépôt git courant. Le schéma se crée et se met à jour au
démarrage de chacune.

## `ingest`

Enregistre un ou plusieurs rapports JUnit XML.

```bash theme={"system"}
testhunch ingest junit.xml 'reports/**/*.xml' --base origin/main
```

| Option | Rôle |
| - | - |
| `reports` | Fichiers ou motifs glob, développés par testhunch et non par le shell |
| `--commit` | Le commit testé (`HEAD` par défaut) |
| `--branch` | La branche testée (détectée par défaut) |
| `--base` | Enregistre aussi les fichiers modifiés depuis cette référence |
| `--api` | Envoie le run à un testhunch hébergé au lieu d'une base (variable `TESTHUNCH_API_URL`) |

Avec `--api`, aucune base locale n'est ouverte : les rapports partent tels quels et c'est le serveur
qui les analyse. Le jeton vient de `TESTHUNCH_API_TOKEN`, et une adresse en `http://` qui n'est pas
la boucle locale est refusée, pour que le jeton ne circule jamais en clair.

```bash theme={"system"}
export TESTHUNCH_API_TOKEN=...
testhunch ingest junit.xml --base origin/main --api https://api.exemple.fr
```

## `token`

Les jetons qui n'ouvrent qu'un dépôt, frappés depuis la machine qui a la base et jamais par l'API.

```bash theme={"system"}
testhunch token create --repo acme/shop --label "github actions"
testhunch token list
testhunch token revoke 3
```

| Sous-commande | Rôle |
| - | - |
| `create` | Frappe un jeton pour `--repo` et l'affiche une seule fois |
| `list` | Les jetons, leur état et leur étiquette, jamais leur secret |
| `revoke` | Ferme un jeton définitivement |

## `report`

Les tests instables, les plus lents et ceux en échec.

| Option | Rôle |
| - | - |
| `--last` | Sur combien d'exécutions récentes porte le rapport |
| `--limit` | Lignes par section |
| `--format` | `text`, `json` ou `markdown` |

## `prioritize`

Ordonne les tests pour un changement.

```bash theme={"system"}
testhunch prioritize --base origin/main --limit 20
```

| Option | Rôle |
| - | - |
| `--base` | Classe pour les fichiers modifiés depuis cette référence |
| `--changed` | Classe pour ces chemins, donnés à la main |
| `--limit` | N'affiche que les N premiers |
| `--format` | `text`, `json`, `keys` ou `markdown` |
| `--api` | Demande le classement à un testhunch hébergé, qui classe depuis son propre historique (variable `TESTHUNCH_API_URL`) |
| `--record` | Enregistre le classement pour le mode fantôme ; avec `--api`, c'est le serveur qui garde ce qu'il a servi |
| `--commit` | Le commit sur le point d'être testé : il départage les scores égaux, et `--record` enregistre pour lui |

`--base` et `--changed` s'excluent.

## `select`

La liste des tests connus qu'un budget laisse de côté, au format d'un lanceur.

```bash theme={"system"}
testhunch select --budget 25% --runner pytest --base origin/main
```

| Option | Rôle |
| - | - |
| `--budget` | Part du temps de test attendu, par exemple `25%`. Obligatoire |
| `--budget-unit` | `time` (défaut) ou `tests` |
| `--runner` | `pytest`, `go`, `surefire`, `nextest`, `vitest` ou `jest`. Obligatoire |
| `--go-test-list` | Avec `--runner go` : la sortie de `go test -list '.*' ./...` |
| `--vitest-list` | Avec `--runner vitest` : la sortie de `vitest list --json --no-static-parse` |
| `--learning-runs` | Part des builds qui lancent tout et enregistrent le classement (25 % par défaut, `0%` pour désactiver) |

Le détail par lanceur est sur [sa page](https://testhunch.mintlify.site/docs/sauter/index.md).

## `shadow`

Ce que sauter les tests les moins bien classés aurait manqué, sur les exécutions dont le classement a
été enregistré.

| Option | Rôle |
| - | - |
| `--last` | Exécutions récentes avec un classement enregistré à utiliser |
| `--api` | Lire le rapport chez un testhunch hébergé au lieu d'une base (variable `TESTHUNCH_API_URL`) |
| `--format` | `text`, `json` ou `markdown` |

Avec `--api`, c'est le serveur qui évalue : le classement qu'il a servi et les résultats qu'on lui a
envoyés sont tous les deux chez lui, et un client devrait télécharger chaque classement enregistré
pour refaire le même calcul.

## `migrate`

Crée ou met à jour le schéma. Les autres commandes le font déjà au démarrage ; celle-ci sert à le
faire seule, par exemple dans un conteneur d'initialisation.


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