sxy-test-runner 1.0.0

package/dist/cli/lib/runDescribe.unitTest.js

@@ -0,0 +1,287 @@
+import { applyConfigDefaults } from './applyConfigDefaults.js';
+import { loadTestFile } from './loadTestFile.js';
+import { runDescribe } from './runDescribe.js';
+const defaultConfig = await applyConfigDefaults({}); // const beforeAfterTestFile = 'unitTesting/runTest/beforeAfter.test.js'
+// const beforeAfterTest = loadTestFile(defaultConfig, beforeAfterTestFile)
+
+await mochaDescribe('runDescribe() function', async function () {
+  await mochaIt('should run an it block that was loaded from a test file', async function () {
+    const sampleTestFile = 'unitTesting/runTest/1.test.js';
+    const sampleTest = await loadTestFile(defaultConfig, sampleTestFile);
+    const sampleDescribe = sampleTest.describes[0];
+    const describeResult = await runDescribe(defaultConfig, sampleDescribe);
+    await describeResult.should.include.keys(['counter', 'thing', 'success', 'itResults', 'itResultsSummary']);
+    await describeResult.success.should.equal(true);
+    await describeResult.itResultsSummary.total.should.equal(1);
+    await describeResult.itResultsSummary.passes.should.equal(1);
+  }); // mochaIt('should return sensible results from a test file without any describes', function() {
+  //     //const config = applyConfigDefaults({})
+  //     const sampleTestFile = 'unitTesting/sampletests/blank.test.js'
+  //     const sampleTest = loadTestFile(defaultConfig, sampleTestFile)
+  //     const testResult = runTest(defaultConfig, sampleTest)
+  //     //console.log(testResult)
+  //     //console.log(testResult.describeResults[0].itResults)
+  //     //console.log(testResult.describeResults[0].itResultsSummary)
+  //     testResult.should.include.keys([
+  //         'file',
+  //         'success',
+  //         'describeResults',
+  //         'describeResultsSummary'
+  //     ])
+  //     chaiExpect(testResult.success).to.be.null
+  //     //testResult.describeResultsSummary.total.should.equal(1)
+  //     //testResult.describeResultsSummary.passes.should.equal(1)
+  //     //testResult.describeResultsSummary.itsTotal.should.equal(1)
+  //     //testResult.describeResultsSummary.itsPasses.should.equal(1)
+  // })
+  // mochaIt('should return sensible results from a test file with describes without any its/tests', function() {
+  //     //const config = applyConfigDefaults({})
+  //     const sampleTestFile = 'unitTesting/sampletests/describesWithoutTests.test.js'
+  //     const sampleTest = loadTestFile(defaultConfig, sampleTestFile)
+  //     const testResult = runTest(defaultConfig, sampleTest)
+  //     //console.log(testResult)
+  //     //console.log(testResult.describeResults[0].itResults)
+  //     //console.log(testResult.describeResults[0].itResultsSummary)
+  //     testResult.should.include.keys([
+  //         'file',
+  //         'success',
+  //         'describeResults',
+  //         'describeResultsSummary'
+  //     ])
+  //     chaiExpect(testResult.success).to.be.null
+  //     testResult.describeResultsSummary.total.should.equal(0)
+  //     testResult.describeResultsSummary.passes.should.equal(0)
+  //     testResult.describeResultsSummary.invalid.should.equal(2)
+  //     testResult.describeResultsSummary.itsTotal.should.equal(0)
+  //     testResult.describeResultsSummary.itsPasses.should.equal(0)
+  // })
+  // mochaIt("should run beforeEachFile tasks (before - can't test)", function() {
+  //     let functionHasRun = false
+  //     global.beforeEachFileFileHasRun = false
+  //     const ourConfig = {
+  //         beforeEachFile: [
+  //             function() {
+  //                 functionHasRun = true
+  //             },
+  //             'unitTesting/runTest/beforeEachFile.js'
+  //         ]
+  //     }
+  //     const config = applyConfigDefaults(ourConfig)
+  //     runTest(config, beforeAfterTest)
+  //     functionHasRun.should.equal(true)
+  //     global.beforeEachFileFileHasRun.should.equal(true)
+  // })
+  // mochaIt("should run afterEachFile tasks (after - can't test)", function() {
+  //     let functionHasRun = false
+  //     global.afterEachFileFileHasRun = false
+  //     const ourConfig = {
+  //         afterEachFile: [
+  //             function() {
+  //                 functionHasRun = true
+  //             },
+  //             'unitTesting/runTest/afterEachFile.js'
+  //         ]
+  //     }
+  //     const config = applyConfigDefaults(ourConfig)
+  //     runTest(config, beforeAfterTest)
+  //     functionHasRun.should.equal(true)
+  //     global.afterEachFileFileHasRun.should.equal(true)
+  // })
+  // mochaIt("should run beforeEachDescribe tasks (before - can't test) each describe block", function() {
+  //     let functionHasRunTimes = 0
+  //     global.beforeEachDescribeFileHasRun = false
+  //     const ourConfig = {
+  //         beforeEachDescribe: [
+  //             function() {
+  //                 functionHasRunTimes++
+  //             },
+  //             'unitTesting/runTest/beforeEachDescribe.js'
+  //         ]
+  //     }
+  //     const config = applyConfigDefaults(ourConfig)
+  //     runTest(config, beforeAfterTest)
+  //     functionHasRunTimes.should.equal(2)
+  //     global.beforeEachDescribeFileHasRun.should.equal(true)
+  // })
+  // mochaIt("should run afterEachDescribe tasks (after - can't test) each describe block", function() {
+  //     let functionHasRunTimes = 0
+  //     global.afterEachDescribeFileHasRun = false
+  //     const ourConfig = {
+  //         afterEachDescribe: [
+  //             function() {
+  //                 functionHasRunTimes++
+  //             },
+  //             'unitTesting/runTest/afterEachDescribe.js'
+  //         ]
+  //     }
+  //     const config = applyConfigDefaults(ourConfig)
+  //     runTest(config, beforeAfterTest)
+  //     functionHasRunTimes.should.equal(2)
+  //     global.afterEachDescribeFileHasRun.should.equal(true)
+  // })
+  // mochaIt("should run beforeEachTest tasks (before - can't test) each test/it block", function() {
+  //     let functionHasRunTimes = 0
+  //     global.beforeEachTestbeforeEachFileFileHasRun = false
+  //     const ourConfig = {
+  //         beforeEachTest: [
+  //             function() {
+  //                 functionHasRunTimes++
+  //             },
+  //             'unitTesting/runTest/beforeEachTest.js'
+  //         ]
+  //     }
+  //     const config = applyConfigDefaults(ourConfig)
+  //     runTest(config, beforeAfterTest)
+  //     functionHasRunTimes.should.equal(3)
+  //     global.beforeEachTestFileHasRun.should.equal(true)
+  // })
+  // mochaIt("should run afterEachTest tasks (after - can't test) each test/it block", function() {
+  //     let functionHasRunTimes = 0
+  //     global.afterEachTestFileFileHasRun = false
+  //     const ourConfig = {
+  //         afterEachTest: [
+  //             function() {
+  //                 functionHasRunTimes++
+  //             },
+  //             'unitTesting/runTest/afterEachTest.js'
+  //         ]
+  //     }
+  //     const config = applyConfigDefaults(ourConfig)
+  //     runTest(config, beforeAfterTest)
+  //     functionHasRunTimes.should.equal(3)
+  //     global.afterEachTestFileHasRun.should.equal(true)
+  // })
+  // // exports provision to test file
+  // // current beforeEachFile exports aren't provided
+  // // perhaps extend sxy-loader to allow this
+  // mochaIt("should pass exported/returned data from beforeEachDescribe tasks", function() {
+  //     const testFile = 'unitTesting/runTest/beforeEachDescribe.test.js'
+  //     const test = loadTestFile(defaultConfig, testFile)
+  //     const ourConfig = {
+  //         beforeEachDescribe: [
+  //             function() {
+  //                 return { functionThing : 'foo' }
+  //             },
+  //             'unitTesting/runTest/beforeEachDescribeExport.js'
+  //         ]
+  //     }
+  //     const config = applyConfigDefaults(ourConfig)
+  //     runTest(config, test)
+  //     global.functionThing.should.equal('foo')
+  //     global.fileThing.should.equal('bar')
+  // })
+  // mochaIt("should pass exported/returned data from beforeEachTest tasks", function() {
+  //     const testFile = 'unitTesting/runTest/beforeEachTest.test.js'
+  //     const test = loadTestFile(defaultConfig, testFile)
+  //     const ourConfig = {
+  //         beforeEachTest: [
+  //             function() {
+  //                 return { functionThing : 'foo' }
+  //             },
+  //             'unitTesting/runTest/beforeEachTestExport.js'
+  //         ]
+  //     }
+  //     const config = applyConfigDefaults(ourConfig)
+  //     runTest(config, test)
+  //     global.functionThing.should.equal('foo')
+  //     global.fileThing.should.equal('bar')
+  // })
+  // // exports pass through
+  // mochaIt("beforeEachFile exports are passed through to afterEachFile", function() {
+  //     // don't try to reload test, fails due to module caching
+  //     //const testFile = 'unitTesting/runTest/beforeAfter.test.js'
+  //     //const test = loadTestFile(defaultConfig, testFile)
+  //     let exports
+  //     const ourConfig = {
+  //         beforeEachFile: [
+  //             function() {
+  //                 return { functionThing : 'foo' }
+  //             },
+  //             'unitTesting/runTest/beforeEachExport.js'
+  //         ],
+  //         afterEachFile: [
+  //             function(theExports) {
+  //                 theExports.should.have.keys(['functionThing', 'fileThing'])
+  //                 exports = theExports
+  //             },
+  //         ]
+  //     }
+  //     const config = applyConfigDefaults(ourConfig)
+  //     runTest(config, beforeAfterTest)
+  //     exports.functionThing.should.equal('foo')
+  //     exports.fileThing.should.equal('bar')
+  // })
+  // mochaIt("beforeEachDescribe exports are passed through to afterEachDescribe", function() {
+  //     // don't try to reload test, fails due to module caching
+  //     //const testFile = 'unitTesting/runTest/beforeAfter.test.js'
+  //     //const test = loadTestFile(defaultConfig, testFile)
+  //     let exports
+  //     const ourConfig = {
+  //         beforeEachDescribe: [
+  //             function() {
+  //                 return { functionThing : 'foo' }
+  //             },
+  //             'unitTesting/runTest/beforeEachExport.js'
+  //         ],
+  //         afterEachDescribe: [
+  //             function(theExports) {
+  //                 exports = theExports
+  //             },
+  //         ]
+  //     }
+  //     const config = applyConfigDefaults(ourConfig)
+  //     runTest(config, beforeAfterTest)
+  //     //console.log('exports', exports)
+  //     exports.functionThing.should.equal('foo')
+  //     exports.fileThing.should.equal('bar')
+  // })
+  // mochaIt("beforeEachTest exports are passed through to afterEachTest", function() {
+  //     // don't try to reload test, fails due to module caching
+  //     //const testFile = 'unitTesting/runTest/beforeAfter.test.js'
+  //     //const test = loadTestFile(defaultConfig, testFile)
+  //     let exports
+  //     const ourConfig = {
+  //         beforeEachTest: [
+  //             function() {
+  //                 return { functionThing : 'foo' }
+  //             },
+  //             'unitTesting/runTest/beforeEachExport.js'
+  //         ],
+  //         afterEachTest: [
+  //             function(theExports) {
+  //                 exports = theExports
+  //             },
+  //         ]
+  //     }
+  //     const config = applyConfigDefaults(ourConfig)
+  //     runTest(config, beforeAfterTest)
+  //     //console.log('exports', exports)
+  //     exports.functionThing.should.equal('foo')
+  //     exports.fileThing.should.equal('bar')
+  // })
+  // mochaIt("we can run code beforeEachTest and afterEachTest from within the test file", function() {
+  //     // don't try to reload test, fails due to module caching
+  //     const testFile = 'unitTesting/runTest/internalBeforeAfterEachTest.test.js'
+  //     const test = loadTestFile(defaultConfig, testFile)
+  //     const config = applyConfigDefaults({})
+  //     global.internalBeforeEachTestRanNTimes = 0
+  //     global.internalAfterEachTestRanNTimes = 0
+  //     runTest(config, test)
+  //     global.internalBeforeAfterEachTest_test1Valid.should.equal(true)
+  //     global.internalBeforeAfterEachTest_test2Valid.should.equal(true)
+  //     global.internalBeforeAfterEachTest_test3Valid.should.equal(true)
+  //     global.internalBeforeEachTestRanNTimes.should.equal(3)
+  //     global.internalAfterEachTestRanNTimes.should.equal(3)
+  // })
+  // mochaIt("we can run code afterDescribe from within descibe in the test file", function() {
+  //     // don't try to reload test, fails due to module caching
+  //     const testFile = 'unitTesting/runTest/internalAfterDescribeTest.test.js'
+  //     const test = loadTestFile(defaultConfig, testFile)
+  //     const config = applyConfigDefaults({})
+  //     global.internalAfterDescribeRanNTimes = 0
+  //     runTest(config, test)
+  //     //global.internalAfterDescribe_test1Valid.should.equal(true)
+  //     //global.internalAfterDescribe_test2Valid.should.equal(true)
+  //     global.internalAfterDescribeRanNTimes.should.equal(2)
+  // })
+});

