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, fare-media, fare-products, fare-leg-rules, fare-transfer-rules, rider-categories, timeframes, areas, stop-areas, networks, route-networks, fare-leg-join-rules, booking-rules, location-groups, location-group-stops. Les alias underscore (stop_times, calendar_dates, feed_info, fare_attributes, fare_rules, fare_media, fare_products, fare_leg_rules, fare_transfer_rules, rider_categories, stop_areas, route_networks, fare_leg_join_rules, booking_rules, location_groups, location_group_stops) 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.