verbatra check
Melde, welche Keys pro Locale fehlen oder veraltet sind, ohne Dateien zu schreiben.
Maschinell übersetzte Seite
Melde pro Ziel-Locale, wie viele Keys fehlen, veraltet oder aktuell sind, und beende dich mit einem Code, auf den ein CI-Schritt verzweigen kann. check führt dasselbe Lesen und Diffen aus, das verbatra translate direkt vor dem Provider-Aufruf ausführen würde, und hört dann auf: kein Provider-Aufruf, keine geschriebenen Dateien, keine Aktualisierung der Lock-Datei und kein API-Key nötig.
Synopsis
verbatra check [flags]Flags
| Flag | Argument | Standard | Wirkung |
|---|---|---|---|
--cwd | <path> | aktuelles Verzeichnis | Konfiguration und Locale-Dateien von diesem Verzeichnis aus auflösen |
--config | <path> | wird gesucht | diese Konfigurationsdatei laden, statt eine zu suchen |
--locales | <list> | alle konfigurierten Ziele | kommagetrennte Teilmenge der Ziel-Locales, die geprüft wird |
--json | keins | aus | einen JSON-Envelope auf stdout ausgeben, der die Prüf-Zusammenfassung unter result trägt, oder bei einem fehlgeschlagenen Lauf den Fehlercode; die menschenlesbare Fehlerzeile geht weiter auf stderr |
Ein Key fehlt, wenn die Quelle ihn hat und das Ziel nicht; er ist veraltet, wenn sich der Quellstring seit der letzten Übersetzung geändert hat. Ein Locale ist synchron, wenn es keines von beidem hat. Ein leerer oder unbekannter --locales-Wert wird mit Exit 2 abgelehnt, statt stillschweigend nichts zu prüfen; ein Tippfehler in einem Locale-Namen lässt ein CI-Gate also nie durch. Du willst die konkreten Key-Listen hinter den Zählern? Das ist verbatra diff.
Beispiele
# fail the build when translations drifted
verbatra check
# machine-readable status for two locales
verbatra check --locales de,fr --jsonExit-Codes
| Code | Bedeutung |
|---|---|
0 | synchron: kein Locale hat einen fehlenden oder veralteten Key |
1 | nicht synchron: mindestens ein Locale hat einen fehlenden oder veralteten Key (der Bericht wird trotzdem ausgegeben) |
2 | konnte nicht laufen: ein Fehler des gesamten Laufs oder ein Verwendungsfehler (einschließlich eines leeren oder unbekannten --locales-Werts) |
Exit 1 heißt "nicht synchron", nicht Fehlschlag: der Lauf selbst war erfolgreich, das Ergebnis ist nur nicht komplett grün.
Auf einem Projekt, dessen Quell-Locale-Datei noch nicht vorhanden ist, kann check gar nicht laufen: Es scheitert als Ganzes mit SOURCE_UNREADABLE und endet mit 2. verbatra doctor prüft die Einrichtung selbst und liefert auch für ein solches Projekt noch einen Bericht.
Siehe auch
verbatra difflistet die genauen Keys hinter diesen Zählern.- CI und Exit-Codes zeigt check als Drift-Gate.
- Die Lock-Datei erklärt, wie Veraltung erkannt wird.