@zohodesk/testinglibrary 0.1.8-exp-bdd-v3 → 0.1.8-exp-bdd-v4

package/build/bdd-framework/gen/testFile.js

@@ -0,0 +1,422 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.TestFile = void 0;
+var _fs = _interopRequireDefault(require("fs"));
+var _path = _interopRequireDefault(require("path"));
+var _formatter = require("./formatter");
+var _i18n = require("./i18n");
+var _loadSteps = require("../cucumber/loadSteps");
+var _index = require("@cucumber/cucumber/lib/formatter/helpers/index");
+var _utils = require("../utils");
+var _testPoms = require("./testPoms");
+var _testNode = require("./testNode");
+var _stepConfig = require("../stepDefinitions/stepConfig");
+var _exit = require("../utils/exit");
+var _fixtures = require("./fixtures");
+var _scenario = require("../hooks/scenario");
+var _worker = require("../hooks/worker");
+var _lang = require("../config/lang");
+/**
+ * Generate test code.
+ */
+
+class TestFile {
+  options;
+  lines = [];
+  i18nKeywordsMap;
+  formatter;
+  hasCucumberStyle = false;
+  testNodes = [];
+  hasCustomTest = false;
+  undefinedSteps = [];
+  constructor(options) {
+    this.options = options;
+    this.formatter = new _formatter.Formatter(options.config);
+  }
+  get sourceFile() {
+    const {
+      uri
+    } = this.options.doc;
+    if (!uri) {
+      throw new Error(`Document without uri`);
+    }
+    return uri;
+  }
+  get content() {
+    return this.lines.join('\n');
+  }
+  get language() {
+    var _this$options$doc$fea;
+    return ((_this$options$doc$fea = this.options.doc.feature) === null || _this$options$doc$fea === void 0 ? void 0 : _this$options$doc$fea.language) || _lang.LANG_EN;
+  }
+  get isEnglish() {
+    return (0, _lang.isEnglish)(this.language);
+  }
+  get config() {
+    return this.options.config;
+  }
+  get outputPath() {
+    return this.options.outputPath;
+  }
+  build() {
+    this.loadI18nKeywords();
+    this.lines = [...this.getFileHeader(),
+    // prettier-ignore
+    ...this.getRootSuite(), ...this.getFileFixtures()];
+    return this;
+  }
+  save() {
+    const dir = _path.default.dirname(this.outputPath);
+    if (!_fs.default.existsSync(dir)) {
+      _fs.default.mkdirSync(dir, {
+        recursive: true
+      });
+    }
+    _fs.default.writeFileSync(this.outputPath, this.content);
+  }
+  getFileHeader() {
+    const importTestFrom = this.getRelativeImportTestFrom();
+    return this.formatter.fileHeader(this.sourceFile, importTestFrom);
+  }
+  loadI18nKeywords() {
+    if (!this.isEnglish) {
+      this.i18nKeywordsMap = (0, _i18n.getKeywordsMap)(this.language);
+    }
+  }
+  getRelativeImportTestFrom() {
+    const {
+      importTestFrom
+    } = this.config;
+    if (!importTestFrom) {
+      return;
+    }
+    const {
+      file,
+      varName
+    } = importTestFrom;
+    const dir = _path.default.dirname(this.outputPath);
+    return {
+      file: _path.default.relative(dir, file),
+      varName
+    };
+  }
+  getFileFixtures() {
+    return this.formatter.useFixtures([...this.formatter.testFixture(), ...(!this.isEnglish ? this.formatter.langFixture(this.language) : []), ...((0, _scenario.hasScenarioHooks)() || this.hasCucumberStyle ? this.formatter.bddWorldFixtures() : []), ...this.formatter.scenarioHookFixtures((0, _scenario.getScenarioHooksFixtures)()), ...this.formatter.workerHookFixtures((0, _worker.getWorkerHooksFixtures)()), ...this.formatter.tagsFixture(this.testNodes)]);
+  }
+  getRootSuite() {
+    const {
+      feature
+    } = this.options.doc;
+    if (!feature) {
+      throw new Error(`Document without feature.`);
+    }
+    return this.getSuite(feature);
+  }
+  /**
+     * Generate test.describe suite for root Feature or Rule
+     */
+  getSuite(feature, parent) {
+    const node = new _testNode.TestNode(feature, parent);
+    if (node.isSkipped()) {
+      return this.formatter.suite(node, []);
+    }
+    const lines = [];
+    feature.children.forEach(child => lines.push(...this.getSuiteChild(child, node)));
+    return this.formatter.suite(node, lines);
+  }
+  getSuiteChild(child, parent) {
+    if ('rule' in child && child.rule) {
+      return this.getSuite(child.rule, parent);
+    }
+    if (child.background) {
+      return this.getBeforeEach(child.background, parent);
+    }
+    if (child.scenario) {
+      return this.getScenarioLines(child.scenario, parent);
+    }
+    throw new Error(`Empty child: ${JSON.stringify(child)}`);
+  }
+  getScenarioLines(scenario, parent) {
+    return this.isOutline(scenario) ? this.getOutlineSuite(scenario, parent) : this.getTest(scenario, parent);
+  }
+  /**
+     * Generate test.beforeEach for Background
+     */
+  getBeforeEach(bg, parent) {
+    const node = new _testNode.TestNode({
+      name: 'background',
+      tags: []
+    }, parent);
+    const {
+      fixtures,
+      lines
+    } = this.getSteps(bg, node.tags);
+    return this.formatter.beforeEach(fixtures, lines);
+  }
+  /**
+     * Generate test.describe suite for Scenario Outline
+     */
+  getOutlineSuite(scenario, parent) {
+    const node = new _testNode.TestNode(scenario, parent);
+    if (node.isSkipped()) {
+      return this.formatter.suite(node, []);
+    }
+    const lines = [];
+    let exampleIndex = 0;
+    scenario.examples.forEach(examples => {
+      const titleFormat = this.getExamplesTitleFormat(scenario, examples);
+      examples.tableBody.forEach(exampleRow => {
+        const testTitle = this.getOutlineTestTitle(titleFormat, examples, exampleRow, ++exampleIndex);
+        const testLines = this.getOutlineTest(scenario, examples, exampleRow, testTitle, node);
+        lines.push(...testLines);
+      });
+    });
+    return this.formatter.suite(node, lines);
+  }
+  /**
+     * Generate test from Examples row of Scenario Outline
+     */
+  // eslint-disable-next-line max-params
+  getOutlineTest(scenario, examples, exampleRow, title, parent) {
+    const node = new _testNode.TestNode({
+      name: title,
+      tags: examples.tags
+    }, parent);
+    if (this.skipByTagsExpression(node)) {
+      return [];
+    }
+    if (node.isSkipped()) {
+      return this.formatter.test(node, new Set(), []);
+    }
+    this.testNodes.push(node);
+    const {
+      fixtures,
+      lines
+    } = this.getSteps(scenario, node.tags, exampleRow.id);
+    return this.formatter.test(node, fixtures, lines);
+  }
+  /**
+     * Generate test from Scenario
+     */
+  getTest(scenario, parent) {
+    const node = new _testNode.TestNode(scenario, parent);
+    if (this.skipByTagsExpression(node)) {
+      return [];
+    }
+    if (node.isSkipped()) {
+      return this.formatter.test(node, new Set(), []);
+    }
+    this.testNodes.push(node);
+    const {
+      fixtures,
+      lines
+    } = this.getSteps(scenario, node.tags);
+    return this.formatter.test(node, fixtures, lines);
+  }
+  /**
+     * Generate test steps
+     */
+  getSteps(scenario, tags, outlineExampleRowId) {
+    const testFixtureNames = new Set();
+    const testPoms = new _testPoms.TestPoms(scenario.name || 'Background');
+    const decoratorSteps = [];
+    let previousKeywordType = undefined;
+    const lines = scenario.steps.map((step, index) => {
+      const {
+        keyword,
+        keywordType,
+        fixtureNames: stepFixtureNames,
+        line,
+        pickleStep,
+        stepConfig
+      } = this.getStep(step, previousKeywordType, outlineExampleRowId);
+      previousKeywordType = keywordType;
+      testFixtureNames.add(keyword);
+      stepFixtureNames.forEach(fixtureName => testFixtureNames.add(fixtureName));
+      if ((0, _stepConfig.isDecorator)(stepConfig)) {
+        testPoms.addByStep(stepConfig.pomNode);
+        decoratorSteps.push({
+          index,
+          keyword,
+          pickleStep,
+          pomNode: stepConfig.pomNode
+        });
+      }
+      return line;
+    });
+    // decorator steps handled in second pass to guess fixtures
+    if (decoratorSteps.length) {
+      testFixtureNames.forEach(fixtureName => testPoms.addByFixtureName(fixtureName));
+      tags === null || tags === void 0 || tags.forEach(tag => testPoms.addByTag(tag));
+      testPoms.resolveFixtures();
+      decoratorSteps.forEach(step => {
+        const {
+          line,
+          fixtureName
+        } = this.getDecoratorStep(step, testPoms);
+        lines[step.index] = line;
+        testFixtureNames.add(fixtureName);
+      });
+    }
+    return {
+      fixtures: testFixtureNames,
+      lines
+    };
+  }
+  /**
+     * Generate step for Given, When, Then
+     */
+  // eslint-disable-next-line max-statements, complexity
+  getStep(step, previousKeywordType, outlineExampleRowId) {
+    const pickleStep = this.getPickleStep(step, outlineExampleRowId);
+    const stepDefinition = (0, _loadSteps.findStepDefinition)(this.options.supportCodeLibrary, pickleStep.text, this.sourceFile);
+    const keywordType = (0, _index.getStepKeywordType)({
+      keyword: step.keyword,
+      language: this.language,
+      previousKeywordType
+    });
+    const enKeyword = this.getStepEnglishKeyword(step);
+    if (!stepDefinition) {
+      this.undefinedSteps.push({
+        keywordType,
+        step,
+        pickleStep
+      });
+      return this.getMissingStep(enKeyword, keywordType, pickleStep);
+    }
+    // for cucumber-style stepConfig is undefined
+    const stepConfig = (0, _stepConfig.getStepConfig)(stepDefinition);
+    if (stepConfig !== null && stepConfig !== void 0 && stepConfig.hasCustomTest) {
+      this.hasCustomTest = true;
+    }
+    if (!(0, _stepConfig.isPlaywrightStyle)(stepConfig)) {
+      this.hasCucumberStyle = true;
+    }
+    const fixtureNames = this.getStepFixtureNames(stepDefinition);
+    const line = (0, _stepConfig.isDecorator)(stepConfig) ? '' : this.formatter.step(enKeyword, pickleStep.text, pickleStep.argument, fixtureNames);
+    return {
+      keyword: enKeyword,
+      keywordType,
+      fixtureNames,
+      line,
+      pickleStep,
+      stepConfig
+    };
+  }
+  getMissingStep(keyword, keywordType, pickleStep) {
+    return {
+      keyword,
+      keywordType,
+      fixtureNames: [],
+      line: this.formatter.missingStep(keyword, pickleStep.text),
+      pickleStep,
+      stepConfig: undefined
+    };
+  }
+  getPickleStep(step, outlineExampleRowId) {
+    for (const pickle of this.options.pickles) {
+      const pickleStep = pickle.steps.find(({
+        astNodeIds
+      }) => {
+        const hasStepId = astNodeIds.includes(step.id);
+        const hasRowId = !outlineExampleRowId || astNodeIds.includes(outlineExampleRowId);
+        return hasStepId && hasRowId;
+      });
+      if (pickleStep) {
+        return pickleStep;
+      }
+    }
+    throw new Error(`Pickle step not found for step: ${step.text}`);
+  }
+  getStepEnglishKeyword(step) {
+    const nativeKeyword = step.keyword.trim();
+    const enKeyword = nativeKeyword === '*' ? 'And' : this.getEnglishKeyword(nativeKeyword);
+    if (!enKeyword) {
+      throw new Error(`Keyword not found: ${nativeKeyword}`);
+    }
+    return enKeyword;
+  }
+  getStepFixtureNames(stepDefinition) {
+    const stepConfig = (0, _stepConfig.getStepConfig)(stepDefinition);
+    if ((0, _stepConfig.isPlaywrightStyle)(stepConfig)) {
+      // for decorator steps fixtureNames are defined later in second pass
+      return (0, _stepConfig.isDecorator)(stepConfig) ? [] : (0, _fixtures.extractFixtureNames)(stepConfig.fn);
+    } else {
+      return (0, _fixtures.extractFixtureNamesFromFnBodyMemo)(stepDefinition.code);
+    }
+  }
+  getDecoratorStep(step, testPoms) {
+    const {
+      keyword,
+      pickleStep,
+      pomNode
+    } = step;
+    const resolvedFixtures = testPoms.getResolvedFixtures(pomNode);
+    if (resolvedFixtures.length !== 1) {
+      const suggestedTags = resolvedFixtures.filter(f => !f.byTag).map(f => (0, _testPoms.buildFixtureTag)(f.name)).join(', ');
+      const suggestedTagsStr = suggestedTags.length ? ` or set one of the following tags: ${suggestedTags}` : '.';
+      (0, _exit.exit)(`Can't guess fixture for decorator step "${pickleStep.text}" in file: ${this.sourceFile}.`, `Please refactor your Page Object classes${suggestedTagsStr}`);
+    }
+    const fixtureName = resolvedFixtures[0].name;
+    return {
+      fixtureName,
+      line: this.formatter.step(keyword, pickleStep.text, pickleStep.argument, [fixtureName])
+    };
+  }
+  getOutlineTestTitle(titleFormat, examples, exampleRow, exampleIndex) {
+    const params = {
+      _index_: exampleIndex
+    };
+    exampleRow.cells.forEach((cell, index) => {
+      var _examples$tableHeader;
+      const colName = (_examples$tableHeader = examples.tableHeader) === null || _examples$tableHeader === void 0 || (_examples$tableHeader = _examples$tableHeader.cells[index]) === null || _examples$tableHeader === void 0 ? void 0 : _examples$tableHeader.value;
+      if (colName) {
+        params[colName] = cell.value;
+      }
+    });
+    return (0, _utils.template)(titleFormat, params);
+  }
+  getExamplesTitleFormat(scenario, examples) {
+    return this.getExamplesTitleFormatFromComment(examples) || this.getExamplesTitleFormatFromScenarioName(scenario, examples) || this.config.examplesTitleFormat;
+  }
+  getExamplesTitleFormatFromComment(examples) {
+    var _comment$text;
+    const {
+      line
+    } = examples.location;
+    const titleFormatCommentLine = line - 1;
+    const comment = this.options.doc.comments.find(c => {
+      return c.location.line === titleFormatCommentLine;
+    });
+    const commentText = comment === null || comment === void 0 || (_comment$text = comment.text) === null || _comment$text === void 0 ? void 0 : _comment$text.trim();
+    const prefix = '# title-format:';
+    return commentText !== null && commentText !== void 0 && commentText.startsWith(prefix) ? commentText.replace(prefix, '').trim() : '';
+  }
+  getExamplesTitleFormatFromScenarioName(scenario, examples) {
+    var _examples$tableHeader2;
+    const columnsInScenarioName = (0, _utils.extractTemplateParams)(scenario.name);
+    const hasColumnsFromExamples = columnsInScenarioName.length && ((_examples$tableHeader2 = examples.tableHeader) === null || _examples$tableHeader2 === void 0 || (_examples$tableHeader2 = _examples$tableHeader2.cells) === null || _examples$tableHeader2 === void 0 ? void 0 : _examples$tableHeader2.some(cell => {
+      return cell.value && columnsInScenarioName.includes(cell.value);
+    }));
+    return hasColumnsFromExamples ? scenario.name : '';
+  }
+  skipByTagsExpression(node) {
+    // see: https://github.com/cucumber/tag-expressions/tree/main/javascript
+    const {
+      tagsExpression
+    } = this.options;
+    return tagsExpression && !tagsExpression.evaluate(node.tags);
+  }
+  isOutline(scenario) {
+    const keyword = this.getEnglishKeyword(scenario.keyword);
+    return keyword === 'ScenarioOutline' || keyword === 'Scenario Outline' || keyword === 'Scenario Template';
+  }
+  getEnglishKeyword(keyword) {
+    return this.i18nKeywordsMap ? this.i18nKeywordsMap.get(keyword) : keyword;
+  }
+}
+exports.TestFile = TestFile;

