APIの仕様を、明示的な操作の入口へ。

Rustの共通CLIが仕様の選別・照合を担い、プロバイダーが個別の通信と認証を担います。公開バイナリの実行結果から、その境界を説明します。

構成をたどる

仕様の読み込み、明示的に選択した操作、元データのhash、プロバイダーの実行契約を分離します。今回の実行ではOpenAPIの合成入力を読み、GET /inspectionの経路情報を取り出しました。

カタログの生成や経路の表示はローカルで完結します。プロバイダーへの対応付けがない操作を、通信や認証へ勝手につなげません。外部サービスを実際に操作するには、別の明示的な契約が必要です。

大きな万能CLIにすべてを集約せず、共通の照合とプロバイダー固有の実装を分けています。汎用性のために権限を暗黙に広げることや、仕様を読んだだけで安全な実操作とみなすことはしません。

v0.2.2でversion、api project、api routesを実行し、実際の入力と出力をexamples/zixに保持しました。認証情報、外部通信、実データ操作は使っていません。書込み可能範囲を限定したファイルだけを受け入れる動作も確認しています。

入力、実行結果、ソースから確認できます。