実行環境
Formulon は 1 つの計算コアを複数の実行環境から使えるようにします。数式の意味ではなく、どこに配置してどう動かすかで選びます。2 つの実行環境でワークブック結果が変わる場合、それは不具合か、文書化された互換性差分として扱います。
同じエンジン、異なる実行環境
WASM、Python、Native Node、CLI は計算結果を共有するべきです。変わるのはパッケージング、ファイルアクセス、メモリ所有権、起動コスト、エラーの受け渡しです。
| 実行環境 | 選ぶ条件 |
|---|---|
| WASM | ブラウザ、worker、ネイティブアドオン前提なしの Node |
| Python | スクリプト、ノートブック、データパイプライン、一括再計算 |
| Native Node | プラットフォーム別の .node アドオンを配置できる Node サービス |
| CLI | シェル処理、CI スナップショット、問題の再現 |
| CI 回帰検査 | 自動チェックでワークブック差分を取りたい場合 |
判断ルール
共通コア
C++17 計算コア
ABI
C ABI
実行入口
WASM
Native Node
Python
CLI
実行環境
ブラウザ / workernative 不要な Node
Node サービスnative 配置可
バッチ / ノートブックデータパイプライン
シェル / CI再現レポート
- ワークブックデータがブラウザにある、アップロード時の privacy が重要、サーバーに raw file を渡したくない場合は WASM。
- 帳票生成、定期ジョブ、データ検証、ノートブックなら Python。
- ネイティブ成果物を配置でき、WASM より低い起動コストが必要な Node サービスなら Native Node。
- 再現可能な issue report、CI スナップショット、単発の再計算チェックなら CLI。
API の実行入口
詳細 API ページはトップレベルのナビゲーションには置かず、この実行環境セクションにまとめています。
| API ページ | 目的 |
|---|---|
| API 一覧 | パッケージごとの役割とホスト側の責務を比較 |
| WASM API | ブラウザ / worker での使い方と lifetime 管理 |
| Python API | 一括再計算とワークブック検査 |
| CLI リファレンス | シェル自動化と CI での利用 |
ここで決めないこと
実行環境の選択だけでは Excel 互換性は保証できません。重要なワークブックで使う前に 互換性 を確認し、自分のファイルで検証してください。