CLI リファレンス

トップレベル

formulon <command> [options]
formulon --version
formulon --help

用語: 終了コード

CLI は 2 層の規約に従います。セル単位の Excel エラー（#DIV/0!、#VALUE! など）は stdout に出力し、プロセスは 0 を返します。コマンド自体は成功しており、数式が error 値を返しただけです。構造的失敗（ファイル無し・bytes 不正・engine 内部失敗）は非ゼロを返し、シェルスクリプトから $? で分岐できます。

`eval`

formulon eval [--json] [--repeat N] <formula>

新規ワークブックで 1 式を評価します。leading = の有無は問いません。

フラグ	効果
`--json`	文字列ではなく構造化 JSON で出力
`--repeat N`	同じ式を `N` 回評価。マイクロベンチ用途

formulon eval '=SUM(1,2,3)'        # → 6
formulon eval --json '=1/0'         # → {"kind":"error","code":"#DIV/0!", ...}

セル単位エラーは stdout、exit 0。構造的失敗は非ゼロ。

`recalc`

formulon recalc [--iterative] [--quiet] <in.xlsx> -o <out.xlsx>

.xlsx をロードして再計算し、新しいワークブックを書き出します。

フラグ	効果
`--iterative`	意図的な循環参照のために iterative calculation を有効化
`--quiet`	進捗 / status 出力を抑制

`dump`

formulon dump [--formulas|--values|--sheets|--metadata] <in.xlsx>

モード	出力
`--formulas`	stable order の数式セル。default
`--values`	再計算後の non-blank セル
`--sheets`	document order のシート名
`--metadata`	defined name、table、passthrough parts

CI での使い方

dump --formulas / --metadata は再計算しないので、PR ごとに走らせても安価です。dump --values は事前に再計算するため、計算値スナップショットの golden 比較に向きます。

次に読むもの

CLI ワークフロー ─ シェルパイプラインへの組み込み
CI でワークブック回帰検査 ─ CI 例

CLI リファレンス ​

トップレベル ​

eval ​

recalc ​

dump ​