artes 1.2.17 → 1.2.19

package/src/helper/executers/helper.js

@@ -1,95 +1,98 @@
-function showHelp() {
-  console.log(`
-        🚀 Artes - Playwright Test Runner
-      
-        Description:
-            Artes is a test runner for Playwright that executes Cucumber tests
-            and can generate Allure reports.
-      
-        Usage: 
-            npx artes [options]
-      
-        Options:
-            🆘 -h, --help      Show this help message
-                Usage: artes -h or artes --help
-      
-            🏷️ -v, --version   Show current version of artes
-                Usage: artes -v or artes --version
-      
-            🏗️ -c, --create    Create example project with artes
-                Usage: artes -c or artes --create 
-      
-            ✅ -y, --yes       Skip confirmation prompt for creating example project
-                Usage:  artes -c -y or artes --create --yes
-      
-            📊 -r, --report    Run tests and generate Allure report
-                Usage:   artes -r or artes --report
-
-            ✅ --reportSuccess Generate screenshot and video record with also successful tests
-                Usage:   artes --reportSuccess
-
-            ⚡ --trace         Enable tracing for all tests
-                Usage:   artes --trace
-            
-            🔍 -rwt, --reportWithTrace Include trace in the report
-                Usage:   artes --reportWithTrace
-            
-            📄 --singleFileReport   Generate single file Allure report
-                Usage:   artes -r --singleFileReport
-
-            🗜️ --zip            Zip the report folder after generation
-                Usage:   artes -r --zip
-      
-            📁 --features      Specify one or more feature files' relative paths to run (comma-separated)
-                Usage:   artes --features "tests/features/Alma, tests/features/Banan.feature"
-
-            📜 --stepDef       Specify one or more step definition files' relative paths to use (comma-separated)
-                Usage:   artes --stepDef "tests/steps/login.js, tests/steps/home.js"
-      
-            🔖 --tags          Run tests with specified Cucumber tags
-                Usage:   artes --tags "@smoke and not @wip"
-      
-            🌐 --env           Set environment for the test run
-                Usage:   artes --env "dev"
-      
-            🕶️ --headless      Run browser in headless mode
-                Usage:   artes --headless
-      
-            ⚡ --parallel      Run tests in parallel mode
-                Usage:   artes --parallel 3
-      
-            🔁 --retry         Retry failed tests
-                Usage:   artes --retry 2
-      
-            🎭 --dryRun        Perform a dry run without executing tests
-                Usage:   artes --dryRun
-
-            📈 --percentage    Set minimum success percentage to pass test run
-                Usage:   artes --percentage 85
-
-            🌐 --browser       Specify browser to use (chromium, firefox, webkit)
-                Usage:   artes --browser chromium
-
-            🌐 --baseURL       Set base URL for the tests
-                Usage:   artes --baseURL "https://example.com"
-
-            📏 --maxScreen     Maximize browser window
-                Usage:   artes --maxScreen
-
-            📐 --width         Set browser width (default: 1280)
-                Usage:   artes --width 1920
-
-            📏 --height        Set browser height (default: 720)
-                Usage:   artes --height 1080
-
-            ⏱️ --timeout       Set timeout for each test step (default: 30 seconds)
-                Usage:   artes --timeout 10
-            
-            🐢 --slowMo        Slow down text execution for clear view (default: 0 seconds)
-                Usage:   artes --slowMo 1
-      `);
-}
-
-module.exports = {
-  showHelp,
-};
+function showHelp() {
+  console.log(`
+        🚀 Artes - Playwright Test Runner
+      
+        Description:
+            Artes is a test runner for Playwright that executes Cucumber tests
+            and can generate Allure reports.
+      
+        Usage: 
+            npx artes [options]
+      
+        Options:
+            🆘 -h, --help      Show this help message
+                Usage: artes -h or artes --help
+      
+            🏷️ -v, --version   Show current version of artes
+                Usage: artes -v or artes --version
+      
+            🏗️ -c, --create    Create example project with artes
+                Usage: artes -c or artes --create 
+      
+            ✅ -y, --yes       Skip confirmation prompt for creating example project
+                Usage:  artes -c -y or artes --create --yes
+
+            🚫 --noDeps       Skip installing dependencies when creating example project
+                Usage:  artes -c --noDeps or artes --create --noDeps
+      
+            📊 -r, --report    Run tests and generate Allure report
+                Usage:   artes -r or artes --report
+
+            ✅ --reportSuccess Generate screenshot and video record with also successful tests
+                Usage:   artes --reportSuccess
+
+            ⚡ --trace         Enable tracing for all tests
+                Usage:   artes --trace
+            
+            🔍 -rwt, --reportWithTrace Include trace in the report
+                Usage:   artes --reportWithTrace
+            
+            📄 --singleFileReport   Generate single file Allure report
+                Usage:   artes -r --singleFileReport
+
+            🗜️ --zip            Zip the report folder after generation
+                Usage:   artes -r --zip
+      
+            📁 --features      Specify one or more feature files' relative paths to run (comma-separated)
+                Usage:   artes --features "tests/features/Alma, tests/features/Banan.feature"
+
+            📜 --stepDef       Specify one or more step definition files' relative paths to use (comma-separated)
+                Usage:   artes --stepDef "tests/steps/login.js, tests/steps/home.js"
+      
+            🔖 --tags          Run tests with specified Cucumber tags
+                Usage:   artes --tags "@smoke and not @wip"
+      
+            🌐 --env           Set environment for the test run
+                Usage:   artes --env "dev"
+      
+            🕶️ --headless      Run browser in headless mode
+                Usage:   artes --headless
+      
+            ⚡ --parallel      Run tests in parallel mode
+                Usage:   artes --parallel 3
+      
+            🔁 --retry         Retry failed tests
+                Usage:   artes --retry 2
+      
+            🎭 --dryRun        Perform a dry run without executing tests
+                Usage:   artes --dryRun
+
+            📈 --percentage    Set minimum success percentage to pass test run
+                Usage:   artes --percentage 85
+
+            🌐 --browser       Specify browser to use (chromium, firefox, webkit)
+                Usage:   artes --browser chromium
+
+            🌐 --baseURL       Set base URL for the tests
+                Usage:   artes --baseURL "https://example.com"
+
+            📏 --maxScreen     Maximize browser window
+                Usage:   artes --maxScreen
+
+            📐 --width         Set browser width (default: 1280)
+                Usage:   artes --width 1920
+
+            📏 --height        Set browser height (default: 720)
+                Usage:   artes --height 1080
+
+            ⏱️ --timeout       Set timeout for each test step (default: 30 seconds)
+                Usage:   artes --timeout 10
+            
+            🐢 --slowMo        Slow down text execution for clear view (default: 0 seconds)
+                Usage:   artes --slowMo 1
+      `);
+}
+
+module.exports = {
+  showHelp,
+};

