artes 1.0.87 → 1.0.89

package/README.md

@@ -45,24 +45,25 @@ npx artes [options]
 | Option              | Description                                                                | Usage Example                                                         |
 | ------------------- | -------------------------------------------------------------------------- | --------------------------------------------------------------------- |
 | 🆘 `-h, --help`     | Show the usage options                                                     | `artes -h` or `artes --help`                                          |
-| 🏷️ `-v, --version` | Show the current version of Artes                                          | `artes -v` or `artes --version`                                       |
-| 🏗️ `-c, --create`  | Create an example project with Artes                                       | `artes -c` or `artes --create`                                        |
-| ✅ `-y, --yes`       | Skip the confirmation prompt when creating an example project              | `artes -c -y` or `artes --create --yes`                               |
+| 🏷️ `-v, --version`  | Show the current version of Artes                                          | `artes -v` or `artes --version`                                       |
+| 🏗️ `-c, --create`   | Create an example project with Artes                                       | `artes -c` or `artes --create`                                        |
+| ✅ `-y, --yes`      | Skip the confirmation prompt when creating an example project              | `artes -c -y` or `artes --create --yes`                               |
 | 📊 `-r, --report`   | Run tests and generate Allure report                                       | `artes -r` or `artes --report`                                        |
 | 📁 `--features`     | Specify one or more feature files' relative paths to run (comma-separated) | `artes --features "tests/features/Alma,tests/features/Banan.feature"` |
 | 🔖 `--tags`         | Run tests with specified Cucumber tags                                     | `artes --tags "@smoke or @wip"`                                       |
 | 🌐 `--env`          | Set the environment for the test run                                       | `artes --env "dev"`                                                   |
-| 🕶️ `--headless`    | Run browser in headless mode                                               | `artes --headless`                                                    |
-| ⚡ `--parallel`      | Run tests in parallel mode                                                 | `artes --parallel 2`                                                  |
+| 🕶️ `--headless`     | Run browser in headless mode                                               | `artes --headless`                                                    |
+| ⚡ `--parallel`     | Run tests in parallel mode                                                 | `artes --parallel 2`                                                  |
 | 🔁 `--retry`        | Retry failed tests                                                         | `artes --retry 3`                                                     |
-| 🎭 `--dryrun`       | Perform a dry run without executing tests                                  | `artes --dryrun`                                                      |
+| 🎭 `--dryRun`       | Perform a dry run without executing tests                                  | `artes --dryRun`                                                      |
 | 📈 `--percentage`   | Set minimum success percentage to pass test run (default is 0)             | `artes --percentage 85`                                               |
 | 🌍 `--browser`      | Specify browser to use (`chromium`, `firefox`, or `webkit`)                | `artes --browser chromium`                                            |
 | 🔗 `--baseURL`      | Set base URL for the tests                                                 | `artes --baseURL "https://example.com"`                               |
-| 🖥️ `--maxScreen`   | Maximize browser window on launch                                          | `artes --maxScreen`                                                   |
+| 🖥️ `--maxScreen`    | Maximize browser window on launch                                          | `artes --maxScreen`                                                   |
 | 📏 `--width`        | Set browser width (default is 1280)                                        | `artes --width 1920`                                                  |
 | 📐 `--height`       | Set browser height (default is 720)                                        | `artes --height 1080`                                                 |
-| ⏱️ `--timeout`      | Set timeout for each test step in seconds (default is 30)                  | `artes --timeout 10`                                                  |
+| ⏱️ `--timeout`      | Set timeout for each test step in seconds (default is 30 seconds)                  | `artes --timeout 10`                                                  |
+| 🐢 `--slowMo`       | Slow down text execution for clear view (default: 0 seconds)                     | `artes --slowMo 1`                                                 |  
 
 \*\* To just run the tests: <br>
 Globally: artes <br>
@@ -285,7 +286,8 @@ You can configure Artes by editing the `artes.config.js` file. Below are the def
 
 | **Option**        | **Default Value**                                                            | **Description**                     |
 | ----------------- | ---------------------------------------------------------------------------- | ----------------------------------- |
-| `timeout`         | `30`                                                                         | Default timeout in milliseconds.    |
+| `timeout`         | `30`                                                                         | Default timeout in seconds.         |
+| `slowMo`          | `0`                                                                          | Default slow motion in seconds      |
 | `paths`           | `[moduleConfig.featuresPath]`                                                | Paths to feature files.             |
 | `require`         | `[moduleConfig.stepsPath, "src/stepDefinitions/*.js", "src/hooks/hooks.js"]` | Support code paths (CommonJS).      |
 | `pomPath`         | `moduleConfig.pomPath`                                                       | Path to Page Object Models.         |

package/cucumber.config.js

