lingo pull

ローカルに記録された最新の実行結果を取得。独自に編集された翻訳先を誤って上書きするのを防ぎます。

--wait を指定せずにプッシュした後、同じマシンの同じプロジェクトルートで lingo pull を実行します。その絶対パスに対応する最新実行のポインターを読み取り、記録された実行の結果を取得します。任意の実行識別子を指定する引数や、プロジェクト履歴を自動検索する機能はありません。

sh
lingo pull --dry-run
lingo pull

ドライランでは、ファイルや Lockfile を変更せずに、書き込みの判断結果を報告します。ただし、サーバーへの接続や未完了の処理のポーリングは行われる場合があります。--force(-f)を指定すると、独自に編集されたローカルの翻訳先も上書きできます。使用する前に、その編集内容を保存してください。どちらのオプションも既定では無効です。

ローカルでの編集が結果の取得に与える影響 #

プルでは、各翻訳先の現在のバイト列を、サーバーの結果、プッシュ時に記録した翻訳先、Lockfile と比較します。

現在の翻訳先判断
存在しない作成します。
サーバー上の完成済み成果物と一致同期済みです。
プッシュ時に記録した翻訳先と一致取得結果で安全に置き換えられます。
Lockfile に記録されたハッシュと一致安全に置き換えられます。
いずれにも一致しない競合しています。

強制上書きもドライランも指定していない場合、競合が一つでもあると、翻訳先への書き込みはすべて中止されます。編集内容をコミットしてもバイト列は変わらず、この比較での競合は解消されません。結果を取得する前に、編集内容を保存して競合を解消するか、内容が確かなバージョンに復元してください。

結果の取得に成功すると、完了した翻訳先のハッシュが記録されます。既存のソースの基準状態が更新されるのは、完了したドキュメントが設定済みのすべての翻訳先ロケールを網羅し、キーによる対象範囲の指定がない場合のみです。一部のロケールだけを取得する場合は、既存のソースハッシュを維持し、存在しなければ初期化します。キーの更新では翻訳先のハッシュだけが記録されるため、保留中の通常のソース編集も、次回の通常のプッシュに反映されます。push --wait を直接実行した場合も同じハッシュが記録されますが、取得時に改めて競合をチェックすることはありません。

未完了・失敗した実行の結果を読み取る #

プルでは、未完了の翻訳先がすべて完了するか、人によるレビュー待ちになるまで、保留中の処理をポーリングします。その後、ドキュメント単位で結果を取得し、各ドキュメントのすべてのロケールが完了した時点で書き込みます。レビュー待ちのドキュメントは変更しません。レビュー担当者の作業が終わってから lingo pull を再実行すると、残りが書き込まれます。

実行が失敗した場合でも、完了したドキュメントは書き込まれます。その後、失敗が報告され、ゼロ以外の終了コードで終了します。ドキュメント内に失敗したロケールがある場合、そのドキュメントのロケールは一つも書き込まれず、ソースの基準状態も維持されます。そのため、そのファイルを次にプッシュすると、再び処理が要求されます。失敗の内容を確認し、想定したファイルが揃っているか確かめてください。翻訳の欠落や必須のレビューには、それぞれに対応するワークフロー操作が必要です。ダウンロードを再試行しても解決しません。

実行が見つからない場合 #

ポインターは ~/.lingo/runs/ の下に保存され、プロジェクトルートの絶対パスに依存します。チェックアウトの移動、別のランナーの使用、新たなプッシュによって、ローカルで参照できる実行が変わることがあります。リモートに出力がないと判断する前に、ローカルの状態とプロジェクトの紐付けを確認してください。

古いバージョンの CLI で送信した実行は、インストール済みのバージョンでは読み取れない場合があります。その場合、プルでその旨が表示され、lingo push を再実行すると処理が再送信されます。Lockfile とキャッシュでは、環境間で引き継げる基準状態と、マシン固有のローカル状態について説明しています。