@plugjs/expect5 0.4.0

package/dist/test.cjs

@@ -0,0 +1,229 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// test.ts
+var test_exports = {};
+__export(test_exports, {
+  Test: () => Test
+});
+module.exports = __toCommonJS(test_exports);
+var import_node_assert = require("node:assert");
+var import_plug = require("@plugjs/plug");
+var import_logging = require("@plugjs/plug/logging");
+var import_asserts = require("@plugjs/plug/asserts");
+var import_executable = require("./execution/executable.cjs");
+var import_executor = require("./execution/executor.cjs");
+var import_expect = require("./expectation/expect.cjs");
+var import_types = require("./expectation/types.cjs");
+var import_print = require("./expectation/print.cjs");
+var import_diff = require("./expectation/diff.cjs");
+var setup = __toESM(require("./execution/setup.cjs"), 1);
+var _pending = "\u22EF";
+var _success = "\u2714";
+var _failure = "\u2718";
+var _details = "\u2192";
+var Test = class {
+  constructor(_options = {}) {
+    this._options = _options;
+  }
+  async pipe(files, context) {
+    (0, import_asserts.assert)(files.length, "No files available for running tests");
+    const {
+      globals = true,
+      genericErrorDiffs = true,
+      maxFailures = Number.POSITIVE_INFINITY
+    } = this._options;
+    if (globals) {
+      const anyGlobal = globalThis;
+      anyGlobal["describe"] = setup.describe;
+      anyGlobal["fdescribe"] = setup.fdescribe;
+      anyGlobal["xdescribe"] = setup.xdescribe;
+      anyGlobal["it"] = setup.it;
+      anyGlobal["fit"] = setup.fit;
+      anyGlobal["xit"] = setup.xit;
+      anyGlobal["afterAll"] = setup.afterAll;
+      anyGlobal["afterEach"] = setup.afterEach;
+      anyGlobal["beforeAll"] = setup.beforeAll;
+      anyGlobal["beforeEach"] = setup.beforeEach;
+      anyGlobal["xafterAll"] = setup.xafterAll;
+      anyGlobal["xafterEach"] = setup.xafterEach;
+      anyGlobal["xbeforeAll"] = setup.xbeforeAll;
+      anyGlobal["xbeforeEach"] = setup.xbeforeEach;
+      anyGlobal["skip"] = import_executable.skip;
+      anyGlobal["expect"] = import_expect.expect;
+      anyGlobal["log"] = import_logging.log;
+    }
+    const suite = new import_executable.Suite(void 0, "", async () => {
+      for (const file of files.absolutePaths())
+        await import(file);
+    });
+    await suite.setup();
+    const snum = suite.specs;
+    const fnum = files.length;
+    const smsg = snum === 1 ? "spec" : "specs";
+    const fmsg = fnum === 1 ? "file" : "files";
+    (0, import_asserts.assert)(snum, "No specs configured by test files");
+    const execution = (0, import_executor.runSuite)(suite);
+    execution.on("suite:start", (current) => {
+      if (current.parent === suite) {
+        if (suite.flag !== "only")
+          context.log.notice("");
+        context.log.enter(import_logging.NOTICE, `${(0, import_logging.$wht)(current.name)}`);
+        context.log.notice("");
+      } else if (current.parent) {
+        context.log.enter(import_logging.NOTICE, `${(0, import_logging.$blu)(_details)} ${(0, import_logging.$wht)(current.name)}`);
+      } else {
+        context.log.notice(`Running ${(0, import_logging.$ylw)(snum)} ${smsg} from ${(0, import_logging.$ylw)(fnum)} ${fmsg}`);
+        if (suite.flag === "only")
+          context.log.notice("");
+      }
+    });
+    execution.on("suite:done", (current) => {
+      if (current.parent)
+        context.log.leave();
+    });
+    execution.on("spec:start", (spec) => {
+      context.log.enter(import_logging.NOTICE, `${(0, import_logging.$blu)(_pending)} ${spec.name}`);
+    });
+    execution.on("spec:skip", (spec, ms) => {
+      if (suite.flag === "only")
+        return context.log.leave();
+      context.log.leave(import_logging.WARN, `${(0, import_logging.$ylw)(_pending)} ${spec.name} ${(0, import_logging.$ms)(ms)} ${(0, import_logging.$gry)("[")}${(0, import_logging.$ylw)("skipped")}${(0, import_logging.$gry)("]")}`);
+    });
+    execution.on("spec:pass", (spec, ms) => {
+      context.log.leave(import_logging.NOTICE, `${(0, import_logging.$grn)(_success)} ${spec.name} ${(0, import_logging.$ms)(ms)}`);
+    });
+    execution.on("spec:fail", (spec, ms, { number }) => {
+      context.log.leave(
+        import_logging.ERROR,
+        `${(0, import_logging.$red)(_failure)} ${spec.name} ${(0, import_logging.$ms)(ms)} ${(0, import_logging.$gry)("[")}${(0, import_logging.$red)("failed")}${(0, import_logging.$gry)("|")}${(0, import_logging.$red)(`${number}`)}${(0, import_logging.$gry)("]")}`
+      );
+    });
+    execution.on("hook:fail", (hook, ms, { number }) => {
+      context.log.error(`${(0, import_logging.$red)(_failure)} Hook "${hook.name}" ${(0, import_logging.$ms)(ms)} ${(0, import_logging.$gry)("[")}${(0, import_logging.$red)("failed")}${(0, import_logging.$gry)("|")}${(0, import_logging.$red)(`${number}`)}${(0, import_logging.$gry)("]")}`);
+    });
+    const { failed, passed, skipped, failures, time } = await execution.result;
+    const limit = Math.min(failures.length, maxFailures);
+    for (let i = 0; i < limit; i++) {
+      if (i === 0)
+        context.log.error("");
+      const { source, error, number } = failures[i];
+      const names = [""];
+      for (let p = source.parent; p?.parent; p = p.parent) {
+        if (p)
+          names.unshift(p.name);
+      }
+      const details = names.join(` ${(0, import_logging.$gry)(_details)} `) + (0, import_logging.$wht)(source.name);
+      context.log.enter(import_logging.ERROR, `${(0, import_logging.$gry)("[")}${(0, import_logging.$red)(number)}${(0, import_logging.$gry)("]:")} ${details}`);
+      dumpError(context.log, error, genericErrorDiffs);
+      context.log.leave();
+    }
+    const summary = [`${passed} ${(0, import_logging.$gry)("passed")}`];
+    if (skipped)
+      summary.push(`${skipped} ${(0, import_logging.$gry)("skipped")}`);
+    if (failed)
+      summary.push(`${failed} ${(0, import_logging.$gry)("failed")}`);
+    if (failures.length)
+      summary.push(`${failures.length} ${(0, import_logging.$gry)("total failures")}`);
+    const epilogue = ` ${(0, import_logging.$gry)("(")}${summary.join((0, import_logging.$gry)(", "))}${(0, import_logging.$gry)(")")}`;
+    const message = `Ran ${(0, import_logging.$ylw)(snum)} ${smsg} from ${(0, import_logging.$ylw)(fnum)} ${fmsg}${epilogue} ${(0, import_logging.$ms)(time)}`;
+    if (failures.length) {
+      context.log.error(message);
+      throw new import_plug.BuildFailure();
+    } else if (suite.flag === "only") {
+      context.log.error("");
+      context.log.error(message);
+      throw new import_plug.BuildFailure('Suite running in focus ("only") mode');
+    } else if (skipped) {
+      context.log.warn("");
+      context.log.warn(message);
+    } else {
+      context.log.notice("");
+      context.log.notice(message);
+    }
+  }
+};
+function dumpError(log2, error, genericErrorDiffs) {
+  if (error instanceof import_types.ExpectationError) {
+    log2.enter(import_logging.ERROR, `${(0, import_logging.$gry)("Expectation Error:")} ${(0, import_logging.$red)(error.message)}`);
+    try {
+      dumpStack(log2, error);
+      if (error.diff)
+        (0, import_print.printDiff)(log2, error.diff);
+    } finally {
+      log2.error("");
+      log2.leave();
+    }
+  } else if (error instanceof import_node_assert.AssertionError) {
+    const [message = "Unknown Error", ...lines] = error.message.split("\n");
+    log2.enter(import_logging.ERROR, `${(0, import_logging.$gry)("Assertion Error:")} ${(0, import_logging.$red)(message)}`);
+    try {
+      dumpStack(log2, error);
+      if (genericErrorDiffs) {
+        if (!error.generatedMessage)
+          for (const line of lines)
+            log2.error(" ", line);
+        (0, import_print.printDiff)(log2, (0, import_diff.diff)(error.actual, error.expected));
+      } else {
+        while (lines.length && !lines[0])
+          lines.shift();
+        for (const line of lines)
+          log2.error(" ", line);
+      }
+    } finally {
+      log2.error("");
+      log2.leave();
+    }
+  } else if (error instanceof Error) {
+    const message = error.message || "Unknown Error";
+    const type = (0, import_types.stringifyObjectType)(error);
+    log2.enter(import_logging.ERROR, `${(0, import_logging.$gry)(type)}: ${(0, import_logging.$red)(message)}`);
+    try {
+      dumpStack(log2, error);
+      if (genericErrorDiffs && ("actual" in error || "expected" in error)) {
+        (0, import_print.printDiff)(log2, (0, import_diff.diff)(error.actual, error.expected));
+      }
+    } finally {
+      log2.error("");
+      log2.leave();
+    }
+  } else {
+    log2.error((0, import_logging.$gry)("Uknown error:"), error);
+  }
+}
+function dumpStack(log2, error) {
+  if (!error.stack)
+    return log2.error("<no stack trace>");
+  error.stack.split("\n").filter((line) => line.match(/^\s+at\s+/)).map((line) => line.trim()).forEach((line) => log2.error(line));
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Test
+});
+//# sourceMappingURL=test.cjs.map

