lingo pull

Rufe den zuletzt lokal erfassten Lauf ab, ohne versehentlich abweichende Änderungen an Zieldateien zu überschreiben.

Führe nach einem Push ohne --wait den Befehl lingo pull im selben Projektstammverzeichnis und auf demselben Rechner aus. Er liest den Zeiger auf den letzten Lauf für diesen absoluten Pfad und ruft den erfassten Lauf ab. Es gibt weder ein Argument für eine beliebige Lauf-ID noch eine automatische Suche im Projektverlauf.

sh
lingo pull --dry-run
lingo pull

Ein Testlauf zeigt an, welche Schreibvorgänge ausgeführt würden, ohne Dateien oder das Lockfile zu ändern. Dabei kann er weiterhin den Server kontaktieren und den Status noch nicht abgeschlossener Arbeiten abfragen. --force (-f) erlaubt das Überschreiben abweichender lokaler Zieldateien. Sichere diese Änderungen, bevor du die Option verwendest. Beide Optionen sind standardmäßig auf false gesetzt.

Wie sich lokale Änderungen auf den Abruf auswirken #

Pull vergleicht die aktuellen Bytes jeder Zieldatei mit dem Serverergebnis, dem beim Push erfassten Stand der Zieldatei und dem Lockfile:

Aktuelle ZieldateiEntscheidung
Nicht vorhandenErstellen.
Stimmt mit dem fertiggestellten Serverartefakt übereinBereits synchronisiert.
Stimmt mit dem beim Push erfassten Stand der Zieldatei übereinKann sicher durch das Ergebnis ersetzt werden.
Stimmt mit dem gespeicherten Lockfile-Hash übereinKann sicher ersetzt werden.
Stimmt mit keinem dieser Vergleichswerte übereinKonflikt.

Ohne erzwungenes Überschreiben oder Testlauf verhindert jeder Konflikt sämtliche Schreibvorgänge für Zieldateien. Ein Commit der Änderung verändert weder deren Bytes noch löst er den Konflikt bei diesem Vergleich. Sichere die Änderung und gleiche sie ab oder stelle vor dem Abruf eine bekannte Version wieder her.

Ein erfolgreicher Abruf speichert Hashes für fertiggestellte Zieldateien. Eine bestehende Ausgangsbasis der Quelldatei wird nur dann aktualisiert, wenn das fertiggestellte Dokument alle konfigurierten Zielsprachen abdeckt und nicht auf bestimmte Schlüssel beschränkt ist. Beim Abruf für weniger Sprachen bleibt der bestehende Quell-Hash erhalten. Fehlt er, wird er initialisiert. Eine Schlüsselaktualisierung speichert nur Ziel-Hashes, sodass ausstehende reguläre Änderungen an der Quelldatei weiterhin beim nächsten normalen Push übertragen werden. Ein direktes push --wait speichert dieselben Hashes, führt aber keine erneute Konfliktkontrolle durch.

Noch nicht abgeschlossene und fehlgeschlagene Ergebnisse abrufen #

Pull fragt den Status ausstehender Arbeiten ab, bis alle noch nicht fertiggestellten Ziele abgeschlossen sind oder auf eine menschliche Prüfung warten. Anschließend ruft es die Ergebnisse dokumentweise ab: Ein Dokument wird geschrieben, sobald alle seine Sprachen abgeschlossen sind. Dokumente, die noch auf eine Prüfung warten, bleiben unverändert. Wenn du lingo pull nach Abschluss der Prüfung durch die Prüfer erneut ausführst, werden die übrigen Dokumente geschrieben.

Auch bei einem fehlgeschlagenen Lauf werden die fertiggestellten Dokumente geschrieben. Anschließend wird der Fehler gemeldet und der Vorgang mit einem Exit-Code ungleich null beendet. Ist bei einem Dokument eine Sprache fehlgeschlagen, wird keine seiner Sprachversionen geschrieben. Die Ausgangsbasis der Quelldatei bleibt erhalten, sodass der nächste Push dieser Datei das Dokument erneut anfordert. Lies die Fehlermeldung und kontrolliere die erwarteten Dateien. Eine fehlende Übersetzung oder eine erforderliche Prüfung erfordert eine eigene Workflow-Aktion, keinen weiteren Downloadversuch.

Wenn der Lauf nicht gefunden werden kann #

Der Zeiger liegt unter ~/.lingo/runs/ und hängt vom absoluten Projektstammverzeichnis ab. Wenn du einen checkout verschiebst, einen anderen Runner verwendest oder einen weiteren Push sendest, kann sich ändern, welcher Lauf lokal verfügbar ist. Kontrolliere diesen Zustand und die Projektzuordnung, bevor du davon ausgehst, dass die Ausgabe auf dem Server fehlt.

Ein Lauf, der mit einer älteren CLI-Version eingereicht wurde, lässt sich mit der installierten Version möglicherweise nicht lesen. Pull weist dann darauf hin, und ein weiteres lingo push reicht die Arbeit erneut ein. Lockfile und Cache erläutert die übertragbare Ausgangsbasis und den rechnerlokalen Zustand.