sxy-test-runner 2.5.1 → 2.5.3

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AACA,2EAA2E;AAC3E,2EAA2E;AAC3E,2EAA2E;AAC3E,+EAA+E","sourcesContent":["\n// Shared types for the test-run data model, user config, and CLI plumbing.\n// The config/result shapes are inferred from usage across the old awaitful\n// source (defaultConfig.js, validateConfig.js, init.js's template, and the\n// run*/parseDescribe/showTestResult modules) - there was no prior type source.\n\nimport type { FileMeta } from './meta.js'\nimport type { DescribeMeta } from './describe.js'\n\n\nexport type ExecutionMode = 'parallel' | 'sequential'\nexport type GlobPattern = string | string[]\n\nexport interface ExecutionConfig {\n    files: ExecutionMode\n    describes: ExecutionMode\n    tests: ExecutionMode\n}\n\n// path to write the latest watch run status to, or false to write none\nexport type StatusFileConfig = string | false\n\nexport interface WatchConfig {\n    watchFilesBase: string\n    watchFiles: GlobPattern\n    watchFilesIgnore: GlobPattern\n    runAllOnStartup: boolean\n    reRunFailingTests: boolean\n    // map a changed file to the tests that import it. Off, any watched change runs everything\n    dependencyEvaluation: boolean\n    ttyActionsOnKeypress: boolean\n    statusFile: StatusFileConfig\n}\n\nexport type TaskExports = Record<string, unknown>\nexport type ConfigTaskFn = (parcel?: TaskExports) => TaskExports | void | Promise<TaskExports | void>\n// a task may also be a file path (relative to the project root) to dynamically import\nexport type ConfigTask = ConfigTaskFn | string\nexport type ConfigTasks = ConfigTask | ConfigTask[]\n\nexport interface FinalConfig {\n    testsBase: string\n    tests: GlobPattern\n    testsFilter?: string\n    testsIgnore: GlobPattern\n    setup?: ConfigTasks\n    beforeEachFile?: ConfigTasks\n    afterEachFile?: ConfigTasks\n    beforeEachDescribe?: ConfigTasks\n    afterEachDescribe?: ConfigTasks\n    beforeEachTest?: ConfigTasks\n    afterEachTest?: ConfigTasks\n    teardown?: ConfigTasks\n    showErrorTrace: boolean\n    compact: boolean\n    // report the run as single agent readable lines instead of the usual output\n    agent: boolean\n    // stop the run at the first failing test, erroring describe or unloadable test file.\n    // Set by `once --fail-fast` only: it describes one invocation, not a project, and in\n    // watch mode it would silently truncate runs that report themselves as covering\n    // everything\n    failFast: boolean\n    execution: ExecutionConfig\n    watch: WatchConfig\n}\n\nexport type UserConfig = Partial<\n    Omit<FinalConfig, 'testsFilter' | 'failFast' | 'execution' | 'watch'>\n> & {\n    execution?: Partial<ExecutionConfig>\n    watch?: Partial<WatchConfig>\n}\n\nexport type UserConfigInternal = UserConfig\n    & Partial<Pick<FinalConfig, 'testsFilter' | 'failFast'>>\n\n\n// -- test-run data model --------------------------------------------------\n\nexport type TestParcel = TaskExports\n\nexport interface DescribeParcel extends TaskExports {\n    it: (should: string, test: (parcel: TestParcel) => void | Promise<void>) => void\n    test: (should: string, test: (parcel: TestParcel) => void | Promise<void>) => void\n    afterDescribe: (func: () => void | Promise<void>) => void\n    beforeEachTest: (func: () => TaskExports | void | Promise<TaskExports | void>) => void\n    afterEachTest: (func: () => void | Promise<void>) => void\n}\n\nexport type DescribeCallback = (parcel: DescribeParcel) => void | Promise<void>\n\n\n\nexport interface ParsedDescribe {\n    its: It[]\n    beforeDescribeExports: TaskExports\n    afterDescribeFunc?: () => void | Promise<void>\n    beforeEachTestFunc?: () => TaskExports | void | Promise<TaskExports | void>\n    afterEachTestFunc?: () => void | Promise<void>\n    error?: unknown\n}\n\n// export interface TestError extends Error {\n//     actual?: unknown\n//     expected?: unknown\n// }\n\n\n\n\n\n\n\n\n\n\nexport type DependencyTrees = Record<string, string[]>\n\nexport type OutFn = (...texts: unknown[]) => void\n\n\n\n// -- globals ----------------------------------------------------------------\n\nexport type Describe = {\n    counter: number\n    thing: string\n    meta?: DescribeMeta\n    tests: DescribeCallback\n}\n\nexport type It = {\n    counter: number\n    should: string\n    test: (parcel: TestParcel) => void | Promise<void>\n}\n\nexport interface SxyTestRunnerGlobal {\n    describes: Describe[]\n    describeCounter: number\n    fileMeta?: FileMeta\n}\ndeclare global {\n    var __sxy_test_runner__: SxyTestRunnerGlobal | undefined\n    var __sxyt_commandLineArguments: string[]\n}\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AACA,2EAA2E;AAC3E,2EAA2E;AAC3E,2EAA2E;AAC3E,+EAA+E","sourcesContent":["\n// Shared types for the test-run data model, user config, and CLI plumbing.\n// The config/result shapes are inferred from usage across the old awaitful\n// source (defaultConfig.js, validateConfig.js, init.js's template, and the\n// run*/parseDescribe/showTestResult modules) - there was no prior type source.\n\nimport type { FileMeta } from './meta.js'\nimport type { DescribeMeta } from './describe.js'\n\n\nexport type ExecutionMode = 'parallel' | 'sequential'\nexport type GlobPattern = string | string[]\n\nexport interface ExecutionConfig {\n    files: ExecutionMode\n    describes: ExecutionMode\n    tests: ExecutionMode\n}\n\n// path to write the latest watch run status to, or false to write none\nexport type StatusFileConfig = string | false\n\nexport interface WatchConfig {\n    watchFilesBase: string\n    watchFiles: GlobPattern\n    watchFilesIgnore: GlobPattern\n    runAllOnStartup: boolean\n    reRunFailingTests: boolean\n    // map a changed file to the tests that import it. Off, any watched change runs everything\n    dependencyEvaluation: boolean\n    ttyActionsOnKeypress: boolean\n    statusFile: StatusFileConfig\n}\n\nexport type TaskExports = Record<string, unknown>\nexport type ConfigTaskFn = (parcel?: TaskExports) => TaskExports | void | Promise<TaskExports | void>\n// a task may also be a file path (relative to the project root) to dynamically import\nexport type ConfigTask = ConfigTaskFn | string\nexport type ConfigTasks = ConfigTask | ConfigTask[]\n\nexport interface FinalConfig {\n    testsBase: string\n    tests: GlobPattern\n    testsFilter?: string\n    testsIgnore: GlobPattern\n    setup?: ConfigTasks\n    beforeEachFile?: ConfigTasks\n    afterEachFile?: ConfigTasks\n    beforeEachDescribe?: ConfigTasks\n    afterEachDescribe?: ConfigTasks\n    beforeEachTest?: ConfigTasks\n    afterEachTest?: ConfigTasks\n    teardown?: ConfigTasks\n    showErrorTrace: boolean\n    compact: boolean\n    // repeat a failed run's failures above the tallies, where scrolling has not buried them\n    restateFailures: boolean\n    // report the run as single agent readable lines instead of the usual output\n    agent: boolean\n    // the most characters of error text on each agent fail line; Infinity for no limit\n    agentLineLengthLimit: number\n    // stop the run at the first failing test, erroring describe or unloadable test file.\n    // Set by `once --fail-fast` only: it describes one invocation, not a project, and in\n    // watch mode it would silently truncate runs that report themselves as covering\n    // everything\n    failFast: boolean\n    execution: ExecutionConfig\n    watch: WatchConfig\n}\n\nexport type UserConfig = Partial<\n    Omit<FinalConfig, 'testsFilter' | 'failFast' | 'execution' | 'watch'>\n> & {\n    execution?: Partial<ExecutionConfig>\n    watch?: Partial<WatchConfig>\n}\n\nexport type UserConfigInternal = UserConfig\n    & Partial<Pick<FinalConfig, 'testsFilter' | 'failFast'>>\n\n\n// -- test-run data model --------------------------------------------------\n\nexport type TestParcel = TaskExports\n\nexport interface DescribeParcel extends TaskExports {\n    it: (should: string, test: (parcel: TestParcel) => void | Promise<void>) => void\n    test: (should: string, test: (parcel: TestParcel) => void | Promise<void>) => void\n    afterDescribe: (func: () => void | Promise<void>) => void\n    beforeEachTest: (func: () => TaskExports | void | Promise<TaskExports | void>) => void\n    afterEachTest: (func: () => void | Promise<void>) => void\n}\n\nexport type DescribeCallback = (parcel: DescribeParcel) => void | Promise<void>\n\n\n\nexport interface ParsedDescribe {\n    its: It[]\n    beforeDescribeExports: TaskExports\n    afterDescribeFunc?: () => void | Promise<void>\n    beforeEachTestFunc?: () => TaskExports | void | Promise<TaskExports | void>\n    afterEachTestFunc?: () => void | Promise<void>\n    error?: unknown\n}\n\n// export interface TestError extends Error {\n//     actual?: unknown\n//     expected?: unknown\n// }\n\n\n\n\n\n\n\n\n\n\nexport type DependencyTrees = Record<string, string[]>\n\nexport type OutFn = (...texts: unknown[]) => void\n\n\n\n// -- globals ----------------------------------------------------------------\n\nexport type Describe = {\n    counter: number\n    thing: string\n    meta?: DescribeMeta\n    tests: DescribeCallback\n}\n\nexport type It = {\n    counter: number\n    should: string\n    test: (parcel: TestParcel) => void | Promise<void>\n}\n\nexport interface SxyTestRunnerGlobal {\n    describes: Describe[]\n    describeCounter: number\n    fileMeta?: FileMeta\n}\ndeclare global {\n    var __sxy_test_runner__: SxyTestRunnerGlobal | undefined\n    var __sxyt_commandLineArguments: string[]\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sxy-test-runner",
-  "version": "2.5.1",
+  "version": "2.5.3",
   "license": "MIT",
   "homepage": "https://github.com/RobertSandiford/sxy-test-runner",
   "repository": {
@@ -109,6 +109,7 @@
     "unit-test-parse-describe": "mocha --watch --parallel --config unitTesting/.mocharc.cjs --watch-files dist,unitTesting dist/**/parseDescribe.unitTest.js",
     "unit-test-run-describe-run": "mocha --watch --parallel --config unitTesting/.mocharc.cjs --watch-files dist,unitTesting dist/**/runDescribeRun.unitTest.js",
     "unit-test-run-test": "mocha --watch --parallel --config unitTesting/.mocharc.cjs --watch-files dist,unitTesting dist/**/runTest.unitTest.js",
+    "unit-test-results-summary": "mocha --watch --parallel --config unitTesting/.mocharc.cjs --watch-files dist,unitTesting dist/**/showTestResultsSummary.unitTest.js",
     "unit-test-load-test-file": "mocha --watch --parallel --config unitTesting/.mocharc.cjs --watch-files dist,unitTesting dist/**/loadTestFile.unitTest.js",
     "unit-test-add-exports": "mocha --watch --parallel --config unitTesting/.mocharc.cjs --watch-files dist,unitTesting dist/**/addExports.unitTest.js",
     "unit-test-describe": "mocha --watch --parallel --config unitTesting/.mocharc.cjs --watch-files dist,unitTesting dist/**/describe.unitTest.js",

package/readme.md

@@ -203,6 +203,12 @@ clean suite. `status` is one of `passed`, `failed`, `aborted` (a test file would
 a describe threw) or `could-not-run` - the same states as the status file table above, named
 rather than numbered. It is not the process exit code: read that from the process.
 
+Each failure's error message is cut at 500 characters. Set `agentLineLengthLimit` in the
+config to change that, or to `Infinity` to keep messages whole.
+
+Agent mode also sets the environment variables `SXYT_AGENT` and `SXY_TEST_RUNNER_AGENT` to
+`true`, so setup code and tests can tell they are running under it.
+
 ## Stopping at the first failure
 
 `-x` or `--fail-fast` stops a `once` run at the first failing test, erroring describe, or
@@ -236,7 +242,8 @@ Because of this, be careful with globals, which will be shared.
 
 While tests are running, `NODE_ENV` defaults to `test` when it was not already set.
 `SXYT` and `SXY_TEST_RUNNER` are both set to `true`, allowing configuration and application
-code to detect sxy-test-runner specifically.
+code to detect sxy-test-runner specifically. In agent mode, `SXYT_AGENT` and
+`SXY_TEST_RUNNER_AGENT` are also set to `true`.
 
 ### Sharing a module between test files
 

package/dist/cli/lib/showTestResult.d.ts

@@ -1,4 +0,0 @@
-import type { FinalConfig, OutFn } from '../../types.js';
-import type { TestResult } from './runTest.js';
-export declare function showTestResult(config: FinalConfig, testResult: TestResult, customOut?: OutFn): Promise<void>;
-//# sourceMappingURL=showTestResult.d.ts.map

package/dist/cli/lib/showTestResult.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"showTestResult.js","sourceRoot":"","sources":["../../../src/cli/lib/showTestResult.ts"],"names":[],"mappings":"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","sourcesContent":["\nimport type { Expand } from 'sxy-lib/types/Expand.js'\nimport { inspect } from 'node:util'\n\nimport type { FinalConfig, OutFn } from '../../types.js'\nimport type { TestResult } from './runTest.js'\nimport chalk from '../../packages/chalk.js'\nimport figures from '../../packages/figures.js'\nimport { createTimeProfiler } from '../../packages/timeProfiler.js'\nimport { showTimeProfiling } from '../../config.js'\nimport { out as mainOut } from '../../output.js'\nimport { indexNumberToLetters } from '../../indexNumberToLetters.js'\n\n\nconst { timeProfileAsync } = createTimeProfiler(showTimeProfiling)\n\n// Assertion failures are recognised by shape, not by where they came from. Importing an\n// assertion library to test `instanceof` against cannot work here: the runner would need it\n// as a dependency, and the copy a test file throws from is a separate ESM instance anyway,\n// so the check fails for the very errors it is meant to catch.\n\n\ninterface ErrorLike {\n    name: string\n    message: string\n    stack?: unknown\n    cause?: unknown\n}\ninterface AssertionLike extends ErrorLike {\n    actual?: unknown\n    expected?: unknown\n}\nfunction IsErrorLike(v: unknown): v is Expand<ErrorLike> {\n    return typeof v === 'object' && v !== null\n        && 'name' in v && typeof v.name === 'string'\n        && 'message' in v && typeof v.message === 'string'\n}\nfunction ErrorLikeIsAssertionLike(v: ErrorLike): v is Expand<AssertionLike> {\n    return ('actual' in v || 'expected' in v)\n}\n\n\n// Node's assertion messages run to several lines. Later lines are indented to the message\n// column and blank ones dropped; a single line message passes through untouched.\nfunction alignMessage(message: string, spacer: string): string {\n    return message.split('\\n').reduce<string[]>(\n        (previous, line) => (previous.length === 0)\n            ? [line]\n            : (line.trim()) ? [...previous, spacer + line] : previous,\n        []\n    ).join('\\n')\n}\n\n// A multi line string is shown as text, indented under its label. inspect() would render it\n// as one quoted chunk per line joined with `+`, which buries the content it is there to\n// show. Everything else - objects, and single line strings, whose quotes reveal padding and\n// emptiness - still goes through inspect.\nfunction showValue(value: unknown, column: string): string {\n    if (typeof value !== 'string' || !value.includes('\\n')) {\n        return inspect(value, { depth: 5 })\n    }\n    return value.split('\\n').join(`\\n${column}`)\n}\n\n// sxy-assert describes an expected that is no single value (not null, instanceof) rather than carrying one\nfunction showExpected(err: AssertionLike, column: string): string {\n    if (!('expected' in err) && 'expectedDescription' in err && typeof err.expectedDescription === 'string') {\n        return err.expectedDescription\n    }\n    return showValue(err.expected, column)\n}\n\nfunction display(u: unknown): string {\n    if (typeof u === 'string') return u\n    return inspect(u)\n}\n\nexport async function showTestResult(config: FinalConfig, testResult: TestResult, customOut?: OutFn): Promise<void> {\n    const out = customOut ?? mainOut\n    // compact keeps only the blank line that separates files\n    const gap = config.compact ? () => {} : () => { out() }\n\n    await timeProfileAsync('show test result', () => {\n        out()\n        const fileTime = (testResult.time === undefined) ? '' : `  ${testResult.time.toLocaleString()}ms`\n            + ((testResult.loadTime === undefined)\n                ? ''\n                : ` (${testResult.loadTime.toLocaleString()}ms module re-loading)`)\n        out(chalk.grey`File ${testResult.sourceFile ?? testResult.file}${fileTime}`)\n\n        const indent = '    '\n\n        if (testResult.logs.length > 0) {\n            gap()\n            out(chalk.grey`console.logs:`)\n            testResult.logs.forEach(log => {\n                out(...log)\n            })\n            gap()\n        }\n\n        if (testResult.describeResults.length === 0) {\n            out('No describes')\n            gap()\n        }\n\n        let first = true\n\n        for (const describeResult of testResult.describeResults) {\n            if (!first) gap()\n            first = false\n\n            out(chalk.lightgrey`${describeResult.counter}) describing ` + chalk.brightblue(describeResult.thing)\n                + chalk.grey`  ${describeResult.time.toLocaleString()}ms`)\n            if (describeResult.itResults.length === 0 && !('error' in describeResult)) out(`${indent}No tests`)\n            gap()\n\n            if (describeResult.logs && describeResult.logs.length > 0) {\n                out(chalk.grey`console.logs:`)\n                describeResult.logs.forEach(log => {\n                    out(...log)\n                })\n                gap()\n            }\n\n            if ('error' in describeResult) {\n                const describeError = describeResult.error\n\n                out(chalk.mediumred(`${indent}Threw:`))\n                if (IsErrorLike(describeError)) {\n                    out(chalk.mediumred(`${indent}${describeError.name}: ${describeError.message}`))\n                    if (config.showErrorTrace && 'stack' in describeError) {\n                        gap()\n                        out(chalk.grey(display(describeError.stack)))\n                    }\n                } else {\n                    out(chalk.mediumred(`${indent}${display(describeError)}`))\n                }\n                gap()\n            }\n\n            for (const itResult of describeResult.itResults) {\n                const letters = indexNumberToLetters(itResult.counter) ?? ''\n                const itTime = chalk.grey`  ${itResult.time.toLocaleString()}ms`\n                if (itResult.success === true) {\n                    out(chalk.lightgrey`${indent}${letters})`\n                        + chalk.mediumgreen`  ${figures.tick}  ${itResult.should}` + itTime)\n                } else {\n                    out(chalk.lightgrey`${indent}${letters})`\n                        + chalk.mediumred`  ${figures.cross}  ${itResult.should}` + itTime)\n                    gap()\n                    const spacer = `${indent}${' '.repeat(letters.length)}   `\n                    if ('error' in itResult) {\n                        const err = itResult.error\n                        if (IsErrorLike(err)) {\n                            if (ErrorLikeIsAssertionLike(err)) {\n                                out(chalk.mediumred(\n                                    //`${spacer}Assertion Failed: ${alignMessage(err.message, spacer)}`\n                                    `${spacer}${err.name}: ${alignMessage(err.message, spacer)}`\n                                ))\n                                // shown whenever the error carries them, so a falsy actual or\n                                // expected - 0, '', false, null - still gets its diff\n                                const valueColumn = `${spacer}          `\n                                out(\n                                    chalk.yellow`${spacer}Actual    ${showValue(err.actual, valueColumn)}\\n`\n                                    + chalk.brightblue`${spacer}Expected  ${showExpected(err, valueColumn)}`\n                                )\n                            } else {\n                                out(chalk.mediumred(\n                                    `${spacer}${err.name}: ${alignMessage(err.message, spacer)}`\n                                ))\n                            }\n                            // stack trace\n                            if (config.showErrorTrace && 'stack' in err) {\n                                gap()\n                                out(chalk.grey(display(err.stack)))\n                            }\n                        } else {\n                            out(chalk.mediumred(\n                                `${spacer}${display(err)}`\n                            ))\n                        }\n                    }\n                }\n\n                gap()\n                if (itResult.logs.length > 0) {\n                    out(chalk.grey`console.logs:`)\n                    itResult.logs.forEach(log => {\n                        out(...log)\n                    })\n                    gap()\n                }\n            }\n        }\n    })\n}\n"]}

package/dist/cli/lib/timeProfier.d.ts

@@ -1,3 +0,0 @@
-declare const timeProfile: <T>(name: string, task: () => T) => T, timeProfileAsync: <T>(name: string, task: () => T | Promise<T>) => Promise<T>;
-export { timeProfile, timeProfileAsync };
-//# sourceMappingURL=timeProfier.d.ts.map

package/dist/cli/lib/timeProfier.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"timeProfier.js","sourceRoot":"","sources":["../../../src/cli/lib/timeProfier.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAA;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AAGnD,MAAM,EAAE,WAAW,EAAE,gBAAgB,EAAE,GAAG,kBAAkB,CAAC,iBAAiB,CAAC,CAAA;AAE/E,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,CAAA","sourcesContent":["\nimport { createTimeProfiler } from '../../packages/timeProfiler.js'\nimport { showTimeProfiling } from '../../config.js'\n\n\nconst { timeProfile, timeProfileAsync } = createTimeProfiler(showTimeProfiling)\n\nexport { timeProfile, timeProfileAsync }\n"]}