Modo de vigilancia: Retraducción automática al cambiar archivos
La CLI de Lingo.dev ahora admite un potente modo de vigilancia para el comando run
, permitiendo la retraducción automática cada vez que cambian tus archivos fuente.
Cómo funciona
Cuando ejecutas la CLI con la bandera --watch
, esta monitorea continuamente tus archivos fuente configurados (según lo definido en tus buckets de i18n.json
) para detectar cambios. Cuando se añade, 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 fuente en tiempo real.
Uso
npx lingo.dev@latest run --watch
- La CLI iniciará en modo de vigilancia, mostrando registros de cambios detectados y progreso de traducción.
- Por defecto, los cambios tienen un tiempo de espera de 5 segundos para evitar ejecuciones redundantes durante ediciones rápidas.
- El proceso continuará ejecutándose hasta que lo detengas (Ctrl+C).
Opción de tiempo de espera
Puedes personalizar el retraso del tiempo de espera (en milisegundos) usando la bandera --debounce
:
npx lingo.dev@latest run --watch --debounce 10000
Este ejemplo establece una ventana de tiempo de espera 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 fuente.
- Ejecuciones con tiempo de espera: Previene solicitudes de traducción excesivas durante cambios rápidos de archivos.
- Manejo de errores: El modo de vigilancia gestiona los errores con elegancia 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 de vigilancia
- Durante el desarrollo activo de funcionalidades multilingües
- Al previsualizar cambios de traducción en tiempo real en tu aplicación
- Para integración continua con entornos de desarrollo locales o en la nube
Consejo: El modo de observación está diseñado para desarrollo e iteración rápida. Para producción o CI/CD, utiliza el comando estándar run
sin --watch
para ejecuciones de traducción puntuales.