delete

Synopsis

gapline delete <target> -w QUERY [-f PATH] [--confirm] [-o PATH]

Description

delete retire chaque enregistrement matchant --where du fichier cible. Le filtre est obligatoire — impossible de vider un fichier avec un simple gapline delete stops, par design.

Quand la cible a des dépendants (par ex. retirer un stop_id référencé par stop_times.txt), gapline construit automatiquement un plan de cascade et liste chaque fichier qui perdra des lignes avant toute application. Il n’y a pas de flag --cascade sur delete : la cascade est calculée depuis le graphe FK du flux, et le prompt de confirmation affiche le détail complet.

--confirm saute le prompt interactif et applique le plan de cascade sans condition. À n’utiliser qu’en script après vérification du match avec gapline read.

Attention

En CI, une faute de frappe dans --where peut supprimer des centaines d’enregistrements silencieusement une fois --confirm passé. Resserrez toujours le filtre avec gapline read <target> --where "..." d’abord.

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 à retirer. Voir le langage de requête.
--confirm			Saute le prompt interactif, y compris l’aperçu de cascade.
--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

Retirer un arrêt et tout ce qui le référence

gapline delete stops -f gtfs.zip --where "stop_id=S01"

Le prompt liste chaque ligne dépendante (stop_times, transfers, pathways, …) qui sera retirée avant de demander confirmation.

Retirer tous les trajets d’une ligne retirée

gapline delete trips -f gtfs.zip --where "route_id=OLD_LINE" --confirm

Les lignes associées dans stop_times.txt et frequencies.txt sont cascadées automatiquement.

Purger des entrées calendrier expirées

gapline delete calendar-dates -f gtfs.zip --where "date<20240101" --confirm

calendar-dates est un fichier feuille (rien ne le référence), donc pas de cascade.

Écrire vers un nouveau flux plutôt qu’écraser

gapline delete stops -f gtfs.zip --where "stop_id=S01" --confirm -o gtfs-cleaned.zip

Codes de retour

Code	Signification
0	Enregistrements supprimés, ou l’utilisateur a refusé le prompt.
1	--where non parsable.
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 — prévisualiser le match avant delete.
• gapline update — réécrire plutôt que supprimer.
• Concepts / Intégrité référentielle.
• Guides / Éditer avec le CRUD.