lingo purge · Lingo.dev

Supprime les fichiers cibles dérivés et/ou le fichier de verrouillage. Action destructive — s’exécute en simulation tant que vous ne passez pas --yes.

text

lingo purge [--locale <code>...] [--file <substring>...] [--lockfile-only] [--yes]

Sans option, purge cible tous les fichiers dérivés de toutes les langues cibles configurées, ainsi que .lingo/lock.json.

Options#

Option	Effet
`--locale <code>`	Limite l’action aux langues cibles indiquées. Option répétable.
`--file <substring>`	Limite l’action aux chemins source contenant cette sous-chaîne. Option répétable.
`--lockfile-only`	Conserve tous les fichiers cibles ; supprime uniquement `.lingo/lock.json`.
`--yes`	Supprime réellement les fichiers. Sans cette option, `purge` se contente d’afficher ce qu’il supprimerait.

Simulation par défaut#

bash

lingo purge --locale fr

text

Would delete (dry run — pass --yes to apply):
  content/fr/app.json
  content/fr/guide.md
  ...

Ajoutez --yes pour exécuter la suppression.

La purge refuse tout chemin de cible ou de Lockfile situé hors de la racine du projet, y compris s’il mène hors de cette racine ou dans .git par un lien symbolique. Elle vérifie chaque cible et le Lockfile avant toute suppression et signale tout chemin refusé, même sans --yes. En cas de refus, rien n’est donc supprimé.

Exemples#

Supprimer une langue#

bash

lingo purge --locale ja --yes

Supprime tous les fichiers cibles ja. À combiner avec la suppression de ja dans targetLocales du fichier config.

Retraduction à moindre coût par langue#

bash

lingo purge --locale fr --yes
lingo push --backfill-missing

Supprime les cibles françaises, puis régénère uniquement ce qui manque. Coûte moins cher que --force, car toutes les autres langues restent servies par le cache. Voir Retranslation.

Cibler des fichiers précis#

bash

lingo purge --file marketing --locale de --yes

Supprime les cibles allemandes dont le chemin source contient marketing.

Réinitialiser uniquement le fichier de verrouillage#

bash

lingo purge --lockfile-only --yes

Conserve toutes les traductions sur le disque, mais supprime .lingo/lock.json. Lors du prochain lingo push, toutes les sources seront rehachées depuis zéro. À utiliser lorsque le fichier de verrouillage n’est plus synchronisé avec le contenu réel du disque.

Aucun retour en arrière possible

purge --yes supprime les fichiers immédiatement. Si vos traductions ne sont pas commit dans git, elles sont perdues. Exécutez d’abord la commande sans --yes pour vérifier la liste des fichiers.

Vous venez de l’ancien CLI ?#

Dans l’ancien CLI, purge filtrait aussi sur --key et --bucket. Le CLI actuel filtre uniquement sur --locale et --file (sous-chaîne du chemin source). Pour supprimer des clés précises, modifiez-les ou supprimez-les à la source, puis relancez lingo push.