read

Synopsis

gapline read <target> [-f PATH] [-w QUERY] [--format FORMAT] [-o PATH]

Description

read charge un flux GTFS en mémoire et affiche les enregistrements d’un seul fichier. Avec --where, la sortie est filtrée par une expression SQL-like ; sans, tous les enregistrements sont retournés. Cette commande n’écrit jamais rien sur disque.

Le résultat respecte l’ordre canonique des colonnes de la spec GTFS. Les formats de sortie correspondent à ceux de validate : texte coloré (défaut), JSON, CSV, XML ou HTML.

Arguments

Argument	Valeurs
<target>	Parmi : agency, stops, routes, trips, stop-times, calendar, calendar-dates, shapes, frequencies, transfers, pathways, levels, feed-info, fare-attributes, fare-rules, translations, attributions. Les alias underscore (stop_times, calendar_dates, feed_info, fare_attributes, fare_rules) sont également acceptés.

Options

Flag	Court	Valeur	Description
--feed	-f	PATH	Chemin du flux GTFS. Optionnel si [default] feed est défini.
--where	-w	QUERY	Expression de filtre dans le langage de requête. Omettre pour tout lire.
--format		FORMAT	Format : text, json, csv, xml, html. Défaut text.
--output	-o	PATH	Écrit le résultat vers ce chemin au lieu de stdout.

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

Exemples

Lister tous les arrêts du flux

gapline read stops -f gtfs.zip

Récupérer un arrêt par ID

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

Trouver les arrêts dont le nom commence par Gare

gapline read stops -f gtfs.zip --where "stop_name LIKE Gare%"

Conditions combinées

gapline read stop-times -f gtfs.zip --where "trip_id=T1 AND stop_sequence>10"

AND est prioritaire sur OR. Quotez l’expression pour que le shell ne la découpe pas sur les espaces.

Exporter des lignes filtrées en CSV

gapline read routes -f gtfs.zip --where "route_type=3" --format csv -o buses.csv

Noms de cibles avec alias

gapline read stop_times -f gtfs.zip --where "trip_id=T1"
gapline read stop-times -f gtfs.zip --where "trip_id=T1"

Les deux orthographes résolvent la même cible.

Codes de retour

Code	Signification
0	Requête exécutée (y compris si zéro ligne matchée).
1	L’expression --where n’a pas pu être parsée.
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

• Langage de requête — grammaire complète de --where.
• gapline update — modifier les enregistrements trouvés.
• gapline delete — les retirer.
• Formats de sortie.