verbatra watch

Page traduite automatiquement

Cette page a été traduite automatiquement, elle peut donc contenir des erreurs ou sonner un peu bizarrement. La version anglaise est la référence. Lire l'original en anglais.

Surveille le fichier de la locale source et relance une traduction à chaque changement temporisé, jusqu'à ce que tu l'interrompes. watch lance une traduction initiale au démarrage, puis garde tes locales cibles à jour au fil de tes sauvegardes. Avant de s'exécuter, il charge .env.local puis .env depuis le répertoire de travail ; une variable déjà définie dans l'environnement réel l'emporte.

Synopsis

verbatra watch [flags]

Options

Option	Argument	Défaut	Effet
`--cwd`	`<path>`	répertoire courant	résout la config et les fichiers de locale depuis ce répertoire
`--config`	`<path>`	recherche automatique	charge ce fichier de config au lieu d'en chercher un
`--debounce`	`<ms>`	`300`	attend ce nombre de millisecondes après le dernier changement avant de traduire ; doit être un entier positif nu (une valeur comme `250ms`, `0` ou `-1` est une erreur d'utilisation, sortie `2`)
`--concurrency`	`<n>`	`1`	traduit jusqu'à `n` locales cibles à la fois par exécution ; doit être un entier positif
`--no-cache`	aucun	désactivé (cache activé)	contourne le cache de mémoire de traduction local (`verbatra.cache.json`) à chaque exécution
`--json`	aucun	désactivé	affiche chaque exécution comme un enregistrement NDJSON (un objet JSON par ligne) sur stdout

Avec --json, chaque exécution émet un enregistrement WatchRunResult : un succès portant le résumé d'exécution, ou un échec portant un code d'erreur et un message. La ligne de démarrage, l'avis d'arrêt et la progression de chaque exécution vont sur stderr, donc le flux stdout reste du NDJSON propre. Une exécution échouée n'est qu'un enregistrement sur le flux : elle n'arrête pas la surveillance et ne change pas le code de sortie.

--concurrency s'applique à l'exécution de chaque cycle. Comme le budget de tokens de chaque exécution est neuf, un --concurrency supérieur à 1 échoue toujours à chaque exécution avec la sortie 2 quand la config fixe un budget maxTokens. --no-cache contourne le cache de mémoire de traduction à chaque cycle.

Arrêt

La première interruption (Ctrl-C ou SIGTERM) laisse l'exécution en cours se terminer, arrête proprement la surveillance et sort avec 0. Une seconde interruption pendant que cet arrêt est encore en cours force l'arrêt avec le code 130.

Exemples

# 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

Codes de sortie

Code	Signification
`0`	arrêté proprement par une seule interruption
`2`	impossible de démarrer ou de s'arrêter : une erreur de config, un échec au démarrage ou à l'arrêt, ou une erreur d'utilisation (y compris un `--debounce` invalide)
`130`	arrêté de force par une seconde interruption

Voir aussi

verbatra translate est l'exécution unique que watch répète.
Le cache explique ce que --no-cache contourne à chaque exécution.
Comment ça marche explique ce que fait chaque exécution.
La référence SDK documente les formes WatchRunResult et RunSummary.

Edit on GitHub