k6-cucumber-steps 1.0.27 → 1.0.29

package/README.md

@@ -19,13 +19,19 @@ Run [k6](https://k6.io/) performance/load tests using [Cucumber](https://cucumbe
 ## ✨ Features
 
 - ✅ Cucumber + Gherkin for writing k6 tests
+  to generate JSON and HTML reports.
+- ✅ Flexible configuration through Cucumber data tables.
 - ✅ Support for JSON body parsing and escaping
-- ✅ Faker support (`{{faker.name.firstName}}`)
+- ✅ Dynamic request body generation using environment variables, Faker templates, and JSON file includes.
 - ✅ `.env` + `K6.env`-style variable resolution (`{{API_KEY}}`)
 - ✅ Support for headers, query params, stages
+- ✅ Supports multiple authentication types: API key, Bearer token, Basic Auth, and No Auth.
+
 - ✅ Clean-up of temporary k6 files after execution
 - ✅ Built-in support for **distributed load testing** with stages
 - ✅ TypeScript-first 🧡
+- ✅ **Optional report overwriting**: Use the `overwrite` option to control whether reports are overwritten or appended.
+- ✅ **Generate detailed reports**: Use the `--reporter` flag
 
 ---
 
@@ -49,7 +55,8 @@ The `run` command accepts the following options:
 
 - `-f, --feature <path>`: Path to the feature file to execute.
 - `-t, --tags <string>`: Cucumber tags to filter scenarios (e.g., `@smoke and not @regression`).
-- `-r, --reporter`: Generate HTML and JSON reports in the `reports` directory. This is a boolean flag, so just include `-r` or `--reporter` to enable it.
+- `-r, --reporter`: Generate HTML and JSON reports in the `reports` directory. This is a boolean flag, so just include `-r, --reporter` to enable it.
+- `-o, --overwrite`: Overwrite existing reports instead of appending them.
 
 ### Example Usage with Options
 
@@ -116,6 +123,7 @@ Here's a step-by-step guide to using `k6-cucumber-steps` in your project:
         "html:reports/report.html", // For HTML report (requires @cucumber/html-formatter)
       ],
       tags: process.env.TAGS,
