Lister les sports avec sports

Traduction automatique provisoire, non révisée. En cas de doute, consultez la version anglaise, qui fait référence.

kent sports liste les combinaisons distinctes de sport et de sous-sport que contient une base, une ligne chacune, triées par nom.

Il est en lecture seule et rapporte ce que cette base contient réellement, pas tous les sports que le schéma sait représenter. Le schéma en décrit des dizaines ; une base en contient d’ordinaire un ou deux.

Synopsis

kent sports <dbfilename>

Ce qu’il affiche

$ kent sports mydata.sqlite
Database:  mydata.sqlite

Sport    Sub-sport
Running  Generic

Une base d’un autre sport rapporte ce sport, et le sous-sport est souvent la moitié la plus informative :

$ kent sports swim.sqlite
Database:  swim.sqlite

Sport     Sub-sport
Swimming  Lap Swimming

Des combinaisons, pas deux listes séparées. Une base contenant nage en eau libre et en piscine liste Swimming deux fois, une par sous-sport, car c’est la paire qui les distingue.

À quoi il sert

Il répond vite à une question : qu’y a-t-il dans cette base ? Cela mérite une commande propre, car activities imprime chaque séance, et une base de 300 courses met 300 lignes à vous dire qu’elle contient de la course.

C’est aussi la façon honnête de vérifier une base avant d’écrire un rapport dessus. Un script qui suppose un seul sport peut le tester d’abord.

Une base sans sport

Une base créée mais jamais alimentée affiche une phrase simple et réussit :

$ kent createdb mydata.sqlite
$ kent sports mydata.sqlite
Database:  mydata.sqlite

No sports recorded.
$ echo $?
0

Un chemin inexistant est signalé comme manquant et n’est pas créé :

$ kent sports nope.sqlite
kent sports: nope.sqlite does not exist
$ echo $?
1

Une base plus ancienne est refusée

Comme les autres commandes de lecture, celle-ci lit des colonnes nommées précises : une base plus ancienne que ce que cette version attend est donc refusée avec une explication :

$ kent sports old.sqlite
kent sports: this database reports schema version 1, older than the version 2 this build of cordelia expects. Use `kent sqldump` to export it instead
$ echo $?
1

Ce qu’il n’est pas

sports ne compte rien. Il ne dit pas combien d’activités chaque sport compte, ni quand elles ont eu lieu. Pour cela, voir kent activities, qui liste chaque séance avec ses dates et son sport.