Fichier de configuration

gapline lit sa configuration depuis des fichiers TOML. Les clés inconnues sont rejetées : une faute de frappe dans une section ou un champ produit une erreur de parse avec le chemin du fichier fautif. Voir premiers pas / configuration pour le fonctionnement de la chaîne de lookup.

Cette page documente toutes les clés acceptées. Certaines sont des stubs forward-compat — elles se désérialisent proprement mais ne sont pas encore consommées par le runtime. Documentées pour l’exhaustivité ; deviendront actives au fur et à mesure des features. gapline émet un avertissement quand l’une d’elles a une valeur différente du défaut.

Sections top-level

[default]
[validation]
[validation.thresholds.speed_limits]
[validation.thresholds.distances]
[validation.thresholds.time]
[validation.thresholds.coordinates]
[validation.thresholds.calendar]
[validation.thresholds.naming]
[performance]
[output]
[batch]
[experimental]

Toute section peut être omise — chaque clé a un défaut.

`[default]`

Défauts pour les arguments CLI omissibles.

Clé	Type	Défaut	Description
`feed`	chemin	—	Chemin du flux utilisé quand `--feed` est omis. ZIP ou répertoire.
`format`	string	—	Format : `text`, `json`, `csv`, `xml`, `html`. Surchargé par `--format`.
`output`	chemin	—	Destination de sortie quand `--output` est omis. Par commande.

`[validation]`

Sélection de règles et comportement global.

Clé	Type	Défaut	Description
`min_severity`	`error\|warning\|info`	—	Filtre les anomalies sous ce niveau. Surchargé par `--min-severity`.
`disabled_rules`	tableau de string	`[]`	IDs de règles ou codes d’anomalie à sauter (voir règles de validation). Chaque clé étrangère a son propre ID `fk_<fichier>_<champ>` ; `foreign_key_violation` les sélectionne toutes. CLI `--disable-rule` ajoute à cette liste.
`max_rows`	entier	—	Lignes max par fichier (consommé par `TooManyRowsRule`). Omettre pour désactiver.
`fail_fast`	booléen	`false`	S’arrête après la première section post-parsing qui signale une erreur.
`max_errors_per_rule`	entier	—	Forward-compat. Pas encore câblé.
`enabled_rules`	tableau de string	`[]`	Si non vide, seuls ces IDs de règles ou codes d’anomalie s’exécutent. `disabled_rules` l’emporte en cas de conflit.

`[validation.thresholds.speed_limits]`

Vitesses max par type de ligne en km/h. Consommées par speed_validation.

Clé	Type	Défaut	S’applique à `route_type`
`tram_kmh`	nombre	`150.0`	0
`subway_kmh`	nombre	`150.0`	1
`rail_kmh`	nombre	`500.0`	2
`bus_kmh`	nombre	`150.0`	3
`ferry_kmh`	nombre	`150.0`	4
`cable_tram_kmh`	nombre	`30.0`	5
`aerial_lift_kmh`	nombre	`50.0`	6
`funicular_kmh`	nombre	`50.0`	7
`trolleybus_kmh`	nombre	`150.0`	11
`monorail_kmh`	nombre	`150.0`	12
`default_kmh`	nombre	`150.0`	Types étendus / inconnus

Chaque valeur doit être un nombre fini strictement positif.

`[validation.thresholds.distances]`

Seuils de distance en mètres.

Clé	Type	Défaut	Description
`max_stop_to_shape_distance_m`	nombre	`100.0`	Distance max d’un arrêt à son point de tracé le plus proche.
`min_shape_point_distance_m`	nombre	`1.11`	Espacement minimal entre points de tracé consécutifs.
`shape_dist_incoherence_ratio`	nombre	`0.5`	Tolérance pour l’incohérence `shape_dist_traveled`. Doit être dans `[0, 1]`.
`max_transfer_distance_m`	nombre	`10000.0`	Borne sup sur la distance dérivée de `transfers.min_transfer_time`.
`transfer_distance_warning_m`	nombre	`2000.0`	Seuil d’avertissement. Doit être ≤ `max_transfer_distance_m`.

Toutes les valeurs doivent être finies et non négatives.

`[validation.thresholds.time]`

