cypress-qase-reporter 2.0.0-beta.1 → 2.0.0-beta.3

package/README.md

@@ -1,65 +1,81 @@
-> # Qase TMS Cypress reporter
->
-> Publish results simple and easy.
+# Qase TMS Cypress reporter
 
-## How to integrate
+Publish results simple and easy.
 
+## How to install
+
+Qase Cypress reporter is currently in open beta stage for the version 2 series.
+To install the latest beta version, run:
+
+```sh
+npm install -D cypress-qase-reporter@beta
 ```
-npm install cypress-qase-reporter
-```
 
-## Example of usage
+## Updating from v1
+
+You can update a test project from using version 1 to version 2 in several steps:
+
+1.  Change import paths:
+
+    ```diff
+    - import { qase } from 'cypress-qase-reporter/dist/mocha'
+    + import { qase } from 'cypress-qase-reporter/mocha'
+    ```
 
-If you want to decorate come test with Qase Case ID you could use qase function:
+2.  Update reporter configuration in `cypress.config.js` and/or environment variables —
+    see the [configuration reference](#configuration) below.
+
+## Getting started
+
+The Cypress reporter can auto-generate test cases
+and suites from your test data.
+Test results of subsequent test runs will match the same test cases
+as long as their names and file paths don't change.
+
+You can also annotate the tests with the IDs of existing test cases
+from Qase.io before executing tests. It's a more reliable way to bind
+autotests to test cases, that persists when you rename, move, or
+parameterize your tests.
+
+For example:
 
 ```typescript
-import { qase } from 'cypress-qase-reporter';
+import { qase } from 'cypress-qase-reporter/mocha';
 
 describe('My First Test', () => {
-    qase([1,2],
-        it('Several ids', () => {
+  qase(1,
+          it('Several ids', () => {
             expect(true).to.equal(true);
-        })
-    );
-    qase(3,
-        it('Correct test', () => {
+          })
+  );
+  // a test can check multiple test cases
+  qase([2, 3],
+          it('Correct test', () => {
             expect(true).to.equal(true);
-        })
-    );
-    qase(4,
-        it.skip('Skipped test', () => {
+          })
+  );
+  qase(4,
+          it.skip('Skipped test', () => {
             expect(true).to.equal(true);
-        })
-    );
-    qase(5,
-        it('Failed test', () => {
-            expect(true).to.equal(false);
-        })
-    );
+          })
+  );
 });
