Flags globaux

Ces flags s’appliquent à toutes les sous-commandes et peuvent être placés avant ou après le nom de la sous-commande.

Options

Flag	Valeur	Description
--config	PATH	Chemin vers un fichier de config TOML. Remplace ./gapline.toml ; ~/.config/gapline/config.toml reste consulté.
--no-color		Désactive les couleurs ANSI, même en TTY. Exclusif avec --force-color.
--force-color		Force les couleurs ANSI, même hors TTY (utile pour les recorders). Exclusif avec --no-color.
--threads	N	Taille du pool de threads utilisé par les règles en parallèle. Auto-détecté si omis.

--config

Par défaut, gapline parcourt une chaîne à quatre niveaux :

1. Flags CLI (priorité la plus haute).
2. ./gapline.toml dans le répertoire courant.
3. ~/.config/gapline/config.toml (ou %APPDATA%\gapline\config.toml sous Windows).
4. Valeurs par défaut du binaire.

--config PATH remplace l’étape 2 par le fichier pointé. L’étape 3 reste chargée en couche inférieure — les overrides locaux continuent de fonctionner, les clés globales aussi.

gapline --config ci/gapline.ci.toml validate -f gtfs.zip

Un fichier absent à PATH est une erreur. Un TOML malformé (erreur de syntaxe, clé inconnue) est une erreur avec la ligne et la colonne du token fautif.

--no-color et --force-color

gapline affiche en couleur quand stdout est un TTY. Quand stdout est redirigé ou piped, les couleurs sont supprimées automatiquement.

Utilisez --no-color quand la détection TTY est fausse ou que vous capturez la sortie depuis un PTY :

gapline validate -f gtfs.zip --no-color | tee run.log

Utilisez --force-color quand un consommateur en aval comprend l’ANSI malgré la pipe — par ex. less -R ou un recorder de terminal :

gapline validate -f gtfs.zip --force-color | less -R

--threads

--threads N plafonne le pool de workers utilisé par la validation parallèle. Défaut : nombre de CPUs logiques rapporté par l’OS. Baissez la valeur quand gapline tourne à côté d’une autre charge CPU ou mémoire (build, tests, autre validateur).

gapline --threads 2 validate -f gtfs.zip

Les opérations CRUD et les scripts .gl sont majoritairement mono-thread et ne profitent pas d’une valeur plus haute. La validation est le consommateur principal de ce flag.

Interaction avec gapline.toml

Chaque flag global a un équivalent dans les sections [default] ou [performance] du fichier de config. Les flags CLI gagnent toujours. Voir référence / fichier de configuration pour la correspondance complète.

Voir aussi

• Premiers pas / Configuration — où poser un gapline.toml.
• Référence / Fichier de configuration — chaque section, chaque clé.