package/build/bdd-framework/gen/testNode.js

@@ -0,0 +1,61 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.TestNode = void 0;
+var _utils = require("../utils");
+/**
+ * Universal TestNode class of parent-child relations in test file structure.
+ * Holds tags and titles path.
+ */
+
+const SPECIAL_TAGS = ['@only', '@skip', '@fixme'];
+class TestNode {
+  title;
+  titlePath;
+  ownTags = [];
+  tags = [];
+  flags = {};
+  constructor(gherkinNode, parent) {
+    this.initOwnTags(gherkinNode);
+    this.tags = (0, _utils.removeDuplicates)(((parent === null || parent === void 0 ? void 0 : parent.tags) || []).concat(this.ownTags));
+    this.title = gherkinNode.name;
+    this.titlePath = ((parent === null || parent === void 0 ? void 0 : parent.titlePath) || []).concat([this.title]);
+  }
+  isSkipped() {
+    return this.flags.skip || this.flags.fixme;
+  }
+  initOwnTags(gherkinNode) {
+    const tagNames = (0, _utils.removeDuplicates)(getTagNames(gherkinNode.tags));
+    tagNames.forEach(tag => {
+      if (isSpecialTag(tag)) {
+        this.setFlag(tag);
+      } else {
+        this.ownTags.push(tag);
+      }
+    });
+  }
+  // eslint-disable-next-line complexity
+  setFlag(tag) {
+    // in case of several system tags, @only takes precendence
+    if (tag === '@only') {
+      this.flags = {
+        only: true
+      };
+    }
+    if (tag === '@skip' && !this.flags.only) {
+      this.flags.skip = true;
+    }
+    if (tag === '@fixme' && !this.flags.only) {
+      this.flags.fixme = true;
+    }
+  }
+}
+exports.TestNode = TestNode;
+function getTagNames(tags) {
+  return tags.map(tag => tag.name);
+}
+function isSpecialTag(tag) {
+  return SPECIAL_TAGS.includes(tag);
+}

