lingo purge

Pré-visualize a eliminação de ficheiros de destino e saiba que entradas do Lockfile são removidas.

lingo purge destina-se a remover intencionalmente ficheiros de destino derivados. No modo normal de ficheiros, apresenta uma pré-visualização dos caminhos selecionados; com --yes, efetua a eliminação. Com --file ou --locale, remove apenas os destinos selecionados e as respetivas entradas do Lockfile, preservando os estados de referência das origens e as entradas dos restantes destinos. Sem filtros, remove também todo o Lockfile do projeto.

Pré-visualizar um destino normal #

Para uma estrutura JSON com ficheiros separados:

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

Confirme que o destino indicado é o ficheiro que pretende descartar. Guarde o resultado aceite antes de adicionar --yes. Se a regeneração falhar mais tarde, a eliminação já terá ocorrido.

OpçãoComportamento
--locale <locale>Filtro de destino que pode ser repetido; por predefinição, utiliza os destinos configurados. O idioma de origem não é aceite.
--file <value>Filtro de caminho de origem que pode ser repetido ou caminho de origem concreto para entradas com padrões glob.
--lockfile-onlyRemove apenas .lingo/lock.json; requer --yes e não pode ser combinado com --file ou --locale.
--yes, -yEfetua a eliminação em vez de apresentar a pré-visualização do modo de ficheiros.

Não são aceites caminhos derivados fora da raiz do projeto, incluindo os que, através de uma ligação simbólica, apontem para fora dessa raiz ou para dentro de .git; o comando purge assinala-os mesmo sem --yes. Os ficheiros dentro da raiz também podem conter dados de origem ou dados partilhados valiosos, por isso verifique o que representam, e não apenas onde se encontram.

Seleção de ficheiros #

O comando purge determina os caminhos a partir de origens concretas configuradas e de valores concretos de --file. Ignora os padrões glob configurados, a menos que sejam fornecidos caminhos de origem concretos. Nas entradas de configuração concretas, --file filtra por subcadeia de caracteres; não faz uma expansão geral de padrões glob.

O comando purge ignora os destinos cujo caminho coincide com o da origem e indica que as respetivas traduções se encontram no ficheiro de origem. Os catálogos XCStrings partilhados utilizam esta estrutura, pelo que o comando purge não consegue remover um idioma desses catálogos. Utilize antes o workflow de correção do catálogo de cadeias de caracteres.

Alterações ao Lockfile #

Uma execução de purge com filtros remove as entradas dos destinos selecionados, mesmo que os respetivos ficheiros já não existam. Mantém os hashes das origens, pelo que as alterações pendentes nas origens podem ainda chegar a outros idiomas num envio posterior. Se o Lockfile estiver malformado, a execução de purge com filtros é interrompida antes de eliminar qualquer destino; restaure-o ou repare-o antes de tentar novamente.

Sem filtros, lingo purge --yes e lingo purge --lockfile-only --yes removem todo o Lockfile. A operação que afeta apenas o Lockfile, sem --yes, pede confirmação em vez de apresentar a pré-visualização normal dos ficheiros.

A ausência de um Lockfile altera o planeamento incremental; não garante um novo resultado do modelo, pois a reutilização no servidor é independente. Para ficheiros normais em falta, utilize backfill. Para entradas React obsoletas, utilize a limpeza. Para trabalho interrompido, comece pela recuperação, preservando o estado disponível.