echolot import и 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 становится одним запросом. Пути к записанному идут в стандартный вывод, по одному в строке, а сводка — в стандартный поток ошибок:

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 называет переменную ECHOLOT_SECRET_<NAME>, которую нужно задать. В отчёте названы секреты, но никогда не их значения.

Импорт спецификации создаёт папку, которая следует за спецификацией. 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