La ligne de commande

Une option, une passe, un code de sortie

FastLoupe [<bibliothèque>.db | --catalog <chemin>] [verbe]

Sans verbe, une fenêtre s’ouvre comme d’habitude. Chaque verbe ci-dessous exécute au contraire une passe puis se termine. Pas de service résident, pas de --watch, pas d’arborescence de sous-commandes à apprendre.

Ce sont les commandes que tapent une personne, un lanceur ou une tâche planifiée. Les modes scriptés et de développement sont autre chose, avec d’autres règles ; --help ne les liste délibérément pas.

Les verbes

--maintain poursuit une passe de détection de visages que vous avez lancée dans l’application et n’en démarre jamais une : faire passer un détecteur sur chaque photo de votre bibliothèque n’est pas une chose à déclencher pour vous à trois heures du matin. Elle ne télécharge rien non plus : un modèle sémantique absent de la machine donne une ligne ignorée et non une surprise sur votre connexion. Et elle respecte vos cadences au lieu de les court-circuiter — un --maintain quotidien avec une sauvegarde hebdomadaire prend une sauvegarde par semaine.

Sur quelle bibliothèque il agit

FastLoupe --catalog D:\Pictures\zappic.db --check
FastLoupe D:\Pictures\zappic.db --backup

--catalog <chemin> sélectionne la bibliothèque, et un simple chemin vers un .db fait la même chose sans option devant — pour un lanceur, une association de fichiers ou un fichier déposé sur l’application. L’un comme l’autre se combine avec tous les verbes.

À côté d’un verbe, il sélectionne la bibliothèque pour cette exécution seulement. Il ne devient délibérément pas la bibliothèque que vous trouverez ouverte demain matin : la même option lors d’un lancement ordinaire, elle, persiste, parce qu’une fenêtre s’ouvre et vous montre vers quoi elle a basculé — et une tâche qui tourne à trois heures du matin n’a personne à qui montrer quoi que ce soit. --lang <culture> définit la langue pour une exécution de la même manière.

Trois codes de sortie

Tout allait bien

0

Cela s’est exécuté, et il n’y a rien à regarder.

Quelque chose demande attention

2

Cela s’est exécuté, et la sortie dit quoi : des fichiers ignorés, un disque absent, une sauvegarde en retard, une passe interrompue.

Refusé, ou impossible

1

Rien n’a été accompli. La raison est sur la sortie d’erreur.

Le 2 est le code autour duquel tout l’ensemble est conçu. Terminé, quatre fichiers ignorés n’est pas un échec — le travail a été publié et la passe suivante les réessaie d’elle-même — et le signaler comme tel produit exactement l’alerte que quelqu’un finira par désactiver. Ce n’est pas non plus une exécution propre. Une règle de supervision qui traite 1 comme réveille-moi et 2 comme regarde ça demain est la lecture prévue. --check en est l’illustration la plus nette : 1 signifie que rien n’a été mesuré, et 2 que cela a été mesuré et que c’est mauvais.

Sous Windows, redirigez la sortie

FastLoupe --check > check.log 2>&1

Sous Windows, FastLoupe est un programme fenêtré. Il s’attache à la console qui l’a démarré pour que les lignes apparaissent, mais un interpréteur de commandes n’attend pas un programme fenêtré : l’invite revient aussitôt et la sortie s’affiche en dessous. Rediriger ou utiliser un tube fait attendre l’interpréteur, et c’est de toute façon ce que veut un journal.

Une tâche planifiée, elle, attend le processus et lit correctement le code de sortie dans les deux cas — et c’est bien l’usage auquel ces verbes sont destinés.

La planifier

Le Planificateur de tâches Windows conserve le résultat de la dernière exécution, c’est-à-dire le code de sortie ci-dessus : une passe nocturne est donc visible sans que personne lise un journal. Pointez-le sur l’exécutable de FastLoupe, là où votre installation l’a placé.

schtasks /create /tn "FastLoupe nightly" /sc daily /st 03:00 ^
  /tr "\"%LOCALAPPDATA%\Programs\FastLoupe\FastLoupe.exe\" --maintain"

Sous macOS, l’équivalent est un agent launchd. La version macOS est désormais sur le Mac App Store — voici la forme que prend sa planification.

~/Library/LaunchAgents/com.oddbrd.fastloupe.maintain.plist

<key>ProgramArguments</key>
<array>
  <string>/Applications/FastLoupe.app/Contents/MacOS/FastLoupe</string>
  <string>--maintain</string>
</array>
<key>StartCalendarInterval</key>
<dict><key>Hour</key><integer>3</integer><key>Minute</key><integer>0</integer></dict>

launchctl load ~/Library/LaunchAgents/com.oddbrd.fastloupe.maintain.plist

Les règles communes à tous les verbes

Ce qui est traduit et ce qui ne l’est pas

Tout ce qui énonce un fait sur votre bibliothèque — une ligne de progression, le résultat d’une passe, un constat de santé, un résumé d’importation — est une chaîne traduite de l’application elle-même : un terminal se lit donc exactement comme la fenêtre, dans la même langue.

Les mots propres à la ligne de commande sont en anglais : les pages d’aide, no such folder, a catalogue that will not open, une combinaison refusée. C’est ce que fait aussi tout autre message console de ce programme.