lingo pull
Obtenha a execução mais recente registada localmente sem substituir acidentalmente alterações divergentes nos ficheiros de destino.
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 apontador para a execução mais recente associado a esse caminho absoluto e recolhe os resultados da execução registada. Não existe um argumento para indicar um ID de execução arbitrário, nem uma pesquisa automática no histórico do projeto.
lingo pull --dry-run
lingo pullUma simulação indica as decisões de escrita sem alterar os ficheiros nem o Lockfile. Ainda assim, pode contactar o servidor e consultar periodicamente o trabalho por concluir. --force (-f) permite substituir ficheiros de destino locais divergentes; preserve essas alterações antes de utilizar esta opção. Ambas as opções têm false como valor predefinido.
Como as alterações locais afetam a recolha #
O comando pull compara os bytes atuais de cada ficheiro de destino com o resultado do servidor, a versão do ficheiro de destino registada no momento do envio e o Lockfile:
| Ficheiro de destino atual | Decisão |
|---|---|
| Ausente | Criar o ficheiro. |
| Corresponde ao artefacto concluído no servidor | Já está sincronizado. |
| Corresponde à versão do ficheiro de destino registada no envio | Pode ser substituído pelo resultado em segurança. |
| Corresponde ao hash registado no Lockfile | Pode ser substituído em segurança. |
| Não corresponde a nenhum dos anteriores | Conflito. |
Sem substituição forçada nem simulação, qualquer conflito cancela todas as operações de escrita nos ficheiros de destino. Registar uma alteração num commit não modifica os respetivos bytes nem resolve o conflito detetado nesta comparação. Preserve e concilie a alteração ou restaure uma versão conhecida antes de recolher os resultados.
Uma recolha bem-sucedida regista os hashes dos ficheiros de destino concluídos. Só atualiza uma referência de origem existente quando o documento concluído abrange todos os idiomas de destino configurados e não está limitado a um conjunto de chaves. A recolha de um número menor de idiomas mantém o hash de origem existente ou inicializa-o, caso ainda não exista. Uma atualização de chaves regista apenas os hashes de destino, pelo que as alterações normais pendentes na origem continuam a ser incluídas no próximo envio simples. A execução direta de push --wait regista os mesmos hashes, mas não volta a verificar a existência de conflitos.
Consultar resultados por concluir e com falhas #
O comando pull consulta periodicamente o trabalho pendente até que todos os destinos por concluir estejam concluídos ou a aguardar revisão humana. Em seguida, recolhe os resultados por documento: cada documento é escrito quando todos os seus idiomas estão concluídos. Os documentos que ainda aguardam revisão ficam inalterados. Depois de os revisores terminarem, execute lingo pull novamente para escrever os restantes.
Mesmo que uma execução falhe, o comando escreve os documentos concluídos, comunica a falha e termina com um código diferente de zero. Se um documento tiver uma falha num dos idiomas, nenhum dos seus idiomas é escrito e a referência de origem é mantida, para que o próximo envio desse ficheiro volte a solicitá-lo. Leia a mensagem de falha e verifique os ficheiros esperados. Uma tradução em falta ou uma revisão obrigatória exige uma ação própria no workflow, não uma nova tentativa de transferência.
Quando não é possível encontrar a execução #
O apontador encontra-se em ~/.lingo/runs/ e depende do caminho absoluto da raiz do projeto. Mover um checkout, utilizar outro executor ou efetuar outro envio pode alterar a execução disponível localmente. Verifique esse estado e a associação do projeto antes de concluir que os resultados remotos estão em falta.
Uma execução submetida por uma versão mais antiga da CLI pode não ser legível pela versão instalada. Nesse caso, o comando pull indica essa incompatibilidade, e uma nova execução de lingo push volta a submeter o trabalho. Lockfile e cache explica a referência portável e o estado local da máquina.