codeceptjs 4.0.0-beta.1 → 4.0.0-beta.10.esm-aria

package/lib/command/generate.js

@@ -1,89 +1,87 @@
-import colors from 'chalk';
-import fs from 'fs';
-import inquirer from 'inquirer';
-import mkdirp from 'mkdirp';
-import path from 'path';
-import {
-  fileExists, ucfirst, lcfirst, beautify,
-} from '../utils.js';
-import { output } from '../output.js';
-import generateDefinitions from './definitions.js';
-import {
-  getConfig, getTestRoot, safeFileWrite, readConfig,
-} from './utils.js';
-import container from '../container.js';
-import { __dirname } from '../dirname.js';
-
-let extension = 'js';
+import colors from 'chalk'
+import fs from 'fs'
+import inquirer from 'inquirer'
+import { mkdirp } from 'mkdirp'
+import path from 'path'
+import { fileExists, ucfirst, lcfirst, beautify } from '../utils.js'
+import output from '../output.js'
+import generateDefinitions from './definitions.js'
+import { getConfig, getTestRoot, safeFileWrite, readConfig } from './utils.js'
+
+let extension = 'js'
 
 const testTemplate = `Feature('{{feature}}');
 
 Scenario('test something', async ({ {{actor}} }) => {
 
 });
-`;
+`
 
 // generates empty test
-export const test = function (genPath) {
-  const testsPath = getTestRoot(genPath);
-  global.codecept_dir = testsPath;
-  const config = getConfig(testsPath);
-  if (!config) return;
-
-  output.print('Creating a new test...');
-  output.print('----------------------');
-
-  const defaultExt = config.tests.match(/([^\*/]*?)$/)[1] || `_test.${extension}`;
-
-  return inquirer.prompt([
-    {
-      type: 'input',
-      name: 'feature',
-      message: 'Feature which is being tested (ex: account, login, etc)',
-      validate: (val) => !!val,
-    },
-    {
-      type: 'input',
-      message: 'Filename of a test',
-      name: 'filename',
-      default(answers) {
-        return (answers.feature).replace(' ', '_') + defaultExt;
+export async function test(genPath) {
+  const testsPath = getTestRoot(genPath)
+  global.codecept_dir = testsPath
+  const config = await getConfig(testsPath)
+  if (!config) return
+
+  output.print('Creating a new test...')
+  output.print('----------------------')
+
+  const defaultExt = config.tests.match(/([^\*/]*?)$/)[1] || `_test.${extension}`
+
+  return inquirer
+    .prompt([
+      {
+        type: 'input',
+        name: 'feature',
+        message: 'Feature which is being tested (ex: account, login, etc)',
+        validate: val => !!val,
       },
-    },
-  ]).then((result) => {
-    const testFilePath = path.dirname(path.join(testsPath, config.tests)).replace(/\*\*$/, '');
-    let testFile = path.join(testFilePath, result.filename);
-    const ext = path.extname(testFile);
-    if (!ext) testFile += defaultExt;
-    const dir = path.dirname(testFile);
-    if (!fileExists(dir)) mkdirp.sync(dir);
-    let testContent = testTemplate.replace('{{feature}}', result.feature);
-
-    container.create(config, {});
-    // translate scenario test
-    if (container.translation().loaded) {
-      const vocabulary = container.translation().vocabulary;
-      testContent = testContent.replace('{{actor}}', container.translation().I);
-      if (vocabulary.contexts.Feature) testContent = testContent.replace('Feature', vocabulary.contexts.Feature);
-      if (vocabulary.contexts.Scenario) testContent = testContent.replace('Scenario', vocabulary.contexts.Scenario);
-      output.print(`Test was created in ${colors.bold(config.translation)} localization. See: https://codecept.io/translation/`);
-    } else {
-      testContent = testContent.replace('{{actor}}', 'I');
-    }
-    if (!config.fullPromiseBased) testContent = testContent.replace('async', '');
+      {
+        type: 'input',
+        message: 'Filename of a test',
+        name: 'filename',
+        default(answers) {
+          return answers.feature.replace(' ', '_') + defaultExt
+        },
+      },
+    ])
+    .then(async result => {
+      const testFilePath = path.dirname(path.join(testsPath, config.tests)).replace(/\*\*$/, '')
+      let testFile = path.join(testFilePath, result.filename)
+      const ext = path.extname(testFile)
+      if (!ext) testFile += defaultExt
+      const dir = path.dirname(testFile)
+      if (!fileExists(dir)) mkdirp.sync(dir)
+      let testContent = testTemplate.replace('{{feature}}', result.feature)
+
+      const containerModule = await import('../container.js')
+      const container = containerModule.default || containerModule
+      await container.create(config, {})
+      // translate scenario test
+      if (container.translation().loaded) {
+        const vocabulary = container.translation().vocabulary
+        testContent = testContent.replace('{{actor}}', container.translation().I)
+        if (vocabulary.contexts.Feature) testContent = testContent.replace('Feature', vocabulary.contexts.Feature)
+        if (vocabulary.contexts.Scenario) testContent = testContent.replace('Scenario', vocabulary.contexts.Scenario)
+        output.print(`Test was created in ${colors.bold(config.translation)} localization. See: https://codecept.io/translation/`)
+      } else {
+        testContent = testContent.replace('{{actor}}', 'I')
+      }
+      if (!config.fullPromiseBased) testContent = testContent.replace('async', '')
 
-    if (!safeFileWrite(testFile, testContent)) return;
-    output.success(`\nTest for ${result.filename} was created in ${testFile}`);
-  });
-};
+      if (!safeFileWrite(testFile, testContent)) return
+      output.success(`\nTest for ${result.filename} was created in ${testFile}`)
+    })
+}
 
 const pageObjectTemplate = `const { I } = inject();
 
-module.exports = {
+export default {
 
   // insert your locators and methods here
 }
-`;
+`
 
 const poModuleTemplateTS = `const { I } = inject();
 
