@thierryade/wdio

Reporter WebdriverIO + helper pour Thierryade : relie automatiquement vos tests e2e aux specs (raffinements compris) que vous avez documentées dans Thierryade, et pousse le résultat de chaque run CI directement vers l'outil.

Installation

pnpm add -D @thierryade/wdio

Usage

Dans votre wdio.conf.ts, ajoutez le reporter :

import { ThierryadeCoverageReporter } from "@thierryade/wdio";

export const config: WebdriverIO.Config = {
  // ...
  reporters: ["spec", ThierryadeCoverageReporter],
};

Dans vos specs, déclarez le code de la spec Thierryade (DRH-17) que chaque cas vérifie (un cas peut en déclarer plusieurs) :

import { covers } from "@thierryade/wdio";

describe("Billetterie", () => {
  it("démarre un paiement et revient confirmé sur le site", () => {
    covers("DRH-17");
    // ...
  });
});

Un raffinement est une spec comme une autre, avec son propre code. Les anciens codes de raffinage (DRH-R-9), d'avant la refonte de Thierryade, restent acceptés : ils désignent désormais la spec qui a repris ce raffinage.

Chaque worker WDIO écrit ses résultats dans e2e/.covers-results/<cid>.json (configurable via new ThierryadeCoverageReporter({ outDir: "..." })). Une fois la suite terminée, poussez-les vers Thierryade :

npx thierryade-wdio push-coverage \
  --covers-dir e2e/.covers-results \
  --thierryade-url https://thierryade.stationmyr.net \
  --thierryade-token "$THIERRYADE_UPLOAD_TOKEN" \
  --commit-sha "$GITHUB_SHA" \
  --ci-run-url "$CI_RUN_URL" \
  --argus-report-out argus-thierryade-report.json

--argus-report-out est optionnel : s'il est fourni, un second fichier JSON est écrit au format générique d'Argus (« format maison »), à uploader avec le snippet partagé upload-to-argus.sh :

sh upload-to-argus.sh custom argus-thierryade-report.json thierryade-coverage

Un code inconnu de Thierryade n'interrompt jamais le reste du push (il est juste signalé) ; une erreur de transport/HTTP, en revanche, fait échouer la commande.

--log-level debug|info|warning|error (défaut info, ou la variable d'environnement THIERRYADE_LOG_LEVEL -- utile pour le reporter, qui tourne dans le process WDIO et ne reçoit pas d'arguments CLI) règle la verbosité.

Développement

pnpm install
pnpm run build
pnpm run lint
pnpm run test