Clé	Type	Défaut	Description
`max_trip_duration_hours`	entier	`24`	Durée max d’un trajet. Omettre pour désactiver. Doit être `> 0`.

`[validation.thresholds.coordinates]`

Clé	Type	Défaut	Description
`min_distance_from_origin_m`	nombre	`1000.0`	Rejette les coordonnées à moins de X mètres de 0/0.
`min_distance_from_poles_m`	nombre	`1000.0`	Rejette les coordonnées à moins de X mètres d’un pôle.

`[validation.thresholds.calendar]`

Clé	Type	Défaut	Description
`min_feed_coverage_days`	entier	`30`	Couverture calendrier minimale. Doit être `> 0`.
`feed_expiration_warning_days`	entier	`7`	Avertit quand le flux expire dans moins de X jours.
`min_trip_activity_days`	entier	`7`	Signale les trajets actifs moins de X jours.

`[validation.thresholds.naming]`

Clé	Type	Défaut	Description
`max_route_short_name_length`	entier	`12`	Avertit quand `route_short_name` dépasse X caractères. Doit être `> 0`.

`[performance]`

Clé	Type	Défaut	Description
`num_threads`	entier	—	Taille du pool de workers. Auto-détecté si omis. Surchargé par `--threads`.
`csv_buffer_size`	entier	`8192`	Forward-compat. Taille du buffer du lecteur CSV en octets.
`parallel_parsing`	booléen	`true`	Forward-compat. Pas encore câblé.
`parallel_validation`	booléen	`true`	Forward-compat. Pas encore câblé.

`[output]`

Clé	Type	Défaut	Description
`force_color`	booléen	`false`	Force les couleurs ANSI. Surchargé par `--force-color`.
`no_color`	booléen	`false`	Supprime les couleurs ANSI. Surchargé par `--no-color`.
`show_progress`	booléen	`true`	Affiche les barres de progression pendant la validation.
`verbosity`	`quiet \| normal \| verbose`	`normal`	Niveau de verbosité des logs.
`timestamp_format`	`none \| iso8601 \| unix \| relative`	`none`	Forward-compat. Style de timestamp dans les en-têtes de rapport.
`group_by_file`	booléen	`true`	Forward-compat. Regroupe les anomalies par `file_name` dans le rapport text.
`group_by_rule`	booléen	`false`	Forward-compat. Regroupe les anomalies par `rule_id` dans le rapport text.

`[batch]`

Clé	Type	Défaut	Description
`continue_on_error`	booléen	`false`	Prévu : continuer après échec d’une directive `.gl`.
`echo_commands`	booléen	`true`	Prévu : afficher chaque directive sur stderr avant exécution.

`[experimental]`

Clé	Type	Défaut	Description
`enabled`	booléen	`false`	Interrupteur principal.
`validate_flex`	booléen	`false`	Validation GTFS-Flex prévue.
`validate_fares_v2`	booléen	`false`	Validation GTFS Fares v2 prévue.
`validate_geojson`	booléen	`false`	Validation des tracés GeoJSON prévue.

Exemple complet

[default]
feed   = "./data/gtfs.zip"
format = "json"
output = "./reports/latest.json"

[validation]
disabled_rules = ["block_id_trip_overlap"]
min_severity   = "warning"
max_rows       = 5_000_000

[validation.thresholds.speed_limits]
rail_kmh = 320
bus_kmh  = 120

[validation.thresholds.distances]
max_transfer_distance_m     = 5000
transfer_distance_warning_m = 1500

[validation.thresholds.calendar]
min_feed_coverage_days       = 60
feed_expiration_warning_days = 14

[performance]
num_threads     = 4

[output]
show_progress    = true
verbosity        = "normal"

Comportement en cas d’erreur

Un fichier de config absent (l’une des trois couches) est ignoré silencieusement.
Un fichier existant non lisible (permission refusée, I/O) avorte avec code 3.
Un fichier avec TOML invalide ou clé inconnue avorte avec code 2 et un message incluant le chemin et le token fautif.
Une valeur sémantiquement invalide (vitesse négative, couverture calendrier nulle, seuils incohérents) avorte avec code 2 et un message citant le champ.

Voir concepts / codes de retour.

Voir aussi

Premiers pas / Configuration — chaîne de lookup et astuces par portée.
Flags globaux — la face CLI des mêmes valeurs.