Übersetzungen aus Make- oder npm-Skripten prüfen

Makefile

Installieren Sie den Prüfer einmal mit pip install kaeris. Die Rezeptzeile beginnt mit einem Tab. Wenn test von i18n-check abhängt, wird die Prüfung vor den Tests ausgeführt.

.PHONY: i18n-check test

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

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

npm Skripte

Das Skript ruft nur kaeris aus Ihrem PATH auf, sodass der Prüfer das Python-Paket von pip install kaeris ist. pretest wird vor test ausgeführt und stoppt es, wenn die Prüfung fehlschlägt.

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

npm test

Ausgabe von npm test mit den obigen Skripten (das test-Skript war in dieser Ausführung echo). Links: Dateien, die in Ordnung sind. Rechts: de.json mit {nam} anstelle von {name} und fehlendem checkout-Schlüssel; npm stoppt vor 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

Die Makefile-Rezeptzeile

Der gleiche Befehl, den das i18n-check-Ziel ausführt, und dessen Exit-Code.

$ 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. Prüfer installieren

   Führen Sie pip install kaeris auf dem Rechner oder im CI-Image aus, das Ihre Tests ausführt.

2. Ziel oder Skript hinzufügen

   Fügen Sie das i18n-check-Ziel zum Makefile oder die Skripte i18n:check und pretest zu package.json hinzu, mit Ihren eigenen --source und --langs.

3. Ihren üblichen Befehl ausführen

   make test oder npm test führt nun zuerst die Prüfung aus und stoppt mit einem Exit-Code ungleich Null, wenn eine Übersetzung defekt ist.

• Was wurde ausgeführt

  npm test mit den obigen Skripten, außer dass test ein echo war (npm 11.17, Node 24) und kaeris 0.2.35 von PyPI auf dem PATH. Saubere Dateien: Exit-Code 0, Tests ausgeführt. Fehlerhafte de.json: Exit-Code 1, Tests nicht ausgeführt.

• Was wurde nicht ausgeführt

  make ist auf dem Rechner, auf dem dies geprüft wurde, nicht installiert. Die Rezeptzeile wurde über die Shell ausgeführt, was make damit tut, sodass der obige Exit-Code real ist, aber das Makefile selbst wurde nicht von make ausgeführt.

• npm

  Es gibt noch kein kaeris-Paket im npm-Registry, daher leitet Sie diese Seite nicht zu npm dafür weiter. Node-Projekte rufen das Python-Paket auf, wie oben.

• Auch bei veralteten Schlüsseln fehlschlagen

  --strict schlägt auch fehl, wenn eine Übersetzung Schlüssel hat, die die Quelle nicht mehr hat.

• Markennamen beibehalten, wie sie geschrieben sind

  --glossary 'KAERIS,GitHub' führt dazu, dass ein Ziel fehlschlägt, das einen der Begriffe fallen gelassen hat. Dieselbe Liste kann unter keep in kaeris.json stehen.

• Anderes Dateilayout

  --out ist der Ordner mit den Übersetzungen und --pattern '{lang}/common.json' deren Dateinamen. Standard: das Layout, das kaeris translate schreibt.

• Gar keine Flags

  Mit einer kaeris.json im Projekt (kaeris init schreibt eine) nimmt kaeris check Quelle, Sprachen und Ordner daraus.

Andere Rezepte: GitHub Actions · GitLab CI · pre-commit

Referenz zur CLI · Referenz zur Prüfung · Referenz zur GitHub Action · Kostenlose Prüfung im Browser · Übersetzen im Browser