TypeSpec ファイルをインポートする

TypeSpec（Microsoft）は専用の言語で API を記述し、それを OpenAPI へコンパイルします。 Restorm もこの経路をたどります。

インポート

ファイル ▸ インポート（Ctrl+I）から、ディスク上の .tsp ファイルを選択します。

Restorm は同梱の TypeSpec コンパイラーでファイルを OpenAPI 3.x にコンパイルし、その結果を OpenAPI インポートに渡します。 そのため、まったく同じ充実したツリーが得られます。タグごとのフォルダー、型付きリクエスト、ドキュメント、事前設定されたセキュリティです。

信頼モデル

.tsp の内容は隔離された一時フォルダーにコピーされ、そこに Restorm が自身の依存関係をマウントします。 その結果、ソースファイルの隣にある tspconfig.yaml や node_modules は一切参照されません。したがって、コンパイルがお使いのツリーにある任意のコードを実行することはありません。

制限事項

• ローカルファイルのみ。 貼り付けと URL からのインポートは、明示的なメッセージとともに拒否されます。
• 単一ファイルの仕様のみ。 隣接する .tsp への相対インポートは解決されません。これは上記の隔離から直接生じる帰結です。モデルが複数のファイルに分かれている場合は、自分で OpenAPI にコンパイルして、その結果をインポートしてください。