create

Synopsis

gapline create <target> -s KEY=VALUE [KEY=VALUE...] [-f PATH] [--confirm] [-o PATH]

Description

create insère un seul nouvel enregistrement dans le fichier cible. L’enregistrement est construit à partir des paires --set KEY=VALUE — chaque champ requis par la spec GTFS pour ce fichier doit être fourni.

Sauf avec --confirm, gapline affiche un résumé de l’enregistrement à insérer et attend une confirmation interactive. Par défaut, le flux est réécrit sur place ; passez --output pour écrire une nouvelle archive.

L’intégrité référentielle est vérifiée avant insertion. Une clé étrangère qui ne résout pas (par ex. un trip_id absent de trips.txt) avorte la commande.

Arguments

Argument	Valeurs
`<target>`	Tout fichier GTFS supporté en CRUD — voir `read` pour la liste complète de 17 valeurs, y compris les alias underscore.

Options

Flag	Court	Valeur	Description
`--feed`	`-f`	`PATH`	Chemin du flux GTFS. Optionnel si `[default] feed` est défini.
`--set`	`-s`	`KEY=VALUE`	Valeurs de champ pour le nouvel enregistrement. Accepte plusieurs paires `KEY=VALUE` après un seul flag, séparées par des espaces.
`--confirm`			Saute le prompt de confirmation interactif. Requis en non-TTY (scripts, CI).
`--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

Insérer un nouvel arrêt

gapline create stops -f gtfs.zip \
  --set stop_id=NEW_01 stop_name="Place du marché" stop_lat=45.5017 stop_lon=-73.5673 \
  --confirm

Insérer une ligne avec un nouveau nom court

gapline create routes -f gtfs.zip \
  --set route_id=R999 agency_id=A1 route_short_name=999 route_long_name="Express" route_type=3 \
  --confirm

Écrire le résultat dans un nouveau fichier

gapline create stops -f gtfs.zip \
  --set stop_id=NEW_02 stop_name="Terminus" stop_lat=45.5 stop_lon=-73.5 \
  --confirm \
  -o gtfs-patched.zip

Codes de retour

Code	Signification
`0`	Enregistrement inséré.
`1`	Un champ requis manque, ou une FK dans `--set` ne résout pas.
`2`	Erreur de configuration.
`3`	Erreur I/O (flux introuvable, sortie non-écrivable).

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

Voir aussi

gapline read — confirmer les champs avant insertion.
gapline update — modifier un enregistrement existant plutôt que de l’insérer.
Concepts / Intégrité référentielle.