package/dist/test.cjs.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../src/test.ts"],
+  "mappings": "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",
+  "names": ["log"]
+}

package/dist/test.d.ts

@@ -0,0 +1,9 @@
+/// <reference path="index.d.ts" />
+import type { Files } from '@plugjs/plug/files';
+import type { Context, PipeParameters, Plug } from '@plugjs/plug/pipe';
+/** Writes some info about the current {@link Files} being passed around. */
+export declare class Test implements Plug<void> {
+    private readonly _options;
+    constructor(...args: PipeParameters<'test'>);
+    pipe(files: Files, context: Context): Promise<void>;
+}

package/dist/test.mjs

@@ -0,0 +1,194 @@
+// test.ts
+import { AssertionError } from "node:assert";
+import { BuildFailure } from "@plugjs/plug";
+import { $blu, $grn, $gry, $ms, $red, $wht, $ylw, log, ERROR, NOTICE, WARN } from "@plugjs/plug/logging";
+import { assert } from "@plugjs/plug/asserts";
+import { skip, Suite } from "./execution/executable.mjs";
+import { runSuite } from "./execution/executor.mjs";
+import { expect } from "./expectation/expect.mjs";
+import { ExpectationError, stringifyObjectType } from "./expectation/types.mjs";
+import { printDiff } from "./expectation/print.mjs";
+import { diff } from "./expectation/diff.mjs";
+import * as setup from "./execution/setup.mjs";
+var _pending = "\u22EF";
+var _success = "\u2714";
+var _failure = "\u2718";
+var _details = "\u2192";
+var Test = class {
+  constructor(_options = {}) {
+    this._options = _options;
+  }
+  async pipe(files, context) {
+    assert(files.length, "No files available for running tests");
+    const {
+      globals = true,
+      genericErrorDiffs = true,
+      maxFailures = Number.POSITIVE_INFINITY
+    } = this._options;
+    if (globals) {
+      const anyGlobal = globalThis;
+      anyGlobal["describe"] = setup.describe;
+      anyGlobal["fdescribe"] = setup.fdescribe;
+      anyGlobal["xdescribe"] = setup.xdescribe;
+      anyGlobal["it"] = setup.it;
+      anyGlobal["fit"] = setup.fit;
+      anyGlobal["xit"] = setup.xit;
+      anyGlobal["afterAll"] = setup.afterAll;
+      anyGlobal["afterEach"] = setup.afterEach;
+      anyGlobal["beforeAll"] = setup.beforeAll;
+      anyGlobal["beforeEach"] = setup.beforeEach;
+      anyGlobal["xafterAll"] = setup.xafterAll;
+      anyGlobal["xafterEach"] = setup.xafterEach;
+      anyGlobal["xbeforeAll"] = setup.xbeforeAll;
+      anyGlobal["xbeforeEach"] = setup.xbeforeEach;
+      anyGlobal["skip"] = skip;
+      anyGlobal["expect"] = expect;
+      anyGlobal["log"] = log;
+    }
+    const suite = new Suite(void 0, "", async () => {
+      for (const file of files.absolutePaths())
+        await import(file);
+    });
+    await suite.setup();
+    const snum = suite.specs;
+    const fnum = files.length;
+    const smsg = snum === 1 ? "spec" : "specs";
+    const fmsg = fnum === 1 ? "file" : "files";
+    assert(snum, "No specs configured by test files");
+    const execution = runSuite(suite);
+    execution.on("suite:start", (current) => {
+      if (current.parent === suite) {
+        if (suite.flag !== "only")
+          context.log.notice("");
+        context.log.enter(NOTICE, `${$wht(current.name)}`);
+        context.log.notice("");
+      } else if (current.parent) {
+        context.log.enter(NOTICE, `${$blu(_details)} ${$wht(current.name)}`);
+      } else {
+        context.log.notice(`Running ${$ylw(snum)} ${smsg} from ${$ylw(fnum)} ${fmsg}`);
+        if (suite.flag === "only")
+          context.log.notice("");
+      }
+    });
+    execution.on("suite:done", (current) => {
+      if (current.parent)
+        context.log.leave();
+    });
+    execution.on("spec:start", (spec) => {
+      context.log.enter(NOTICE, `${$blu(_pending)} ${spec.name}`);
+    });
+    execution.on("spec:skip", (spec, ms) => {
+      if (suite.flag === "only")
+        return context.log.leave();
+      context.log.leave(WARN, `${$ylw(_pending)} ${spec.name} ${$ms(ms)} ${$gry("[")}${$ylw("skipped")}${$gry("]")}`);
+    });
+    execution.on("spec:pass", (spec, ms) => {
+      context.log.leave(NOTICE, `${$grn(_success)} ${spec.name} ${$ms(ms)}`);
+    });
+    execution.on("spec:fail", (spec, ms, { number }) => {
+      context.log.leave(
+        ERROR,
+        `${$red(_failure)} ${spec.name} ${$ms(ms)} ${$gry("[")}${$red("failed")}${$gry("|")}${$red(`${number}`)}${$gry("]")}`
+      );
+    });
+    execution.on("hook:fail", (hook, ms, { number }) => {
+      context.log.error(`${$red(_failure)} Hook "${hook.name}" ${$ms(ms)} ${$gry("[")}${$red("failed")}${$gry("|")}${$red(`${number}`)}${$gry("]")}`);
+    });
+    const { failed, passed, skipped, failures, time } = await execution.result;
+    const limit = Math.min(failures.length, maxFailures);
+    for (let i = 0; i < limit; i++) {
+      if (i === 0)
+        context.log.error("");
+      const { source, error, number } = failures[i];
+      const names = [""];
+      for (let p = source.parent; p?.parent; p = p.parent) {
+        if (p)
+          names.unshift(p.name);
+      }
+      const details = names.join(` ${$gry(_details)} `) + $wht(source.name);
+      context.log.enter(ERROR, `${$gry("[")}${$red(number)}${$gry("]:")} ${details}`);
+      dumpError(context.log, error, genericErrorDiffs);
+      context.log.leave();
+    }
+    const summary = [`${passed} ${$gry("passed")}`];
+    if (skipped)
+      summary.push(`${skipped} ${$gry("skipped")}`);
+    if (failed)
+      summary.push(`${failed} ${$gry("failed")}`);
+    if (failures.length)
+      summary.push(`${failures.length} ${$gry("total failures")}`);
+    const epilogue = ` ${$gry("(")}${summary.join($gry(", "))}${$gry(")")}`;
+    const message = `Ran ${$ylw(snum)} ${smsg} from ${$ylw(fnum)} ${fmsg}${epilogue} ${$ms(time)}`;
+    if (failures.length) {
+      context.log.error(message);
+      throw new BuildFailure();
+    } else if (suite.flag === "only") {
+      context.log.error("");
+      context.log.error(message);
+      throw new BuildFailure('Suite running in focus ("only") mode');
+    } else if (skipped) {
+      context.log.warn("");
+      context.log.warn(message);
+    } else {
+      context.log.notice("");
+      context.log.notice(message);
+    }
+  }
+};
+function dumpError(log2, error, genericErrorDiffs) {
+  if (error instanceof ExpectationError) {
+    log2.enter(ERROR, `${$gry("Expectation Error:")} ${$red(error.message)}`);
+    try {
+      dumpStack(log2, error);
+      if (error.diff)
+        printDiff(log2, error.diff);
+    } finally {
+      log2.error("");
+      log2.leave();
+    }
+  } else if (error instanceof AssertionError) {
+    const [message = "Unknown Error", ...lines] = error.message.split("\n");
+    log2.enter(ERROR, `${$gry("Assertion Error:")} ${$red(message)}`);
+    try {
+      dumpStack(log2, error);
+      if (genericErrorDiffs) {
+        if (!error.generatedMessage)
+          for (const line of lines)
+            log2.error(" ", line);
+        printDiff(log2, diff(error.actual, error.expected));
+      } else {
+        while (lines.length && !lines[0])
+          lines.shift();
+        for (const line of lines)
+          log2.error(" ", line);
+      }
+    } finally {
+      log2.error("");
+      log2.leave();
+    }
+  } else if (error instanceof Error) {
+    const message = error.message || "Unknown Error";
+    const type = stringifyObjectType(error);
+    log2.enter(ERROR, `${$gry(type)}: ${$red(message)}`);
+    try {
+      dumpStack(log2, error);
+      if (genericErrorDiffs && ("actual" in error || "expected" in error)) {
+        printDiff(log2, diff(error.actual, error.expected));
+      }
+    } finally {
+      log2.error("");
+      log2.leave();
+    }
+  } else {
+    log2.error($gry("Uknown error:"), error);
+  }
+}
+function dumpStack(log2, error) {
+  if (!error.stack)
+    return log2.error("<no stack trace>");
+  error.stack.split("\n").filter((line) => line.match(/^\s+at\s+/)).map((line) => line.trim()).forEach((line) => log2.error(line));
+}
+export {
+  Test
+};
+//# sourceMappingURL=test.mjs.map

