npm - artes - Versions diffs - 1.7.3 → 1.7.5 - Mend

artes 1.7.3 → 1.7.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (8) hide show

package/README.md +68 -52
package/executer.js +177 -215
package/package.json +1 -1
package/src/helper/controller/screenComparer.js +26 -37
package/src/helper/controller/testCoverageCalculator.js +31 -10
package/src/helper/executers/exporter.js +4 -1
package/src/helper/executers/helper.js +188 -162
package/src/stepDefinitions/assertions.steps.js +24 -1

package/README.md CHANGED Viewed

@@ -139,61 +139,77 @@ npx artes [options]
 npx artes [options]
 ```
-### 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`                               |
-| 🚫 --noDeps               | Skip installing dependencies when creating example project                         | `artes -c --noDeps`                                                   |
-| 📊 `-r, --report`         | Run tests and generate Allure report                                               | `artes -r` or `artes --report`                                        |
-| `--reportSuccess`         | Add screenshots and video records for also Success test cases                      | `artes --reportSuccess`                                               |
-| `--trace`                 | Enable tracing                                                                     | `artes --trace`                                                       |
-| `-rwt, --reportWithTrace` | Add trace to the report                                                            | `artes -rwt` or `artes --reportWithTrace`                             |
-| `--singleFileReport`      | Generate single file allure report                                                 | `artes -r --singleFileReport`                                         |
-| `--zip`                   | Zip the report folder after generation                                             | `artes -r --zip`                                                      |
-| `--uploadReport`          | Upload the generated report to Artes Reporting System                              | `artes -r --zip --uploadReport --reporterURL "https://example.com"`            |
-| `--reporterURL`           | URL of the Artes Reporting System to upload the report                             | `artes -r --zip --uploadReport --reporterURL "https://example.com"`            |
-| `--projectName`           | Name of the project in the Artes Reporting System (default: `"Artes Report"`)     | `artes -r --zip --uploadReport --reporterURL "https://example.com" --projectName "My Project"` |
-| `--projectType`           | Type of the project for reporting purposes (default: `"Artes"`)                   | `artes -r --zip --uploadReport --reporterURL "https://example.com" --projectType "API"` |
-| `--reportPath`            | Path to the report zip file to upload (default: `./report.zip`)                   | `artes -r --zip --uploadReport --reporterURL "https://example.com" --reportPath "./my_report.zip"` |
-| 🖼️ `--logo`               | Set a custom logo in the report sidebar. Accepts an absolute path, a relative path, or a direct image URL | `artes -r --logo /abs/path/logo.png`<br>`artes --logo logo.png`<br>`artes --logo 'https://example.com/logo.png'` |
-| 🏢 `--brandName`          | Set the brand name displayed next to the logo in the report sidebar                | `artes --brandName 'My Company'`                                      |
-| 📄 `--reportName`         | Report name displayed on the summary widget and in the Artes Reporting System                       | `artes --reportName 'Alma UI'`
-| 📁 `--features`           | Specify one or more feature files' relative paths to run (comma-separated)         | `artes --features "tests/features/Alma,tests/features/Banan.feature"` |
-| 📜 `--stepDef`            | Specify one or more step definition files' relative paths to use (comma-separated) | `artes --stepDef "tests/steps/login.js,tests/steps/home.js"`          |
-| 🔖 `--tags`               | Run tests with specified Cucumber tags                                             | `artes --tags "@smoke or @wip"`                                       |
-| 🌐 `--env`                | Set the environment for the test run                                               | `artes --env "dev"`                                                   |
-| `--saveVar`              |  Set the variables from CLI                                                         | `artes --saveVar '{"armud":20,"banana":200}'` |
-| 🕶️ `--headless`           | Run browser in headless mode                                                       | `artes --headless`                                                    |
-| ⚡ `--parallel`           | Run tests in parallel mode                                                         | `artes --parallel 2`                                                  |
-| 🔁 `--retry`              | Retry failed tests                                                                 | `artes --retry 3`                                                     |
-| 🔁 `--rerun`              | Rerun only the failed tests from previous run                                      | `artes --rerun @rerun.txt`                                            |
-| 🎭 `--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`                                            |
-| `--offline`               | Run browser in offline mode                                                        | `artes --offline` |
-| 📱 `--device`             | Emulate specific device (e.g., "iPhone 13")                                        | `artes --device "iPhone 13"`   |
-| 🔗 `--baseURL`            | Set base URL for the tests                                                         | `artes --baseURL "https://example.com"`                               |
-| 🖥️ `--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 seconds)                  | `artes --timeout 10`                                                  |
-| 🐢 `--slowMo`             | Slow down text execution for clear view (default: 0 seconds)                       | `artes --slowMo 1`                                                    |
-### AI Options
+### General ( artes -h or artes --help )
+| Option | Description | Usage Example |
+| --- | --- | --- |
+| `-h, --help` | Show this help message | `artes -h` or `artes --help` |
+| `-v, --version` | Show current version of artes | `artes -v` or `artes --version` |
+| `-c, --create` | Create example artes project | `artes -c` or `artes --create` |
+| `-y, --yes` | Skip confirmation prompt when creating a project | `artes -c -y` or `artes -c --yes` |
+| `--noDeps` | Create project without installing dependencies | `artes -c --noDeps` |
+### Reporting & Branding ( artes report --help )
+| Option | Description | Usage Example |
+| --- | --- | --- |
+| `-r, --report` | Run tests and generate Allure report | `artes -r` or `artes --report` |
+| `--reportSuccess` | Generate screenshot and video with successful tests too | `artes --reportSuccess` |
+| `--trace` | Enable tracing for all tests | `artes --trace` |
+| `-rwt, --reportWithTrace` | Include trace in the report | `artes -rwt` or `artes --reportWithTrace` |
+| `--singleFileReport` | Generate single file Allure report | `artes -r --singleFileReport` |
+| `--zip` | Zip the report folder after generation | `artes -r --zip` |
+| `--logo` | Set a custom logo in the report sidebar | `artes --logo logo.png` |
+| `--brandName` | Set the brand name displayed next to the logo | `artes --brandName 'My Company'` |
+| `--reportName` | Report name on the summary widget | `artes --reportName 'Alma UI'` |
+| `--uploadReport` | Upload the generated report to Artes Reporting System | `artes -r --zip --uploadReport --reporterURL "https://example.com"` |
+| `--reporterURL` | URL of the Artes Reporting System | `artes --uploadReport --reporterURL "https://example.com"` |
+| `--projectName` | Project name in the Artes Reporting System (default: `"Artes Report"`) | `artes --uploadReport --reporterURL "https://example.com" --projectName "My Project"` |
+| `--projectType` | Project type for reporting, e.g., UI, API (default: `"Artes"`) | `artes --uploadReport --reporterURL "https://example.com" --projectType "API"` |
+| `--reportPath` | Path to the report zip file to upload (default: `./report.zip`) | `artes --uploadReport --reporterURL "https://example.com" --reportPath "./my_report.zip"` |
+### Browser ( artes browser --help )
+| Option | Description | Usage Example |
+| --- | --- | --- |
+| `--browser` | Specify browser to use (`chromium`, `firefox`, `webkit`) | `artes --browser chromium` |
+| `--device` | Emulate a specific device (e.g., `"iPhone 13"`) | `artes --device "iPhone 13"` |
+| `--maxScreen` | Maximize browser window on launch | `artes --maxScreen` |
+| `--width` | Set browser width (default: `1280`) | `artes --width 1920` |
+| `--height` | Set browser height (default: `720`) | `artes --height 1080` |
+### Execution ( artes execution --help )
+| Option | Description | Usage Example |
+| --- | --- | --- |
+| `--headless` | Run browser in headless mode | `artes --headless` |
+| `--baseURL` | Set base URL for the tests | `artes --baseURL "https://example.com"` |
+| `--offline` | Run browser in offline mode | `artes --offline` |
+| `--features` | Specify feature file paths to run (comma-separated) | `artes --features "tests/features/Alma,tests/features/Banan.feature"` |
+| `--stepDef` | Specify step definition file paths to use (comma-separated) | `artes --stepDef "tests/steps/login.js,tests/steps/home.js"` |
+| `--tags` | Run tests with specified Cucumber tags | `artes --tags "@smoke and not @wip"` |
+| `--env` | Set the environment for the test run | `artes --env "dev"` |
+| `--saveVar` | Set variables from CLI | `artes --saveVar '{"armud":20,"banana":200}'` |
+| `--parallel` | Run tests in parallel mode | `artes --parallel 3` |
+| `--retry` | Retry failed tests | `artes --retry 2` |
+| `--rerun` | Rerun only failed tests from previous run | `artes --rerun @rerun.txt` |
+| `--dryRun` | Perform a dry run without executing tests | `artes --dryRun` |
+| `--percentage` | Set minimum success percentage to pass test run (default: `0`) | `artes --percentage 85` |
+| `--timeout` | Set timeout for each test step in seconds (default: `30`) | `artes --timeout 10` |
+| `--slowMo` | Slow down execution for clear view (default: `0`) | `artes --slowMo 1` |
+### AI Bug Reporter ( artes ai --help )
 | Option | Description | Usage Example |
 | --- | --- | --- |
-| 🤖 `--ai` | Enable AI-generated bug reports and test summaries | `artes --ai` |
-| 🧠 `--aiModel` | AI model to use for report generation | `artes --ai --aiModel "gemini 2.5 flash"` |
-| 🔑 `--aiKey` | API key for the selected AI provider | `artes --ai --aiKey "your-api-key"` |
-| 🔗 `--aiURL` | Local AI endpoint URL (e.g. Ollama, LM Studio). Overrides `--aiModel` and `--aiKey` when set | `artes --ai --aiURL "http://localhost:11434/api/chat"` |
-| 🌍 `--aiLanguage` | Language for AI-generated reports (default: `"English"`) | `artes --ai --aiLanguage "Azerbaijani"` |
-| 🔢 --maxTokens | Maximum tokens for AI response output (default: 4000) | artes --ai --maxTokens 8000 |
-| 📋 `--maxReports` | Maximum number of AI reports to generate per test run (default: `10`) | `artes --ai --maxReports 5` |
+| `--ai` | Enable AI-generated bug reports and test summaries | `artes --ai` |
+| `--aiModel` | AI model to use for report generation | `artes --ai --aiModel "gemini 2.5 flash"` |
+| `--aiKey` | API key for the selected AI provider | `artes --ai --aiKey "your-api-key"` |
+| `--aiURL` | Local AI endpoint URL (e.g., Ollama, LM Studio). Overrides `--aiModel` and `--aiKey` when set | `artes --ai --aiURL "http://localhost:11434/api/chat"` |
+| `--aiLanguage` | Language for AI-generated reports (default: `"English"`) | `artes --ai --aiLanguage "Azerbaijani"` |
+| `--maxTokens` | Maximum tokens for AI-generated reports (default: `4000`) | `artes --ai --maxTokens 8000` |
+| `--maxReports` | Maximum number of AI reports to generate per test run (default: `10`) | `artes --ai --maxReports 5` |
 \*\* To just run the tests: <br>

package/executer.js CHANGED Viewed

@@ -3,24 +3,25 @@ const {
   showHelp,
   showAIHelp,
   showVersion,
+  showBrowserHelp,
+  showExecutionHelp,
+  showReportingHelp,
   createProject,
   runTests,
   generateReport,
   cleanUp,
 } = require("./src/helper/executers/exporter");
 const { logPomWarnings } = require("./src/helper/controller/pomCollector");
-const fs = require("fs");
-const path = require("path");
-const {
-  testCoverageCalculator,
-} = require("./src/helper/controller/testCoverageCalculator");
+const { testCoverageCalculator } = require("./src/helper/controller/testCoverageCalculator");
 const { getExecutor } = require("./src/helper/controller/getExecutor");
-const {
-  findDuplicateTestNames,
-} = require("./src/helper/controller/findDuplicateTestNames");
+const { findDuplicateTestNames } = require("./src/helper/controller/findDuplicateTestNames");
 const { getEnvInfo } = require("artes/src/helper/controller/getEnvInfo");
 const { uploadReport } = require("./src/helper/controller/reportUploader");
+const fs = require("fs");
+const path = require("path");
 const artesConfigPath = path.resolve(process.cwd(), "artes.config.js");
 let artesConfig = {};
@@ -31,256 +32,217 @@ if (fs.existsSync(artesConfigPath)) {
 const args = process.argv.slice(2);
+const set = (key, value) => { if (value) process.env[key] = value; };
 const getArgValue = (flag) => {
   const index = args.indexOf(flag);
   return index >= 0 ? args[index + 1] : undefined;
 };
 const flags = {
-  help: args.includes("-h") || args.includes("--help"),
+  // Main
+  help:    args.includes("-h") || args.includes("--help"),
   version: args.includes("-v") || args.includes("--version"),
-  create: args.includes("-c") || args.includes("--create"),
+  create:  args.includes("-c") || args.includes("--create"),
   createYes: args.includes("-y") || args.includes("--yes"),
   noDeps: args.includes("--noDeps"),
-  report: args.includes("-r") || args.includes("--report"),
-  reportSuccess: args.includes("--reportSuccess"),
-  trace: args.includes("-t") || args.includes("--trace"),
-  reportWithTrace: args.includes("-rwt") || args.includes("--reportWithTrace"),
+  // Sub-command help pages
+  reportHelp:    (args[0] === "report"    && args.includes("--help")),
+  browserHelp:   (args[0] === "browser"   && args.includes("--help")),
+  executionHelp: (args[0] === "execution" && args.includes("--help")),
+  aiHelp:        (args[0] === "ai"        && args.includes("--help")),
+  // Reporting
+  report:           args.includes("-r")              || args.includes("--report"),
+  reportSuccess:    args.includes("--reportSuccess"),
+  reportWithTrace:  args.includes("-rwt")            || args.includes("--reportWithTrace"),
+  trace:            args.includes("--trace"),
   singleFileReport: args.includes("--singleFileReport"),
-  customLogo: args.includes("--logo"),
-  customBrandName: args.includes("--brandName"),
-  customReportName: args.includes("--reportName"),
-  zip: args.includes("--zip"),
-  uploadReport: args.includes("--uploadReport"),
-  reporterURL: args.includes("--reporterURL"),
-  projectName: args.includes("--projectName"),
-  projectType: args.includes("--projectType"),
-  reportPath: args.includes("--reportPath"),
-  aiHelp: args.includes("--aiHelp"),
-  ai: args.includes("--ai"),
-  aiURL: args.includes("--aiURL"),
-  aiModel: args.includes("--aiModel"),
-  aiKey: args.includes("--aiKey"),
-  aiLanguage: args.includes("--aiLanguage"),
-  maxTokens: args.includes("--maxTokens"),
-  maxReports: args.includes("--maxReports"),
-  features: args.includes("--features"),
-  stepDef: args.includes("--stepDef"),
-  tags: args.includes("--tags"),
-  env: args.includes("--env"),
-  saveVar: args.includes("--saveVar"),
-  headless: args.includes("--headless"),
-  parallel: args.includes("--parallel"),
-  retry: args.includes("--retry"),
-  rerun: args.includes("--rerun"),
-  dryRun: args.includes("--dryRun"),
+  zip:              args.includes("--zip"),
+  logo:             args.includes("--logo"),
+  brandName:        args.includes("--brandName"),
+  reportName:       args.includes("--reportName"),
+  uploadReport:     args.includes("--uploadReport"),
+  reporterURL:      args.includes("--reporterURL"),
+  projectName:      args.includes("--projectName"),
+  projectType:      args.includes("--projectType"),
+  reportPath:       args.includes("--reportPath"),
+  // Browser & Environment
+  browser:    args.includes("--browser"),
+  device:     args.includes("--device"),
+  maxScreen:  args.includes("--maxScreen"),
+  width:      args.includes("--width"),
+  height:     args.includes("--height"),
+  // Execution
+  baseURL:    args.includes("--baseURL"),
+  env:        args.includes("--env"),
+  headless:   args.includes("--headless"),
+  offline:    args.includes("--offline"),
+  features:   args.includes("--features"),
+  stepDef:    args.includes("--stepDef"),
+  tags:       args.includes("--tags"),
+  parallel:   args.includes("--parallel"),
+  retry:      args.includes("--retry"),
+  rerun:      args.includes("--rerun"),
+  dryRun:     args.includes("--dryRun"),
   percentage: args.includes("--percentage"),
-  browser: args.includes("--browser"),
-  offline: args.includes("--offline"),
-  device: args.includes("--device"),
-  baseURL: args.includes("--baseURL"),
-  maximizeScreen: args.includes("--maxScreen"),
-  width: args.includes("--width"),
-  height: args.includes("--height"),
-  timeout: args.includes("--timeout"),
-  slowMo: args.includes("--slowMo"),
+  timeout:    args.includes("--timeout"),
+  slowMo:     args.includes("--slowMo"),
+  saveVar:    args.includes("--saveVar"),
+  // AI
+  ai:          args.includes("--ai"),
+  aiModel:     args.includes("--aiModel"),
+  aiKey:       args.includes("--aiKey"),
+  aiURL:       args.includes("--aiURL"),
+  aiLanguage:  args.includes("--aiLanguage"),
+  maxTokens:   args.includes("--maxTokens"),
+  maxReports:  args.includes("--maxReports"),
 };
-const env = getArgValue("--env");
-const vars = getArgValue("--saveVar");
-const reporterURL = getArgValue("--reporterURL");
-const projectType = getArgValue("--projectType");
-const projectName = getArgValue("--projectName");
-const reportPath = getArgValue("--reportPath");
-const logo = getArgValue("--logo");
-const brandName = getArgValue("--brandName");
-const reportName = getArgValue("--reportName");
-const ai = args.includes("--ai");
-const aiURL = getArgValue("--aiURL");
-const aiModel = getArgValue("--aiModel");
-const aiKey = getArgValue("--aiKey");
-const aiLanguage = getArgValue("--aiLanguage");
-const maxTokens = getArgValue("--maxTokens")
-const maxReports = getArgValue("--maxReports");
+const shouldReport = flags.reportWithTrace || artesConfig.reportWithTrace || flags.report || artesConfig.report;
+// Reporting & Branding
+const logo             = getArgValue("--logo");
+const brandName        = getArgValue("--brandName");
+const reportName       = getArgValue("--reportName");
+const reporterURL      = getArgValue("--reporterURL");
+const projectName      = getArgValue("--projectName");
+const projectType      = getArgValue("--projectType");
+const reportPath       = getArgValue("--reportPath");
+// Browser & Environment
+const browser   = getArgValue("--browser");
+const baseURL   = getArgValue("--baseURL");
+const device    = getArgValue("--device");
+const width     = getArgValue("--width");
+const height    = getArgValue("--height");
+// Execution
+const env          = getArgValue("--env");
 const featureFiles = getArgValue("--features");
 const features = flags.features && featureFiles;
-const stepDef = getArgValue("--stepDef");
-const tags = getArgValue("--tags");
-const parallel = getArgValue("--parallel");
-const retry = getArgValue("--retry");
-const rerun = getArgValue("--rerun");
-const percentage = getArgValue("--percentage");
-const browser = getArgValue("--browser");
-const device = getArgValue("--device");
-const baseURL = getArgValue("--baseURL");
-const width = getArgValue("--width");
-const height = getArgValue("--height");
-const timeout = getArgValue("--timeout");
-const slowMo = getArgValue("--slowMo");
-flags.env ? (process.env.ENV = env) : "";
-vars ? (process.env.VARS = vars) : "";
-flags.reportWithTrace ||
-artesConfig.reportWithTrace ||
-flags.report ||
-artesConfig.report
-  ? (process.env.REPORT_FORMAT = JSON.stringify([
-      "allure-cucumberjs/reporter:./allure-results",
-    ]))
-  : "";
-flags.customLogo ? (process.env.LOGO = logo) : "";
-flags.customBrandName ? (process.env.BRAND_NAME = brandName) : "";
-flags.customReportName ? (process.env.REPORT_NAME = reportName) : "";
-flags.reportSuccess ? (process.env.REPORT_SUCCESS = true) : "";
-flags.tags && console.log("Running tags:", tags);
-flags.tags ? (process.env.RUN_TAGS = JSON.stringify(tags)) : "";
-flags.features && console.log("Running features:", features);
-flags.features ? (process.env.FEATURES = features) : "";
-flags.stepDef && console.log("Running step definitions:", flags.stepDef);
-flags.stepDef ? (process.env.STEP_DEFINITIONS = stepDef) : "";
-flags.report ? (process.env.REPORT = true) : "";
-flags.trace ? (process.env.TRACE = true) : "";
-flags.reportWithTrace
-  ? (process.env.REPORT_WITH_TRACE = true)
-  : (process.env.REPORT_WITH_TRACE = false);
-flags.singleFileReport
-  ? (process.env.SINGLE_FILE_REPORT = true)
-  : (process.env.SINGLE_FILE_REPORT = false);
-flags.zip ? (process.env.ZIP = true) : (process.env.ZIP = false);
-flags.ai ? (process.env.AI = ai) : (process.env.AI = false);
-flags.aiURL ? (process.env.AI_URL = aiURL) : "";
-flags.aiModel ? (process.env.AI_MODEL = aiModel) : "";
-flags.aiKey ? (process.env.AI_KEY = aiKey) : "";
-flags.aiLanguage ? (process.env.AI_LANGUAGE = aiLanguage) : "";
-flags.maxTokens ? (process.env.MAX_TOKENS = maxTokens) : "";
-flags.maxReports ? (process.env.MAX_REPORTS = maxReports) : "";
-flags.headless &&
-  console.log("Running mode:", flags.headless ? "headless" : "headed");
-flags.headless ? (process.env.MODE = JSON.stringify(true)) : false;
-flags.parallel ? (process.env.PARALLEL = parallel) : "";
-flags.retry ? (process.env.RETRY = retry) : "";
-flags.rerun ? (process.env.RERUN = rerun) : "";
-flags.dryRun ? (process.env.DRYRUN = flags.dryRun) : "";
-flags.percentage ? (process.env.PERCENTAGE = percentage) : "";
-flags.browser && console.log("Running browser:", browser);
-flags.browser ? (process.env.BROWSER = JSON.stringify(browser)) : "";
-flags.browser && console.log("Running mode:", flags.offline && "Offline");
-flags.offline ? (process.env.OFFLINE = true) : "";
-flags.device && console.log("Running device:", device);
-flags.device ? (process.env.DEVICE = JSON.stringify(device)) : "";
-flags.baseURL ? (process.env.BASE_URL = JSON.stringify(baseURL)) : "";
-flags.maximizeScreen
-  ? (process.env.MAXIMIZE_SCREEN = flags.maximizeScreen)
-  : "";
+const stepDef      = getArgValue("--stepDef");
+const tags         = getArgValue("--tags");
+const parallel     = getArgValue("--parallel");
+const retry        = getArgValue("--retry");
+const rerun        = getArgValue("--rerun");
+const percentage   = getArgValue("--percentage");
+const timeout      = getArgValue("--timeout");
+const slowMo       = getArgValue("--slowMo");
+const vars         = getArgValue("--saveVar");
+// AI
+const aiModel    = getArgValue("--aiModel");
+const aiKey      = getArgValue("--aiKey");
+const aiURL      = getArgValue("--aiURL");
+const aiLanguage = getArgValue("--aiLanguage");
+const maxTokens  = getArgValue("--maxTokens");
+const maxReports = getArgValue("--maxReports");
-flags.width && console.log("Running width:", width);
-flags.width ? (process.env.WIDTH = width) : "";
-flags.height && console.log("Running height:", height);
-flags.height ? (process.env.HEIGHT = height) : "";
-flags.timeout ? (process.env.TIMEOUT = timeout) : "";
+// Reporting & Branding
+set("REPORT",              flags.report);
+set("REPORT_SUCCESS",      flags.reportSuccess);
+set("SINGLE_FILE_REPORT",  flags.singleFileReport);
+set("REPORT_WITH_TRACE",   flags.reportWithTrace);
+set("TRACE",               flags.trace);
+set("ZIP",                 flags.zip);
+set("LOGO",                logo);
+set("BRAND_NAME",          brandName);
+set("REPORT_NAME",         reportName);
+if (shouldReport) { process.env.REPORT_FORMAT = JSON.stringify(["allure-cucumberjs/reporter:./allure-results"]) }
+set("REPORTER_URL",  reporterURL);
+set("PROJECT_NAME",  projectName);
+set("PROJECT_TYPE",  projectType);
+set("REPORT_PATH",   reportPath);
+// Browser & Environment
+set("BROWSER",          browser);
+set("BASE_URL",         baseURL ? JSON.stringify(baseURL) : null);
+set("DEVICE",           device  ? JSON.stringify(device)  : null);
+set("MODE",             flags.headless ? JSON.stringify(true)   : null);
+set("OFFLINE",          flags.offline);
+set("MAXIMIZE_SCREEN",  flags.maxScreen);
+set("WIDTH",            width);
+set("HEIGHT",           height);
+// Execution
+set("ENV",  env);
+set("VARS", vars);
+set("FEATURES",         features);
+set("STEP_DEFINITIONS", stepDef);
+set("RUN_TAGS",         tags ? JSON.stringify(tags) : null);
+set("PARALLEL",         parallel);
+set("RETRY",            retry);
+set("RERUN",            rerun);
+set("DRYRUN",           flags.dryRun);
+set("PERCENTAGE",       percentage);
+set("TIMEOUT",          timeout);
+set("SLOWMO",           slowMo);
+// AI
+set("AI",          flags.ai);
+set("AI_URL",      aiURL);
+set("AI_MODEL",    aiModel);
+set("AI_KEY",      aiKey);
+set("AI_LANGUAGE", aiLanguage);
+set("MAX_TOKENS",  maxTokens);
+set("MAX_REPORTS", maxReports);
-flags.slowMo ? (process.env.SLOWMO = slowMo) : "";
 async function main() {
+  if (flags.reportHelp)    return showReportingHelp();
+  if (flags.browserHelp)   return showBrowserHelp();
+  if (flags.executionHelp) return showExecutionHelp();
+  if (flags.aiHelp)        return showAIHelp();
   if (flags.help) return showHelp();
-  if (flags.aiHelp) return showAIHelp();
   if (flags.version) return showVersion();
   if (flags.create) return createProject(flags.createYes, flags.noDeps);
   runTests();
-  const testCoverage = testCoverageCalculator();
+  const testPercentage = process.env.PERCENTAGE ? Number(process.env.PERCENTAGE) : artesConfig.testPercentage || 0;
+  const testCoverage = testCoverageCalculator({ percentage: testPercentage });
+  if (!testCoverage) {
+    cleanUp();
+    process.exit(1);
+  }
   if (testCoverage.totalTests === 0) {
-    console.log("\x1b[33mNo tests were run (0 scenarios). Skipping report generation and upload.\x1b[0m");
     cleanUp();
     process.exit(process.env.EXIT_CODE);
   }
   logPomWarnings();
   findDuplicateTestNames();
-  const testPercentage = process.env.PERCENTAGE
-    ? Number(process.env.PERCENTAGE)
-    : artesConfig.testPercentage || 0;
-  if (testPercentage > 0) {
-    const meetsThreshold = testCoverage.percentage >= testPercentage;
-    if (meetsThreshold) {
-      console.log(
-        `\x1b[32mTests passed required ${testPercentage}% success rate with ${testCoverage.percentage.toFixed(2)}%!\x1b[0m`,
-      );
-      process.env.EXIT_CODE = parseInt(0, 10);
-    } else {
-      console.log(
-        `\x1b[31mTests failed required ${testPercentage}% success rate with ${testCoverage.percentage.toFixed(2)}%!\x1b[0m`,
-      );
-      process.env.EXIT_CODE = parseInt(1, 10);
-    }
-  }
-  const source = path.join(
-    process.cwd(),
-    "node_modules",
-    "artes",
-    "@rerun.txt",
-  );
+  const source = path.join(process.cwd(), "node_modules", "artes",  "@rerun.txt" );
   const destination = path.join(process.cwd(), "@rerun.txt");
+  if (fs.existsSync(source)) { fs.renameSync(source, destination)}
-  if (fs.existsSync(source)) {
-    fs.renameSync(source, destination);
-  }
-    if (
-      flags.reportWithTrace ||
-      artesConfig.reportWithTrace ||
-      flags.report ||
-      artesConfig.report
-    ) {
+    if (shouldReport) {
       getExecutor();
       getEnvInfo();
       generateReport();
     }
-  if (
-    !(process.env.TRACE === "true"
-      ? process.env.TRACE
-      : artesConfig.trace || false)
-  ) {
-    fs.rmSync(path.join(process.cwd(), "traces"), {
-      recursive: true,
-      force: true,
-    });
-  }
+    const traceEnabled = process.env.TRACE === "true" || artesConfig.trace || false;
+    if (!traceEnabled) {
+      fs.rmSync(path.join(process.cwd(), "traces"), { recursive: true, force: true });
+    }
   try {
     if (flags.uploadReport || artesConfig.uploadReport) {

package/package.json CHANGED Viewed

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

package/src/helper/controller/screenComparer.js CHANGED Viewed

@@ -8,31 +8,30 @@ const { PNG } = require("pngjs");
 const { moduleConfig } = require("artes/src/helper/imports/commons");
 async function screenComparer(baselineFilename, screenshotFn, options = {}) {
-  const { maxDiffPercent = 0.01, threshold = 0.1 } = options;
+  const { maxDiffPercent = 0.01, threshold = 0.1, comparePath } = options;
   const baselinePath = path.join(moduleConfig.projectPath, baselineFilename);
-  const actualPath = path.join(
-    moduleConfig.projectPath,
-    "visualComparison",
-    `actual_${baselineFilename}`,
-  );
+  const actualPath = comparePath
+    ? path.join(moduleConfig.projectPath, comparePath)
+    : path.join(moduleConfig.projectPath, "visualComparison", `actual_${baselineFilename}`);
   const diffPath = path.join(
     moduleConfig.projectPath,
     "visualComparison",
     `diff_${baselineFilename}`,
   );
-  await screenshotFn(actualPath);
-  const baselineMeta = await sharp(baselinePath).metadata();
-  const actualMeta = await sharp(actualPath).metadata();
+  const visualComparisonDir = path.join(moduleConfig.projectPath, "visualComparison");
+  if (!fs.existsSync(visualComparisonDir)) {
+    fs.mkdirSync(visualComparisonDir, { recursive: true });
+  }
-  // if (baselineMeta.width !== actualMeta.width || baselineMeta.height !== actualMeta.height) {
-  //   console.warn(`⚠️  Dimension mismatch! Baseline: ${baselineMeta.width}x${baselineMeta.height} | Actual: ${actualMeta.width}x${actualMeta.height}`);
-  // }
+  if (!comparePath) {
+    await screenshotFn(actualPath);
+  }
-  const width = actualMeta.width;
-  const height = actualMeta.height;
+  const { width, height } = await sharp(actualPath).metadata();
   const baselineBuffer = await sharp(baselinePath)
     .resize(width, height, { fit: "fill" })
@@ -59,44 +58,34 @@ async function screenComparer(baselineFilename, screenshotFn, options = {}) {
   fs.writeFileSync(diffPath, PNG.sync.write(diffImg));
-  const totalPixels = width * height;
+  const totalPixels   = width * height;
   const mismatchRatio = mismatchedPixels / totalPixels;
-  const expectedBase64 = (
-    await sharp(baselinePath)
-      .resize(width, height, { fit: "fill" })
-      .png()
-      .toBuffer()
-  ).toString("base64");
-  const actualBase64 = (await sharp(actualPath).png().toBuffer()).toString(
-    "base64",
-  );
-  const diffBase64 = (await sharp(diffPath).png().toBuffer()).toString(
-    "base64",
-  );
+  const expectedBase64 = (await sharp(baselinePath).resize(width, height, { fit: "fill" }).png().toBuffer()).toString("base64");
+  const actualBase64   = (await sharp(actualPath).png().toBuffer()).toString("base64");
+  const diffBase64     = (await sharp(diffPath).png().toBuffer()).toString("base64");
   const content = JSON.stringify({
     expected: `data:image/png;base64,${expectedBase64}`,
-    actual: `data:image/png;base64,${actualBase64}`,
-    diff: `data:image/png;base64,${diffBase64}`,
+    actual:   `data:image/png;base64,${actualBase64}`,
+    diff:     `data:image/png;base64,${diffBase64}`,
   });
   await allure.attachment(
     "Screenshot diff details",
-    ` Mismatched pixels: ${mismatchedPixels} / ${totalPixels} (${(mismatchRatio * 100).toFixed(2)}%) Max allowed: ${maxDiffPercent * 100}%`,
+    `Mismatched pixels: ${mismatchedPixels} / ${totalPixels} (${(mismatchRatio * 100).toFixed(2)}%) Max allowed: ${maxDiffPercent * 100}%`,
     "text/plain",
   );
   await allure.attachment(
     "Screenshot diff",
     content,
     "application/vnd.allure.image.diff",
   );
-  if (fs.existsSync(path.join(moduleConfig.projectPath, "visualComparison")))
-    fs.rmSync(path.join(moduleConfig.projectPath, "visualComparison"), {
-      recursive: true,
-      force: true,
-    });
+  if (fs.existsSync(visualComparisonDir)) {
+    fs.rmSync(visualComparisonDir, { recursive: true, force: true });
+  }
   if (mismatchRatio > maxDiffPercent) {
     throw new Error(
@@ -105,4 +94,4 @@ async function screenComparer(baselineFilename, screenshotFn, options = {}) {
   }
 }
-module.exports = { screenComparer };
+module.exports = { screenComparer };

package/src/helper/controller/testCoverageCalculator.js CHANGED Viewed

@@ -1,7 +1,7 @@
 const fs = require("fs");
 const path = require("path");
-function testCoverageCalculator({ silent = false } = {}) {
+function testCoverageCalculator({ silent = false, percentage = 0 } = {}) {
   const testStatusFile = path.join(
     process.cwd(),
     "node_modules",
@@ -67,6 +67,22 @@ function testCoverageCalculator({ silent = false } = {}) {
     }
   });
+  const result = {
+    percentage: ((total - notPassed) / total) * 100,
+    totalTests: total,
+    notPassed,
+    passed: total - notPassed,
+    latestStatuses: Object.fromEntries(
+      Object.entries(map).map(([id, data]) => [id, data.latest.status]),
+    ),
+  };
+  if (!silent && result.totalTests === 0) {
+    console.log("\x1b[33mNo tests were run (0 scenarios).\x1b[0m");
+    process.env.EXIT_CODE = 1;
+    return result;
+  }
   if (!silent && retriedTests.length > 0) {
     console.warn(`\n\x1b[33mRetried ${retriedTests.length} test cases:`);
     retriedTests.forEach((t) => {
@@ -76,15 +92,20 @@ function testCoverageCalculator({ silent = false } = {}) {
     console.log("");
   }
-  return {
-    percentage: ((total - notPassed) / total) * 100,
-    totalTests: total,
-    notPassed,
-    passed: total - notPassed,
-    latestStatuses: Object.fromEntries(
-      Object.entries(map).map(([id, data]) => [id, data.latest.status]),
-    ),
-  };
+  if (!silent && percentage > 0) {
+    const meetsThreshold = result.percentage >= percentage;
+    if (meetsThreshold) {
+      console.log(`\x1b[32mTests passed required ${percentage}% success rate with ${result.percentage.toFixed(2)}%!\x1b[0m`);
+      process.env.EXIT_CODE = 0;
+    } else {
+      console.log(`\x1b[31mTests failed required ${percentage}% success rate with ${result.percentage.toFixed(2)}%!\x1b[0m`);
+      process.env.EXIT_CODE = 1;
+    }
+  }
+  return result
 }
 module.exports = { testCoverageCalculator };

package/src/helper/executers/exporter.js CHANGED Viewed

@@ -1,4 +1,4 @@
-const { showHelp, showAIHelp } = require("./helper");
+const { showHelp, showBrowserHelp, showExecutionHelp, showReportingHelp, showAIHelp } = require("./helper");
 const { createProject } = require("./projectCreator");
 const { generateReport } = require("./reportGenerator");
 const { runTests } = require("./testRunner");
@@ -10,6 +10,9 @@ module.exports = {
   generateReport,
   runTests,
   showHelp,
+  showBrowserHelp,
+  showExecutionHelp,
+  showReportingHelp,
   showAIHelp,
   showVersion,
   cleanUp,

package/src/helper/executers/helper.js CHANGED Viewed

@@ -1,168 +1,194 @@
 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:
+    console.log(`
+      Artes CLI
+        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
-            --uploadReport     Upload the generated report to a Artes Reporting System
-                Usage:   artes --uploadReport --reporterURL "https://example.com/upload"
-            --reporterURL      URL of the Artes Reporting System to upload the report
-                Usage:   artes --uploadReport --reporterURL "https://example.com/upload"
-            --projectName      Name of the project in the Artes Reporting System (default: "Artes Report")
-                Usage:   artes --uploadReport --reporterURL "https://example.com/upload" --projectName "My Project"
-            --projectType      Type of the project (e.g., UI, API) for reporting purposes (default: "Artes")
-                Usage:   artes --uploadReport --reporterURL "https://example.com/upload" --projectType "API"
-            --reportPath       Path to the report zip or html file to be uploaded (default: ./report.zip)
-                Usage:   artes --uploadReport --reporterURL "https://example.com/upload" --reportPath "./my_report.zip"
-            🖼️ --logo           Set a custom logo in the report sidebar
-                Usage:  artes --logo logo.png
-            🏢 --brandName      Set the brand name displayed next to the logo in the report sidebar
-                Usage:  artes --brandName 'My Company'
-            📄 --reportName      Report name displayed on the summary widget and in the Artes Reporting System
-                Usage:  artes --reportName 'Alma UI'
-            📁 --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"
-            --saveVar         Set variables from cli
-                        artes --saveVar '{"armud":20,"banana":200}'
-            🕶️ --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
-            🔄 --rerun         Rerun only the failed tests from previous run
-                Usage:   artes --rerun @rerun.txt
-            🎭 --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
-            --offline       Run browser in offline mode
-                Usage:   artes --offline
-            📱 --device       Emulate specific device (e.g., "iPhone 13")
-                Usage:   artes --device "iPhone 13"
-            🌐 --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
-      `);
-}
-function showAIHelp() {
-  console.log(`
-        🚀 Artes AI Bug reporter
-        Usage:
+            -h, --help      Show this help message
+            -v, --version   Show current version of artes
+            -c, --create    Create example artes project
+            -y, --yes       Skip confirmation prompt when creating a project
+            --noDeps        Create project without installing dependencies
+        For more options, use:
+            artes report --help       Reporting & branding options
+            artes browser --help      Browser & environment options
+            artes execution --help    Execution control options
+            artes ai --help           AI bug reporter options
+    `);
+  }
+  function showReportingHelp() {
+    console.log(`
+      Artes CLI - Reporting & Branding
+        Usage:
             npx artes [options]
+        Options:
+            -r, --report              Run tests and generate Allure report
+                Usage: artes -r or artes --report
+            --reportSuccess           Generate screenshot and video with successful tests too
+                Usage: artes --reportSuccess
+            -rwt, --reportWithTrace   Include trace in the report
+                Usage: artes --reportWithTrace
+            --trace                   Enable tracing for all tests
+                Usage: artes --trace
+            --singleFileReport        Generate single file Allure report
+                Usage: artes -r --singleFileReport
+            --zip                     Zip the report folder after generation
+                Usage: artes -r --zip
+            --logo                    Set a custom logo in the report sidebar
+                Usage: artes --logo logo.png
+            --brandName               Set the brand name displayed next to the logo
+                Usage: artes --brandName 'My Company'
+            --reportName              Report name on the summary widget
+                Usage: artes --reportName 'Alma UI'
+            --uploadReport            Upload the generated report to Artes Reporting System
+                Usage: artes --uploadReport --reporterURL "https://example.com/upload"
+            --reporterURL             URL of the Artes Reporting System
+                Usage: artes --uploadReport --reporterURL "https://example.com/upload"
+            --projectName             Project name in the Artes Reporting System (default: "Artes Report")
+                Usage: artes --uploadReport --reporterURL "https://example.com/upload" --projectName "My Project"
+            --projectType             Project type for reporting, e.g., UI, API (default: "Artes")
+                Usage: artes --uploadReport --reporterURL "https://example.com/upload" --projectType "API"
+            --reportPath              Path to the report zip or html file to upload (default: ./report.zip)
+                Usage: artes --uploadReport --reporterURL "https://example.com/upload" --reportPath "./my_report.zip"
+    `);
+  }
+  function showBrowserHelp() {
+    console.log(`
+      Artes CLI - Browser & Environment
+        Usage:
+            npx artes [options]
+        Options:
+            --browser     Specify browser to use (chromium, firefox, webkit)
+                Usage: artes --browser chromium
+            --device      Emulate a specific device (e.g., "iPhone 13")
+                Usage: artes --device "iPhone 13"
+            --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
+    `);
+  }
+  function showExecutionHelp() {
+    console.log(`
+      Artes CLI - Execution
+        Usage:
+            npx artes [options]
         Options:
-            🤖 --ai            Enable AI-generated bug reports and test summaries
-                Usage:   artes --ai
-            🧠 --aiModel       AI model to use for report generation
-                               Supported: "gpt-4o", "gemini 2.5 flash", "claude sonnet", "mistral large"
-                Usage:   artes --ai --aiModel "gemini 2.5 flash"
-            🔑 --aiKey         API key for the selected AI provider
-                Usage:   artes --ai --aiKey "your-api-key"
-            🔗 --aiURL         Local AI endpoint URL (e.g., Ollama, LM Studio). Overrides --aiModel and --aiKey when set
-                Usage:   artes --ai --aiURL "http://localhost:11434/api/chat"
-            🌍 --aiLanguage    Language for AI-generated reports (default: "English")
-                Usage:   artes --ai --aiLanguage "Azerbaijani"
-            🔢 --maxTokens     Maximum tokens for AI-generated reports (default: 4000)
-                Usage:   artes --ai --maxTokens 8000
-            📋 --maxReports    Maximum number of AI reports to generate per test run (default: 10)
-                Usage:   artes --ai --maxReports 5
-      `);
-}
-module.exports = {
-  showHelp, showAIHelp
-};
+            --headless    Run browser in headless mode
+                Usage: artes --headless
+            --baseURL     Set base URL for the tests
+                Usage: artes --baseURL "https://example.com"
+            --env         Set environment for the test run
+                Usage: artes --env "dev"
+            --offline     Run browser in offline mode
+                Usage: artes --offline
+            --features      Specify feature file paths to run (comma-separated)
+                Usage: artes --features "tests/features/Alma, tests/features/Banan.feature"
+            --stepDef       Specify step definition file 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"
+            --parallel      Run tests in parallel mode
+                Usage: artes --parallel 3
+            --retry         Retry failed tests
+                Usage: artes --retry 2
+            --rerun         Rerun only failed tests from previous run
+                Usage: artes --rerun @rerun.txt
+            --dryRun        Perform a dry run without executing tests
+                Usage: artes --dryRun
+            --percentage    Set minimum success percentage to pass test run
+                Usage: artes --percentage 85
+            --timeout       Set timeout for each test step (default: 30 seconds)
+                Usage: artes --timeout 10
+            --slowMo        Slow down execution for clear view (default: 0)
+                Usage: artes --slowMo 1
+            --saveVar       Set variables from CLI
+                Usage: artes --saveVar '{"armud":20,"banana":200}'
+    `);
+  }
+  function showAIHelp() {
+    console.log(`
+      Artes CLI - AI Bug Reporter
+        Usage:
+            npx artes [options]
+        Options:
+            --ai            Enable AI-generated bug reports and test summaries
+                Usage: artes --ai
+            --aiModel       AI model to use for report generation.
+                            (For supported AI models: https://github.com/4gayev1/Artes/blob/main/docs/aiProviders.md)
+                Usage: artes --ai --aiModel "gemini 2.5 flash"
+            --aiKey         API key for the selected AI provider
+                Usage: artes --ai --aiKey "your-api-key"
+            --aiURL         Local AI endpoint URL (e.g., Ollama, LM Studio). Overrides --aiModel and --aiKey when set
+                Usage: artes --ai --aiURL "http://localhost:11434/api/chat"
+            --aiLanguage    Language for AI-generated reports (default: "English")
+                Usage: artes --ai --aiLanguage "Azerbaijani"
+            --maxTokens     Maximum tokens for AI-generated reports (default: 4000)
+                Usage: artes --ai --maxTokens 8000
+            --maxReports    Maximum number of AI reports to generate per test run (default: 10)
+                Usage: artes --ai --maxReports 5
+    `);
+  }
+  module.exports = {
+    showHelp,
+    showReportingHelp,
+    showBrowserHelp,
+    showExecutionHelp,
+    showAIHelp
+  };

package/src/stepDefinitions/assertions.steps.js CHANGED Viewed

@@ -9,7 +9,7 @@ const {
 } = require("../helper/imports/commons");
 const {
   screenComparer,
-} = require("artes/src/helper/controller/screenComparer");
+} = require("../helper/controller/screenComparer");
 const { assert, frame } = require("../helper/stepFunctions/exporter");
 const Ajv = require("ajv");
@@ -399,6 +399,29 @@ Then(
   },
 );
+Then(
+  "User expects that {string} screenshot match with {string} screenshot",
+  async function (ss1, ss2) {
+    await screenComparer(
+      ss1,
+      null,
+      { maxDiffPercent: 0.01, comparePath: ss2 },
+    );
+  },
+);
+Then(
+  "User expects that {string} screenshot match with {string} screenshot with {float}% difference",
+  async function (ss1, ss2, maxDiff) {
+    await screenComparer(
+      ss1,
+      null,
+      { maxDiffPercent: maxDiff / 100, comparePath: ss2 },
+    );
+  },
+);
 // Check if a selector should have specific text
 Then(
   "User expects {string} should match {string} text",