@@ -91,7 +89,7 @@ export = {
 
   // insert your locators and methods here
 }
-`;
+`
 
 const poClassTemplate = `const { I } = inject();
 
@@ -104,100 +102,103 @@ class {{name}} {
 }
 
 // For inheritance
-module.exports = new {{name}}();
-export = {{name}};
-`;
+export default new {{name}}();
+export { {{name}} };
+`
 
-export const pageObject = function (genPath, opts) {
-  const testsPath = getTestRoot(genPath);
-  const config = getConfig(testsPath);
-  const kind = opts.T || 'page';
-  if (!config) return;
+export async function pageObject(genPath, opts) {
+  const testsPath = getTestRoot(genPath)
+  const config = await getConfig(testsPath)
+  const kind = opts.T || 'page'
+  if (!config) return
 
-  let configFile = path.join(testsPath, `codecept.conf.${extension}`);
+  let configFile = path.join(testsPath, `codecept.conf.${extension}`)
 
   if (!fileExists(configFile)) {
-    extension = 'ts';
-    configFile = path.join(testsPath, `codecept.conf.${extension}`);
+    extension = 'ts'
+    configFile = path.join(testsPath, `codecept.conf.${extension}`)
   }
-  output.print(`Creating a new ${kind} object`);
-  output.print('--------------------------');
-
-  return inquirer.prompt([
-    {
-      type: 'input',
-      name: 'name',
-      message: `Name of a ${kind} object`,
-      validate: (val) => !!val,
-    },
-    {
-      type: 'input',
-      name: 'filename',
-      message: 'Where should it be stored',
-      default: answers => `./${kind}s/${answers.name}.${extension}`,
-    },
-    {
-      type: 'list',
-      name: 'objectType',
-      message: 'What is your preferred object type',
-      choices: ['module', 'class'],
-      default: 'module',
-    },
-  ]).then((result) => {
-    const pageObjectFile = path.join(testsPath, result.filename);
-    const dir = path.dirname(pageObjectFile);
-    if (!fileExists(dir)) fs.mkdirSync(dir);
-
-    let actor = 'actor';
-
-    if (config.include.I) {
-      let actorPath = config.include.I;
-      if (actorPath.charAt(0) === '.') { // relative path
-        actorPath = path.relative(dir, path.dirname(path.join(testsPath, actorPath))) + actorPath.substring(1); // get an upper level
+  output.print(`Creating a new ${kind} object`)
+  output.print('--------------------------')
+
+  return inquirer
+    .prompt([
+      {
+        type: 'input',
+        name: 'name',
+        message: `Name of a ${kind} object`,
+        validate: val => !!val,
+      },
+      {
+        type: 'input',
+        name: 'filename',
+        message: 'Where should it be stored',
+        default: answers => `./${kind}s/${answers.name}.${extension}`,
+      },
+      {
+        type: 'list',
+        name: 'objectType',
+        message: 'What is your preferred object type',
+        choices: ['module', 'class'],
+        default: 'module',
+      },
+    ])
+    .then(result => {
+      const pageObjectFile = path.join(testsPath, result.filename)
+      const dir = path.dirname(pageObjectFile)
+      if (!fileExists(dir)) fs.mkdirSync(dir)
+
+      let actor = 'actor'
+
+      if (config.include.I) {
+        let actorPath = config.include.I
+        if (actorPath.charAt(0) === '.') {
+          // relative path
+          actorPath = path.relative(dir, path.dirname(path.join(testsPath, actorPath))) + actorPath.substring(1) // get an upper level
+        }
+        actor = `import('${actorPath}')`
       }
-      actor = `require('${actorPath}')`;
-    }
 
-    const name = lcfirst(result.name) + ucfirst(kind);
-    if (result.objectType === 'module' && extension === 'ts') {
-      if (!safeFileWrite(pageObjectFile, poModuleTemplateTS.replace('{{actor}}', actor))) return;
-    } else if (result.objectType === 'module' && extension === 'js') {
-      if (!safeFileWrite(pageObjectFile, pageObjectTemplate.replace('{{actor}}', actor))) return;
-    } else if (result.objectType === 'class') {
-      const content = poClassTemplate.replace(/{{actor}}/g, actor).replace(/{{name}}/g, name);
-      if (!safeFileWrite(pageObjectFile, content)) return;
-    }
+      const name = lcfirst(result.name) + ucfirst(kind)
+      if (result.objectType === 'module' && extension === 'ts') {
+        if (!safeFileWrite(pageObjectFile, poModuleTemplateTS.replace('{{actor}}', actor))) return
+      } else if (result.objectType === 'module' && extension === 'js') {
+        if (!safeFileWrite(pageObjectFile, pageObjectTemplate.replace('{{actor}}', actor))) return
+      } else if (result.objectType === 'class') {
+        const content = poClassTemplate.replace(/{{actor}}/g, actor).replace(/{{name}}/g, name)
+        if (!safeFileWrite(pageObjectFile, content)) return
+      }
 
-    let data = readConfig(configFile);
-    config.include[name] = result.filename;
+      let data = readConfig(configFile)
+      config.include[name] = result.filename
 
-    if (!data) throw Error('Config file is empty');
-    const currentInclude = `${data.match(/include:[\s\S][^\}]*/i)[0]}\n ${name}:${JSON.stringify(config.include[name])}`;
+      if (!data) throw Error('Config file is empty')
+      const currentInclude = `${data.match(/include:[\s\S][^\}]*/i)[0]}\n ${name}:${JSON.stringify(config.include[name])}`
 
-    data = data.replace(/include:[\s\S][^\}]*/i, `${currentInclude},`);
+      data = data.replace(/include:[\s\S][^\}]*/i, `${currentInclude},`)
 
-    fs.writeFileSync(configFile, beautify(data), 'utf-8');
+      fs.writeFileSync(configFile, beautify(data), 'utf-8')
 
-    output.success(`${ucfirst(kind)} object for ${result.name} was created in ${pageObjectFile}`);
-    output.print(`Your config file (${colors.cyan('include')} section) has included the new created PO:
+      output.success(`${ucfirst(kind)} object for ${result.name} was created in ${pageObjectFile}`)
+      output.print(`Your config file (${colors.cyan('include')} section) has included the new created PO:
 
     include: {
     ...
       ${name}: '${result.filename}',
-    },`);
+    },`)
 
-    output.print(`Use ${output.colors.bold(colors.cyan(name))} as parameter in test scenarios to access this object:`);
-    output.print(`\nScenario('my new test', ({ I, ${name} })) { /** ... */ }\n`);
+      output.print(`Use ${output.colors.bold(colors.cyan(name))} as parameter in test scenarios to access this object:`)
+      output.print(`\nScenario('my new test', ({ I, ${name} })) { /** ... */ }\n`)
 
-    try {
-      generateDefinitions(testsPath, {});
-    } catch (_err) {
-      output.print(`Run ${colors.green('npx codeceptjs def')} to update your types to get auto-completion for object.`);
-    }
-  });
-};
+      try {
+        generateDefinitions(testsPath, {})
+      } catch (_err) {
+        output.print(`Run ${colors.green('npx codeceptjs def')} to update your types to get auto-completion for object.`)
+      }
+    })
+}
 
-const helperTemplate = `const Helper = require('@codeceptjs/helper');
+const helperTemplate = `import Helper from '@codeceptjs/helper';
 
 class {{name}} extends Helper {
 
@@ -222,64 +223,71 @@ class {{name}} extends Helper {
 
 }
 
-module.exports = {{name}};
-`;
-
-export const helper = function (genPath) {
-  const testsPath = getTestRoot(genPath);
-
-  output.print('Creating a new helper');
-  output.print('--------------------------');
-
-  return inquirer.prompt([{
-    type: 'input',
-    name: 'name',
-    message: 'Name of a Helper',
-    validate: (val) => !!val,
-  }, {
-    type: 'input',
-    name: 'filename',
-    message: 'Where should it be stored',
-    default: answers => `./${answers.name.toLowerCase()}_helper.${extension}`,
-  }]).then((result) => {
-    const name = ucfirst(result.name);
-    const helperFile = path.join(testsPath, result.filename);
-    const dir = path.dirname(helperFile);
-    if (!fileExists(dir)) fs.mkdirSync(dir);
-
-    if (!safeFileWrite(helperFile, helperTemplate.replace(/{{name}}/g, name))) return;
-    output.success(`Helper for ${name} was created in ${helperFile}`);
-    output.print(`Update your config file (add to ${colors.cyan('helpers')} section):
+export default {{name}};
+`
+
+export async function helper(genPath) {
+  const testsPath = getTestRoot(genPath)
+
+  output.print('Creating a new helper')
+  output.print('--------------------------')
+
+  return inquirer
+    .prompt([
+      {
+        type: 'input',
+        name: 'name',
+        message: 'Name of a Helper',
+        validate: val => !!val,
+      },
+      {
+        type: 'input',
+        name: 'filename',
+        message: 'Where should it be stored',
+        default: answers => `./${answers.name.toLowerCase()}_helper.${extension}`,
+      },
+    ])
+    .then(result => {
+      const name = ucfirst(result.name)
+      const helperFile = path.join(testsPath, result.filename)
+      const dir = path.dirname(helperFile)
+      if (!fileExists(dir)) fs.mkdirSync(dir)
+
+      if (!safeFileWrite(helperFile, helperTemplate.replace(/{{name}}/g, name))) return
+      output.success(`Helper for ${name} was created in ${helperFile}`)
+      output.print(`Update your config file (add to ${colors.cyan('helpers')} section):
 
 helpers: {
   ${name}: {
     require: '${result.filename}',
   },
 },
-    `);
-  });
-};
+    `)
+    })
+}
 
-const healTemplate = fs.readFileSync(path.join(__dirname, '/template/heal.js'), 'utf8').toString();
+import { fileURLToPath } from 'url'
+const __dirname = path.dirname(fileURLToPath(import.meta.url))
+const healTemplate = fs.readFileSync(path.join(__dirname, '../template/heal.js'), 'utf8').toString()
 
-export function heal(genPath) {
-  const testsPath = getTestRoot(genPath);
+export async function heal(genPath) {
+  const testsPath = getTestRoot(genPath)
 
-  let configFile = path.join(testsPath, `codecept.conf.${extension}`);
+  let configFile = path.join(testsPath, `codecept.conf.${extension}`)
 
   if (!fileExists(configFile)) {
-    configFile = path.join(testsPath, `codecept.conf.${extension}`);
-    if (fileExists(configFile)) extension = 'ts';
+    configFile = path.join(testsPath, `codecept.conf.${extension}`)
+    if (fileExists(configFile)) extension = 'ts'
   }
 
-  output.print('Creating basic heal recipes');
-  output.print(`Add your own custom recipes to ./heal.${extension} file`);
-  output.print('Require this file in the config file and enable heal plugin:');
-  output.print('--------------------------');
+  output.print('Creating basic heal recipes')
+  output.print(`Add your own custom recipes to ./heal.${extension} file`)
+  output.print('Require this file in the config file and enable heal plugin:')
+  output.print('--------------------------')
   output.print(`
-require('./heal')
+import './heal.js'
 
-exports.config = {
+export const config = {
   // ...
   plugins: {
     heal: {
@@ -287,9 +295,41 @@ exports.config = {
     }
   }
 }
-  `);
+  `)
+
+  const healFile = path.join(testsPath, `heal.${extension}`)
+  if (!safeFileWrite(healFile, healTemplate)) return
+  output.success(`Heal recipes were created in ${healFile}`)
+}
+
+export async function prompt(promptName, genPath) {
+  if (!promptName) {
+    output.error('Please specify prompt name: writeStep, healStep, or generatePageObject')
+    output.print('Usage: npx codeceptjs generate:prompt <promptName>')
+    return
+  }
 
-  const healFile = path.join(testsPath, `heal.${extension}`);
-  if (!safeFileWrite(healFile, healTemplate)) return;
-  output.success(`Heal recipes were created in ${healFile}`);
-};
+  const validPrompts = ['writeStep', 'healStep', 'generatePageObject']
+  if (!validPrompts.includes(promptName)) {
+    output.error(`Invalid prompt name: ${promptName}`)
+    output.print(`Valid prompts: ${validPrompts.join(', ')}`)
+    return
+  }
+
+  const testsPath = getTestRoot(genPath)
+
+  const promptsDir = path.join(testsPath, 'prompts')
+  if (!fileExists(promptsDir)) {
+    mkdirp.sync(promptsDir)
+  }
+
+  const templatePath = path.join(__dirname, `../template/prompts/${promptName}.js`)
+  const promptContent = fs.readFileSync(templatePath, 'utf8')
+
+  const promptFile = path.join(promptsDir, `${promptName}.${extension}`)
+  if (!safeFileWrite(promptFile, promptContent)) return
+
+  output.success(`Prompt ${promptName} was created in ${promptFile}`)
+  output.print('Customize this prompt to fit your needs.')
+  output.print('This prompt will be automatically loaded when AI features are enabled.')
+}

package/lib/command/gherkin/init.js

@@ -1,10 +1,9 @@
-import path from 'path';
-import mkdirp from 'mkdirp';
-import * as output from '../../output.js';
-import { fileExists } from '../../utils.js';
-import {
-  getConfig, getTestRoot, updateConfig, safeFileWrite,
-} from '../utils.js';
+import path from 'path'
+import { mkdirp } from 'mkdirp'
+
+import output from '../../output.js'
+import { fileExists } from '../../utils.js'
+import { getConfig, getTestRoot, updateConfig, safeFileWrite, findConfigFile } from '../utils.js'
 
 const featureFile = `Feature: Business rules
   In order to achieve my goals
@@ -13,7 +12,7 @@ const featureFile = `Feature: Business rules
 
   Scenario: do something
     Given I have a defined step
-`;
+`
 
 const stepsFile = `const { I } = inject();
 // Add in your custom step files
@@ -21,50 +20,60 @@ const stepsFile = `const { I } = inject();
 Given('I have a defined step', () => {
   // TODO: replace with your own step
 });
-`;
+`
+
+export default async function (genPath) {
+  const testsPath = getTestRoot(genPath)
+  const configFile = findConfigFile(testsPath)
 
-export default function (genPath) {
-  const testsPath = getTestRoot(genPath);
-  const config = getConfig(testsPath);
+  if (!configFile) {
+    output.error("Can't initialize Gherkin. This command must be run in an already initialized project.")
+    process.exit(1)
+  }
 
-  output.print('Initializing Gherkin (Cucumber BDD) for CodeceptJS');
-  output.print('--------------------------');
+  const config = await getConfig(testsPath)
+  const extension = path.extname(configFile).substring(1)
+
+  output.print('Initializing Gherkin (Cucumber BDD) for CodeceptJS')
+  output.print('--------------------------')
 
   if (config.gherkin && config.gherkin.steps) {
-    output.output.error('Gherkin is already initialized in this project. See `gherkin` section in the config');
-    process.exit(1);
+    output.error('Gherkin is already initialized in this project. See `gherkin` section in the config')
+    process.exit(1)
   }
 
-  let dir;
-  dir = path.join(testsPath, 'features');
+  let dir
+  dir = path.join(testsPath, 'features')
   if (!fileExists(dir)) {
-    mkdirp.sync(dir);
-    output.success(`Created ${dir}, place your *.feature files in it`);
+    mkdirp.sync(dir)
+    // Use relative path for output
+    const relativeDir = path.relative(process.cwd(), dir)
+    output.success(`Created ${relativeDir}, place your *.feature files in it`)
   }
 
   if (safeFileWrite(path.join(dir, 'basic.feature'), featureFile)) {
-    output.success('Created sample feature file: features/basic.feature');
+    output.success('Created sample feature file: features/basic.feature')
   }
 
-  dir = path.join(testsPath, 'step_definitions');
+  dir = path.join(testsPath, 'step_definitions')
   if (!fileExists(dir)) {
-    mkdirp.sync(dir);
-    output.success(`Created ${dir}, place step definitions into it`);
+    mkdirp.sync(dir)
+    // Use relative path for output
+    const relativeDir = path.relative(process.cwd(), dir)
+    output.success(`Created ${relativeDir}, place step definitions into it`)
   }
 
-  if (safeFileWrite(path.join(dir, 'steps.js'), stepsFile)) {
-    output.success('Created sample steps file: step_definitions/steps.js');
+  if (safeFileWrite(path.join(dir, `steps.${extension}`), stepsFile)) {
+    output.success(`Created sample steps file: step_definitions/steps.${extension}`)
   }
 
   config.gherkin = {
     features: './features/*.feature',
-    steps: [
-      './step_definitions/steps.js',
-    ],
-  };
+    steps: [`./step_definitions/steps.${extension}`],
+  }
 
-  updateConfig(testsPath, config);
+  updateConfig(testsPath, config, extension)
 
-  output.success('Gherkin setup is done.');
-  output.success('Start writing feature files and implement corresponding steps.');
+  output.success('Gherkin setup is done.')
+  output.success('Start writing feature files and implement corresponding steps.')
 }