package/dist/test.mjs.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../src/test.ts"],
+  "mappings": "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",
+  "names": ["log"]
+}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@plugjs/expect5",
+  "version": "0.4.0",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "expect5": "./dist/cli.mjs"
+  },
+  "exports": {
+    ".": {
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.cjs"
+      },
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.mjs"
+      }
+    },
+    "./globals": {
+      "require": {
+        "types": "./dist/globals.d.ts",
+        "default": "./dist/globals.cjs"
+      },
+      "import": {
+        "types": "./dist/globals.d.ts",
+        "default": "./dist/globals.mjs"
+      }
+    },
+    "./test": {
+      "require": {
+        "types": "./dist/test.d.ts",
+        "default": "./dist/test.cjs"
+      },
+      "import": {
+        "types": "./dist/test.d.ts",
+        "default": "./dist/test.mjs"
+      }
+    }
+  },
+  "author": "Juit Developers <developers@juit.com>",
+  "license": "Apache-2.0",
+  "devDependencies": {
+    "@types/chai": "^4.3.4",
+    "chai": "^4.3.7"
+  },
+  "peerDependencies": {
+    "@plugjs/plug": "0.4.0"
+  },
+  "files": [
+    "*.md",
+    "dist/",
+    "src/"
+  ]
+}

package/src/cli.mts

