Comprobar traducciones desde scripts Make o npm

Makefile

Instala el verificador una vez con pip install kaeris. La línea de receta empieza con una tabulación. Hacer que test dependa de i18n-check ejecuta la comprobación antes de las pruebas.

.PHONY: i18n-check test

i18n-check:
	kaeris check --source locales/en.json --langs de,fr --ci

test: i18n-check
	./run-tests.sh

Scripts npm

El script solo llama a kaeris desde tu PATH, por lo que el verificador es el paquete de Python de pip install kaeris. pretest se ejecuta antes de test y lo detiene cuando la comprobación falla.

{
  "scripts": {
    "i18n:check": "kaeris check --source locales/en.json --langs de,fr --ci",
    "pretest": "npm run i18n:check",
    "test": "jest"
  }
}

npm test

Salida de npm test con los scripts anteriores (el script test fue echo en esta ejecución). Izquierda: archivos que están bien. Derecha: de.json con {nam} en lugar de {name} y la clave checkout faltante; npm se detiene antes de test.

$ npm test

> [email protected] pretest
> npm run i18n:check


> [email protected] i18n:check
> kaeris check --source locales/en.json --langs de,fr --ci

✓ de: complete & placeholder-safe
✓ fr: complete & placeholder-safe
✓ all locales complete & placeholder-safe

> [email protected] test
> echo tests would run here

tests would run here
exit code: 0

$ npm test

> [email protected] pretest
> npm run i18n:check


> [email protected] i18n:check
> 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
exit code: 1

La línea de receta del Makefile

El mismo comando que ejecuta el objetivo i18n-check, y su código de salida.

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

$ 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
exit code: 1

1. Instalar el verificador

   Ejecuta pip install kaeris en la máquina o en la imagen de CI que ejecuta tus pruebas.

2. Añadir el objetivo o el script

   Añade el objetivo i18n-check al Makefile o los scripts i18n:check y pretest a package.json, con tu propio --source y --langs.

3. Ejecutar tu comando habitual

   make test o npm test ahora ejecuta la comprobación primero y se detiene con un código de salida no cero cuando una traducción está rota.

• Lo que se ejecutó

  npm test con los scripts anteriores, excepto que test fue un echo (npm 11.17, Node 24), y kaeris 0.2.35 de PyPI en el PATH. Archivos limpios: código de salida 0, pruebas ejecutadas. de.json roto: código de salida 1, pruebas no ejecutadas.

• Lo que no se ejecutó

  make no está instalado en la máquina donde se comprobó esto. La línea de receta se ejecutó a través del shell, que es lo que make hace con ella, por lo que el código de salida anterior es real, pero el propio Makefile no fue ejecutado por make.

• npm

  Todavía no hay un paquete kaeris en el registro npm, por lo que esta página no te envía a npm para él. Los proyectos Node llaman al paquete Python, como se ha indicado anteriormente.

• 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 · GitLab CI · pre-commit

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