Lister les fichiers importés avec files

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

kent files liste les fichiers .FIT enregistrés dans une base de données, une ligne par fichier jamais importé dans celle-ci, dans l'ordre où ils ont été importés.

Il est en lecture seule, et ne touche jamais aux fichiers .FIT eux-mêmes. Il ne lit que ce que la base de données a enregistré à leur sujet, ce qui veut dire qu'il fonctionne même quand les fichiers d'origine ont depuis longtemps disparu de la machine.

Synopsis

kent files <dbfilename>

Ce qu'il affiche

$ kent files mydata.sqlite
Database:  mydata.sqlite

#  Imported              Created               Path
1  2026-08-12T09:14:03Z  2026-08-11T17:22:41Z  /home/user/rides/morning.fit  (Forerunner 965)
2  2026-08-14T20:41:55Z  2026-08-14T06:02:10Z  /home/user/rides/evening.fit
3  2026-08-15T11:00:00Z  -                     /home/user/rides/hike.fit

Colonne	Ce que c'est
`#`	Le numéro du fichier dans cette base de données. Chaque activité, session et enregistrement de la base pointe vers l'un d'eux, c'est donc aussi le numéro à citer pour identifier un fichier. Il est attribué dans l'ordre d'importation.
`Imported`	Quand Cordelia a importé le fichier. Toujours présent.
`Created`	Quand l'appareil lui-même a écrit le fichier. Affiché comme `-` lorsque le fichier n'en portait pas. Tous les appareils ne l'enregistrent pas.
`Path`	Le fichier `.FIT` depuis lequel il a été importé. C'est l'emplacement du fichier au moment de l'importation ; il n'est pas vérifié, et il peut ne plus être là.

Un nom d'appareil entre parenthèses après le chemin n'apparaît que lorsque le fichier en portait un. La plupart n'en portent pas, et une paire de parenthèses vide sur chaque ligne serait du bruit.

La largeur des colonnes suit la valeur la plus longue réellement présente, si bien qu'une base de chemins courts n'hérite pas d'une colonne large et presque vide.

Une base de données sans fichiers

Une base qui a été créée mais jamais alimentée affiche une phrase simple et réussit. Aucun fichier est une réponse, pas un échec, et le code de sortie est 0 :

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

No files recorded.
$ echo $?
0

Dans un script, cela compte : testez le code de sortie pour savoir si Kent a pu lire la base de données, pas s'il a trouvé quelque chose.

Un chemin qui n'existe pas est signalé comme manquant et n'est pas créé :

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

Une base plus ancienne est refusée

files refuse une base de données écrite par une Cordelia plus ancienne que celle attendue par cette compilation, de la même façon que info et details. Il lit des colonnes nommées précises, si bien qu'une base ancienne qui ne les a jamais eues échouerait sinon avec une erreur SQLite brute au lieu d'une explication.

kent sqldump et kent archive sont les deux commandes qui lisent malgré tout une base pareille. Voir Messages d'erreur et codes de sortie.

Ce que ce n'est pas

files liste les fichiers qui ont été importés. Il ne liste pas les activités qu'ils contiennent, et il n'affiche aucune des données enregistrées. Pour des décomptes de ce que contient une base, voir kent info et kent details ; pour lire les données elles-mêmes, voir kent archive ou Consulter les données importées.

Voir aussi Messages d'erreur et codes de sortie et Importer des fichiers .FIT.