自動化
すべてのコマンドは --json を受け付けます。
標準出力 (stdout) には正確に1つのJSONドキュメントが出力され、成功時には標準エラー出力 (stderr) は何も出力せず、カラー表示も適用されません。
list と tag を除くすべてのコマンドは --timing を受け付け、通常(人間用)モードではフェーズごとのテーブルを表示し、--json モードでは同一のブロックをJSONドキュメント内にマージします。
--progress は標準エラー出力に進捗バーを描画するもので、--json との併用は拒否されます。
終了コード:0 成功、1 実行時エラー(標準出力にエラーのエンベロープが含まれます)、2 使用方法のエラー(clap が標準エラー出力に出力します)。
コマンドごとの dry-run:
| プレビュー | dry-run の意味 |
|---|---|
status | コマンド全体(backup に --dry-run がないのは設計通り) |
gc --dry-run、prune --dry-run | plan のみ、削除なし |
rollback、export | なし(rollback は定義上破壊的、export は空ディレクトリ前提で可逆のため) |
フラグマトリクス、エンベロープ、コマンドごとのペイロード、互換性の約束などの完全な規約については docs/json.md を参照してください。 そのページがリファレンスであり、本ドキュメントでは重複記載を行いません。