@@ -0,0 +1,122 @@
+#!/usr/bin/env node
+
+import { async, find, paths, pipe, logging } from '@plugjs/plug'
+import { main, yargsParser } from '@plugjs/tsrun'
+
+import { Test } from './test'
+
+const { $blu, $und, $gry, $wht } = logging
+const $gnd = (s: string): string => $gry($und(s))
+const $bnd = (s: string): string => $blu($und(s))
+const $wnd = (s: string): string => $wht($und(s))
+
+
+/** Version injected by esbuild, defaulted in case of dynamic transpilation */
+const version = typeof __version === 'string' ? __version : '0.0.0-dev'
+declare const __version: string | undefined
+
+/* ========================================================================== *
+ * HELP SCREEN                                                                *
+ * ========================================================================== */
+
+/** Show help screen */
+function help(): void {
+  // eslint-disable-next-line no-console
+  console.log(`${$blu($und('Usage:'))}
+
+  ${$wht('expect5')} ${$gry('[')}--options${$gry('] [...')}globs${$gry('...]')}
+
+  ${$bnd('Options:')}
+
+      ${$wht('-d --directory')} ${$gnd('dir')}    Directory where tests are to be found
+      ${$wht('-h --help     ')}        Help! You're reading it now!
+      ${$wht('   --version  ')}        Version! This one: ${version}!
+
+  ${$bnd('Globs:')}
+
+      Other arguments will be treated as globs, used to match test files in
+      the specified directory (defaults to the current directory).
+
+      If no globs are specified, the default will be to find all JavaScript
+      and TypeScript files in the ${$wnd('./test')} directory, prefixed by the ${$wnd('.test')}
+      extension ${$gry('(for example')} ${$und('foobar.test.ts')}${$gry(')')}.
+
+  ${$bnd('Environment Variables:')}
+
+      ${$wht('LOG_LEVEL       ')}    The default ${$wnd('notice')}, or ${$gnd('debug')}, ${$gnd('info')}, ${$gnd('warn')} or ${$gnd('error')}.
+      ${$wht('NODE_V8_COVERAGE')}    The directory where Node will write coverage data to.
+
+  ${$bnd('TypeScript module format:')}
+
+      Normally our TypeScript loader will transpile ${$wnd('.ts')} files to the type
+      specified in ${$wnd('package.json')}, either ${$wnd('commonjs')} (the default) or ${$wnd('module')}.
+
+      To force a specific module format use one of the following flags:
+
+      ${$wht('--force-esm')}    Force transpilation of ${$wnd('.ts')} files to EcmaScript modules
+      ${$wht('--force-cjs')}    Force transpilation of ${$wnd('.ts')} files to CommonJS modules
+`)
+  process.exit(0)
+}
+
+/* ========================================================================== *
+ * MAIN TEST RUNNER                                                           *
+ * ========================================================================== */
+
+/** Parse command line and run tests */
+main(import.meta.url, async (args): Promise<void> => {
+  logging.logOptions.spinner = false
+
+  const filename = paths.requireFilename(import.meta.url) // self, for context
+  const context = new pipe.Context(filename, '') // context for pipes
+  let directory = '.' // default directory to CWD
+  const globs: string[] = [] // empty globs list
+
+  const parsed = yargsParser(args, {
+    configuration: {
+      'camel-case-expansion': false,
+      'strip-aliased': true,
+      'strip-dashed': true,
+    },
+
+    alias: {
+      'directory': [ 'd' ],
+      'help': [ 'h' ],
+    },
+
+    string: [ 'directory' ],
+    boolean: [ 'help', 'version' ],
+  })
+
+  for (const [ key, value ] of Object.entries(parsed)) {
+    switch (key) {
+      case '_': // globs as args
+        globs.push(...value)
+        break
+      case 'directory':
+        directory = context.resolve(value)
+        break
+      case 'help':
+        return help()
+      case 'version':
+        return context.log.notice(`Expect5 ${$gry('ver.')} ${$wnd(version)}`)
+      default:
+        context.log.error(`Unsupported option ${$wnd(key)} (try ${$wnd('--help')})`)
+        process.exit(1)
+    }
+  }
+
+  // Default glob (all .test.xx files in the test directory)
+  const glob = globs.shift() || 'test/**/*.test.([cm])?[jt]s'
+
+  // Simply create the Test plug and pass everything to it
+  try {
+    process.exitCode = 0
+    await async.runAsync(context, '', () => {
+      return find(glob, ...globs, { directory }).plug(new Test())
+    })
+  } catch (error) {
+    context.log.error(error)
+    process.exit(1)
+  }
+})