lingo pull
Recupera la última ejecución registrada localmente sin sobrescribir por error los cambios divergentes en los archivos de destino.
Después de un 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 con un ID de ejecución arbitrario ni busca automáticamente en el historial del proyecto.
lingo pull --dry-run
lingo pullUna ejecución de prueba indica qué se escribiría sin modificar los archivos ni el Lockfile. Aun así, puede contactar con el servidor y consultar periódicamente el trabajo pendiente. --force (-f) permite sobrescribir los archivos de destino locales divergentes; guarda esos cambios antes de usarlo. Ambas opciones tienen el valor false por defecto.
Cómo afectan los cambios locales a la recuperación de resultados #
El comando pull compara los bytes actuales de cada archivo de destino con el resultado del servidor, el archivo de destino capturado al hacer push y el Lockfile:
| Archivo de destino actual | Decisión |
|---|---|
| No existe | Crearlo. |
| Coincide con el artefacto completado del servidor | Ya está sincronizado. |
| Coincide con el archivo de destino capturado al hacer push | Se puede sustituir por el resultado de forma segura. |
| Coincide con el hash registrado en el Lockfile | Se puede sustituir de forma segura. |
| No coincide con ninguno de los anteriores | Conflicto. |
Si no fuerzas la operación ni realizas una ejecución de prueba, 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 e integra el cambio, o restaura una versión conocida antes de recuperar los resultados.
Cuando la recuperación se completa correctamente, se registran los hashes de los archivos de destino completados. Solo se actualiza una versión de referencia de origen existente cuando el documento completado abarca todos los idiomas de destino configurados y no está limitado a determinadas claves. Si se recuperan los resultados de menos idiomas, se mantiene el hash de origen existente o se inicializa si no existe. Una actualización de claves solo registra los hashes de destino, de modo que los cambios ordinarios pendientes en el origen siguen enviándose en el siguiente push normal. La ejecución directa de push --wait registra los mismos hashes, pero no realiza esta nueva comprobación de conflictos.
Consulta los resultados pendientes 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. Después recupera los resultados por documento: cada documento se escribe cuando se han completado todos sus idiomas. Los documentos que siguen esperando una revisión no se modifican; al volver a ejecutar lingo pull una vez terminadas las revisiones, se escriben los restantes.
Una ejecución fallida también escribe los documentos que se hayan completado; después informa del fallo 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 de origen, por lo que el siguiente push de ese archivo vuelve a solicitarlo. Lee la información del fallo y comprueba los archivos esperados. Si falta una traducción o se requiere una revisión, hace falta una acción específica en el flujo de trabajo, no otro intento de descarga.
Cuando no se encuentra la ejecución #
El puntero se guarda 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. Comprueba ese estado y la vinculación del proyecto antes de concluir que faltan los resultados remotos.
Es posible que la versión instalada no pueda leer una ejecución enviada por una versión anterior de la CLI. En ese caso, el comando pull lo indica y otro lingo push vuelve a enviar el trabajo. Lockfile y caché explica la versión de referencia portátil y el estado local de la máquina.