echolot import y export

echolot import convierte lo que tienes en archivos de espacio de trabajo: un comando cURL, una colección de Postman, Insomnia, Paw o Bruno, una especificación OpenAPI o Swagger, un archivo HAR. echolot export escribe un espacio de trabajo, o una de sus carpetas, como colección de Postman, Insomnia o Bruno, o como copia del espacio de trabajo de Echolot. Hacen lo que hacen Archivo › Importar… y Archivo › Exportar espacio de trabajo… en la app; mira importar y exportar.

echolot importCopy Anchor Link

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

<file> es el archivo que importar, una carpeta de colección de Bruno, o - para leer la entrada estándar.

El formato se deduce del contenido. Una colección o una especificación acaba en una carpeta propia; un comando cURL se convierte en una solicitud. Las rutas de lo que se escribió van a la salida estándar, una por línea, y un resumen a la salida de error estándar:

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

Las credenciales nunca van a los archivos. Las contraseñas, los tokens, las claves de API y otros valores secretos que se encuentran en los ajustes de autenticación y en las cabeceras de credenciales se convierten en variables secretas, con el nombre de la solicitud y del campo (me_password), y el archivo conserva {{me_password}}. En un Mac van al llavero. Sin llavero (Linux, CI, ECHOLOT_KEYCHAIN=0), el valor se deja fuera y Echolot nombra la variable ECHOLOT_SECRET_<NAME> que hay que fijar. El informe nombra los secretos, nunca sus valores.

Importar una especificación crea una carpeta que sigue la especificación. Echolot lo dice (note: the folder follows …); mantenla al día con echolot spec check y apply.

OpcionesCopy Anchor Link

echolot exportCopy Anchor Link

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

<output> es dónde escribir: un archivo para Postman e Insomnia, una carpeta para Bruno, para un espacio de trabajo de Echolot y para Postman con entornos.

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

Lo que un formato no puede contener se nombra en la salida de error estándar: las solicitudes que no admite (left out:) y las partes que cambian por el camino, como las capturas de respuesta o los valores dinámicos que la otra herramienta no tiene.

Los valores secretos nunca se escriben. Las variables secretas salen solo por su nombre. Echolot avisa de cualquier credencial que esté escrita en un campo de autenticación o de cabecera en lugar de guardada en una variable secreta, porque esa se escribe tal cual.

Echolot nunca escribe sobre el espacio de trabajo desde el que exportas, ni dentro de él ni a su alrededor, y nunca sustituye nada en la ruta de salida salvo que indiques --force; lo que sustituye va a la Papelera.

OpcionesCopy Anchor Link

Códigos de salidaCopy Anchor Link