Vérifier les traductions dans GitLab CI

Le job

Ajoutez-le à .gitlab-ci.yml. Modifiez --source pour pointer vers votre fichier de langue de base et --langs pour les locales que vous expédiez. Le bloc rules exécute le job uniquement sur les merge requests qui modifient quelque chose sous locales/ ; supprimez les lignes changes pour l'exécuter sur chaque merge request.

i18n-check:
  stage: test
  image: python:3.12-slim
  rules:
    - if: $CI_PIPELINE_SOURCE == "merge_request_event"
      changes:
        - locales/**/*
  script:
    - pip install kaeris
    - kaeris check --source locales/en.json --langs de,fr --ci

Ce que le job imprime

Les deux lignes script, exécutées dans l'ordre. Gauche : fichiers corrects. Droite : de.json avec {nam} au lieu de {name} et la clé checkout manquante ; le job s'arrête avec le code de sortie 1.

$ pip install kaeris
Collecting kaeris
  Using cached kaeris-0.2.35-py3-none-any.whl.metadata (26 kB)
Using cached kaeris-0.2.35-py3-none-any.whl (131 kB)
Installing collected packages: kaeris
Successfully installed kaeris-0.2.35

$ kaeris check --source locales/en.json --langs de,fr --ci
✓ de: complete & placeholder-safe
✓ fr: complete & placeholder-safe
✓ all locales complete & placeholder-safe
Job succeeded
exit code: 0

$ pip install kaeris
Requirement already satisfied: kaeris in C:\Users\Inzagi\AppData\Local\Temp\claude\C--Users-Inzagi-projects-kaeris\bfeebe69-3cfd-4f28-bbe7-e5600be082b9\scratchpad\venv-gl2\Lib\site-packages (0.2.35)

$ kaeris check --source locales/en.json --langs de,fr --ci
✗ 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
ERROR: Job failed: exit code 1
exit code: 1

1. Ajouter le job

   Collez le job dans .gitlab-ci.yml et définissez vos propres --source et --langs.

2. Ouvrir une requête de fusion

   Modifiez un fichier de langue sur une branche et ouvrez une requête de fusion. Le job s'exécute et affiche toutes les anomalies dans son journal.

3. Exiger le pipeline

   Dans les paramètres du projet sous requêtes de fusion, activez l'option selon laquelle les pipelines doivent réussir. Un job rouge bloque alors la fusion.

• Ce qui a été exécuté

  Les deux lignes script, extraites du YAML analysé et exécutées l'une après l'autre dans un environnement virtuel Python propre, s'arrêtent à la première ligne échouée, comme le fait un job GitLab. pip install kaeris a téléchargé kaeris 0.2.35 depuis PyPI. Fichiers propres : code de sortie 0. Le de.json corrompu : code de sortie 1.

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

  Aucun runner GitLab ni aucune image Docker n'ont été utilisés (le journal ci-dessus provient d'un PC Windows avec Python 3.14, et non de python:3.12-slim). Le bloc rules et changes a seulement été analysé comme YAML ; GitLab ne l'a pas évalué. Le package déclare Python 3.8 ou plus récent.

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

  --strict échoue également lorsqu'une traduction a des clés que la source n'a plus.

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

• Aucun drapeau du tout

  Avec un fichier kaeris.json dans le projet (kaeris init en écrit un), kaeris check récupère la source, les langues et le dossier à partir de celui-ci.

Autres recettes : GitHub Actions · 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