update

Synopsis

gapline update <target> -w QUERY -s KEY=VALUE [KEY=VALUE...] [-f PATH] [--confirm] [--cascade] [-o PATH]

Description

update réécrit des champs sur chaque enregistrement matchant --where. Le filtre et les paires --set sont tous deux obligatoires — il n’y a pas de mise à jour en masse sans filtre.

Quand une affectation --set change une clé primaire (par ex. renommer un stop_id), gapline détecte le changement de PK et, si --cascade est passé, réécrit toute référence FK dans les fichiers dépendants (par ex. stop_times.txt pour un renommage de stop_id). Sans --cascade, une réécriture de PK qui orphelinerait des dépendants est refusée.

Les updates non-PK ne cascadent jamais : ils touchent uniquement le fichier cible. Utilisez --confirm pour sauter le prompt interactif en script/CI.

Arguments

Argument	Valeurs
<target>	Tout fichier GTFS supporté en CRUD — voir read pour la liste complète.

Options

Flag	Court	Valeur	Description
--feed	-f	PATH	Chemin du flux GTFS. Optionnel si [default] feed est défini.
--where	-w	QUERY	Requis. Expression de filtre qui sélectionne les enregistrements à modifier. Voir le langage de requête.
--set	-s	KEY=VALUE	Requis. Valeurs de champ à appliquer à chaque enregistrement matché. Plusieurs paires KEY=VALUE acceptées après un seul flag.
--confirm			Saute le prompt de confirmation interactif.
--cascade			Cascade les changements de clé primaire à tous les fichiers dépendants. Requis quand --set réécrit une PK référencée ailleurs.
--output	-o	PATH	Écrit le flux modifié à ce chemin au lieu d’écraser la source.

Les flags globaux sont listés sur référence / flags globaux.

Exemples

Renommer un arrêt

gapline update stops -f gtfs.zip \
  --where "stop_id=S01" \
  --set stop_name="Gare Centrale" \
  --confirm

Pas de cascade : stop_name n’est pas une clé primaire.

Réécrire une clé primaire dans tout le flux

gapline update stops -f gtfs.zip \
  --where "stop_id=S01" \
  --set stop_id=STOP_MAIN \
  --cascade --confirm

Toutes les lignes de stop_times.txt, transfers.txt, pathways.txt, et de tout autre fichier qui référence stop_id=S01 sont réécrites dans la même passe.

Mettre à jour plusieurs champs à la fois

gapline update routes -f gtfs.zip \
  --where "route_id=R1" \
  --set route_short_name="1" route_long_name="Boulevard" route_type=3 \
  --confirm

Corriger une classification en masse

gapline update routes -f gtfs.zip \
  --where "route_type=700" \
  --set route_type=3 \
  --confirm

Attention

--confirm est un auto-oui. En script il est requis, mais revérifiez la clause --where d’abord avec gapline read — un match involontaire touche chaque enregistrement matché.

Codes de retour

Code	Signification
0	Enregistrements mis à jour.
1	--where non parsable, aucun enregistrement matché, ou réécriture de PK refusée sans --cascade.
2	Erreur de configuration.
3	Erreur I/O (flux introuvable, sortie non-écrivable).
4	--where a matché zéro enregistrement. Rien n’a été écrit.

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

Voir aussi

• gapline read — vérifier le match avant update.
• gapline delete — retirer les matchs plutôt que les modifier.
• Concepts / Intégrité référentielle — comment la cascade choisit les dépendants.
• Guides / Éditer avec le CRUD.