echolot import et export

echolot import transforme ce que vous avez en fichiers d’espace de travail : une commande cURL, une collection Postman, Insomnia, Paw ou Bruno, une spec OpenAPI ou Swagger, un fichier HAR. echolot export écrit un espace de travail, ou l’un de ses dossiers, sous forme de collection Postman, Insomnia ou Bruno, ou de copie de l’espace de travail Echolot. Ils font ce que font Fichier › Importer… et Fichier › Exporter l’espace de travail… dans l’app ; voir importer et exporter.

echolot importCopy Anchor Link

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

<file> est le fichier à importer, un dossier de collection Bruno, ou - pour lire l’entrée standard.

Le format est déterminé d’après le contenu. Une collection ou une spec arrive dans un dossier à part ; une commande cURL devient une requête. Les chemins de ce qui a été écrit vont sur la sortie standard, un par ligne, et un résumé sur la sortie d’erreur :

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

Les identifiants n’entrent jamais dans les fichiers. Les mots de passe, jetons, clés d’API et autres valeurs secrètes trouvés dans les réglages d’authentification et les en-têtes d’identifiants deviennent des variables secrètes, nommées d’après la requête et le champ (me_password), et le fichier conserve {{me_password}}. Sur un Mac, elles vont dans le trousseau. Sans trousseau (Linux, CI, ECHOLOT_KEYCHAIN=0), la valeur est écartée et Echolot nomme la variable ECHOLOT_SECRET_<NAME> à définir. Le rapport nomme les secrets, jamais leurs valeurs.

L’import d’une spec crée un dossier qui suit la spec. Echolot l’indique (note: the folder follows …) ; gardez-le à jour avec echolot spec check et apply.

OptionsCopy Anchor Link

echolot exportCopy Anchor Link

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

<output> est l’endroit où écrire : un fichier pour Postman et Insomnia, un dossier pour Bruno, pour un espace de travail Echolot, et pour Postman avec les environnements.

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

Ce pour quoi un format n’a pas de place est nommé sur la sortie d’erreur : les requêtes qu’il ne peut pas contenir (left out:), et les éléments qui changent en route, comme les captures de réponse ou les valeurs dynamiques que l’autre outil n’a pas.

Les valeurs secrètes ne sont jamais écrites. Les variables secrètes sortent par leur nom seulement. Echolot signale tout identifiant saisi dans un champ d’authentification ou d’en-tête au lieu d’être conservé dans une variable secrète, puisque celui-là est écrit tel quel.

Echolot n’écrit jamais par-dessus l’espace de travail que vous exportez, ni dedans, ni autour, et il ne remplace jamais rien au chemin de sortie sans --force ; ce qu’il remplace va dans la corbeille.

OptionsCopy Anchor Link

Codes de sortieCopy Anchor Link