CLI ワークフロー

CLI は Formulon の最も軽量な surface です。ホスト言語の integration を書かずに、shell・CI・問題再現でスプレッドシート計算を使いたいときに便利です。

用語: standalone バイナリ

Formulon と最小限のコマンドランナーをリンクした単一実行ファイル。Node / Python / 共有ライブラリは不要です。GitHub Releases から (os, arch) 別に配布されます。

主なコマンド:

• eval: 名前付き profile で式を評価
• recalc: ワークブックを再計算して保存
• dump: ワークブック構造や計算値を確認

ホスト言語の integration を書く前に CLI で問題を再現できます。

例

formulon --version
formulon eval '=SUM(1,2,3)'
formulon eval --json '=1/0'
formulon recalc input.xlsx -o output.xlsx
formulon dump --formulas input.xlsx
formulon dump --values output.xlsx
formulon dump --sheets input.xlsx
formulon dump --metadata input.xlsx

--values は再計算する。--formulas は再計算しない

dump --values は表示前に再計算するため、最新結果を見られます。dump --formulas と dump --metadata は副作用と再計算を避けるためにスキップします。

CI での使い方

recalc と dump --values で計算値スナップショットを golden に対して取れます。同じワークブック + profile に対して CLI は決定論的なので、ダンプファイルへの git diff が安定したシグナルになります。

formulon recalc model.xlsx -o /tmp/model.recalc.xlsx --quiet
formulon dump --values /tmp/model.recalc.xlsx > model.values.txt
git diff --exit-code model.values.txt

数式だけ追うなら:

formulon dump --formulas model.xlsx > model.formulas.txt
git diff --exit-code model.formulas.txt

cached value に依存せずに数式編集を検知できます。

volatile は決定論的ではない

NOW / TODAY / RAND / RANDBETWEEN や一部のネットワーク関数は呼び出すたびに値が変わります。CI スナップショット fixture では避けるか、ワークブック側で固定値に置き換えてください。

次に読むもの

• CLI リファレンス ─ コマンド構文
• CI 回帰検査の例 ─ CI gating パターン
• CI でワークブック回帰検査 ─ パイプライン例