lingo pull
Récupérez la dernière exécution enregistrée localement sans écraser par inadvertance les modifications divergentes des cibles.
Après un push sans --wait, exécutez lingo pull depuis la même racine de projet et sur la même machine. La commande lit le pointeur de la dernière exécution associé à ce chemin absolu et récupère les résultats de l’exécution enregistrée. Elle n’accepte pas d’argument permettant de choisir un ID d’exécution arbitraire et ne recherche pas automatiquement dans l’historique du projet.
lingo pull --dry-run
lingo pullUne simulation indique les décisions d’écriture sans modifier les fichiers ni le Lockfile. Elle peut toutefois contacter le serveur et vérifier l’avancement des travaux inachevés. --force (-f) autorise l’écrasement des cibles locales divergentes ; sauvegardez ces modifications avant de l’utiliser. Les deux options sont désactivées par défaut.
Impact des modifications locales sur la récupération #
La commande pull compare les octets actuels de chaque cible au résultat du serveur, à la cible capturée lors du push et au Lockfile :
| Cible actuelle | Décision |
|---|---|
| Absente | La créer. |
| Identique à l’artefact finalisé sur le serveur | Déjà synchronisée. |
| Identique à la cible capturée lors du push | Peut être remplacée par le résultat sans risque. |
| Correspond à l’empreinte enregistrée dans le Lockfile | Peut être remplacée sans risque. |
| Ne correspond à aucun de ces cas | Conflit. |
Sans forçage ni simulation, tout conflit interrompt l’ensemble des écritures dans les cibles. Faire un commit d’une modification ne change pas ses octets et ne résout pas le conflit détecté par cette comparaison. Sauvegardez la modification et réconciliez les versions, ou restaurez une version connue avant de récupérer les résultats.
Une récupération réussie enregistre les empreintes des cibles terminées. Elle ne met à jour une référence source existante que si le document terminé couvre toutes les langues cibles configurées et n’est pas limité à certaines clés. Une récupération portant sur moins de langues conserve l’empreinte source existante ou l’initialise si elle est absente. Une actualisation de clés enregistre uniquement les empreintes des cibles : les modifications ordinaires de la source encore en attente sont donc toujours prises en compte lors du prochain push standard. Un push --wait direct enregistre les mêmes empreintes, mais n’effectue pas cette nouvelle vérification des conflits.
Lire les résultats inachevés et en échec #
La commande pull vérifie régulièrement l’avancement des travaux en attente jusqu’à ce que chaque cible inachevée soit terminée ou en attente de relecture humaine, puis récupère les résultats par document : un document est écrit une fois toutes ses langues terminées. Les documents encore en attente de relecture restent inchangés ; exécutez à nouveau lingo pull une fois que les personnes chargées de la relecture ont terminé pour écrire le reste.
Une exécution en échec écrit tout de même les documents terminés, puis signale l’échec et se termine avec un code de sortie non nul. Si une langue d’un document est en échec, aucune de ses langues n’est écrite et sa référence source est conservée ; le prochain push de ce fichier demandera donc à nouveau ce document. Consultez les détails de l’échec et vérifiez les fichiers attendus. Une traduction manquante ou une relecture requise nécessite une action spécifique dans le workflow, et non une nouvelle tentative de téléchargement.
Lorsque l’exécution est introuvable #
Le pointeur se trouve sous ~/.lingo/runs/ et dépend du chemin absolu de la racine du projet. Déplacer un checkout, utiliser un autre environnement d’exécution ou soumettre un autre push peut changer l’exécution disponible localement. Vérifiez cet état et l’association du projet avant de conclure que les résultats distants sont manquants.
Une exécution soumise par une ancienne version de la CLI peut être illisible par la version installée ; la commande pull le signale alors, et un nouveau lingo push soumet à nouveau le travail. La section Lockfile et cache explique la référence portable et l’état local propre à la machine.