run

Synopsis

gapline run <file.gl>

Description

run lit un fichier batch .gl, charge en mémoire le flux déclaré par sa première directive feed, puis exécute les commandes listées dans l’ordre. Le flux reste en mémoire entre les étapes ; le disque n’est touché qu’à une directive save.

Les scripts sont séquentiels et stop-on-error : le premier échec stoppe l’exécution, et le flux n’est pas persisté sauf si un save antérieur a déjà réussi. Cela rend les fichiers .gl sûrs à relancer idempotemment.

run n’accepte pas de flags CLI en dehors des globaux — toutes les options par commande sont à l’intérieur du script. run imbriqué n’est pas supporté.

Arguments

Argument	Description
`<file.gl>`	Chemin du fichier batch `.gl`. Requis, positionnel.

Options

run n’a pas de flags spécifiques. Voir flags globaux pour les options qui s’appliquent à toutes les sous-commandes.

Exemple

# Charge le flux une seule fois — les commandes suivantes opèrent en mémoire.
feed ./data/gtfs.zip

# Purge la ligne retirée et tout ce qui la référence.
delete trips --where "route_id=OLD_LINE" --confirm

# Normalise le nom court.
update routes --where "route_id=R1" --set route_short_name="1" --confirm

# Validation finale, machine-readable, écrite sur disque.
validate --format json -o report.json

# Écriture atomique — n'est atteinte que si toutes les étapes précédentes ont réussi.
save ./data/gtfs-patched.zip

Lancer :

gapline run weekly-fix.gl

Codes de retour

Code	Signification
`0`	Toutes les commandes ont terminé. Le flux a été sauvé si et seulement si `save` a été atteint.
`1`	Une commande du script a échoué. Le flux sur disque est inchangé.
`2`	Le script lui-même a une erreur de syntaxe (directive inconnue, ligne malformée).
`3`	Erreur I/O (fichier script absent, flux illisible, chemin de `save` non-écrivable).

Voir concepts / codes de retour pour la table complète.

Voir aussi

Syntaxe .gl — grammaire complète et directives.
Concepts / Modèle de session .gl — comment l’état mémoire et save interagissent.
Guides / Écrire des scripts .gl.