allure 3.3.1 → 3.4.0

package/README.md

@@ -50,6 +50,12 @@ For example, if you're using `npm` as your test runner, the command would be:
 npx allure run -- npm test
 ```
 
+To hide specific labels use `--hide-labels` option:
+
+```bash
+npx allure run --hide-labels=owner --hide-labels=tag -- npm test
+```
+
 To successfully generate a report, ensure that your test setup outputs results into an `allure-results` directory, which is automatically detected by Allure 3. This directory can be placed at any nested level within your project (e.g., `out/tests/allure-results`), provided it retains the correct name.
 
 After the tests complete, the report is generated automatically. Existing results from previous runs are ignored, as Allure 3 focuses solely on new data to ensure accurate and up-to-date reporting.
@@ -121,6 +127,7 @@ import { defineConfig } from "allure";
 export default defineConfig({
   name: "Allure Report Example",
   output: "./out/allure-report",
+  hideLabels: ["owner", /^_/],
   plugins: {
     awesome: {
       options: {
@@ -140,6 +147,7 @@ The configuration file allows you to fine-tune report generation. Key options in
 
 - **`name`**: Specifies the report’s display name.
 - **`output`**: Defines the directory where the report will be saved.
+- **`hideLabels`** *(`(string | RegExp)[]`)*: Hides matching labels by name in report data. Currently, only Allure Awesome report respects the option. Labels with names starting with `_` are hidden by default.
 - **`plugins`**: Enables and configures plugins, with each supporting various options.
 
 ### Awesome Plugin Options

package/dist/commands/allure2.js

@@ -1,10 +1,10 @@
-import { AllureReport, readConfig } from "@allurereport/core";
-import Allure2Plugin from "@allurereport/plugin-allure2";
-import { Command, Option } from "clipanion";
 import * as console from "node:console";
 import { existsSync } from "node:fs";
 import { realpath } from "node:fs/promises";
 import process, { exit } from "node:process";
+import { AllureReport, readConfig } from "@allurereport/core";
+import Allure2Plugin from "@allurereport/plugin-allure2";
+import { Command, Option } from "clipanion";
 import { red } from "yoctocolors";
 export class Allure2Command extends Command {
     constructor() {

package/dist/commands/awesome.d.ts

@@ -14,5 +14,6 @@ export declare class AwesomeCommand extends Command {
     historyPath: string | undefined;
     knownIssues: string | undefined;
     groupBy: string | undefined;
+    hideLabels: string[] | undefined;
     execute(): Promise<void>;
 }

package/dist/commands/awesome.js

@@ -1,10 +1,10 @@
-import { AllureReport, readConfig } from "@allurereport/core";
-import { default as AwesomePlugin } from "@allurereport/plugin-awesome";
-import { Command, Option } from "clipanion";
 import * as console from "node:console";
 import { existsSync } from "node:fs";
 import { realpath } from "node:fs/promises";
 import process, { exit } from "node:process";
+import { AllureReport, readConfig } from "@allurereport/core";
+import { default as AwesomePlugin } from "@allurereport/plugin-awesome";
+import { Command, Option } from "clipanion";
 import { red } from "yoctocolors";
 export class AwesomeCommand extends Command {
     constructor() {
@@ -43,6 +43,9 @@ export class AwesomeCommand extends Command {
         this.groupBy = Option.String("--group-by,-g", {
             description: "Group test results by labels. The labels should be separated by commas",
         });
+        this.hideLabels = Option.Array("--hide-labels", {
+            description: "Hide labels by exact name in generated reports. Repeat the option for multiple labels",
+        });
     }
     async execute() {
         if (!existsSync(this.resultsDir)) {
@@ -52,6 +55,14 @@ export class AwesomeCommand extends Command {
         }
         const cwd = await realpath(this.cwd ?? process.cwd());
         const before = new Date().getTime();
+        const hideLabels = this.hideLabels?.length ? this.hideLabels : undefined;
+        const config = await readConfig(cwd, this.config, {
+            output: this.output,
+            name: this.reportName,
+            knownIssuesPath: this.knownIssues,
+            historyPath: this.historyPath,
+            hideLabels,
+        });
         const defaultAwesomeOptions = {
             singleFile: this.singleFile ?? false,
             logo: this.logo,
@@ -59,12 +70,6 @@ export class AwesomeCommand extends Command {
             reportLanguage: this.reportLanguage,
             groupBy: this.groupBy?.split?.(",") ?? ["parentSuite", "suite", "subSuite"],
         };
-        const config = await readConfig(cwd, this.config, {
-            output: this.output,
-            name: this.reportName,
-            knownIssuesPath: this.knownIssues,
-            historyPath: this.historyPath,
-        });
         config.plugins = [
             {
                 id: "awesome",

package/dist/commands/classic.js

@@ -1,10 +1,10 @@
-import { AllureReport, readConfig } from "@allurereport/core";
-import ClassicPlugin from "@allurereport/plugin-classic";
-import { Command, Option } from "clipanion";
 import * as console from "node:console";
 import { existsSync } from "node:fs";
 import { realpath } from "node:fs/promises";
 import process, { exit } from "node:process";
+import { AllureReport, readConfig } from "@allurereport/core";
+import ClassicPlugin from "@allurereport/plugin-classic";
+import { Command, Option } from "clipanion";
 import { red } from "yoctocolors";
 export class ClassicCommand extends Command {
     constructor() {

package/dist/commands/commons/generate.js

@@ -1,7 +1,7 @@
+import { exit } from "node:process";
 import { AllureReport } from "@allurereport/core";
 import { KnownError } from "@allurereport/service";
 import { glob } from "glob";
-import { exit } from "node:process";
 import { red } from "yoctocolors";
 import { logError } from "../../utils/logs.js";
 export const generate = async (params) => {

package/dist/commands/csv.js

@@ -1,11 +1,11 @@
-import { AllureReport, readConfig } from "@allurereport/core";
-import CsvPlugin from "@allurereport/plugin-csv";
-import { Command, Option } from "clipanion";
 import * as console from "node:console";
 import { existsSync } from "node:fs";
 import { realpath } from "node:fs/promises";
 import { isAbsolute, join } from "node:path";
 import process, { exit } from "node:process";
+import { AllureReport, readConfig } from "@allurereport/core";
+import CsvPlugin from "@allurereport/plugin-csv";
+import { Command, Option } from "clipanion";
 import { red } from "yoctocolors";
 export class CsvCommand extends Command {
     constructor() {

package/dist/commands/dashboard.js

@@ -1,10 +1,10 @@
-import { AllureReport, readConfig } from "@allurereport/core";
-import DashboardPlugin from "@allurereport/plugin-dashboard";
-import { Command, Option } from "clipanion";
 import * as console from "node:console";
 import { existsSync } from "node:fs";
 import { realpath } from "node:fs/promises";
 import process, { exit } from "node:process";
+import { AllureReport, readConfig } from "@allurereport/core";
+import DashboardPlugin from "@allurereport/plugin-dashboard";
+import { Command, Option } from "clipanion";
 import { red } from "yoctocolors";
 export class DashboardCommand extends Command {
     constructor() {

package/dist/commands/generate.d.ts

@@ -11,5 +11,6 @@ export declare class GenerateCommand extends Command {
     open: boolean | undefined;
     port: string | undefined;
     historyLimit: string | undefined;
+    hideLabels: string[] | undefined;
     execute(): Promise<void>;
 }

package/dist/commands/generate.js

@@ -1,7 +1,7 @@
+import { cwd as processCwd } from "node:process";
 import { readConfig } from "@allurereport/core";
 import { serve } from "@allurereport/static-server";
 import { Command, Option } from "clipanion";
-import { cwd as processCwd } from "node:process";
 import { generate } from "./commons/generate.js";
 export class GenerateCommand extends Command {
     constructor() {
@@ -34,14 +34,19 @@ export class GenerateCommand extends Command {
         this.historyLimit = Option.String("--history-limit", {
             description: "Limits the number of history entries to keep (default: unlimited)",
         });
+        this.hideLabels = Option.Array("--hide-labels", {
+            description: "Hide labels by exact name in generated reports. Repeat the option for multiple labels",
+        });
     }
     async execute() {
         const cwd = this.cwd ?? processCwd();
+        const hideLabels = this.hideLabels?.length ? this.hideLabels : undefined;
         const config = await readConfig(cwd, this.config, {
             name: this.reportName,
             output: this.output,
             open: this.open,
             port: this.port,
+            hideLabels,
             historyLimit: this.historyLimit ? parseInt(this.historyLimit, 10) : undefined,
         });
         await generate({

package/dist/commands/history.js

@@ -1,8 +1,8 @@
-import { AllureReport, resolveConfig } from "@allurereport/core";
-import { Command, Option } from "clipanion";
 import * as console from "node:console";
 import { existsSync } from "node:fs";
 import { exit } from "node:process";
+import { AllureReport, resolveConfig } from "@allurereport/core";
+import { Command, Option } from "clipanion";
 import { red } from "yoctocolors";
 export class HistoryCommand extends Command {
     constructor() {

package/dist/commands/jira/clear.js

@@ -1,8 +1,8 @@
+import { realpath } from "node:fs/promises";
+import process, { exit } from "node:process";
 import { getPluginInstance, readConfig } from "@allurereport/core";
 import JiraPlugin from "@allurereport/plugin-jira";
 import { Command, Option, UsageError } from "clipanion";
-import { realpath } from "node:fs/promises";
-import process, { exit } from "node:process";
 import { green, red } from "yoctocolors";
 class BaseJiraCommand extends Command {
     constructor() {

package/dist/commands/knownIssue.js

@@ -1,9 +1,9 @@
-import { AllureReport, resolveConfig, writeKnownIssues } from "@allurereport/core";
-import { Command, Option } from "clipanion";
 import * as console from "node:console";
 import { existsSync } from "node:fs";
 import { resolve } from "node:path";
 import { exit } from "node:process";
+import { AllureReport, resolveConfig, writeKnownIssues } from "@allurereport/core";
+import { Command, Option } from "clipanion";
 import { red } from "yoctocolors";
 export class KnownIssueCommand extends Command {
     constructor() {

package/dist/commands/log.js

@@ -1,10 +1,10 @@
-import { AllureReport, readConfig } from "@allurereport/core";
-import LogPlugin from "@allurereport/plugin-log";
-import { Command, Option } from "clipanion";
 import * as console from "node:console";
 import { existsSync } from "node:fs";
 import { realpath } from "node:fs/promises";
 import process, { exit } from "node:process";
+import { AllureReport, readConfig } from "@allurereport/core";
+import LogPlugin from "@allurereport/plugin-log";
+import { Command, Option } from "clipanion";
 import { red } from "yoctocolors";
 export class LogCommand extends Command {
     constructor() {

package/dist/commands/open.d.ts

@@ -6,5 +6,6 @@ export declare class OpenCommand extends Command {
     config: string | undefined;
     port: string | undefined;
     cwd: string | undefined;
+    hideLabels: string[] | undefined;
     execute(): Promise<void>;
 }

package/dist/commands/open.js

@@ -1,12 +1,12 @@
-import { readConfig } from "@allurereport/core";
-import { serve } from "@allurereport/static-server";
-import { Command, Option } from "clipanion";
-import { glob } from "glob";
 import { existsSync } from "node:fs";
 import { mkdtemp, rm } from "node:fs/promises";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
 import { cwd as processCwd } from "node:process";
+import { readConfig } from "@allurereport/core";
+import { serve } from "@allurereport/static-server";
+import { Command, Option } from "clipanion";
+import { glob } from "glob";
 import { generate } from "./commons/generate.js";
 export class OpenCommand extends Command {
     constructor() {
@@ -24,9 +24,13 @@ export class OpenCommand extends Command {
         this.cwd = Option.String("--cwd", {
             description: "The working directory for the command to run (default: current working directory)",
         });
+        this.hideLabels = Option.Array("--hide-labels", {
+            description: "Hide labels by exact name in generated reports. Repeat the option for multiple labels",
+        });
     }
     async execute() {
         const cwd = this.cwd ?? processCwd();
+        const hideLabels = this.hideLabels?.length ? this.hideLabels : undefined;
         const targetFullPath = join(cwd, this.resultsDir ?? "allure-report");
         const summaryFiles = existsSync(targetFullPath)
             ? await glob(join(targetFullPath, "**", "summary.json"), {
@@ -53,6 +57,7 @@ export class OpenCommand extends Command {
             const config = await readConfig(cwd, this.config, {
                 port: this.port,
                 output: tmpDir,
+                hideLabels,
             });
             await generate({
                 resultsDir: targetFullPath,

package/dist/commands/qualityGate.d.ts

@@ -10,6 +10,7 @@ export declare class QualityGateCommand extends Command {
     successRate: number | undefined;
     knownIssues: string | undefined;
     environment: string | undefined;
+    environmentName: string | undefined;
     cwd: string | undefined;
     execute(): Promise<void>;
 }

package/dist/commands/qualityGate.js

@@ -1,11 +1,12 @@
-import { AllureReport, QualityGateState, readConfig, stringifyQualityGateResults } from "@allurereport/core";
-import { Command, Option } from "clipanion";
-import { glob } from "glob";
 import * as console from "node:console";
 import { realpath } from "node:fs/promises";
 import { exit, cwd as processCwd } from "node:process";
+import { AllureReport, QualityGateState, readConfig, stringifyQualityGateResults } from "@allurereport/core";
+import { Command, Option } from "clipanion";
+import { glob } from "glob";
 import * as typanion from "typanion";
 import { red } from "yoctocolors";
+import { environmentNameOption, environmentOption, normalizeCommandEnvironmentOptions, resolveCommandEnvironment, } from "../utils/environment.js";
 export class QualityGateCommand extends Command {
     constructor() {
         super(...arguments);
@@ -34,20 +35,25 @@ export class QualityGateCommand extends Command {
         this.knownIssues = Option.String("--known-issues", {
             description: "Path to the known issues file. Updates the file and quarantines failed tests when specified",
         });
-        this.environment = Option.String("--environment,--env", {
-            description: "Force specific environment to all tests in the run. Given environment has higher priority than the one defined in the config file (default: empty string)",
-        });
+        this.environment = environmentOption();
+        this.environmentName = environmentNameOption();
         this.cwd = Option.String("--cwd", {
             description: "The working directory for the command to run (default: current working directory)",
         });
     }
     async execute() {
+        const environmentOptions = {
+            environment: this.environment,
+            environmentName: this.environmentName,
+        };
+        normalizeCommandEnvironmentOptions(environmentOptions);
         const cwd = await realpath(this.cwd ?? processCwd());
         const resultsDir = (this.resultsDir ?? "./**/allure-results").replace(/[\\/]$/, "");
-        const { maxFailures, minTestsCount, successRate, fastFail, knownIssues: knownIssuesPath, environment } = this;
+        const { maxFailures, minTestsCount, successRate, fastFail, knownIssues: knownIssuesPath } = this;
         const config = await readConfig(cwd, this.config, {
             knownIssuesPath,
         });
+        const resolvedEnvironment = resolveCommandEnvironment(config, environmentOptions);
         const rules = {};
         if (maxFailures !== undefined) {
             rules.maxFailures = maxFailures;
@@ -67,7 +73,10 @@ export class QualityGateCommand extends Command {
                 rules: [rules],
             };
         }
-        const allureReport = new AllureReport(config);
+        const allureReport = new AllureReport({
+            ...config,
+            environment: resolvedEnvironment?.id,
+        });
         if (!allureReport.hasQualityGate) {
             console.error(red("Quality gate is not configured!"));
             console.error(red("Add qualityGate to the config or consult help to know, how to use the command with command-line arguments"));
@@ -94,7 +103,7 @@ export class QualityGateCommand extends Command {
             const notHiddenTrs = trs.filter((tr) => !tr.hidden);
             const { results, fastFailed } = await allureReport.validate({
                 trs: notHiddenTrs,
-                environment,
+                environment: resolvedEnvironment?.id,
                 knownIssues,
                 state,
             });
@@ -113,7 +122,7 @@ export class QualityGateCommand extends Command {
         const validationResults = await allureReport.validate({
             trs: allTrs,
             knownIssues,
-            environment,
+            environment: resolvedEnvironment?.id,
         });
         if (validationResults.results.length === 0) {
             exit(0);

package/dist/commands/results/pack.js

@@ -4,14 +4,14 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
     return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
 };
 var _ResultsPackCommand_instances, _ResultsPackCommand_formatSize;
-import AdmZip from "adm-zip";
-import { Command, Option } from "clipanion";
-import { glob } from "glob";
 import * as console from "node:console";
 import * as fs from "node:fs/promises";
 import { realpath } from "node:fs/promises";
 import { basename, join, resolve } from "node:path";
 import { exit } from "node:process";
+import AdmZip from "adm-zip";
+import { Command, Option } from "clipanion";
+import { glob } from "glob";
 import { green, red } from "yoctocolors";
 export class ResultsPackCommand extends Command {
     constructor() {

package/dist/commands/results/unpack.js

@@ -1,9 +1,9 @@
-import AdmZip from "adm-zip";
-import { Command, Option } from "clipanion";
 import * as console from "node:console";
 import * as fs from "node:fs/promises";
 import { realpath } from "node:fs/promises";
 import { basename, resolve } from "node:path";
+import AdmZip from "adm-zip";
+import { Command, Option } from "clipanion";
 import { green, red } from "yoctocolors";
 export class ResultsUnpackCommand extends Command {
     constructor() {
@@ -25,13 +25,15 @@ export class ResultsUnpackCommand extends Command {
         try {
             await fs.mkdir(outputDir, { recursive: true });
         }
-        catch (ignored) { }
+        catch {
+        }
         let successCount = 0;
         let failCount = 0;
         for (const archivePath of archives) {
             const resolvedPath = resolve(cwd, archivePath);
             try {
-                await fs.access(resolvedPath);
+                await fs.access(resolvedPath, fs.constants.R_OK);
+                await fs.access(outputDir, fs.constants.W_OK);
                 console.log(`Extracting ${resolvedPath} to ${outputDir}`);
                 try {
                     const zip = new AdmZip(resolvedPath);

package/dist/commands/run.d.ts

@@ -20,7 +20,9 @@ export declare class RunCommand extends Command {
     ignoreLogs: boolean | undefined;
     dump: string | undefined;
     environment: string | undefined;
+    environmentName: string | undefined;
     historyLimit: string | undefined;
+    hideLabels: string[] | undefined;
     commandToRun: string[];
     get logs(): "pipe" | "inherit" | "ignore";
     execute(): Promise<void>;

package/dist/commands/run.js

@@ -1,3 +1,9 @@
+import * as console from "node:console";
+import { randomUUID } from "node:crypto";
+import { mkdtemp, realpath, rm, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join, resolve } from "node:path";
+import process, { exit } from "node:process";
 import { AllureReport, QualityGateState, isFileNotFoundError, readConfig, stringifyQualityGateResults, } from "@allurereport/core";
 import { createTestPlan } from "@allurereport/core-api";
 import { allureResultsDirectoriesWatcher, delayedFileProcessingWatcher, newFilesInDirectoryWatcher, } from "@allurereport/directory-watcher";
@@ -5,14 +11,9 @@ import Awesome from "@allurereport/plugin-awesome";
 import { BufferResultFile, PathResultFile } from "@allurereport/reader-api";
 import { KnownError } from "@allurereport/service";
 import { serve } from "@allurereport/static-server";
-import { Command, Option } from "clipanion";
-import * as console from "node:console";
-import { randomUUID } from "node:crypto";
-import { mkdtemp, realpath, rm, writeFile } from "node:fs/promises";
-import { tmpdir } from "node:os";
-import { join, resolve } from "node:path";
-import process, { exit } from "node:process";
+import { Command, Option, UsageError } from "clipanion";
 import { red } from "yoctocolors";
+import { environmentNameOption, environmentOption, normalizeCommandEnvironmentOptions, resolveCommandEnvironment, } from "../utils/environment.js";
 import { logTests, runProcess, terminationOf } from "../utils/index.js";
 import { logError } from "../utils/logs.js";
 import { stopProcessTree } from "../utils/process.js";
@@ -163,12 +164,14 @@ export class RunCommand extends Command {
         this.dump = Option.String("--dump", {
             description: "Runs tests in dump mode to collect results to a dump archive with the provided name (default: empty string)",
         });
-        this.environment = Option.String("--environment,--env", {
-            description: "Force specific environment to all tests in the run. Given environment has higher priority than the one defined in the config file (default: empty string)",
-        });
+        this.environment = environmentOption();
+        this.environmentName = environmentNameOption();
         this.historyLimit = Option.String("--history-limit", {
             description: "Limits the number of history entries to keep (default: unlimited)",
         });
+        this.hideLabels = Option.Array("--hide-labels", {
+            description: "Hide labels by exact name in generated reports. Repeat the option for multiple labels",
+        });
         this.commandToRun = Option.Rest();
     }
     get logs() {
@@ -180,8 +183,13 @@ export class RunCommand extends Command {
     async execute() {
         const args = this.commandToRun.filter((arg) => arg !== "--");
         if (!args || !args.length) {
-            throw new Error("expecting command to be specified after --, e.g. allure run -- npm run test");
+            throw new UsageError("expecting command to be specified after --, e.g. allure run -- npm run test");
         }
+        const environmentOptions = {
+            environment: this.environment,
+            environmentName: this.environmentName,
+        };
+        normalizeCommandEnvironmentOptions(environmentOptions);
         const before = new Date().getTime();
         process.on("exit", (exitCode) => {
             const after = new Date().getTime();
@@ -190,6 +198,7 @@ export class RunCommand extends Command {
         const command = args[0];
         const commandArgs = args.slice(1);
         const cwd = await realpath(this.cwd ?? process.cwd());
+        const hideLabels = this.hideLabels?.length ? this.hideLabels : undefined;
         console.log(`${command} ${commandArgs.join(" ")}`);
         const maxRerun = this.rerun ? parseInt(this.rerun, 10) : 0;
         const config = await readConfig(cwd, this.config, {
@@ -197,8 +206,10 @@ export class RunCommand extends Command {
             name: this.reportName,
             open: this.open,
             port: this.port,
+            hideLabels,
             historyLimit: this.historyLimit ? parseInt(this.historyLimit, 10) : undefined,
         });
+        const resolvedEnvironment = resolveCommandEnvironment(config, environmentOptions);
         const withQualityGate = !!config.qualityGate;
         const withRerun = !!this.rerun;
         if (withQualityGate && withRerun) {
@@ -216,7 +227,7 @@ export class RunCommand extends Command {
         }
         const allureReport = new AllureReport({
             ...config,
-            environment: this.environment,
+            environment: resolvedEnvironment?.id,
             dump: this.dump,
             realTime: false,
             plugins: [
@@ -251,7 +262,7 @@ export class RunCommand extends Command {
                 cwd,
                 command,
                 commandArgs,
-                environment: this.environment,
+                environment: resolvedEnvironment?.id,
                 environmentVariables: {},
                 withQualityGate,
             });
@@ -275,7 +286,7 @@ export class RunCommand extends Command {
                     cwd,
                     command,
                     commandArgs,
-                    environment: this.environment,
+                    environment: resolvedEnvironment?.id,
                     environmentVariables: {
                         ALLURE_TESTPLAN_PATH: testPlanPath,
                         ALLURE_RERUN: `${rerun}`,
@@ -291,7 +302,7 @@ export class RunCommand extends Command {
                 const { results } = await allureReport.validate({
                     trs,
                     knownIssues,
-                    environment: this.environment,
+                    environment: resolvedEnvironment?.id,
                 });
                 qualityGateResults = results;
             }

package/dist/commands/slack.js

@@ -1,10 +1,10 @@
-import { AllureReport, readConfig } from "@allurereport/core";
-import SlackPlugin from "@allurereport/plugin-slack";
-import { Command, Option } from "clipanion";
 import * as console from "node:console";
 import { existsSync } from "node:fs";
 import { realpath } from "node:fs/promises";
 import process, { exit } from "node:process";
+import { AllureReport, readConfig } from "@allurereport/core";
+import SlackPlugin from "@allurereport/plugin-slack";
+import { Command, Option } from "clipanion";
 import { red } from "yoctocolors";
 export class SlackCommand extends Command {
     constructor() {

package/dist/commands/testplan.js

@@ -1,9 +1,9 @@
-import { AllureReport, resolveConfig } from "@allurereport/core";
-import { Command, Option } from "clipanion";
 import * as console from "node:console";
 import { existsSync } from "node:fs";
 import { basename, dirname, resolve } from "node:path";
 import { exit } from "node:process";
+import { AllureReport, resolveConfig } from "@allurereport/core";
+import { Command, Option } from "clipanion";
 import { red } from "yoctocolors";
 export class TestPlanCommand extends Command {
     constructor() {

package/dist/commands/watch.js

@@ -1,3 +1,8 @@
+import * as console from "node:console";
+import { existsSync } from "node:fs";
+import { rm } from "node:fs/promises";
+import { join, resolve } from "node:path";
+import process, { exit } from "node:process";
 import { AllureReport, isFileNotFoundError, readConfig } from "@allurereport/core";
 import { newFilesInDirectoryWatcher } from "@allurereport/directory-watcher";
 import Awesome from "@allurereport/plugin-awesome";
@@ -6,11 +11,6 @@ import ServerReloadPlugin from "@allurereport/plugin-server-reload";
 import { PathResultFile } from "@allurereport/reader-api";
 import { serve } from "@allurereport/static-server";
 import { Command, Option } from "clipanion";
-import * as console from "node:console";
-import { existsSync } from "node:fs";
-import { rm } from "node:fs/promises";
-import { join, resolve } from "node:path";
-import process, { exit } from "node:process";
 import { red } from "yoctocolors";
 export class WatchCommand extends Command {
     constructor() {

package/dist/commands/whoami.js

@@ -1,8 +1,8 @@
+import * as console from "node:console";
+import { exit } from "node:process";
 import { readConfig } from "@allurereport/core";
 import { AllureServiceClient, KnownError } from "@allurereport/service";
 import { Command, Option } from "clipanion";
-import * as console from "node:console";
-import { exit } from "node:process";
 import { green, red } from "yoctocolors";
 import { logError } from "../utils/logs.js";
 export class WhoamiCommand extends Command {

package/dist/index.js

@@ -1,6 +1,6 @@
-import { Builtins, Cli } from "clipanion";
 import { readFileSync } from "node:fs";
 import { argv } from "node:process";
+import { Builtins, Cli } from "clipanion";
 import { Allure2Command, AwesomeCommand, ClassicCommand, CsvCommand, DashboardCommand, GenerateCommand, HistoryCommand, JiraClearCommand, KnownIssueCommand, LogCommand, OpenCommand, QualityGateCommand, ResultsPackCommand, ResultsUnpackCommand, RunCommand, SlackCommand, TestPlanCommand, WatchCommand, WhoamiCommand, } from "./commands/index.js";
 const [node, app, ...args] = argv;
 const pkg = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8"));

package/dist/utils/environment.d.ts

@@ -0,0 +1,16 @@
+import { type FullConfig } from "@allurereport/core";
+import type { EnvironmentIdentity } from "@allurereport/core-api";
+type CommandEnvironmentOptions = {
+    environment?: string;
+    environmentName?: string;
+};
+export declare const environmentOption: () => string | undefined;
+export declare const environmentNameOption: () => string | undefined;
+export declare const resolveCommandEnvironment: (config: Pick<FullConfig, "environment" | "environments">, options: CommandEnvironmentOptions & {
+    source?: string;
+}) => EnvironmentIdentity | undefined;
+export declare const normalizeCommandEnvironmentOptions: (options: CommandEnvironmentOptions) => {
+    environment: string | undefined;
+    environmentName: string | undefined;
+};
+export {};

package/dist/utils/environment.js

@@ -0,0 +1,64 @@
+import { environmentIdentityById, environmentIdentityByName } from "@allurereport/core";
+import { validateEnvironmentId, validateEnvironmentName } from "@allurereport/core-api";
+import { Option, UsageError } from "clipanion";
+const environmentOptionDescription = "Force specific environment ID to all tests in the run. Given environment has higher priority than the one defined in the config file (default: empty string)";
+const environmentNameOptionDescription = "Force specific environment display name to all tests in the run. Has lower priority than --environment and higher priority than the config value (default: empty string)";
+export const environmentOption = () => Option.String("--environment,--env", {
+    description: environmentOptionDescription,
+});
+export const environmentNameOption = () => Option.String("--environment-name", {
+    description: environmentNameOptionDescription,
+});
+const resolveEnvironmentByName = (config, environmentName, source) => {
+    const identity = environmentIdentityByName(config.environments ?? {}, environmentName);
+    if (!identity) {
+        throw new UsageError(`${source}: environment name ${JSON.stringify(environmentName)} does not match any configured environment`);
+    }
+    return identity;
+};
+const resolveConfigEnvironment = (config) => {
+    if (config.environment === undefined) {
+        return undefined;
+    }
+    return (environmentIdentityById(config.environments ?? {}, config.environment) ??
+        environmentIdentityByName(config.environments ?? {}, config.environment) ?? {
+        id: config.environment,
+        name: config.environment,
+    });
+};
+export const resolveCommandEnvironment = (config, options) => {
+    const source = options.source ?? "cli";
+    const { environment, environmentName } = normalizeCommandEnvironmentOptions(options);
+    const identityFromId = environment !== undefined
+        ? (environmentIdentityById(config.environments ?? {}, environment) ?? { id: environment, name: environment })
+        : undefined;
+    const identityFromName = environmentName !== undefined ? resolveEnvironmentByName(config, environmentName, source) : undefined;
+    const configIdentity = resolveConfigEnvironment(config);
+    if (identityFromId && identityFromName && identityFromId.id !== identityFromName.id) {
+        throw new UsageError(`${source}: environment id ${JSON.stringify(identityFromId.id)} and environment name ${JSON.stringify(identityFromName.name)} resolve to different environments`);
+    }
+    const identity = identityFromId ?? identityFromName ?? configIdentity;
+    return identity;
+};
+export const normalizeCommandEnvironmentOptions = (options) => {
+    let environment;
+    let environmentName;
+    if (typeof options.environment === "string") {
+        const validation = validateEnvironmentId(options.environment);
+        if (!validation.valid) {
+            throw new UsageError(`Invalid --environment value ${JSON.stringify(options.environment)}: ${validation.reason}`);
+        }
+        environment = validation.normalized;
+    }
+    if (typeof options.environmentName === "string") {
+        const validation = validateEnvironmentName(options.environmentName);
+        if (!validation.valid) {
+            throw new UsageError(`Invalid --environment-name value ${JSON.stringify(options.environmentName)}: ${validation.reason}`);
+        }
+        environmentName = validation.normalized;
+    }
+    return {
+        environment,
+        environmentName,
+    };
+};

package/dist/utils/process.js

@@ -1,7 +1,7 @@
-import { invokeStdoutCliTool } from "@allurereport/reader-api";
 import { spawn } from "node:child_process";
 import process from "node:process";
 import { platform } from "process";
+import { invokeStdoutCliTool } from "@allurereport/reader-api";
 const IS_WIN = platform === "win32";
 const PS_OUTPUT_PATTERN = /(?<ppid>\d+)\s+(?<pid>\d+)\s+(?<comm>.*)/;
 export const runProcess = (params) => {

package/dist/utils/terminal.js

@@ -1,5 +1,5 @@
-import { formatDuration } from "@allurereport/core-api";
 import console from "node:console";
+import { formatDuration } from "@allurereport/core-api";
 import { blue, gray, green, red, yellow } from "yoctocolors";
 export const status2color = (status) => {
     switch (status) {

package/package.json

@@ -1,56 +1,56 @@
 {
   "name": "allure",
-  "version": "3.3.1",
+  "version": "3.4.0",
   "description": "Allure Commandline Tool",
   "keywords": [
     "allure",
-    "testing",
-    "report"
+    "report",
+    "testing"
   ],
-  "repository": "https://github.com/allure-framework/allure3",
   "license": "Apache-2.0",
   "author": "Qameta Software",
+  "repository": "https://github.com/allure-framework/allure3",
+  "bin": "./cli.js",
+  "files": [
+    "./dist"
+  ],
   "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "exports": {
     ".": "./dist/index.js",
     "./rules": "./dist/rules.js",
     "./qualityGate": "./dist/qualityGate.js"
   },
-  "main": "./dist/index.js",
-  "module": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "bin": "./cli.js",
-  "files": [
-    "./dist"
-  ],
   "scripts": {
     "build": "run clean && tsc --project ./tsconfig.json",
     "clean": "rimraf ./dist",
-    "eslint": "eslint ./src/**/*.{js,jsx,ts,tsx}",
-    "eslint:format": "eslint --fix ./src/**/*.{js,jsx,ts,tsx}",
     "start": "node ./cli.js",
-    "test": "vitest run"
+    "test": "vitest run",
+    "lint": "oxlint --import-plugin src test features stories",
+    "lint:fix": "oxlint --import-plugin --fix src test features stories"
   },
   "dependencies": {
-    "@allurereport/charts-api": "3.3.1",
-    "@allurereport/ci": "3.3.1",
-    "@allurereport/core": "3.3.1",
-    "@allurereport/core-api": "3.3.1",
-    "@allurereport/directory-watcher": "3.3.1",
-    "@allurereport/plugin-allure2": "3.3.1",
-    "@allurereport/plugin-api": "3.3.1",
-    "@allurereport/plugin-awesome": "3.3.1",
-    "@allurereport/plugin-classic": "3.3.1",
-    "@allurereport/plugin-csv": "3.3.1",
-    "@allurereport/plugin-dashboard": "3.3.1",
-    "@allurereport/plugin-jira": "3.3.1",
-    "@allurereport/plugin-log": "3.3.1",
-    "@allurereport/plugin-progress": "3.3.1",
-    "@allurereport/plugin-server-reload": "3.3.1",
-    "@allurereport/plugin-slack": "3.3.1",
-    "@allurereport/reader-api": "3.3.1",
-    "@allurereport/service": "3.3.1",
-    "@allurereport/static-server": "3.3.1",
+    "@allurereport/charts-api": "3.4.0",
+    "@allurereport/ci": "3.4.0",
+    "@allurereport/core": "3.4.0",
+    "@allurereport/core-api": "3.4.0",
+    "@allurereport/directory-watcher": "3.4.0",
+    "@allurereport/plugin-allure2": "3.4.0",
+    "@allurereport/plugin-api": "3.4.0",
+    "@allurereport/plugin-awesome": "3.4.0",
+    "@allurereport/plugin-classic": "3.4.0",
+    "@allurereport/plugin-csv": "3.4.0",
+    "@allurereport/plugin-dashboard": "3.4.0",
+    "@allurereport/plugin-jira": "3.4.0",
+    "@allurereport/plugin-log": "3.4.0",
+    "@allurereport/plugin-progress": "3.4.0",
+    "@allurereport/plugin-server-reload": "3.4.0",
+    "@allurereport/plugin-slack": "3.4.0",
+    "@allurereport/reader-api": "3.4.0",
+    "@allurereport/service": "3.4.0",
+    "@allurereport/static-server": "3.4.0",
     "adm-zip": "^0.5.16",
     "clipanion": "^4.0.0-rc.4",
     "glob": "^11.1.0",
@@ -60,24 +60,13 @@
     "yoctocolors": "^2.1.1"
   },
   "devDependencies": {
-    "@stylistic/eslint-plugin": "^2.6.1",
     "@types/adm-zip": "^0",
-    "@types/eslint": "^8.56.11",
     "@types/lodash.omit": "^4.5.9",
     "@types/node": "^20.17.9",
     "@types/prompts": "^2",
-    "@typescript-eslint/eslint-plugin": "^8.0.0",
-    "@typescript-eslint/parser": "^8.0.0",
     "@vitest/runner": "^2.1.9",
     "@vitest/snapshot": "^2.1.9",
     "allure-vitest": "^3.3.3",
-    "eslint": "^8.57.0",
-    "eslint-config-prettier": "^9.1.0",
-    "eslint-plugin-import": "^2.29.1",
-    "eslint-plugin-jsdoc": "^50.0.0",
-    "eslint-plugin-n": "^17.10.1",
-    "eslint-plugin-no-null": "^1.0.2",
-    "eslint-plugin-prefer-arrow": "^1.2.3",
     "rimraf": "^6.0.1",
     "typescript": "^5.6.3",
     "vitest": "^2.1.9"