lingo pull

Recupere a execução mais recente registrada localmente sem sobrescrever acidentalmente alterações divergentes nos destinos.

Após um envio sem --wait, execute lingo pull a partir da mesma raiz do projeto e na mesma máquina. O comando lê o ponteiro da execução mais recente para esse caminho absoluto e coleta a execução registrada. Não há argumento para especificar um ID de execução arbitrário nem busca automática no histórico do projeto.

sh
lingo pull --dry-run
lingo pull

Uma simulação informa quais gravações seriam feitas sem alterar os arquivos nem o Lockfile. Ela ainda pode entrar em contato com o servidor e consultar periodicamente o trabalho em andamento. --force (-f) permite sobrescrever destinos locais divergentes; preserve essas alterações antes de usar a opção. O valor padrão de ambas as opções é false.

Como as alterações locais afetam a coleta #

O comando pull compara os bytes atuais de cada destino com o resultado do servidor, a versão do destino capturada no envio e o Lockfile:

Destino atualDecisão
AusenteCriar o destino.
Corresponde ao artefato concluído no servidorJá sincronizado.
Corresponde ao destino capturado no envioPode ser substituído pelo resultado com segurança.
Corresponde ao hash registrado no LockfilePode ser substituído com segurança.
Não corresponde a nenhum dessesConflito.

Sem forçar a operação ou usar a simulação, qualquer conflito cancela todas as gravações nos destinos. Fazer um commit de uma alteração não muda seus bytes nem resolve o conflito nessa comparação. Preserve e concilie a alteração ou restaure uma versão conhecida antes de coletar os resultados.

Uma coleta bem-sucedida registra os hashes dos destinos concluídos. Ela só atualiza uma referência de origem existente quando o documento concluído abrange todos os idiomas de destino configurados e não tem o escopo limitado por chaves. A coleta de um número menor de idiomas mantém o hash de origem existente ou o inicializa, caso esteja ausente. Uma atualização de chaves registra apenas os hashes dos destinos, para que as alterações comuns pendentes na origem ainda sejam incluídas no próximo envio simples. O uso direto de push --wait registra os mesmos hashes, mas não realiza essa nova verificação de conflitos.

Consulte os resultados de execuções inacabadas ou com falha #

O comando pull consulta periodicamente o trabalho pendente até que cada destino ainda não concluído esteja pronto ou aguardando revisão humana. Em seguida, coleta os resultados por documento: um documento é gravado assim que todos os seus idiomas estão concluídos. Os documentos que ainda aguardam revisão permanecem inalterados. Depois que os revisores terminarem, execute lingo pull novamente para gravar os demais.

Mesmo quando uma execução falha, os documentos concluídos são gravados. Em seguida, o comando informa a falha e encerra com um código diferente de zero. Se houver falha em um dos idiomas de um documento, nenhum de seus idiomas será gravado e sua referência de origem será mantida, para que o próximo envio desse arquivo o solicite novamente. Leia a mensagem de falha e verifique os arquivos esperados. Uma tradução ausente ou uma revisão obrigatória exige uma ação específica no workflow, não outra tentativa de download.

Quando a execução não é encontrada #

O ponteiro fica em ~/.lingo/runs/ e depende do caminho absoluto da raiz do projeto. Mover um checkout, usar outro executor ou fazer outro envio pode mudar qual execução está disponível localmente. Verifique esse estado e a vinculação do projeto antes de concluir que o resultado remoto está ausente.

Uma execução enviada por uma versão mais antiga da CLI pode não ser legível pela versão instalada. Nesse caso, o comando pull informa o problema, e outro lingo push envia o trabalho novamente. Lockfile e cache explica a referência portátil e o estado local da máquina.