package/dist/cli/lib/runDescribeParseIts.js

@@ -0,0 +1,87 @@
+import { timeProfileAsync } from './timeProfier.js';
+import { runTasks } from './runTasks.js';
+import { addExports } from './addExports.js';
+import { debug } from '../../output.js';
+import { runIt } from './runIt.js';
+export async function runDescribeParseIts(config, describe) {
+  return await timeProfileAsync(`parse its from describe ${describe.thing}`, async () => {
+    let itCounter = 1;
+    const its = []; // create functions to pass back
+    // afterDescribe
+
+    let afterDescribeFunc;
+
+    async function afterDescribe(func) {
+      if (typeof func !== 'function') {
+        throw new Error(`afterDescribe() error, argument passed to afterDescribe() must be a function,` + ` received ${typeof func}`);
+      }
+
+      afterDescribeFunc = func;
+    } // beforeEachTest
+
+
+    let beforeEachTestFunc;
+
+    async function beforeEachTest(func) {
+      if (typeof func !== 'function') {
+        throw new Error(`afterDescribe() error, argument passed to afterDescribe() must be a function,` + ` received ${typeof func}`);
+      }
+
+      beforeEachTestFunc = func;
+    } // afterEachTest
+
+
+    let afterEachTestFunc;
+
+    async function afterEachTest(func) {
+      if (typeof func !== 'function') {
+        throw new Error(`afterDescribe() error, argument passed to afterDescribe() must be a function,` + ` received ${typeof func}`);
+      }
+
+      afterEachTestFunc = func;
+    } // it
+
+
+    async function it(should, test) {
+      const thisItCounter = itCounter++;
+      await its.push({
+        counter: thisItCounter,
+        should,
+        test //beforeEachTestExports
+
+      });
+    }
+
+    const test = it;
+    const describeExports = {};
+    await configBeforeEachDescribe(config, describeExports);
+    const describeParcel = {
+      it,
+      test,
+      afterDescribe,
+      beforeEachTest,
+      afterEachTest
+    };
+    await addExports(describeParcel, describeExports);
+    await describe.tests(describeParcel);
+    return {
+      its,
+      afterDescribeFunc,
+      beforeEachTestFunc,
+      afterEachTestFunc
+    };
+  });
+}
+
+async function configBeforeEachDescribe(config, exports) {
+  if (config.beforeEachDescribe) {
+    const theExports = await runTasks(config.beforeEachDescribe, undefined);
+    await addExports(exports, theExports);
+  }
+}
+
+async function configAfterEachDescribe(config, exports) {
+  if (config.afterEachDescribe) {
+    await runTasks(config.afterEachDescribe, exports);
+  }
+}

