PlataformaCriar uma conta

lingo purge

Max PrilutskiyCEO e cofundador2 min de leitura

Exclua arquivos de destino gerados e/ou o lockfile. Operação destrutiva — roda como simulação, a menos que você passe --yes.

text
lingo purge [--locale <code>...] [--file <substring>...] [--lockfile-only] [--yes]

Sem flags, purge seleciona todos os arquivos gerados de cada idioma de destino configurado, além de .lingo/lock.json.

Flags#

FlagEfeito
--locale <code>Limita aos idiomas de destino informados. Pode ser repetida.
--file <substring>Limita aos caminhos de origem que contenham esta substring. Pode ser repetida.
--lockfile-onlyMantém todos os arquivos de destino; exclui apenas .lingo/lock.json.
--yesExclui de verdade. Sem ela, purge só mostra o que removeria.

Simulação por padrão#

bash
lingo purge --locale fr
text
Would delete (dry run — pass --yes to apply):
  content/fr/app.json
  content/fr/guide.md
  ...

Adicione --yes para aplicar.

Purge recusa qualquer caminho de destino ou de Lockfile fora da raiz do projeto, inclusive aqueles que, por meio de um link simbólico, apontem para fora dela ou para dentro de .git. Antes de excluir qualquer coisa, verifica todos os destinos e o Lockfile e informa qualquer caminho recusado, mesmo sem --yes. Assim, em caso de recusa, nada é excluído.

Exemplos#

Remover um idioma#

bash
lingo purge --locale ja --yes

Exclui todos os arquivos de destino de ja. Combine com a remoção de ja de targetLocales em config.

Retradução econômica por idioma#

bash
lingo purge --locale fr --yes
lingo push --backfill-missing

Exclui os arquivos de destino em francês e depois regenera apenas o que estiver faltando. Sai mais barato do que --force, porque todos os outros idiomas continuam como acertos de cache. Veja Retranslation.

Restringir a arquivos específicos#

bash
lingo purge --file marketing --locale de --yes

Exclui os arquivos de destino em alemão cujo caminho de origem contenha marketing.

Redefinir apenas o lockfile#

bash
lingo purge --lockfile-only --yes

Mantém todas as traduções no disco, mas remove .lingo/lock.json. O próximo lingo push recalcula o hash de todas as origens do zero. Use isso quando o lockfile estiver fora de sincronia com o que realmente está no disco.

Não há como desfazer

purge --yes exclui arquivos imediatamente. Se suas traduções não estiverem commitadas no git, elas serão perdidas. Execute sem --yes primeiro para confirmar a lista de arquivos.

Vindo da CLI legada?#

O purge da CLI legada também filtrava por --key e --bucket. A CLI atual filtra apenas por --locale e --file (substring do caminho de origem). Para limpar chaves específicas, edite ou exclua essas chaves na origem e execute lingo push novamente.