Modo watch: retraducción automática al cambiar archivos
La CLI de Lingo.dev ahora admite un potente modo watch para el comando run, que permite la retraducción automática cada vez que cambian tus archivos de origen.
Cómo funciona
Cuando ejecutas la CLI con el flag --watch, monitorea continuamente tus archivos de origen configurados (según se definen en tus buckets de i18n.json) en busca de cambios. Cuando se agrega, modifica o elimina un archivo, la CLI activa automáticamente el flujo de trabajo de traducción, actualizando tus archivos de idioma de destino y el i18n.lock según sea necesario.
Esto es ideal para desarrollo rápido, entornos de vista previa en vivo o cualquier flujo de trabajo donde desees que las traducciones se mantengan sincronizadas con tu contenido de origen en tiempo real.
Uso
npx lingo.dev@latest run --watch
- La CLI se iniciará en modo watch, mostrando logs de los cambios detectados y el progreso de traducción.
- Por defecto, los cambios se debounce durante 5 segundos para evitar ejecuciones redundantes durante ediciones rápidas.
- El proceso continuará ejecutándose hasta que lo detengas (Ctrl+C).
Opción de debounce
Puedes personalizar el retraso de debounce (en milisegundos) usando el flag --debounce:
npx lingo.dev@latest run --watch --debounce 10000
Este ejemplo establece una ventana de debounce de 10 segundos entre los cambios detectados y la siguiente ejecución de traducción.
Características
- Retraducción automática: actualiza instantáneamente las traducciones mientras editas tus archivos de origen.
- Ejecuciones con debounce: previene solicitudes de traducción excesivas durante cambios rápidos de archivos.
- Manejo de errores: el modo watch gestiona errores de forma elegante y continúa monitoreando después de fallos.
- Todos los tipos de archivo: funciona con cualquier tipo de archivo compatible con tu configuración de
i18n.json.
Cuándo usar el modo watch
- Durante el desarrollo activo de funcionalidades multilingües
- Al previsualizar cambios de traducción en vivo en tu aplicación
- Para integración continua con entornos de desarrollo locales o en la nube
Consejo: El modo watch está diseñado para desarrollo e iteración rápida. Para producción o CI/CD, usa el comando estándar run sin --watch para ejecuciones de traducción únicas.