verbatra watch

Vigila el archivo del locale de origen y vuelve a ejecutar una traducción en cada cambio asentado por el anti-rebote, hasta que lo interrumpas. watch ejecuta una traducción inicial al arrancar y luego mantiene al día tus locales de destino mientras guardas. Antes de ejecutarse, carga .env.local y luego .env desde el directorio de trabajo; una variable ya definida en el entorno real gana.

Sinopsis

verbatra watch [flags]

Flags

Con --json, cada ejecución emite un registro envoltorio con command: "watch": un registro ok: true que lleva el RunSummary de esa ejecución bajo result, o un registro ok: false que lleva un código de error y un mensaje. La línea de arranque, el aviso de parada y el progreso de cada ejecución van a stderr, así que el flujo de stdout se mantiene como NDJSON limpio. Una ejecución fallida es solo un registro en el flujo: ni detiene el watcher ni cambia el código de salida.

--locales de,fr reduce cada ciclo de la sesión a un subconjunto de los destinos configurados, lo que mantiene barato un bucle de desarrollo cuando solo te importa un idioma. El subconjunto se valida una sola vez al arrancar, no en cada ejecución.

--lock-timeout se aplica a cada ciclo: ajusta cuánto espera un locale por un bloqueo de escritura disputado antes de que esa ejecución falle con LOCK_CONTENDED. Una ejecución fallida es solo un registro en el flujo, así que el watcher sigue de todas formas.

--concurrency se aplica a la ejecución de cada ciclo. Como el presupuesto de tokens de cada ejecución es nuevo, un --concurrency mayor que 1 no se puede respetar cuando la configuración fija un presupuesto maxTokens: watch rechaza esa combinación al arrancar y sale con 2 antes de la ejecución inicial, en lugar de arrancar una sesión que falla en cada ciclo. --no-cache omite la caché de memoria de traducción en cada ciclo.

Detener

La primera interrupción (Ctrl-C, o SIGTERM) deja terminar la ejecución en curso, detiene el watcher limpiamente y sale con 0. Una segunda interrupción mientras esa parada sigue en curso fuerza la detención con salida 130.

Ejemplos

# watch and re-translate on each change
verbatra watch

# calmer in a busy editor: wait 1s after the last change, stream NDJSON
verbatra watch --debounce 1000 --json

# keep only German current while you work
verbatra watch --locales de

Códigos de salida

Relacionado

• verbatra translate es la ejecución única que watch repite.
• La caché explica qué omite --no-cache en cada ejecución.
• Cómo funciona explica qué hace cada ejecución.
• La referencia del SDK documenta las formas WatchRunResult y RunSummary.