Controlla le traduzioni da script Make o npm

Makefile

Installa il checker una volta con pip install kaeris. La riga della ricetta inizia con una tabulazione. Rendere test dipendente da i18n-check esegue il controllo prima dei test.

.PHONY: i18n-check test

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

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

Script npm

Lo script chiama solo kaeris dal tuo PATH, quindi il checker è il pacchetto Python da pip install kaeris. pretest viene eseguito prima di test e lo interrompe quando il controllo fallisce.

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

npm test

Output di npm test con gli script sopra (lo script test era echo in questa esecuzione). A sinistra: file corretti. A destra: de.json con {nam} invece di {name} e la chiave checkout mancante; npm si ferma prima di 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 riga della ricetta del Makefile

Lo stesso comando che esegue il target i18n-check, e il suo codice di uscita.

$ 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. Installa il checker

   Esegui pip install kaeris sulla macchina o nell'immagine CI che esegue i tuoi test.

2. Aggiungi il target o lo script

   Aggiungi il target i18n-check al Makefile o gli script i18n:check e pretest a package.json, con i tuoi --source e --langs.

3. Esegui il tuo comando abituale

   make test o npm test ora eseguono prima il controllo e si interrompono con un codice di uscita non zero quando una traduzione è corrotta.

• Cosa è stato eseguito

  npm test con gli script sopra, tranne che test era un echo (npm 11.17, Node 24), e kaeris 0.2.35 da PyPI sul PATH. File puliti: codice di uscita 0, test eseguiti. de.json rotto: codice di uscita 1, test non eseguiti.

• Cosa non è stato eseguito

  make non è installato sulla macchina dove questo è stato controllato. La riga della ricetta è stata eseguita tramite la shell, che è ciò che make fa con essa, quindi il codice di uscita sopra è reale, ma il Makefile stesso non è stato eseguito da make.

• npm

  Non esiste ancora un pacchetto kaeris nel registro npm, quindi questa pagina non ti indirizza a npm per esso. I progetti Node chiamano il pacchetto Python, come sopra.

• Fallisce anche per chiavi obsolete

  --strict fallisce anche quando una traduzione ha chiavi che la sorgente non ha più.

• Mantieni i nomi dei brand così come sono scritti

  --glossary 'KAERIS,GitHub' fa fallire un target che ha omesso uno dei termini. Lo stesso elenco può risiedere sotto keep in kaeris.json.

• Layout file diverso

  --out è la cartella con le traduzioni e --pattern '{lang}/common.json' i loro nomi file. Predefinito: il layout che kaeris translate scrive.

• Nessun flag

  Con un file kaeris.json nel progetto (scritto da kaeris init), kaeris check prende sorgente, lingue e cartella da esso.

Altre ricette: GitHub Actions · GitLab CI · pre-commit

Riferimento CLI · Riferimento Check · Riferimento GitHub Action · Controllo gratuito nel browser · Traduci nel browser