lingo purge

Confira uma prévia da exclusão dos arquivos de destino e entenda quais entradas do Lockfile são removidas.

lingo purge serve para remover intencionalmente arquivos de destino derivados. No modo normal de arquivos, exibe uma prévia dos caminhos selecionados; com --yes, executa a exclusão. Com --file ou --locale, remove apenas os destinos selecionados e suas entradas no Lockfile, preservando as referências de origem e as entradas dos demais destinos. Sem filtros, também remove todo o Lockfile do projeto.

Confira a prévia de um destino comum #

Para uma estrutura JSON com arquivos separados:

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

Confirme se o destino indicado é mesmo o arquivo que você pretende descartar. Preserve os resultados já aceitos antes de adicionar --yes. Se a regeneração falhar depois, a exclusão já terá ocorrido.

OpçãoComportamento
--locale <locale>Filtro de destino que pode ser repetido; por padrão, usa os destinos configurados. Não aceita o idioma de origem.
--file <value>Filtro de caminho de origem que pode ser repetido ou caminho de origem específico para entradas com padrões glob.
--lockfile-onlyRemove apenas .lingo/lock.json; exige --yes e não pode ser combinado com --file ou --locale.
--yes, -yExecuta a exclusão em vez de exibir a prévia do modo de arquivos.

Caminhos derivados fora da raiz do projeto não são aceitos, incluindo aqueles que, por meio de um link simbólico, levam para fora dela ou para dentro de .git; o purge os sinaliza mesmo sem --yes. Arquivos dentro da raiz também podem conter dados valiosos de origem ou compartilhados, então verifique o que eles representam, não apenas onde estão.

Seleção de arquivos #

O purge determina os caminhos a partir das origens específicas configuradas e dos valores específicos de --file. Ele ignora os padrões glob configurados, a menos que sejam fornecidos caminhos de origem específicos. Para entradas de configuração com caminhos específicos, --file filtra por trecho de texto; não faz uma expansão geral de padrões glob.

O purge ignora destinos que tenham o mesmo caminho da origem e informa que as traduções estão no arquivo de origem. Catálogos XCStrings compartilhados usam essa estrutura, por isso o purge não consegue remover apenas um idioma deles. Em vez disso, use o workflow de correção do Catálogo de Strings.

Alterações no Lockfile #

Uma operação de purge com filtros remove as entradas dos destinos selecionados mesmo que os arquivos correspondentes já não existam. Ela preserva os hashes de origem, para que alterações pendentes na origem ainda possam chegar a outros idiomas em um envio posterior. Se o Lockfile estiver malformado, o purge com filtros será interrompido antes de excluir qualquer destino; restaure ou repare o arquivo antes de tentar novamente.

Sem filtros, lingo purge --yes e lingo purge --lockfile-only --yes removem todo o Lockfile. A operação restrita ao Lockfile, sem --yes, exige confirmação em vez de exibir a prévia normal dos arquivos.

A ausência do Lockfile altera o planejamento incremental, mas não garante um novo resultado do modelo, pois a reutilização no servidor é independente. Para arquivos comuns que estejam ausentes, use preenchimento de lacunas. Para entradas React obsoletas, use limpeza. Para trabalhos interrompidos, comece pela recuperação, preservando o estado disponível.