lingo purge
Prévisualisez la suppression des fichiers cibles et comprenez quelles entrées du Lockfile elle retire.
lingo purge permet de supprimer délibérément les fichiers cibles dérivés. En mode fichier standard, la commande affiche un aperçu des chemins sélectionnés ; --yes procède à la suppression. Avec --file ou --locale, elle supprime uniquement les cibles sélectionnées et leurs entrées du Lockfile, tout en conservant les états de référence des sources et les entrées des autres cibles. Sans filtres, elle supprime également l’intégralité du Lockfile du projet.
Prévisualiser une cible standard #
Pour une structure JSON répartie dans des fichiers distincts :
lingo purge --locale de --file locales/en.jsonVérifiez que la cible indiquée est bien le fichier que vous pouvez supprimer. Sauvegardez les résultats acceptés avant d’ajouter --yes. Si la régénération échoue ensuite, la suppression aura déjà eu lieu.
| Option | Comportement |
|---|---|
--locale <locale> | Filtre de cibles utilisable plusieurs fois ; cible par défaut les cibles configurées. La langue source est refusée. |
--file <value> | Filtre de chemins sources utilisable plusieurs fois, ou chemin source explicite pour les entrées utilisant des motifs glob. |
--lockfile-only | Supprime uniquement .lingo/lock.json ; nécessite --yes et ne peut pas être combiné avec --file ou --locale. |
--yes, -y | Procède à la suppression au lieu d’afficher l’aperçu du mode fichier. |
Les chemins dérivés situés hors de la racine du projet sont refusés, y compris ceux qui mènent à l’extérieur de cette racine ou dans .git par un lien symbolique ; la commande purge les signale même sans --yes. Les fichiers situés dans la racine peuvent toutefois contenir des sources ou des données partagées précieuses : vérifiez donc leur rôle autant que leur emplacement.
Sélection des fichiers #
La commande purge déduit les chemins à partir des sources explicitement configurées et des valeurs explicites de --file. Elle ignore les motifs glob configurés, sauf si des chemins sources explicites sont fournis. Pour les entrées de configuration explicites, --file filtre par sous-chaîne ; il ne réalise pas une expansion générale des motifs glob.
La commande purge ignore toute cible dont le chemin est identique à celui de la source et indique que ses traductions se trouvent dans le fichier source. Les catalogues XCStrings partagés utilisent cette structure : la commande purge ne peut donc pas y supprimer une seule langue. Utilisez plutôt le workflow de correction des catalogues de chaînes.
Modifications du Lockfile #
Une purge filtrée supprime les entrées des cibles sélectionnées, même si les fichiers correspondants sont déjà absents. Elle conserve les empreintes des sources, afin que les modifications des sources en attente puissent encore être transmises aux autres langues lors d’un envoi ultérieur. Si le Lockfile est mal formé, la purge filtrée s’arrête avant de supprimer la moindre cible ; restaurez-le ou réparez-le avant de réessayer.
Sans filtres, lingo purge --yes et lingo purge --lockfile-only --yes suppriment l’intégralité du Lockfile. Sans --yes, le mode limité au Lockfile demande une confirmation au lieu d’afficher l’aperçu habituel des fichiers.
L’absence de Lockfile modifie la planification incrémentale ; elle ne garantit pas de nouveaux résultats du modèle, car la réutilisation côté serveur est indépendante. Pour les fichiers standard manquants, utilisez le Remplissage rétroactif. Pour les entrées React obsolètes, utilisez le nettoyage. Pour les travaux interrompus, commencez par la reprise tout en conservant l’état disponible.