package/build/bdd-framework/gen/testPoms.js

@@ -0,0 +1,133 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.TestPoms = void 0;
+exports.buildFixtureTag = buildFixtureTag;
+var _class = require("../stepDefinitions/decorators/class");
+var _exit = require("../utils/exit");
+/**
+ * Track PomNodes used in the particular test.
+ * To select correct fixture for decorator steps.
+ *
+ * Idea: try to use the deepest child fixture for parent steps.
+ *
+ * Example inheritance tree:
+ *      A
+ *     / \
+ *    B   C
+ *   / \   \
+ *  D   E   F
+ *
+ * If test uses steps from classes A and D:
+ * -> resolved fixture will be D, even for steps from A.
+ *
+ * If test uses steps from classes A, D and C:
+ * -> error, b/c A has 2 possible fixtures.
+ *
+ * If test uses steps from classes A and C, but @fixture tag is D:
+ * -> error, b/c A has 2 possible fixtures.
+ */
+
+const FIXTURE_TAG_PREFIX = '@fixture:';
+class TestPoms {
+  title;
+  // map of poms used in test
+  usedPoms = new Map();
+  constructor(title) {
+    this.title = title;
+  }
+  addByStep(pomNode) {
+    this.addUsedPom(pomNode, {
+      byTag: false
+    });
+  }
+  addByFixtureName(fixtureName) {
+    const pomNode = (0, _class.getPomNodeByFixtureName)(fixtureName);
+    this.addUsedPom(pomNode, {
+      byTag: false
+    });
+  }
+  addByTag(tag) {
+    const fixtureName = extractFixtureName(tag);
+    if (fixtureName) {
+      const pomNode = (0, _class.getPomNodeByFixtureName)(fixtureName);
+      this.addUsedPom(pomNode, {
+        byTag: true
+      });
+    }
+  }
+  /**
+     * Resolve all used pomNodes to fixtures.
+     * This is needed to handle @fixture: tagged pomNodes
+     * that does not have steps in the test, but should be considered.
+     */
+  resolveFixtures() {
+    this.usedPoms.forEach((_, pomNode) => {
+      this.getResolvedFixtures(pomNode);
+    });
+  }
+  /**
+     * Returns fixtures suitable for particular pomNode (actually for step)
+     */
+  getResolvedFixtures(pomNode) {
+    const usedPom = this.usedPoms.get(pomNode);
+    if (usedPom !== null && usedPom !== void 0 && usedPom.fixtures) {
+      return usedPom.fixtures;
+    }
+    // Recursively resolve children fixtures, used in test.
+    let childFixtures = [...pomNode.children].map(child => this.getResolvedFixtures(child)).flat();
+    if (!usedPom) {
+      return childFixtures;
+    }
+    if (childFixtures.length) {
+      this.verifyChildFixtures(pomNode, usedPom, childFixtures);
+      usedPom.fixtures = childFixtures;
+    } else {
+      usedPom.fixtures = [{
+        name: pomNode.fixtureName,
+        byTag: usedPom.byTag
+      }];
+    }
+    return usedPom.fixtures;
+  }
+  addUsedPom(pomNode, {
+    byTag
+  }) {
+    if (!pomNode) {
+      return;
+    }
+    const usedPom = this.usedPoms.get(pomNode);
+    if (usedPom) {
+      if (byTag && !usedPom.byTag) {
+        usedPom.byTag = true;
+      }
+    } else {
+      this.usedPoms.set(pomNode, {
+        byTag
+      });
+    }
+  }
+  /**
+     * For scenarios with @fixture:xxx tags verify that there are no steps from fixtures,
+     * deeper than xxx.
+     * @fixture:xxx tag provides maximum fixture that can be used in the scenario.
+     */
+  verifyChildFixtures(pomNode, usedPom, childFixtures) {
+    if (!usedPom.byTag) {
+      return;
+    }
+    const childFixturesBySteps = childFixtures.filter(f => !f.byTag);
+    if (childFixturesBySteps.length) {
+      (0, _exit.exit)(`Scenario "${this.title}" contains ${childFixturesBySteps.length} step(s)`, `not compatible with required fixture "${pomNode.fixtureName}"`);
+    }
+  }
+}
+exports.TestPoms = TestPoms;
+function extractFixtureName(tag) {
+  return tag.startsWith(FIXTURE_TAG_PREFIX) ? tag.replace(FIXTURE_TAG_PREFIX, '') : '';
+}
+function buildFixtureTag(fixtureName) {
+  return `${FIXTURE_TAG_PREFIX}${fixtureName}`;
+}