lingo pull
Получите результаты последнего запуска, записанного локально, без риска случайно перезаписать расходящиеся с ним правки в целевых файлах.
После push без --wait выполните lingo pull из того же корня проекта и на том же компьютере. Команда читает указатель на последний запуск для этого абсолютного пути и получает результаты записанного запуска. Аргумента для произвольного ИД запуска нет, как и автоматического поиска по истории проекта.
lingo pull --dry-run
lingo pullПробный запуск показывает, что будет записано, не меняя файлы и Lockfile. При этом команда может обращаться к серверу и проверять состояние незавершённых задач. --force (-f) разрешает перезаписывать локальные целевые файлы с расходящимися правками. Перед использованием сохраните эти правки. По умолчанию обе опции имеют значение false.
Как локальные правки влияют на получение результатов #
Команда pull побайтово сравнивает текущее содержимое каждого целевого файла с результатом сервера, версией файла на момент push и данными в Lockfile:
| Текущий целевой файл | Решение |
|---|---|
| Отсутствует | Создать. |
| Совпадает с готовым артефактом сервера | Уже синхронизирован. |
| Совпадает с версией целевого файла на момент push | Можно безопасно заменить результатом. |
| Совпадает с хешем, записанным в Lockfile | Можно безопасно заменить. |
| Не совпадает ни с одним из вариантов | Конфликт. |
Если не включён принудительный режим или пробный запуск, любой конфликт прерывает запись всех целевых файлов. Коммит правки не меняет байты файла и не устраняет расхождение при сравнении. Прежде чем получать результаты, сохраните правку и устраните расхождения или восстановите известную версию.
При успешном получении результатов записываются хеши готовых целевых файлов. Существующая базовая версия исходника обновляется, только если готовый документ охватывает все настроенные целевые локали и для него не задана область видимости ключей. При получении результатов для меньшего числа локалей текущий хеш исходника сохраняется, а если его нет — создаётся. Обновление ключей записывает только хеши целевых файлов, поэтому ещё не отправленные обычные правки исходника попадут в следующий обычный push. Прямой вызов push --wait записывает те же хеши, но не проверяет конфликты заново.
Как получить результаты незавершённых запусков и запусков с ошибками #
Команда pull проверяет состояние незавершённых задач, пока каждый незавершённый целевой файл не будет готов или не перейдёт в ожидание ручной проверки. Затем она получает результаты по документам: документ записывается, когда готовы все его локали. Документы, которые ещё ждут проверки, остаются без изменений. Когда проверка завершится, повторный вызов lingo pull запишет остальные документы.
Даже если запуск завершился с ошибкой, команда записывает готовые документы, затем сообщает об ошибке и завершается с ненулевым кодом. Если хотя бы одна локаль документа завершилась с ошибкой, ни одна из его локалей не записывается, а базовая версия исходника сохраняется. Поэтому следующий push этого файла снова запросит его перевод. Прочитайте сообщение об ошибке и проверьте файлы, которые должны были появиться. Если перевода нет или требуется проверка, нужен отдельный шаг рабочего процесса, а не ещё одна попытка скачать результаты.
Что делать, если не удаётся найти запуск #
Указатель хранится в ~/.lingo/runs/ и зависит от абсолютного пути к корню проекта. После перемещения checkout, смены исполнителя или нового push локально может быть доступен уже другой запуск. Проверьте локальное состояние и привязку проекта, прежде чем делать вывод, что на сервере нет результатов.
Установленная версия CLI может не прочитать запуск, отправленный более старой версией. Тогда pull сообщит об этом, а повторный вызов lingo push отправит задачи заново. В разделе Lockfile и кеш описаны переносимая базовая версия и состояние, которое хранится только на текущем компьютере.