echolot import / echolot export

echolot import は、手元にあるものをワークスペースのファイルに変換します：cURLコマンド、Postman・Insomnia・Paw・Brunoのコレクション、OpenAPIまたはSwaggerの仕様、HARファイル。 echolot export は、ワークスペースまたはそのフォルダを、Postman・Insomnia・Brunoのコレクション、またはEcholotワークスペースのコピーとして書き出します。 アプリのファイル › 読み込む…とファイル › ワークスペースを書き出す…と同じことを行います。読み込みと 書き出しを参照してください。

echolot importCopy Anchor Link

echolot import <file> [--workspace <workspace>] [--folder <folder>] [--format <format>]

<file> は読み込むファイル、Brunoコレクションのフォルダ、または標準入力から読み込む - です。

形式は内容から判別されます。コレクションや仕様は専用のフォルダに入り、cURLコマンドは1つのリクエストになります。書き出されたもののパスは1行に1つずつ標準出力に、 概要は標準エラーに出力されます。

pbpaste | echolot import - -w Alpenglow.echolot --folder auth

Imported 1 request from cURL.
note: 1 credential kept out of the workspace files but not saved, as there is no Keychain here: auth_token_token. Set ECHOLOT_SECRET_AUTH_TOKEN_TOKEN where Echolot sends.
auth/auth-token

認証情報がファイルに保存されることはありません。 認証設定や認証情報のヘッダーにあるパスワード、トークン、APIキーなどのシークレットの値は、リクエストとフィールドにちなんだ名前 （me_password）のシークレット変数になり、ファイルには {{me_password}} が残ります。Macでは、値はキーチェーンに保存されます。キーチェーンがない場合（Linux、CI、 ECHOLOT_KEYCHAIN=0）は、値は保存されず、設定すべき ECHOLOT_SECRET_<NAME> 変数がEcholotから示されます。レポートにはシークレットの名前が表示され、値は表示されません。

仕様の読み込みでは、仕様に追従するフォルダが作成されます。Echolotはその旨を表示します（note: the folder follows …）。最新に保つには echolot spec check と applyを使います。

オプションCopy Anchor Link

echolot exportCopy Anchor Link

echolot export <output> [--workspace <workspace>] [--folder <folder>] --format <format> [--no-environments] [--force]

<output> は書き出し先です。PostmanとInsomniaではファイル、Bruno、Echolotワークスペース、環境付きのPostmanではフォルダです。

echolot export /tmp/alpenglow.postman_collection.json -w Alpenglow.echolot --format postman

Exported 21 requests, 7 folders, 3 environments as Postman Collection v2.1.
warning: 8 requests left out: Postman Collection v2.1 has no MCP requests. …
  left out: realtime/order-updates
  left out: inventory/reserve-stock
  …
warning: Response captures (Store in a Variable) are not exported; other tools set variables from scripts.
warning: 1 password, token or key is written in clear: it is typed into an auth or header field rather than kept in a secret variable. Move it to the Keychain before sharing the file.
/tmp/alpenglow.postman_collection.json

形式に含められないものは、標準エラーに表示されます：収められないリクエスト（left out:）と、変換の過程で変わる部分（レスポンスのキャプチャや、ほかのツールにない動的な値など）。

シークレットの値が書き出されることはありません。 シークレット変数は名前だけが出力されます。認証やヘッダーのフィールドに直接入力された認証情報は、シークレット変数に 保存されていないため、そのまま書き出されます。Echolotはそのような認証情報について警告します。

Echolotは、書き出し元のワークスペースの上書き、その内部への書き込み、その周辺への書き込みを決して行いません。また、--force を指定しない限り、出力パスにあるものを置き換えることもありません。 置き換えられたものはゴミ箱に入ります。

オプションCopy Anchor Link

終了コードCopy Anchor Link