Mode surveillance : retraduction automatique lors des modifications de fichiers
La CLI Lingo.dev prend désormais en charge un puissant mode surveillance pour la commande run, permettant la retraduction automatique dès que vos fichiers sources sont modifiés.
Fonctionnement
Lorsque vous exécutez la CLI avec le flag --watch, elle surveille en continu vos fichiers sources configurés (tels que définis dans vos buckets i18n.json) pour détecter les modifications. Lorsqu'un fichier est ajouté, modifié ou supprimé, la CLI déclenche automatiquement le workflow de traduction, mettant à jour vos fichiers de locale cible et le i18n.lock si nécessaire.
C'est idéal pour le développement rapide, les environnements de prévisualisation en direct ou tout workflow où vous souhaitez que les traductions restent synchronisées avec votre contenu source en temps réel.
Utilisation
npx lingo.dev@latest run --watch
- La CLI démarrera en mode surveillance, affichant les logs des modifications détectées et la progression de la traduction.
- Par défaut, les modifications sont différées de 5 secondes pour éviter les exécutions redondantes lors d'éditions rapides.
- Le processus continuera de s'exécuter jusqu'à ce que vous l'arrêtiez (Ctrl+C).
Option de temporisation
Vous pouvez personnaliser le délai de temporisation (en millisecondes) en utilisant le flag --debounce :
npx lingo.dev@latest run --watch --debounce 10000
Cet exemple définit une fenêtre de temporisation de 10 secondes entre les modifications détectées et la prochaine exécution de traduction.
Fonctionnalités
- Retraduction automatique : met à jour instantanément les traductions lorsque vous modifiez vos fichiers sources.
- Exécutions différées : empêche les requêtes de traduction excessives lors de modifications rapides de fichiers.
- Gestion des erreurs : le mode surveillance gère les erreurs avec élégance et continue la surveillance après les échecs.
- Tous types de fichiers : fonctionne avec tous les types de fichiers pris en charge par votre configuration
i18n.json.
Quand utiliser le mode surveillance
- Pendant le développement actif de fonctionnalités multilingues
- Lors de la prévisualisation en direct des modifications de traduction dans votre application
- Pour l'intégration continue avec des environnements de développement locaux ou cloud
Astuce : Le mode watch est conçu pour le développement et l'itération rapide. Pour la production ou CI/CD, utilisez la commande standard run sans --watch pour des exécutions de traduction ponctuelles.