Vérifiez les traductions dans GitHub Actions

Le workflow

Enregistrez-le sous .github/workflows/i18n-check.yml. Changez source pour votre fichier de langue de base et languages pour les locales que vous expédiez.

name: i18n check
on: pull_request
jobs:
  check:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: kaeris-io/kaeris-action@v1
        with:
          mode: check
          source: locales/en.json
          languages: de,fr

Sans Python : npx

Le paquet npm kaeris lance la même vérification avec Node 18 ou plus récent ; npx le télécharge lui-même, sans étape d’installation. Il ne contient que check : pour traduire, il faut le paquet Python.

    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 20
      - run: npx kaeris check --source locales/en.json --langs de,fr

La même chose sans l'Action

Étapes simples avec Python et pip. Le journal affiche ensuite chaque découverte ligne par ligne au lieu du tableau que l'Action imprime.

    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-python@v5
        with:
          python-version: "3.12"
      - run: pip install kaeris
      - run: kaeris check --source locales/en.json --langs de,fr --ci

Découvertes sur la ligne exacte de la pull request (facultatif)

L'Action peut également écrire un rapport SARIF ; son téléversement transforme chaque découverte en annotation dans le diff. Les téléversements de code-scanning sont gratuits sur les dépôts publics ; les dépôts privés nécessitent GitHub Advanced Security.

name: i18n check
on: pull_request
permissions:
  contents: read
  security-events: write
jobs:
  check:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: kaeris-io/kaeris-action@v1
        with:
          mode: check
          source: locales/en.json
          languages: de,fr
          sarif-file: kaeris.sarif
      - uses: github/codeql-action/upload-sarif@v3
        if: always()
        with:
          sarif_file: kaeris.sarif

Ce que le job imprime

L'Action imprime un tableau récapitulatif par langue et se termine par la ligne d'erreur lorsqu'il y a un problème. Gauche : fichiers corrects. Droite : de.json avec {nam} au lieu de {name} et la clé checkout manquante.

## KAERIS i18n — CI check

Placeholder-loss: **0** (should be 0).

| Language | Status | Missing | Placeholder issues | Translated |
|---|---|---|---|---|
| de | ✓ complete | 0 | 0 | – |
| fr | ✓ complete | 0 | 0 | – |

_Generated from `kaeris check --json` — no fabricated numbers._
step exit=0
--- GITHUB_OUTPUT (without summary body):
missing=0
placeholder-issues=0
changed=false
check-exit-code=0
translate-exit-code=0

## KAERIS i18n — CI check

Placeholder-loss: **1** (should be 0).
Missing keys remaining: **1**.

| Language | Status | Missing | Placeholder issues | Translated |
|---|---|---|---|---|
| de | ⚠ 1 missing, 1 placeholder issue | 1 | 1 | – |
| fr | ✓ complete | 0 | 0 | – |

_Generated from `kaeris check --json` — no fabricated numbers._
::error::kaeris check found incomplete/broken translations — see the job summary for the language matrix
step exit=1
--- GITHUB_OUTPUT (without summary body):
missing=1
placeholder-issues=1
changed=false
check-exit-code=1
translate-exit-code=0

Ce qu’affiche l’étape npx

Le même projet vérifié avec npx : kaeris 0.2.37 depuis npm, un cache npm vide et CI=true, comme sur un runner neuf. La première ligne est npm qui installe le paquet.

$ npx kaeris check --source locales/en.json --langs de,fr
npm warn exec The following package was not found and will be installed: [email protected]
✓ de: complete & placeholder-safe
✓ fr: complete & placeholder-safe
✓ all locales complete & placeholder-safe
exit code: 0

$ npx kaeris check --source locales/en.json --langs de,fr
npm warn exec The following package was not found and will be installed: [email protected]
✗ de: 1 missing key(s): checkout
✗ de: 1 placeholder mismatch(es):
    greeting: missing ['{name}'], added ['{nam}']
✗ de: 2 translation fault(s):
    greeting: lost placeholder {name}
    greeting: invented placeholder {nam} (not in source)
✓ fr: complete & placeholder-safe
✗ 1 missing key, 1 placeholder mismatch, 2 translation faults
exit code: 1

1. Sauvegarder le workflow

   Créez .github/workflows/i18n-check.yml avec le workflow ci-dessus, en y ajoutant votre propre source et vos languages.

2. Ouvrir une pull request

   Poussez une branche qui modifie un fichier de locale. Le job s'exécute sur chaque pull request et devient rouge en cas de placeholder perdu ou de clé manquante.

3. Rendre la vérification obligatoire

   Dans les paramètres du dépôt, ajoutez le job comme vérification de statut obligatoire dans la protection de branche. Un job rouge bloque alors la fusion.

• Ce qui a été exécuté

  Le script d'étape de kaeris-io/kaeris-action à la balise v1, copié de GitHub le 27 octobre 2026 et exécuté en bash sur un projet de test, avec le CLI installé depuis PyPI (kaeris 0.2.35). Fichiers propres : code de sortie 0. Le de.json incorrect : code de sortie 1 et la ligne d'erreur montrée ci-dessus.

• npx

  npx kaeris check du paquet npm kaeris 0.2.37 a été lancé le 28 octobre 2026 sur le même projet de test, avec un cache npm vide, CI=true et sans --yes. Fichiers corrects : code de sortie 0. Le de.json cassé : code de sortie 1.

• SARIF

  Le flag --sarif a été exécuté sur le projet incorrect et a écrit un rapport avec 4 résultats ; sur des fichiers propres, il a écrit un rapport avec 0. Le téléversement sur GitHub n'a pas été tenté.

• Ce qui n’a pas été exécuté

  Le fichier workflow lui-même n’a pas été exécuté sur un runner GitHub, pas plus que actions/checkout, actions/setup-python, actions/setup-node et upload-sarif. La syntaxe des workflows ci-dessus n’a pas été vérifiée par GitHub.

• Quel CLI l'Action installe

  L'Action exécute pip install "kaeris>=0.2.12", donc un job récupère la dernière version disponible à ce moment-là. Si vous avez besoin d'une version fixe, utilisez la variante "plain-steps" et épinglez-la : pip install kaeris==0.2.35.

• Échouer également sur les clés obsolètes

  Définissez strict: true sur l'Action (ou --strict dans la variante simple).

• Traductions dans un autre dossier

  Définissez out: path/to/translations sur l'Action ; par défaut, elle utilise le dossier du fichier source.

• Conserver les noms de marque tels quels

  --glossary 'KAERIS,GitHub' fait échouer une cible qui a supprimé l'un des termes. La même liste peut se trouver sous keep dans kaeris.json.

• Disposition de fichiers différente

  --out est le dossier contenant les traductions et --pattern '{lang}/common.json' leurs noms de fichiers. Par défaut : la disposition que kaeris translate écrit.

Autres recettes : GitLab CI · pre-commit · Make et scripts npm

Référence CLI · Référence Check · Référence GitHub Action · Vérification gratuite dans le navigateur · Traduction dans le navigateur