lingo purge

Посмотрите, какие целевые файлы и записи в Lockfile будут удалены.

Команда lingo purge нужна, когда вы хотите удалить целевые файлы, созданные на основе исходных. В обычном файловом режиме она показывает выбранные пути, а с --yes — удаляет файлы. С --file или --locale команда удаляет только выбранные целевые файлы и их записи в Lockfile, сохраняя базовое состояние исходных файлов и записи остальных целевых файлов. Без фильтров она также удаляет весь Lockfile проекта.

Предпросмотр обычного целевого файла #

Для структуры с отдельными JSON-файлами:

sh
lingo purge --locale de --file locales/en.json

Убедитесь, что показан именно тот целевой файл, который вы собираетесь удалить. Прежде чем добавлять --yes, сохраните одобренные результаты. Если повторная генерация позже завершится с ошибкой, файл к тому моменту уже будет удалён.

ПараметрЧто делает
--locale <locale>Фильтр целевых локалей. Можно указать несколько раз. По умолчанию используются целевые локали из конфигурации. Исходную локаль указать не удастся.
--file <value>Фильтр путей исходных файлов, который можно указать несколько раз, или конкретный путь к исходному файлу для записей с glob-шаблонами.
--lockfile-onlyУдаляет только .lingo/lock.json. Требует --yes и несовместим с --file и --locale.
--yes, -yУдаляет файлы вместо предпросмотра в файловом режиме.

Команда не принимает вычисленные пути за пределами корня проекта, в том числе пути, которые через символическую ссылку ведут за его пределы или в .git. Команда purge сообщает о них даже без --yes. Файлы внутри корня проекта тоже могут содержать ценные исходные или общие данные, поэтому проверяйте не только их расположение, но и назначение.

Выбор файлов #

Команда purge вычисляет пути на основе конкретных исходных файлов из конфигурации и конкретных значений --file. Она пропускает glob-шаблоны из конфигурации, если не указаны конкретные пути к исходным файлам. Для конкретных записей конфигурации --file фильтрует по подстроке, а не раскрывает произвольные glob-шаблоны.

Команда purge пропускает целевой файл, если его путь совпадает с путём исходного файла, и сообщает, что переводы хранятся в исходном файле. Так устроены общие каталоги XCStrings, поэтому purge не может удалить из них одну локаль. Вместо этого используйте рабочий процесс исправления каталога строк.

Изменения в Lockfile #

Команда purge с фильтрами удаляет записи выбранных целевых файлов, даже если самих файлов уже нет. При этом она сохраняет хеши исходных файлов, поэтому ещё не отправленные изменения исходного текста смогут попасть в другие языки при следующем push. Если Lockfile имеет неверный формат, purge с фильтрами останавливается до удаления целевых файлов. Восстановите или исправьте Lockfile перед повторной попыткой.

Без фильтров lingo purge --yes и lingo purge --lockfile-only --yes удаляют весь Lockfile. При удалении только Lockfile без --yes вместо обычного предпросмотра файлов нужно подтвердить удаление.

Отсутствие Lockfile меняет планирование инкрементальной обработки, но не гарантирует, что модель сгенерирует новый результат: повторное использование результатов на сервере работает независимо. Для обычных отсутствующих файлов используйте дозаполнение. Для устаревших записей React — очистку. Если работа была прервана, начните с восстановления, сохранив доступное состояние.