@@ -14,6 +14,22 @@ try {
   console.log("Proceeding with default config.");
 }
 
+const defaultFormats = [
+    "rerun:@rerun.txt",
+      "progress-bar"];
+
+const userFormatsFromEnv = process.env.REPORT_FORMAT
+  ? JSON.parse(process.env.REPORT_FORMAT)
+  : [];
+
+const userFormatsFromConfig = artesConfig.format || [];
+
+const finalFormats = [...new Set([
+  ...defaultFormats,
+  ...userFormatsFromEnv,
+  ...userFormatsFromConfig,
+])];
+
 module.exports = {
   default: {
     // File paths and patterns
@@ -21,8 +37,8 @@ module.exports = {
       ? Number(process.env.PERCENTAGE)
       : artesConfig.testPercentage || 0, // number - Percentage of tests to run (0-100)
     timeout: process.env.TIMEOUT
-      ? Number(process.env.TIMEOUT)
-      : artesConfig.timeout || 30, // Default timeout in milliseconds
+      ? Number(process.env.TIMEOUT) * 1000
+      : artesConfig.timeout * 1000 || 30 * 1000, // Default timeout in seconds
     paths: process.env.FEATURES
       ? [path.join(moduleConfig.projectPath, process.env.FEATURES)]
       : artesConfig.features
@@ -41,12 +57,7 @@ module.exports = {
     import: artesConfig.import || [], // Support code paths
 
     // Formatting and output
-    format: process.env.REPORT_FORMAT
-      ? JSON.parse(process.env.REPORT_FORMAT)
-      : artesConfig.format || [
-          "rerun:@rerun.txt",
-          "allure-cucumberjs/reporter",
-        ], // Formatter names/paths
+    format: finalFormats, // Formatter names/paths
     formatOptions: artesConfig.formatOptions || {
       resultsDir: `allure-result`,
     }, // Formatter options
@@ -116,5 +127,8 @@ module.exports = {
       : artesConfig?.headless !== undefined
         ? artesConfig.headless
         : true,
+        slowMo: process.env.SLOWMO
+        ? Number(process.env.SLOWMO) * 1000
+        : artesConfig?.slowMo * 1000 || 0    
   },
 };

package/executer.js

@@ -23,7 +23,7 @@ const flags = {
   headless: args.includes("--headless"),
   parallel: args.includes("--parallel"),
   retry: args.includes("--retry"),
-  dryrun: args.includes("--dryrun"),
+  dryRun: args.includes("--dryRun"),
   percentage: args.includes("--percentage"),
   browser: args.includes("--browser"),
   baseURL: args.includes("--baseURL"),
@@ -31,6 +31,7 @@ const flags = {
   width: args.includes("--width"),
   height: args.includes("--height"),
   timeout: args.includes("--timeout"),
+  slowMo: args.includes("--slowMo"),
 };
 
 const env = args[args.indexOf("--env") + 1];
@@ -45,14 +46,13 @@ const baseURL = args[args.indexOf("--baseURL") + 1];
 const width = args[args.indexOf("--width") + 1];
 const height = args[args.indexOf("--height") + 1];
 const timeout = args[args.indexOf("--timeout") + 1];
+const slowMo = args[args.indexOf("--slowMo") + 1];
 
 flags.env && console.log("Running env:", env);
 flags.env ? (process.env.ENV = JSON.stringify(env)) : "";
 
 flags.report
   ? (process.env.REPORT_FORMAT = JSON.stringify([
-      "rerun:@rerun.txt",
-      "progress-bar",
       "allure-cucumberjs/reporter:./allure-results",
     ]))
   : "";
@@ -71,7 +71,7 @@ flags.parallel ? (process.env.PARALLEL = parallel) : "";
 
 flags.retry ? (process.env.RETRY = retry) : "";
 
-flags.dryrun ? (process.env.DRYRUN = flags.dryrun) : "";
+flags.dryRun ? (process.env.DRYRUN = flags.dryRun) : "";
 
 flags.percentage ? (process.env.PERCENTAGE = percentage) : "";
 
@@ -92,6 +92,8 @@ flags.height ? (process.env.HEIGHT = height) : "";
 
 flags.timeout ? (process.env.TIMEOUT = timeout) : "";
 
+flags.slowMo ? (process.env.SLOWMO = slowMo) : "";
+
 function main() {
   if (flags.help) return showHelp();
   if (flags.version) return showVersion();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "artes",
-  "version": "1.0.87",
+  "version": "1.0.89",
   "description": "The simplest way to automate UI and API tests using Cucumber-style steps.",
   "main": "index.js",
   "scripts": {

package/src/helper/contextManager/browserManager.js

@@ -23,6 +23,7 @@ const invokeBrowser = async () => {
 
   const options = {
     headless: cucumberConfig.browser.headless,
+    slowMo: cucumberConfig.browser.slowMo,
     args: [cucumberConfig.browser.maximizeScreen ? "--start-maximized" : ""],
   };
 

package/src/helper/executers/helper.js

@@ -43,8 +43,8 @@ function showHelp() {
             🔁 --retry         Retry failed tests
                 Usage:   artes --retry 2
       
-            🎭 --dryrun        Perform a dry run without executing tests
-                Usage:   artes --dryrun
+            🎭 --dryRun        Perform a dry run without executing tests
+                Usage:   artes --dryRun
 
             📈 --percentage    Set minimum success percentage to pass test run
                 Usage:   artes --percentage 85
@@ -66,6 +66,9 @@ function showHelp() {
 
             ⏱️ --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
       `);
 }
 

package/src/helper/executers/projectCreator.js

@@ -46,6 +46,7 @@ function createProject(createYes) {
     // 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
     // format: [],                   // string[] - Formatter names/paths
     // formatOptions: {},            // object - Formatter options    
@@ -81,14 +82,14 @@ function createProject(createYes) {
               And User clicks "#login-button"
 
         Scenario Outline: Success Shopping
-              And User expects the page url should be "https://www.saucedemo.com/inventory.html"
+              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 the page url should be "https://www.saucedemo.com/inventory.html"
+              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"

package/src/helper/executers/versionChecker.js

@@ -1,11 +1,12 @@
+const { execSync } = require("child_process");
+const path = require("path");
 const fs = require("fs");
-const { moduleConfig } = require("../imports/commons");
 
 function showVersion() {
-  const packageJson = JSON.parse(
-    fs.readFileSync(moduleConfig.modulePackageJsonPath, "utf-8"),
-  );
-  console.log(`📌 Artes version: ${packageJson.version}`);
+  const artesVersion = execSync("npm root -g").toString().trim();
+  const artesGPackageJSONPath = path.join(artesVersion, "artes/package.json");
+   const asrtesGPackageJSON = JSON.parse(fs.readFileSync(artesGPackageJSONPath, "utf8"));
+   console.log(`ARTES Version: ${asrtesGPackageJSON.version}`);
 }
 
 module.exports = {

package/src/hooks/hooks.js

@@ -19,7 +19,7 @@ const path = require("path");
 
 const statusDir = path.join(process.cwd(), "testsStatus");
 
-setDefaultTimeout(cucumberConfig.default.timeout * 1000);
+setDefaultTimeout(cucumberConfig.default.timeout);
 
 BeforeAll(async function () {
   pomCollector();
@@ -36,7 +36,7 @@ Before(async function () {
   context.page = await browserContext.newPage();
   context.request = requestInstance;
 
-  await context.page.setDefaultTimeout(cucumberConfig.default.timeout * 1000);
+  await context.page.setDefaultTimeout(cucumberConfig.default.timeout);
 
   await context.browserContext.tracing.start({
     sources: true,

package/src/stepDefinitions/keyboardActions.steps.js

@@ -6,25 +6,25 @@ When("User presses {string} on {string}", async function (key, selector) {
   await keyboard.press(selector, key);
 });
 
+// User presses keys sequentially on a specific selector
 When(
-  "User types {string} in {int} th of {string}",
-  async (text, order, elements) => {
-    const nthElement = await frame.nth(elements, order);
-    await nthElement.fill(text);
+  "User types {string} by hand in {string}",
+  async function (keys, selector) {
+    await keyboard.pressSequentially(selector, keys);
   },
 );
 
-// User presses keys sequentially on a specific selector
 When(
-  "User presses keys {string} sequentially on {string}",
-  async function (keys, selector) {
-    await keyboard.pressSequentially(selector, keys);
+  "User types {string} by hand in {int} th of {string}",
+  async (text, order, elements) => {
+    const nthElement = await frame.nth(elements, order);
+    await nthElement.pressSequentially(text);
   },
 );
 
 // User presses keys sequentially with a delay on a specific selector
 When(
-  "User presses keys {string} sequentially with delay {int} on {string}",
+  "User types {string} by hand with delay {int} in {string}",
   async function (keys, delay, selector) {
     await keyboard.pressSequentiallyDelay(selector, keys, delay);
   },
@@ -35,6 +35,14 @@ When("User types {string} in {string}", async function (value, selector) {
   await keyboard.fill(selector, value);
 });
 
+When(
+  "User types {string} in {int} th of {string}",
+  async (text, order, elements) => {
+    const nthElement = await frame.nth(elements, order);
+    await nthElement.fill(text);
+  },
+);
+
 When(
   "User types {string} in multiple {string}",
   async function (value, selectors) {