-
-```
-If you are going to use several specifications for execution and you have in config 
-```json
-"testops": {
-  "run": {
-    "complete": true
-  }
-}
-```
-then it is necessary to additionally set in the project settings
-```
-Allow to add results for cases in closed runs.
 ```
 
-To run tests and create a test run, execute the command (for example from folder examples):
+To execute Cypress tests and report them to Qase.io, run the command:
+
 ```bash
 QASE_MODE=testops npx cypress run
 ```
+
 or
+
 ```bash
 npm test
 ```
+
+You can try it with the example project at [`examples/cypress`](../examples/cypress/).
+
 <p align="center">
   <img width="65%" src="./screenshots/screenshot.png">
 </p>
@@ -72,39 +88,65 @@ https://app.qase.io/run/QASE_PROJECT_CODE
 
 ## Configuration
 
-Reporter options (* - required):
-
-- `mode` - `testops`/`off` Enables reporter, default - `off`
-- `debug` - Enables debug logging, defaule - `false`
-- `environment` - To execute with the sending of the envinroment information
-- *`testops.api.token` - Token for API access, you can find more information
-  [here](https://developers.qase.io/#authentication)
-- *`testops.project` - Code of your project (can be extracted from main
-  page of your project: `https://app.qase.io/project/DEMOTR` -
-  `DEMOTR` is project code here)
-- `testops.uploadAttachments` - Permission to send screenshots to Qase TMS
-- `testops.run.id` - Pass Run ID
-- `testops.run.title` - Set custom Run name, when new run is created
-- `testops.run.description` - Set custom Run description, when new run is created
-- `testops.run.complete` - Whether the run should be completed
-- `framework.cypress.screenshotFolder` - Folder for save screenshot cypress
-
-#### You can check example configuration with multiple reporters in [demo project](../examples/cypress/cypress.config.js).
-
-Supported ENV variables:
-
-- `QASE_MODE` - Same as `mode`
-- `QASE_DEBUG` - Same as `debug`
-- `QASE_ENVIRONMENT` - Same as `environment`
-- `QASE_TESTOPS_API_TOKEN` - Same as `testops.api.token`
-- `QASE_TESTOPS_PROJECT` - Same as `testops.project`
-- `QASE_TESTOPS_RUN_ID` - Pass Run ID from ENV and override reporter option `testops.run.id`
-- `QASE_TESTOPS_RUN_TITLE` - Same as `testops.run.title`
-- `QASE_TESTOPS_RUN_DESCRIPTION` - Same as `testops.run.description`
+Qase Cypress reporter can be configured in multiple ways:
+- by adding configuration block in `cypress.config.js`,
+- using a separate config file `qase.config.json`,
+- using environment variables (they override the values from the configuration files).
+
+For a full list of configuration options, see the [Configuration reference](../qase-javascript-commons/README.md#configuration).
+
+Example `cypress.config.js` config:
+
+```js
+import cypress from 'cypress';
+
+import plugins from './cypress/plugins/index.js';
+
+module.exports = cypress.defineConfig({
+  reporter: 'cypress-multi-reporters',
+  reporterOptions: {
+    reporterEnabled: 'cypress-mochawesome-reporter, cypress-qase-reporter',
+    cypressMochawesomeReporterReporterOptions: {
+      charts: true,
+    },
+    cypressQaseReporterReporterOptions: {
+      debug: true,
+
+      testops: {
+        api: {
+          token: 'api_key',
+        },
+
+        project: 'project_code',
+        uploadAttachments: true,
+
+        run: {
+          complete: true,
+        },
+      },
+
+      framework: {
+        cypress: {
+          screenshotsFolder: 'cypress/screenshots',
+        }
+      }
+    },
+  },
+  video: false,
+  e2e: {
+    setupNodeEvents(on, config) {
+      return plugins(on, config);
+    },
+  },
+});
+```
+
+Check out the example of configuration for multiple reporters in the
+[demo project](../examples/cypress/cypress.config.js).
 
 ## Requirements
 
-We maintain the reporter on LTS versions of Node. You can find the current versions by following the [link](https://nodejs.org/en/about/releases/)
+We maintain the reporter on [LTS versions of Node](https://nodejs.org/en/about/releases/).
 
 `cypress >= 8.0.0`
 

package/changelog.md

@@ -0,0 +1,8 @@
+# cypress-qase-reporter@2.0.0-beta.3
+
+Fixed an issue with multiple test runs created when Cypress is running 
+multiple tests in parallel.
+
+# cypress-qase-reporter@2.0.0-beta.2
+
+First major beta release for the version 2 series of the Qase Cypress reporter.

package/dist/reporter.d.ts

@@ -27,7 +27,7 @@ export declare class CypressQaseReporter extends reporters.Base {
     /**
      * @param {number[]} ids
      * @param {string} dir
-     * @returns {string[]}
+     * @returns {Attachment[]}
      * @private
      */
     private static findAttachments;

package/dist/reporter.js

@@ -5,11 +5,12 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CypressQaseReporter = void 0;
 const path_1 = __importDefault(require("path"));
+const uuid_1 = require("uuid");
 const mocha_1 = require("mocha");
 const qase_javascript_commons_1 = require("qase-javascript-commons");
 const traverse_dir_1 = require("./utils/traverse-dir");
 const configSchema_1 = require("./configSchema");
-const { EVENT_TEST_FAIL, EVENT_TEST_PASS, EVENT_TEST_PENDING, EVENT_RUN_END, } = mocha_1.Runner.constants;
+const { EVENT_TEST_FAIL, EVENT_TEST_PASS, EVENT_TEST_PENDING, EVENT_RUN_END, EVENT_RUN_BEGIN, } = mocha_1.Runner.constants;
 /**
  * @class CypressQaseReporter
  * @extends reporters.Base
@@ -27,7 +28,7 @@ class CypressQaseReporter extends mocha_1.reporters.Base {
     /**
      * @param {number[]} ids
      * @param {string} dir
-     * @returns {string[]}
+     * @returns {Attachment[]}
      * @private
      */
     static findAttachments(ids, dir) {
@@ -36,11 +37,18 @@ class CypressQaseReporter extends mocha_1.reporters.Base {
         try {
             (0, traverse_dir_1.traverseDir)(path_1.default.join(process.cwd(), dir), (filePath) => {
                 if (CypressQaseReporter.getCaseId(filePath).some((item) => idSet.has(item))) {
-                    attachments.push(filePath);
+                    attachments.push({
+                        content: '',
+                        id: (0, uuid_1.v4)(),
+                        mime_type: '', size: 0,
+                        file_name: path_1.default.basename(filePath),
+                        file_path: filePath,
+                    });
                 }
             });
         }
-        catch (error) { /* ignore */ }
+        catch (error) { /* ignore */
+        }
         return attachments;
     }
     /**
@@ -71,6 +79,8 @@ class CypressQaseReporter extends mocha_1.reporters.Base {
         runner.on(EVENT_TEST_PENDING, (test) => this.addTestResult(test));
         runner.on(EVENT_TEST_FAIL, (test) => this.addTestResult(test));
         // eslint-disable-next-line @typescript-eslint/no-misused-promises
+        runner.on(EVENT_RUN_BEGIN, () => this.reporter.startTestRun());
+        // eslint-disable-next-line @typescript-eslint/no-misused-promises
         runner.once(EVENT_RUN_END, async () => {
             this.preventExit();
             await this.reporter.publish();
@@ -89,18 +99,32 @@ class CypressQaseReporter extends mocha_1.reporters.Base {
             ? CypressQaseReporter.findAttachments(ids, this.screenshotsFolder)
             : undefined;
         const result = {
+            attachments: attachments ?? [],
+            author: null,
+            fields: {},
+            message: test.err?.message ?? null,
+            muted: false,
+            params: {},
+            relations: {},
+            run_id: null,
+            signature: '',
+            steps: [],
             id: test.id,
-            testOpsId: ids,
+            execution: {
+                status: test.state
+                    ? CypressQaseReporter.statusMap[test.state]
+                    : qase_javascript_commons_1.TestStatusEnum.invalid,
+                start_time: null,
+                end_time: null,
+                duration: test.duration ?? 0,
+                stacktrace: test.err?.stack ?? null,
+                thread: null,
+            },
+            testops_id: ids.length > 0 ? ids : null,
             title: test.title,
-            suiteTitle: test.parent?.titlePath(),
-            status: test.state
-                ? CypressQaseReporter.statusMap[test.state]
-                : qase_javascript_commons_1.TestStatusEnum.invalid,
-            duration: test.duration ?? 0,
-            error: test.err,
-            attachments,
+            // suiteTitle: test.parent?.titlePath(),
         };
-        this.reporter.addTestResult(result);
+        void this.reporter.addTestResult(result);
     }
     /**
      * @private

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cypress-qase-reporter",
-  "version": "2.0.0-beta.1",
+  "version": "2.0.0-beta.3",
   "description": "Qase Cypress Reporter",
   "homepage": "https://github.com/qase-tms/qase-javascript",
   "sideEffects": false,
@@ -44,7 +44,8 @@
   "author": "Nikita Fedorov <nik333r@gmail.com>",
   "license": "Apache-2.0",
   "dependencies": {
-    "qase-javascript-commons": "^2.0.0-beta.1"
+    "qase-javascript-commons": "^2.0.0-beta.9",
+    "uuid": "^9.0.1"
   },
   "peerDependencies": {
     "cypress": ">=8.0.0"