Die Befehlszeile

Ein Schalter, ein Durchgang, ein Exit-Code

FastLoupe [<Bibliothek>.db | --catalog <Pfad>] [Verb]

Ohne Verb öffnet sich wie gewohnt ein Fenster. Jedes Verb unten führt stattdessen einen Durchgang aus und beendet sich. Es gibt keinen Dienst, kein --watch und keinen Unterbefehlsbaum, den man lernen müsste.

Das sind die Befehle, die ein Mensch, ein Starter oder eine geplante Aufgabe eintippt. Die Skript- und Entwicklermodi sind eine andere Sache mit anderen Regeln; --help führt sie bewusst nicht auf.

Die Verben

--maintain setzt einen in der App begonnenen Durchgang zur Gesichtserkennung fort und beginnt nie einen: einen Detektor über jedes Foto Ihrer Bibliothek laufen zu lassen, ist nichts, was man um drei Uhr morgens für Sie anstößt. Heruntergeladen wird auch nichts, ein nicht vorhandenes semantisches Modell ist also eine übersprungene Zeile und keine Überraschung auf Ihrer Leitung. Und die eingestellten Intervalle werden befolgt statt übergangen — ein nächtliches --maintain nimmt bei wöchentlicher Sicherung eine Sicherung pro Woche.

Auf welche Bibliothek er wirkt

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

--catalog <Pfad> wählt die Bibliothek, und ein bloßer Pfad zu einer .db tut dasselbe ohne Schalter davor — für einen Starter, eine Dateizuordnung oder eine auf die Anwendung gezogene Datei. Beides lässt sich mit jedem Verb kombinieren.

Neben einem Verb wählt es die Bibliothek nur für diesen Lauf. Es wird bewusst nicht zu der Bibliothek, die Sie morgen früh geöffnet vorfinden: derselbe Schalter bei einem gewöhnlichen Start bleibt sehr wohl bestehen, weil sich dabei ein Fenster öffnet und zeigt, wohin gewechselt wurde — und eine Aufgabe um drei Uhr morgens hat niemanden, dem sie etwas zeigen könnte. --lang <Kultur> setzt die Sprache auf dieselbe Weise für einen Lauf.

Drei Exit-Codes

Alles war in Ordnung

0

Es lief, und es gibt nichts anzusehen.

Etwas erfordert Aufmerksamkeit

2

Es lief, und die Ausgabe benennt was: übersprungene Dateien, ein nicht verbundenes Laufwerk, eine überfällige Sicherung, ein gestoppter Durchgang.

Verweigert oder nicht möglich

1

Es wurde nichts erledigt. Der Grund steht auf der Standardfehlerausgabe.

Die Zwei ist der Code, um den herum das Ganze entworfen ist. Abgeschlossen, vier Dateien übersprungen ist kein Fehlschlag — die Arbeit wurde veröffentlicht und der nächste Durchgang versucht es von selbst erneut — und sie als solchen zu melden, erzeugt genau die Warnung, die jemand abschaltet. Ein sauberer Lauf ist es aber auch nicht. Eine Überwachungsregel, die 1 als weck mich und 2 als sieh es dir morgen an behandelt, ist die vorgesehene Lesart. --check ist das schärfste Beispiel: 1 heißt, es wurde nichts gemessen, und 2 heißt, es wurde gemessen und ist schlecht.

Unter Windows die Ausgabe umleiten

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

Unter Windows ist FastLoupe ein Fensterprogramm. Es hängt sich an die Konsole, aus der es gestartet wurde, damit die Zeilen überhaupt erscheinen — aber eine Konsolen-Shell wartet nicht auf ein Fensterprogramm: die Eingabeaufforderung kommt sofort zurück und die Ausgabe erscheint darunter. Umleiten oder eine Pipe lässt die Shell warten und ist ohnehin das, was ein Protokoll will.

Eine geplante Aufgabe wartet auf den Prozess und liest den Exit-Code in beiden Fällen korrekt — und das ist der Aufruf, für den diese Verben eigentlich da sind.

Zeitgesteuert ausführen

Die Windows-Aufgabenplanung speichert das letzte Ausführungsergebnis, also den Exit-Code von oben, sodass ein nächtlicher Durchgang sichtbar ist, ohne dass jemand ein Protokoll liest. Richten Sie sie auf FastLoupes eigene ausführbare Datei, wo Ihre Installation sie abgelegt hat.

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

Unter macOS ist das Gegenstück ein Launch Agent. Die macOS-Ausgabe ist jetzt im Mac App Store — dies ist die Form, in der ein Durchgang dort eingeplant wird.

~/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

Regeln, die für jedes Verb gelten

Was übersetzt wird und was nicht

Alles, was eine Tatsache über Ihre Bibliothek feststellt — eine Fortschritts- zeile, das Ergebnis eines Durchgangs, eine Zustandsangabe, eine Importzusammenfassung — ist eine übersetzte Zeichenkette der Anwendung selbst, sodass sich ein Terminal genau wie das Fenster liest, in derselben Sprache.

Die eigenen Worte der Befehlszeile sind Englisch: die Hilfeseiten, no such folder, a catalogue that will not open, eine abgelehnte Kombination. Das gilt für jede andere Konsolenmeldung dieses Programms genauso.