package/src/helper/executers/projectCreator.js

@@ -1,198 +1,201 @@
-#!/usr/bin/env node
-
-const fs = require("fs");
-const path = require("path");
-const { execSync } = require("child_process");
-
-function createProject(createYes) {
-  const projectDir = path.join(process.cwd(), "artes");
-  const srcDir = path.join(projectDir, "tests");
-
-  [
-    projectDir,
-    path.join(srcDir, "features"),
-    path.join(srcDir, "POMs"),
-    path.join(srcDir, "steps"),
-    path.join(projectDir, ".vscode"),
-  ].forEach((dir) => fs.mkdirSync(dir, { recursive: true }));
-
-  
-  console.log("🚀 Initializing project...");
-  execSync(`npm init ${createYes ? "-y" : ""}`, {cwd: projectDir,  stdio: "inherit" });
-  execSync("npm i artes", {cwd: projectDir, stdio: "inherit" });
-
-  console.log("📦 Setting up browsers...");
-  execSync("npx playwright install", {cwd: projectDir, stdio: "inherit" });
-
-  const packageJsonPath = path.join(projectDir, "package.json");
-  const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, "utf-8"));
-
-  if (packageJson.type) {
-    delete packageJson.type;
-  }
-
-  packageJson.scripts = {
-    test: "npx artes",
-    testWithReport: "npx artes -r",
-  };
-
-  fs.writeFileSync(packageJsonPath, JSON.stringify(packageJson, null, 2));
-
-  const config = `module.exports = {
-    headless: false, // Set to true for headless browser mode
-
-    // Configuration options:
-    // env: "",                      // string - Environment name for tests
-    // testPercentage: 0, // number - Minimum success rate percentage(Default: 0)
-    // baseURL: "",                  // string - Base URL for API tests
-    // paths: [],                    // string[] - Paths to feature files
-    // steps: "",                    // string - Step definitions files
-    // pomPath: "",                  // string - Path to POM files
-    // timeout : 0,                  // number - Test timeout in seconds
-    // slowMo: 0,                    // number - Slow down test execution (Default: 0 seconds)
-    // parallel: 0,                  // number - Number of parallel workers
-    // report: true                   / boolean - Generate report
-    // reportSuccess: false,         // boolean - Add screenshots and video records to report also for success test cases
-    // trace: false,                 // boolean - Enable tracing
-    // reportWithTrace: false,       // boolean - Include trace in report
-    // format: [],                   // string[] - Formatter names/paths
-    // formatOptions: {},            // object - Formatter options    
-    // retry: 0,                     // number - Retry attempts for failing tests
-    // tags: "",                     // string - Tag expression to filter scenarios
-    // backtrace: false,             // boolean - Show full backtrace for errors
-    // dryRun: false,                // boolean - Prepare test run without execution
-    // browser: "chrome",            // "chrome", "firefox", "webkit"
-    // width: 1280,                  // number - Browser width
-    // height: 720,                  // number - Browser height
-    // maximizeScreen: true          // boolean - Maximize browser window
-    // forceExit: false,             // boolean - Force process.exit() after tests
-    // failFast: false,              // boolean - Stop on first test failure
-    // import: [],                   // string[] - Support code paths
-    // language: "en",               // string - Default feature file language
-    // loader: [],                   // string[] - Module loader specifications
-    // name: [],                     // string[] - Run scenarios matching regex
-    // order: "defined",             // string - Run order (defined/random)
-    // publish: false,               // boolean - Publish to cucumber.io
-    // requireModule: [],            // string[] - Transpilation module names
-    // retryTagFilter: "",           // string - Tag expression for retries
-    // strict: true,                 // boolean - Fail on pending steps
-    // worldParameters: {}           // object - World constructor parameters
-};
-`;
-
-  const featureContent = `Feature: Shopping on SauceDemo 🛒
-
-        Background: Login on SauceDemo
-            Given User is on home page of SauceDemo
-              And User types "standard_user" in "username_input"
-              And User types "secret_sauce" in "password_input"
-              And User clicks "#login-button"
-
-        Scenario Outline: Success Shopping
-              And User expects to be in "https://www.saucedemo.com/inventory.html" page
-              And User clicks "product_title"
-              And User clicks "add_to_cart_button"
-              And User clicks "cart_button"
-             Then User expects "item_price" should have "$29.99" text
-
-        Scenario Outline: Failed Shopping
-              And User expects to be in "https://www.saucedemo.com/inventory.html" page
-              And User clicks "product_title"
-              And User clicks "add_to_cart_button"
-              And User clicks "cart_button"
-             Then User expects "item_price" should not have "$29.99" text
-
-`;
-
-  const pomContent = JSON.stringify(
-    {
-      username_input: { selector: "#user-name" },
-      password_input: "#password",
-      login_button: "#login-button",
-      product_title:
-        "xpath=/html/body/div/div/div/div[2]/div/div/div/div[1]/div[2]/div[1]/a/div",
-      add_to_cart_button: "#add-to-cart",
-      cart_button: ".shopping_cart_link",
-      item_price: ".inventory_item_price",
-    },
-    null,
-    2,
-  );
-
-  const stepsContent = `
-const {Given,context} = require("artes");
-
-// Example step definition
-Given("User is on home page of SauceDemo", async () => {
-await context.page.goto("https://www.saucedemo.com/");
-});
-`;
-
-const hooksContent = `
-export function BeforeStep() {
-  // hook for before each step
-}
-
-export function Before() {
-  // hook for before each test
-}
-
-export function BeforeAll() {
-  // hook for before all tests
-}
-
-export function AfterStep() {
-  // hook for after each step
-}
-
-export function After() {
-  // hook for after each test
-}
-
-export function AfterAll() {
-  // hook for after all tests
-}
-`;
-
-  const vsCodeExtension = JSON.stringify({
-    recommendations: ["CucumberOpen.cucumber-official"],
-  });
-
-  const vsCodeSettings = JSON.stringify({
-    "cucumber.glue": [
-      "tests/steps/*.{ts,js}",
-      "node_modules/artes/src/stepDefinitions/*.{ts,js}",
-    ],
-    "cucumber.features": ["tests/features/**/*.feature"],
-    "cucumberautocomplete.syncfeatures": true,
-    "cucumberautocomplete.strictGherkinCompletion": true,
-  });
-
-  console.log("📂 Creating project files...");
-
-  fs.writeFileSync(path.join(projectDir, "artes.config.js"), config, "utf-8");
-  fs.writeFileSync(
-    path.join(srcDir, "features", "example.feature"),
-    featureContent,
-  );
-  fs.writeFileSync(path.join(srcDir, "POMs", "example.pom.json"), pomContent);
-  fs.writeFileSync(path.join(srcDir, "steps", "common.steps.js"), stepsContent);
-  fs.writeFileSync(path.join(srcDir, "steps", "hooks.js"), hooksContent);
-
-  fs.writeFileSync(
-    path.join(projectDir, ".vscode", "settings.json"),
-    vsCodeSettings,
-  );
-
-  fs.writeFileSync(
-    path.join(projectDir, ".vscode", "extensions.json"),
-    vsCodeExtension,
-  );
-
-  console.log(`✨ Project created successfully in ${projectDir}!`);
-  console.log("Happy Testing 🎉");
-}
-
-module.exports = {
-  createProject,
-};
+#!/usr/bin/env node
+
+const fs = require("fs");
+const path = require("path");
+const { execSync } = require("child_process");
+
+function createProject(createYes, noDeps) {
+  const projectDir = path.join(process.cwd(), "artes");
+  const srcDir = path.join(projectDir, "tests");
+
+  [
+    projectDir,
+    path.join(srcDir, "features"),
+    path.join(srcDir, "POMs"),
+    path.join(srcDir, "steps"),
+    path.join(projectDir, ".vscode"),
+  ].forEach((dir) => fs.mkdirSync(dir, { recursive: true }));
+
+  console.log("🚀 Initializing project...");
+  execSync(`npm init ${createYes ? "-y" : ""}`, {
+    cwd: projectDir,
+    stdio: "inherit",
+  });
+
+  !noDeps ? execSync("npm i artes", { cwd: projectDir, stdio: "inherit" }) : "";
+
+  console.log("📦 Setting up browsers...");
+  execSync("npx playwright install", { cwd: projectDir, stdio: "inherit" });
+
+  const packageJsonPath = path.join(projectDir, "package.json");
+  const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, "utf-8"));
+
+  if (packageJson.type) {
+    delete packageJson.type;
+  }
+
+  packageJson.scripts = {
+    test: "npx artes",
+    testWithReport: "npx artes -r",
+  };
+
+  fs.writeFileSync(packageJsonPath, JSON.stringify(packageJson, null, 2));
+
+  const config = `module.exports = {
+    headless: false, // Set to true for headless browser mode
+
+    // Configuration options:
+    // env: "",                      // string - Environment name for tests
+    // testPercentage: 0, // number - Minimum success rate percentage(Default: 0)
+    // baseURL: "",                  // string - Base URL for API tests
+    // paths: [],                    // string[] - Paths to feature files
+    // steps: "",                    // string - Step definitions files
+    // pomPath: "",                  // string - Path to POM files
+    // timeout : 0,                  // number - Test timeout in seconds
+    // slowMo: 0,                    // number - Slow down test execution (Default: 0 seconds)
+    // parallel: 0,                  // number - Number of parallel workers
+    // report: true                   / boolean - Generate report
+    // reportSuccess: false,         // boolean - Add screenshots and video records to report also for success test cases
+    // trace: false,                 // boolean - Enable tracing
+    // reportWithTrace: false,       // boolean - Include trace in report
+    // format: [],                   // string[] - Formatter names/paths
+    // formatOptions: {},            // object - Formatter options    
+    // retry: 0,                     // number - Retry attempts for failing tests
+    // tags: "",                     // string - Tag expression to filter scenarios
+    // backtrace: false,             // boolean - Show full backtrace for errors
+    // dryRun: false,                // boolean - Prepare test run without execution
+    // browser: "chrome",            // "chrome", "firefox", "webkit"
+    // width: 1280,                  // number - Browser width
+    // height: 720,                  // number - Browser height
+    // maximizeScreen: true          // boolean - Maximize browser window
+    // forceExit: false,             // boolean - Force process.exit() after tests
+    // failFast: false,              // boolean - Stop on first test failure
+    // import: [],                   // string[] - Support code paths
+    // language: "en",               // string - Default feature file language
+    // loader: [],                   // string[] - Module loader specifications
+    // name: [],                     // string[] - Run scenarios matching regex
+    // order: "defined",             // string - Run order (defined/random)
+    // publish: false,               // boolean - Publish to cucumber.io
+    // requireModule: [],            // string[] - Transpilation module names
+    // retryTagFilter: "",           // string - Tag expression for retries
+    // strict: true,                 // boolean - Fail on pending steps
+    // worldParameters: {}           // object - World constructor parameters
+};
+`;
+
+  const featureContent = `Feature: Shopping on SauceDemo 🛒
+
+        Background: Login on SauceDemo
+            Given User is on home page of SauceDemo
+              And User types "standard_user" in "username_input"
+              And User types "secret_sauce" in "password_input"
+              And User clicks "#login-button"
+
+        Scenario Outline: Success Shopping
+              And User expects to be in "https://www.saucedemo.com/inventory.html" page
+              And User clicks "product_title"
+              And User clicks "add_to_cart_button"
+              And User clicks "cart_button"
+             Then User expects "item_price" should have "$29.99" text
+
+        Scenario Outline: Failed Shopping
+              And User expects to be in "https://www.saucedemo.com/inventory.html" page
+              And User clicks "product_title"
+              And User clicks "add_to_cart_button"
+              And User clicks "cart_button"
+             Then User expects "item_price" should not have "$29.99" text
+
+`;
+
+  const pomContent = JSON.stringify(
+    {
+      username_input: { selector: "#user-name" },
+      password_input: "#password",
+      login_button: "#login-button",
+      product_title:
+        "xpath=/html/body/div/div/div/div[2]/div/div/div/div[1]/div[2]/div[1]/a/div",
+      add_to_cart_button: "#add-to-cart",
+      cart_button: ".shopping_cart_link",
+      item_price: ".inventory_item_price",
+    },
+    null,
+    2,
+  );
+
+  const stepsContent = `
+const {Given,context} = require("artes");
+
+// Example step definition
+Given("User is on home page of SauceDemo", async () => {
+await context.page.goto("https://www.saucedemo.com/");
+});
+`;
+
+  const hooksContent = `
+export function BeforeStep() {
+  // hook for before each step
+}
+
+export function Before() {
+  // hook for before each test
+}
+
+export function BeforeAll() {
+  // hook for before all tests
+}
+
+export function AfterStep() {
+  // hook for after each step
+}
+
+export function After() {
+  // hook for after each test
+}
+
+export function AfterAll() {
+  // hook for after all tests
+}
+`;
+
+  const vsCodeExtension = JSON.stringify({
+    recommendations: ["CucumberOpen.cucumber-official"],
+  });
+
+  const vsCodeSettings = JSON.stringify({
+    "cucumber.glue": [
+      "tests/steps/*.{ts,js}",
+      "node_modules/artes/src/stepDefinitions/*.{ts,js}",
+    ],
+    "cucumber.features": ["tests/features/**/*.feature"],
+    "cucumberautocomplete.syncfeatures": true,
+    "cucumberautocomplete.strictGherkinCompletion": true,
+  });
+
+  console.log("📂 Creating project files...");
+
+  fs.writeFileSync(path.join(projectDir, "artes.config.js"), config, "utf-8");
+  fs.writeFileSync(
+    path.join(srcDir, "features", "example.feature"),
+    featureContent,
+  );
+  fs.writeFileSync(path.join(srcDir, "POMs", "example.pom.json"), pomContent);
+  fs.writeFileSync(path.join(srcDir, "steps", "common.steps.js"), stepsContent);
+  fs.writeFileSync(path.join(srcDir, "steps", "hooks.js"), hooksContent);
+
+  fs.writeFileSync(
+    path.join(projectDir, ".vscode", "settings.json"),
+    vsCodeSettings,
+  );
+
+  fs.writeFileSync(
+    path.join(projectDir, ".vscode", "extensions.json"),
+    vsCodeExtension,
+  );
+
+  console.log(`✨ Project created successfully in ${projectDir}!`);
+  console.log("Happy Testing 🎉");
+}
+
+module.exports = {
+  createProject,
+};