+      overwrite: false, // Default to not overwrite the report file
     };
     ```
 

package/bin/k6-cucumber-runner.js

@@ -1,74 +1,104 @@
 #!/usr/bin/env node
 
-console.log("-----------------------------------------");
-console.log("🚀 Starting k6-cucumber-steps execution...");
-console.log("-----------------------------------------");
-
 const path = require("path");
 const { spawn } = require("child_process");
+const fs = require("fs");
 require("dotenv").config();
-const argv = require("yargs")
-  .usage("Usage: $0 run [options]") // Removed the --feature requirement from usage
+const yargs = require("yargs");
+
+const argv = yargs
+  .usage("Usage: $0 run [options]")
   .option("feature", {
     alias: "f",
     describe: "Path to the feature file",
     type: "string",
-  }) // Keep the option but don't demand it
-  .option("tags", { alias: "t", describe: "Cucumber tags", type: "string" })
+  })
+  .option("tags", {
+    alias: "t",
+    describe: "Cucumber tags to filter scenarios (e.g., @smoke)",
+    type: "string",
+  })
+  .option("configFile", {
+    alias: "c",
+    describe: "Custom cucumber config file name (default: cucumber.js)",
+    type: "string",
+  })
   .option("reporter", {
     alias: "r",
-    describe: "Generate reports",
+    describe: "Generate HTML and JSON reports in the reports directory",
+    type: "boolean",
+    default: false,
+  })
+  .option("overwrite", {
+    alias: "o",
+    describe: "Overwrite existing reports instead of appending them",
     type: "boolean",
     default: false,
   })
   .help().argv;
 
-const cucumberCommand = "npx";
 const cucumberArgs = [
   "cucumber-js",
   "--require-module",
   "@babel/register",
   "--require",
-  path.resolve(
-    process.cwd(),
-    "node_modules",
-    "k6-cucumber-steps",
-    "step_definitions"
-  ),
-  "--require",
-  path.resolve(process.cwd(), "step_definitions"), // Keep the user's local step definitions as well
+  path.resolve(__dirname, "../step_definitions"),
   "--format",
   "summary",
   "--format",
-  "progress", // Add this line
+  "progress",
 ];
 
-const tagsFromEnv = process.env.TAGS || " ";
-cucumberArgs.push("--tags", tagsFromEnv);
+// Handle dynamic config file name
+const configFileName =
+  "cucumber.js" || process.env.CUCUMBER_CONFIG_FILE || argv.configFile;
+const cucumberConfigPath = path.resolve(process.cwd(), configFileName);
+if (fs.existsSync(cucumberConfigPath)) {
+  cucumberArgs.push("--config", cucumberConfigPath);
+}
+
+// Add tags from CLI or environment variables
+if (argv.tags) {
+  cucumberArgs.push("--tags", argv.tags);
+} else if (process.env.TAGS) {
+  cucumberArgs.push("--tags", process.env.TAGS);
+}
 
+// Add feature file if provided
 if (argv.feature) {
   cucumberArgs.push(path.resolve(process.cwd(), argv.feature));
 }
 
+// Add reporting options if enabled
 if (argv.reporter) {
   const reportsDir = path.resolve(process.cwd(), "reports");
+  try {
+    fs.mkdirSync(reportsDir, { recursive: true });
+  } catch (err) {
+    console.error(`Failed to create reports directory: ${err.message}`);
+    process.exit(1);
+  }
   cucumberArgs.push(
     "--format",
-    `json:${reportsDir}/load-results.json`,
+    `json:${path.join(reportsDir, "load-results.json")}`,
     "--format",
-    `html:${reportsDir}/load-results.html`
+    `html:${path.join(reportsDir, "load-results.html")}`
   );
 }
 
-async function main() {
-  const cucumberProcess = spawn(cucumberCommand, cucumberArgs, {
-    cwd: process.cwd(),
-    stdio: "inherit",
-  });
-
-  cucumberProcess.on("close", (code) => {
-    process.exit(code);
-  });
-}
+const cucumberProcess = spawn("npx", cucumberArgs, {
+  stdio: "inherit",
+  env: {
+    ...process.env,
+    K6_CUCUMBER_OVERWRITE: argv.overwrite ? "true" : "false",
+  },
+});
 
-main().catch((err) => console.error(err));
+cucumberProcess.on("close", (code) => {
+  if (code === 0) {
+    console.log("✅ k6-cucumber-steps execution completed successfully.");
+  } else {
+    console.error("❌ k6-cucumber-steps execution failed.");
+  }
+  process.exit(code);
+});

package/cucumber.js

@@ -4,10 +4,11 @@ module.exports = {
   require: ["./step_definitions/**/*.js"],
   format: [
     "summary",
-    "json:reports/load-report.json",
-    "html:reports/report.html",
+    "json:src/examples/reports/load-report.json",
+    "html:src/examples/reports/report.html",
   ],
   // Specify the path to your features folder here
-  paths: ["./features"],
+  paths: ["./src/examples/features/loadTestTemplate.feature"],
   tags: "@loadTest", // Default tag for load tests
+  overwrite: false, // Default to not overwrite the report file
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "k6-cucumber-steps",
-  "version": "1.0.27",
+  "version": "1.0.29",
   "main": "index.js",
   "license": "MIT",
   "repository": {

package/step_definitions/load_test_steps.js

@@ -175,8 +175,16 @@ Then(
     }
     try {
       const scriptContent = buildK6Script(this.config);
-      const scriptPath = await generateK6Script(scriptContent);
-      const stdout = await runK6Script(scriptPath);
+      const scriptPath = await generateK6Script(
+        scriptContent,
+        "load",
+        process.env.K6_CUCUMBER_OVERWRITE === "true"
+      );
+      const stdout = await runK6Script(
+        scriptPath,
+        process.env.K6_CUCUMBER_OVERWRITE === "true"
+      );
+      console.log(stdout);
     } catch (error) {
       console.error("k6 execution failed:", error.message);
       throw new Error("k6 test execution failed");

package/step_definitions/world.js

@@ -1,12 +1,16 @@
-const { setWorldConstructor } = require('@cucumber/cucumber');
+const { setWorldConstructor } = require("@cucumber/cucumber");
 
 class CustomWorld {
-  constructor() {
+  constructor({ parameters }) {
     this.options = {};
     this.configurations = {};
     this.endpoints = [];
-    this.authType = '';
+    this.authType = "";
     this.postBody = {};
+    this.overwrite =
+      parameters?.overwrite ||
+      process.env.K6_CUCUMBER_OVERWRITE === "true" ||
+      false;
   }
 }