lingo pull

Recupera la última ejecución registrada localmente sin sobrescribir por accidente los cambios divergentes en los archivos de destino.

Después de ejecutar push sin --wait, ejecuta lingo pull desde la misma raíz del proyecto y en la misma máquina. El comando lee el puntero a la última ejecución para esa ruta absoluta y recupera la ejecución registrada. No admite un argumento para especificar un ID de ejecución arbitrario ni busca automáticamente en el historial del proyecto.

sh
lingo pull --dry-run
lingo pull

Una simulación informa qué se escribiría sin modificar los archivos ni el Lockfile. Aun así, puede comunicarse con el servidor y consultar periódicamente el trabajo sin terminar. --force (-f) permite sobrescribir los archivos de destino locales divergentes; conserva esos cambios antes de usarlo. Ambas opciones tienen false como valor predeterminado.

Cómo afectan los cambios locales a la recuperación #

El comando pull compara los bytes actuales de cada archivo de destino con el resultado del servidor, el archivo de destino capturado al ejecutar push y el Lockfile:

Archivo de destino actualDecisión
No existeCrearlo.
Coincide con el artefacto completado del servidorYa está sincronizado.
Coincide con el archivo de destino capturado al ejecutar pushSe puede reemplazar con el resultado de forma segura.
Coincide con el hash registrado en el LockfileSe puede reemplazar de forma segura.
No coincide con ninguno de los anterioresConflicto.

Si no se fuerza la operación ni se usa una simulación, cualquier conflicto cancela todas las escrituras en los archivos de destino. Registrar un cambio en un commit no modifica sus bytes ni resuelve esta comparación. Conserva el cambio y resuelve las diferencias, o restaura una versión conocida antes de recuperar los resultados.

Una recuperación exitosa registra los hashes de los archivos de destino completados. Solo actualiza la versión de referencia existente del origen cuando el documento completado abarca todos los idiomas de destino configurados y no está limitado a determinadas claves. La recuperación para menos idiomas conserva el hash de origen existente o lo inicializa si no existe. Una actualización de claves solo registra los hashes de destino, por lo que los cambios habituales pendientes en el origen siguen enviándose en la siguiente ejecución de push sin opciones adicionales. Ejecutar push --wait directamente registra los mismos hashes, pero no realiza esta nueva comprobación de conflictos.

Leer los resultados sin terminar y fallidos #

El comando pull consulta periódicamente el trabajo pendiente hasta que todos los destinos sin terminar se hayan completado o estén esperando una revisión humana. Luego recupera los resultados por documento: cada documento se escribe cuando todos sus idiomas están completos. Los documentos que aún esperan una revisión no se modifican. Volver a ejecutar lingo pull después de que quienes realizan la revisión terminen permite escribir los documentos restantes.

Una ejecución fallida escribe de todos modos los documentos que se completaron, luego informa el error y termina con un código de salida distinto de cero. Si falla un idioma de un documento, no se escribe ninguno de sus idiomas y se conserva su versión de referencia del origen, de modo que la siguiente ejecución de push para ese archivo vuelve a solicitarlo. Lee el error y verifica los archivos esperados. Una traducción faltante o una revisión obligatoria requiere su propia acción en el flujo de trabajo, no otro intento de descarga.

Cuando no se encuentra la ejecución #

El puntero se almacena en ~/.lingo/runs/ y depende de la ruta absoluta de la raíz del proyecto. Mover un checkout, usar otro ejecutor o enviar otro push puede cambiar qué ejecución está disponible localmente. Revisa ese estado y la vinculación del proyecto antes de concluir que falta el resultado remoto.

Es posible que la versión instalada no pueda leer una ejecución enviada con una versión anterior de la CLI; en ese caso, pull lo indica y otra ejecución de lingo push vuelve a enviar el trabajo. Lockfile y caché explica la versión de referencia portable y el estado local de la máquina.