Autocomplétion shell

L’autocomplétion économise des frappes à chaque invocation. Elle suggère les sous-commandes, les flags, les cibles CRUD, et — unique à gapline — les IDs de toutes les règles de validation compilées dans votre build, ce qui transforme --disable-rule <Tab> en menu plutôt qu’en un grep-puis-coller.

Installation en une commande

Bash

gapline completion bash --install

Ouvrez un nouveau terminal ou source ~/.bashrc pour activer la complétion.

Zsh

gapline completion zsh --install

Vérifiez que compinit tourne dans votre .zshrc avant tout chargeur de complétion custom. Démarrez un nouveau shell ou source ~/.zshrc.

Fish

gapline completion fish --install

Fish prend le nouveau fichier au prochain prompt — pas de redémarrage nécessaire.

Installation manuelle

Quand --install ne peut pas atteindre le répertoire standard (partition en lecture seule, setup shell inhabituel, runner CI sans home), générez le script vous-même et redirigez-le vers le chemin qui convient.

gapline completion bash > ~/.local/share/bash-completion/completions/gapline
gapline completion zsh  > "${fpath[1]}/_gapline"
gapline completion fish > ~/.config/fish/completions/gapline.fish

Note

Les scripts peuvent aussi être générés pour elvish et powershell, mais --install ne sait pas où les déposer. Générez avec gapline completion elvish ou gapline completion powershell puis suivez l’emplacement documenté par votre shell.

Ce qui est complété

• Sous-commandes — validate, read, create, update, delete, run, rules, completion.
• Flags — formes longues (--feed, --format, --min-severity…) et alias courts (-f, -o, -w, -s).
• Cibles CRUD — les 17 fichiers GTFS acceptés par read, create, update, delete (stops, routes, trips, stop-times, …).
• IDs de règles de validation — chaque règle enregistrée dans le binaire courant, suggérée comme valeur de --disable-rule.

Essayer

gapline valid<Tab>                       # → validate
gapline validate --m<Tab>                # → --min-severity
gapline validate --disable-rule bloc<Tab># → block_id_trip_overlap
gapline read sto<Tab>                    # → stops  stop-times

Dépannage

• Rien ne se passe au <Tab>. La plupart des shells chargent les scripts au démarrage. Ouvrez un nouveau terminal ou sourcez le fichier que vous venez d’écrire.
• Zsh affiche une erreur _arguments:comparguments. compinit doit tourner avant que le script de complétion ne soit sourcé. Vérifiez que .zshrc appelle autoload -Uz compinit && compinit avant tout gestionnaire de plugins qui source des complétions custom.
• Les IDs de règles ne se suggèrent pas. Le complèteur dynamique appelle le binaire gapline. Lancez gapline --version pour confirmer qu’il est dans votre PATH.

Voir aussi

• Référence gapline completion — référence complète des flags.
• gapline rules list — les mêmes IDs que suggère la complétion.
• Valider des flux — comment --disable-rule s’intègre à un workflow réel.