コマンドライン

1つのオプション、1回のパス、1つの終了コード

FastLoupe [<ライブラリ>.db | --catalog <パス>] [動詞]

動詞を付けなければ、いつもどおりウィンドウが開きます。以下の動詞を付けた場合は、代わりに1回のパスを実行して終了します。常駐サービスも --watch もなく、覚えるべきサブコマンドの階層もありません。

ここに挙げるのは、人やランチャー、スケジュール済みタスクが入力するコマンドです。スクリプト用および開発者向けのモードは別のもので、規則も異なります。--help は意図的にそれらを一覧しません。

動詞

--maintain は、アプリで始めた顔検出のパスを続けるだけで、自分から始めることはありません。ライブラリのすべての写真に検出器をかけるのは、深夜3時に本人の代わりに始めてよい種類の処理ではないからです。ダウンロードも一切行わないため、セマンティックのモデルがマシンにない場合は1行スキップされるだけで、回線に不意の負荷がかかることもありません。設定した間隔も上書きせずに守ります。毎晩の --maintain でも、バックアップが週1回の設定なら、取られるバックアップは週に1回です。

どのライブラリに対して動くか

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

--catalog <パス> でライブラリを選びます。.db へのパスだけを書いても同じで、こちらはランチャーやファイルの関連付け、アプリにドロップされたファイルのためのものです。どちらもすべての動詞と組み合わせられます。

動詞と並べた場合、選ばれるのはその実行のあいだだけです。翌朝あなたが開くライブラリが変わってしまうことは、意図的にありません。通常の起動時に同じオプションを付けた場合は記憶されますが、それはウィンドウが開いて何に切り替わったかを見せられるからです。深夜3時に走るタスクには、見せる相手がいません。--lang <カルチャー> も同じように、1回の実行だけ言語を切り替えます。

3つの終了コード

問題なし

0

実行され、見るべきものはありません。

注意が必要

2

実行され、出力がその内容を伝えます。スキップされたファイル、未接続のドライブ、期限を過ぎたバックアップ、停止したパスなどです。

拒否、または実行不能

1

何も行われていません。理由は標準エラー出力に表示されます。

この一式全体が設計の中心に置いているのは 2 です。4件をスキップして完了は失敗ではありません。作業は公開されており、次のパスが自動的に再試行します。これを失敗として報告すれば、いずれ誰かが黙らせるアラートになるだけです。とはいえ、きれいな実行でもありません。1 をすぐ起こして、2 を明日見ればよいとして扱う監視ルールが、想定している読み方です。--check がいちばん分かりやすい例で、1 は何も測れなかったこと、2 は測れた上で状態が悪いことを意味します。

Windows では出力をリダイレクトしてください

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

Windows では FastLoupe はウィンドウを持つプログラムです。行が表示されるよう、起動元のコンソールに接続はしますが、コンソールのシェルはウィンドウを持つプログラムを待ちません。プロンプトはすぐに戻り、出力はその下に現れます。リダイレクトやパイプを使えばシェルは待ちますし、ログを残すならどのみちそれが望ましい形です。

スケジュール済みタスクはどちらの場合もプロセスを待ち、終了コードを正しく読み取ります。これらの動詞が本来想定しているのは、その呼び出し方です。

スケジュール実行する

Windows のタスク スケジューラは前回の実行結果、つまり上記の終了コードを保存します。夜間のパスの結果は、誰もログを読まなくても分かります。指定先は、お使いの環境で FastLoupe の実行ファイルが置かれている場所にしてください。

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

macOS での対応物は launchd のエージェントです。macOS 版は Mac App Store で提供中です。スケジュール設定は次のような形になります。

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

すべての動詞に共通する決まり

翻訳されるもの、されないもの

ライブラリについての事実を述べるもの — 進捗の行、パスの結果、状態の1行、取り込みの要約 — は、アプリケーション自身の翻訳済みの文字列です。ターミナルの表示は、ウィンドウとまったく同じ言葉で、同じ言語になります。

コマンドライン自身の言葉は英語です。使い方のページ、no such folder、a catalogue that will not open、拒否された組み合わせなどです。このプログラムが出力するほかのコンソールメッセージも同じ扱いです。