echolot run

echolot run envoie les requêtes d’un espace de travail dans leur ordre, exécute leurs scripts et leurs vérifications, et indique ce qui a réussi. C’est l’Exécution sans la fenêtre, pensée pour la CI. Il exécute aussi une collection Postman telle quelle, sans l’importer.

echolot run [<options>] <source>

<source> est un dossier d’espace de travail (celui qui contient workspace.toml) ou un fichier de collection Postman.

Exécuter un espace de travailCopy Anchor Link

echolot run Alpenglow.echolot --folder auth/sign-in --folder catalog

catalog, auth/sign-in

✓ POST   auth/sign-in  200 150 ms
    ✓ Status equals 200
    ✓ JSON value $.access_token exists
✓ GET    catalog/list-products  200 74 ms
    ✓ Status equals 200
    ✓ JSON value $.items.length is greater than 0
    ✓ Header Content-Type contains json
    ✓ Response time (ms) is less than 1000
✓ GET    catalog/search  200 69 ms
    ✓ Status equals 200
✓ GET    catalog/get-product  200 70 ms
    ✓ Status equals 200
    ✓ JSON value $.sku equals {{productId}}
✓ GET    catalog/categories  200 73 ms
    ✓ Status equals 200
✓ GQL    catalog/search-products  200 37 ms
✓ GET    catalog/export  200 410 ms
    ✓ Status equals 200

All 7 requests passed  11/11 checks passed · 0.90 s

• Sans --folder, tout s’exécute. --folder accepte un dossier (catalog) ou une requête (auth/sign-in), sous forme de chemins de slugs sous requests/, et peut être donné plusieurs fois. Les requêtes s’exécutent dans l’ordre de l’espace de travail.
• --env accepte le nom de fichier de l’environnement sans .toml (staging) ou son nom (Staging).
• Les vérifications de chaque requête et ses résultats pm.test comptent. Une requête échoue quand elle ne reçoit aucune réponse ou qu’une vérification échoue ; l’exécution se termine alors avec le code 1.
• Les réponses capturées dans des variables, les jetons obtenus par les identifiants client OAuth 2 et les valeurs définies par les scripts se transmettent aux requêtes suivantes de l’exécution, comme dans l’app. Les valeurs des scripts ne durent que le temps de l’exécution et ne sont jamais écrites dans des fichiers.

Exécutions pilotées par les donnéesCopy Anchor Link

--data exécute tout une fois par ligne d’un fichier de données :

• Un fichier CSV avec une ligne d’en-tête : chaque colonne est une variable pour sa ligne.
• Un fichier JSON contenant un tableau d’objets : chaque clé est une variable.

echolot run Alpenglow.echolot --folder catalog/get-product --data skus.csv

catalog/get-product · skus.csv, 2 rows

✓ #1 GET    catalog/get-product  200 133 ms
    ✓ Status equals 200
    ✓ JSON value $.sku equals {{productId}}
✓ #2 GET    catalog/get-product  200 88 ms
    ✓ Status equals 200
    ✓ JSON value $.sku equals {{productId}}

All 2 requests passed  4/4 checks passed · 0.22 s

Les scripts lisent la ligne avec pm.iterationData. Sans fichier de données, --iterations répète l’exécution. --concurrency exécute ce nombre d’itérations en parallèle ; ce que définissent les scripts d’une itération lui reste propre.

RapportsCopy Anchor Link

--reporter choisit un rapport et peut être donné plusieurs fois. --out nomme le fichier de chaque rapport autre que console, dans l’ordre des options --reporter ; un rapport sans fichier va sur la sortie standard.

echolot run Alpenglow.echolot --env staging \
  --reporter console \
  --reporter junit --out results.xml \
  --reporter html --out report.html

Un rapport JUnit d’une exécution avec une vérification en échec :

<?xml version="1.0" encoding="UTF-8"?>
<testsuites name="Alpenglow" tests="4" failures="1" errors="0" time="0.377" timestamp="2026-11-01T09:23:04Z">
  <testsuite name="auth/sign-in" tests="2" failures="0" errors="0" skipped="0" time="0.155">
    <testcase name="Status equals 200" classname="auth.sign-in" time="0"/>
    <testcase name="JSON value $.access_token exists" classname="auth.sign-in" time="0"/>
  </testsuite>
  <testsuite name="auth/who-am-i" tests="1" failures="1" errors="0" skipped="0" time="0.083">
    <testcase name="Status equals 200" classname="auth.who-am-i" time="0">
      <failure message="expected “200”, got “401”" type="AssertionFailure"/>
    </testcase>
  </testsuite>
</testsuites>

Chaque rapport masque les valeurs secrètes, dans les URL, les en-têtes, les messages de vérification et les journaux : un rapport peut donc être conservé sans risque comme artefact de CI.

Exécuter une collection PostmanCopy Anchor Link

echolot run shop.postman_collection.json --env-file staging.postman_environment.json --data users.csv

La collection s’exécute telle quelle : Echolot la lit dans un espace de travail temporaire qui est jeté ensuite, et ses identifiants restent en mémoire. Ses scripts de pré-requête et de test s’exécutent, comme dans Newman. --env-file accepte un fichier d’environnement Postman ; --env est pour les espaces de travail. --folder peut nommer un dossier de la collection sans le dossier racine de la collection.

Pour continuer à travailler avec une collection, importez-la plutôt.

OptionsCopy Anchor Link

Codes de sortieCopy Anchor Link

Voir CI pour des pipelines complets, et secrets pour savoir d’où viennent les valeurs secrètes.