Verificar traducciones en GitLab CI

El trabajo

Añádelo a .gitlab-ci.yml. Cambia --source a tu archivo de idioma base y --langs a las localizaciones que envías. El bloque rules ejecuta el trabajo solo en solicitudes de fusión que cambian algo bajo locales/; elimina las líneas changes para ejecutarlo en cada solicitud de fusión.

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

Lo que imprime el trabajo

Las dos líneas de script, ejecutadas en orden. Izquierda: archivos que están bien. Derecha: de.json con {nam} en lugar de {name} y la clave checkout faltante; el trabajo se detiene con el código de salida 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. Añadir el trabajo

   Pega el trabajo en .gitlab-ci.yml y configura tu propio --source y --langs.

2. Abrir una solicitud de fusión

   Cambia un archivo de localización en una rama y abre una solicitud de fusión. El trabajo se ejecuta y muestra todos los hallazgos en su registro.

3. Requerir el pipeline

   En la configuración del proyecto, bajo solicitudes de fusión, activa que los pipelines deben tener éxito. Un trabajo rojo entonces bloquea la fusión.

• Lo que se ejecutó

  Ambas líneas de script, tomadas del YAML analizado y ejecutadas una tras otra en un entorno virtual de Python limpio, deteniéndose en la primera línea fallida como lo hace un trabajo de GitLab. pip install kaeris descargó kaeris 0.2.35 de PyPI. Archivos limpios: código de salida 0. El de.json roto: código de salida 1.

• Lo que no se ejecutó

  No se utilizó ningún runner de GitLab ni imagen Docker (el registro anterior proviene de un PC con Windows y Python 3.14, no de python:3.12-slim). El bloque rules y changes solo se analizó como YAML; GitLab no lo evaluó. El paquete declara Python 3.8 o superior.

• Fallar también en claves obsoletas

  --strict también falla cuando una traducción tiene claves que la fuente ya no tiene.

• Mantener los nombres de marca tal como están escritos

  --glossary 'KAERIS,GitHub' falla un objetivo que omitió uno de los términos. La misma lista puede vivir bajo keep en kaeris.json.

• Diseño de archivo diferente

  --out es la carpeta con las traducciones y --pattern '{lang}/common.json' sus nombres de archivo. Por defecto: el diseño que escribe kaeris translate.

• Sin flags

  Con un kaeris.json en el proyecto (kaeris init escribe uno), kaeris check toma la fuente, los idiomas y la carpeta de él.

Otras recetas: GitHub Actions · pre-commit · Make y scripts npm

Referencia de CLI · Referencia de Check · Referencia de GitHub Action · Verificación gratuita en el navegador · Traducir en el navegador