CLI-Referenzverbatra diff

verbatra diff

Zeige die Keys, die pro Locale hinzugefügt oder neu übersetzt würden oder verwaist sind, ohne Dateien zu schreiben.

Maschinell übersetzte Seite

Diese Seite wurde automatisch übersetzt und kann daher Fehler oder seltsame Formulierungen enthalten. Die englische Version ist die maßgebliche Quelle. Das englische Original lesen.

Liste pro Ziel-Locale die genauen ausstehenden Keys: die, die ein Lauf hinzufügen würde (im Ziel fehlend), die, die er neu übersetzen würde (Quelle seit der letzten Übersetzung geändert), und die inzwischen verwaisten (im Ziel, aber aus der Quelle verschwunden). diff 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 diff [flags]

Flags

FlagArgumentStandardWirkung
--cwd<path>aktuelles VerzeichnisKonfiguration und Locale-Dateien von diesem Verzeichnis aus auflösen
--config<path>wird gesuchtdiese Konfigurationsdatei laden, statt eine zu suchen
--locales<list>alle konfigurierten Zielekommagetrennte Teilmenge der Ziel-Locales, die verglichen wird
--jsonkeinsausdie Diff-Zusammenfassung als ein JSON-Objekt auf stdout ausgeben; Fehler gehen weiter auf stderr

Ein Locale hat ausstehende Änderungen, wenn es mindestens einen Key zum Hinzufügen oder Neuübersetzen hat. Verwaiste Keys werden gemeldet, zählen aber nie als ausstehend, weil ein Standardlauf sie nicht entfernt (das tut nur verbatra translate --prune). Ein leerer oder unbekannter --locales-Wert wird mit Exit 2 abgelehnt, statt stillschweigend nichts zu vergleichen. Wo verbatra check mit Zählern beantwortet, "wie viel gedriftet ist", beantwortet diff mit den Listen, "welche Keys".

Beispiele

# list the pending keys per locale (exit 1 if any are pending)
verbatra diff

# machine-readable key lists for tooling or a PR comment
verbatra diff --json

Exit-Codes

CodeBedeutung
0keine ausstehenden Änderungen: kein Locale hat einen Key zum Hinzufügen oder Neuübersetzen
1ausstehende Änderungen: mindestens ein Locale hat einen fehlenden oder geänderten Key (verwaiste Keys allein erzeugen nie 1)
2konnte nicht laufen: ein Fehler des gesamten Laufs oder ein Verwendungsfehler (einschließlich eines leeren oder unbekannten --locales-Werts)

Siehe auch

Edit on GitHub