package/dist/cli/lib/runDescribeRun.js

@@ -0,0 +1,59 @@
+import { timeProfileAsync } from './timeProfier.js';
+import { runTasks } from './runTasks.js';
+import { addExports } from './addExports.js';
+import { debug } from '../../output.js';
+import { runIt } from './runIt.js';
+export async function runDescribeRun(config, describe, parsedIts) {
+  return await timeProfileAsync(`run describe, run its ${describe.thing}`, async () => {
+    // const beforeEachDescribeExports = {}
+    // configBeforeEachDescribe(config, beforeEachDescribeExports)
+    const {
+      its,
+      beforeDescribeExports,
+      afterDescribeFunc,
+      beforeEachTestFunc,
+      afterEachTestFunc
+    } = parsedIts;
+    const itResults = [];
+
+    for (const it of its) {
+      await itResults.push(await runIt(config, it, beforeEachTestFunc, afterEachTestFunc));
+    }
+
+    const itResultsSummary = {
+      total: 0,
+      passes: 0
+    };
+
+    for (const itResult of itResults) {
+      itResultsSummary.total += +(itResult.success !== null);
+      itResultsSummary.passes += +itResult.success;
+    }
+
+    await debug('itResultsSummary', itResultsSummary);
+    const describeResult = {
+      counter: describe.counter,
+      thing: describe.thing,
+      success: itResultsSummary.total > 0 ? itResultsSummary.passes === itResultsSummary.total : null,
+      itResults,
+      itResultsSummary
+    }; // run after 
+
+    if (typeof afterDescribeFunc === 'function') await afterDescribeFunc();
+    await configAfterEachDescribe(config, beforeDescribeExports);
+    return describeResult;
+  });
+}
+
+async function configBeforeEachDescribe(config, exports) {
+  if (config.beforeEachDescribe) {
+    const theExports = await runTasks(config.beforeEachDescribe, undefined);
+    await addExports(exports, theExports);
+  }
+}
+
+async function configAfterEachDescribe(config, exports) {
+  if (config.afterEachDescribe) {
+    await runTasks(config.afterEachDescribe, exports);
+  }
+}