@plugjs/expect5 0.4.0

package/README.md

@@ -0,0 +1,7 @@
+Unit Testing for the PlugJS Build System
+========================================
+
+Prototype build system from [Juit GmbH](https://www.juit.com/)
+
+* [Copyright Notice](https://github.com/plugjs/plug/blob/main/NOTICE.md)
+* [License](https://github.com/plugjs/plug/blob/main/LICENSE.md)

package/dist/cli.d.mts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.mjs

@@ -0,0 +1,96 @@
+#!/usr/bin/env node
+
+// cli.mts
+import { async, find, paths, pipe, logging } from "@plugjs/plug";
+import { main, yargsParser } from "@plugjs/tsrun";
+import { Test } from "./test.mjs";
+var { $blu, $und, $gry, $wht } = logging;
+var $gnd = (s) => $gry($und(s));
+var $bnd = (s) => $blu($und(s));
+var $wnd = (s) => $wht($und(s));
+var version = true ? "0.4.0" : "0.0.0-dev";
+function help() {
+  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(import.meta.url, async (args) => {
+  logging.logOptions.spinner = false;
+  const filename = paths.requireFilename(import.meta.url);
+  const context = new pipe.Context(filename, "");
+  let directory = ".";
+  const globs = [];
+  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.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);
+    }
+  }
+  const glob = globs.shift() || "test/**/*.test.([cm])?[jt]s";
+  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);
+  }
+});
+//# sourceMappingURL=cli.mjs.map

package/dist/cli.mjs.map

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

package/dist/execution/executable.cjs

@@ -0,0 +1,299 @@
+"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);
+
+// execution/executable.ts
+var executable_exports = {};
+__export(executable_exports, {
+  Hook: () => Hook,
+  Spec: () => Spec,
+  Suite: () => Suite,
+  getCurrentSuite: () => getCurrentSuite,
+  skip: () => skip
+});
+module.exports = __toCommonJS(executable_exports);
+var import_node_assert = __toESM(require("node:assert"), 1);
+var import_node_async_hooks = require("node:async_hooks");
+function execute(call, timeout, notify) {
+  return new Promise((resolve) => {
+    let resolved = false;
+    const abort = new AbortController();
+    const handle = setTimeout(() => {
+      if (resolved)
+        return;
+      const error = new Error(`Timeout of ${timeout} ms reached`);
+      resolve(error);
+      notify?.(error);
+      resolved = true;
+    }, timeout).unref();
+    void Promise.resolve().then(async () => {
+      try {
+        await call.call(void 0, abort.signal);
+        resolve(void 0);
+        resolved = true;
+      } catch (cause) {
+        const error = cause instanceof Error ? cause : new Error(String(cause));
+        notify?.(error);
+        resolve(error);
+        resolved = true;
+      } finally {
+        abort.abort("Spec finished");
+        clearTimeout(handle);
+      }
+    });
+  });
+}
+var suiteKey = Symbol.for("plugjs.expect5.async.suiteStorage");
+var skipKey = Symbol.for("plugjs.expect5.async.skipStorage");
+function getSuiteStorage() {
+  let storage = globalThis[suiteKey];
+  if (!storage) {
+    storage = new import_node_async_hooks.AsyncLocalStorage();
+    globalThis[suiteKey] = storage;
+  }
+  return storage;
+}
+function getSkipStorage() {
+  let storage = globalThis[skipKey];
+  if (!storage) {
+    storage = new import_node_async_hooks.AsyncLocalStorage();
+    globalThis[skipKey] = storage;
+  }
+  return storage;
+}
+var suiteStorage = getSuiteStorage();
+var skipStorage = getSkipStorage();
+function getCurrentSuite() {
+  const suite = suiteStorage.getStore();
+  (0, import_node_assert.default)(suite, "No suite found");
+  return suite;
+}
+function skip() {
+  const skipState = skipStorage.getStore();
+  (0, import_node_assert.default)(skipState, 'The "skip" function can only be used in specs or hooks');
+  skipState.skipped = true;
+}
+var suiteMarker = Symbol.for("plugjs:expect5:marker:Suite");
+var Suite = class {
+  constructor(parent, name, call, timeout = 5e3, flag = void 0) {
+    this.parent = parent;
+    this.name = name;
+    this.call = call;
+    this.timeout = timeout;
+    this.flag = flag;
+  }
+  _beforeAll = [];
+  _beforeEach = [];
+  _afterAll = [];
+  _afterEach = [];
+  _suites = [];
+  _specs = [];
+  _children = [];
+  _setup = false;
+  static {
+    this.prototype[suiteMarker] = suiteMarker;
+  }
+  static [Symbol.hasInstance](instance) {
+    return instance && instance[suiteMarker] === suiteMarker;
+  }
+  get specs() {
+    return this._suites.reduce((n, s) => n + s.specs, 0) + this._specs.length;
+  }
+  /** Add a child {@link Suite} to this */
+  addSuite(suite) {
+    import_node_assert.default.strictEqual(suite.parent, this, "Suite is not a child of this");
+    this._children.push(suite);
+    this._suites.push(suite);
+  }
+  /** Add a {@link Spec} to this */
+  addSpec(spec) {
+    import_node_assert.default.strictEqual(spec.parent, this, "Spec is not a child of this");
+    this._children.push(spec);
+    this._specs.push(spec);
+  }
+  /** Add a _before all_ {@link Hook} to this */
+  addBeforeAllHook(hook) {
+    import_node_assert.default.strictEqual(hook.parent, this, "Hook is not a child of this");
+    import_node_assert.default.strictEqual(hook.name, "beforeAll", `Invalid before all hook name "${hook.name}"`);
+    this._beforeAll.push(hook);
+  }
+  /** Add a _before each_ {@link Hook} to this */
+  addBeforeEachHook(hook) {
+    import_node_assert.default.strictEqual(hook.parent, this, "Hook is not a child of this");
+    import_node_assert.default.strictEqual(hook.name, "beforeEach", `Invalid before each hook name "${hook.name}"`);
+    this._beforeEach.push(hook);
+  }
+  /** Add a _after all_ {@link Hook} to this */
+  addAfterAllHook(hook) {
+    import_node_assert.default.strictEqual(hook.parent, this, "Hook is not a child of this");
+    import_node_assert.default.strictEqual(hook.name, "afterAll", `Invalid after all hook name "${hook.name}"`);
+    this._afterAll.push(hook);
+  }
+  /** Add a _after each_ {@link Hook} to this */
+  addAfterEachHook(hook) {
+    import_node_assert.default.strictEqual(hook.parent, this, "Hook is not a child of this");
+    import_node_assert.default.strictEqual(hook.name, "afterEach", `Invalid after each hook name "${hook.name}"`);
+    this._afterEach.push(hook);
+  }
+  /**
+   * Setup this {@link Suite} invoking its main function, then initializing all
+   * children {@link Suite Suites}, and finally normalizing execution flags.
+   */
+  async setup() {
+    if (this._setup)
+      return;
+    this._setup = true;
+    await suiteStorage.run(this, async () => {
+      const error = await execute(this.call, this.timeout);
+      if (error)
+        throw error;
+    });
+    if (this.parent) {
+      this._beforeEach.unshift(...this.parent._beforeEach.map((h) => h.clone(this)));
+      this._afterEach.push(...this.parent._afterEach.map((h) => h.clone(this)));
+    }
+    for (const suite of this._suites) {
+      await suite.setup();
+    }
+    for (const spec of this._specs) {
+      spec.before.push(...this._beforeEach.map((h) => h.clone(spec)));
+      spec.after.push(...this._afterEach.map((h) => h.clone(spec)));
+    }
+    const only = this._children.reduce((o, c) => o || c.flag === "only", false);
+    if (only) {
+      this._children.forEach((c) => c.flag !== "only" && (c.flag = "skip"));
+      this.flag = "only";
+    }
+    if (this.flag === "only") {
+      this._children.forEach((c) => c.flag !== "skip" && (c.flag = "only"));
+    }
+    for (const child of this._children) {
+      if (child.flag !== "skip")
+        return;
+    }
+    this.flag = "skip";
+  }
+  /**
+   * Execute this suite, executing all {@link Hook hooks} and children
+   * {@link Spec specs} and  {@link Suite suites}
+   */
+  async execute(executor, skip2 = false) {
+    const { done } = executor.start(this);
+    if (skip2 || this.flag === "skip") {
+      for (const child of this._children)
+        await child.execute(executor, true);
+      return done();
+    }
+    for (const hook of this._beforeAll) {
+      const failed = await hook.execute(executor);
+      if (failed) {
+        for (const child of this._children)
+          await child.execute(executor, true);
+        return done();
+      }
+    }
+    for (const child of this._children)
+      await child.execute(executor);
+    for (const hook of this._afterAll)
+      await hook.execute(executor);
+    done();
+  }
+};
+var specMarker = Symbol.for("plugjs:expect5:marker:Spec");
+var Spec = class {
+  constructor(parent, name, call, timeout = 5e3, flag = void 0) {
+    this.parent = parent;
+    this.name = name;
+    this.call = call;
+    this.timeout = timeout;
+    this.flag = flag;
+  }
+  before = [];
+  after = [];
+  static {
+    this.prototype[specMarker] = specMarker;
+  }
+  static [Symbol.hasInstance](instance) {
+    return instance && instance[specMarker] === specMarker;
+  }
+  /** Execute this spec */
+  async execute(executor, skip2 = false) {
+    const { done, notify } = executor.start(this);
+    if (skip2 || this.flag == "skip")
+      return done(true);
+    for (const hook of this.before) {
+      const failed = await hook.execute(executor);
+      if (failed)
+        return done(true);
+    }
+    const skipState = { skipped: false };
+    await skipStorage.run(skipState, () => execute(this.call, this.timeout, notify));
+    for (const hook of this.after)
+      await hook.execute(executor);
+    return done(skipState.skipped);
+  }
+};
+var hookMarker = Symbol.for("plugjs:expect5:marker:Hook");
+var Hook = class {
+  constructor(parent, name, call, timeout = 5e3, flag = void 0) {
+    this.parent = parent;
+    this.name = name;
+    this.call = call;
+    this.timeout = timeout;
+    this.flag = flag;
+  }
+  static {
+    this.prototype[hookMarker] = hookMarker;
+  }
+  static [Symbol.hasInstance](instance) {
+    return instance && instance[hookMarker] === hookMarker;
+  }
+  /** Execute this hook */
+  async execute(executor) {
+    if (this.flag === "skip")
+      return false;
+    const { done, notify } = executor.start(this);
+    const skipState = { skipped: false };
+    const error = await skipStorage.run(skipState, () => execute(this.call, this.timeout, notify));
+    done(skipState.skipped);
+    return !!error;
+  }
+  /** Clone this associating it with a new {@link Suite} or {@link Spec} */
+  clone(parent) {
+    return new Hook(parent, this.name, this.call, this.timeout, this.flag);
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Hook,
+  Spec,
+  Suite,
+  getCurrentSuite,
+  skip
+});
+//# sourceMappingURL=executable.cjs.map

package/dist/execution/executable.cjs.map

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

package/dist/execution/executable.d.ts

@@ -0,0 +1,87 @@
+/// <reference types="node" />
+/**
+ * A _callable_ (possibly async) function.
+ *
+ * When the timeout configured is reached, the passed `signal` will be aborted.
+ */
+export type Call = (this: undefined, signal: AbortSignal) => void | Promise<void>;
+/** Flag types for an {@link Executable} */
+export type Flag = 'skip' | 'only' | undefined;
+/** An {@link Executor} notifying lifecycle events for {@link Executable}s */
+export interface Executor {
+    start(executable: Suite | Spec | Hook): {
+        notify(error: Error): void;
+        done(skip?: boolean): void;
+    };
+}
+export declare function getCurrentSuite(): Suite;
+export declare function skip(): void;
+/** Our {@link Suite} implementation */
+export declare class Suite {
+    readonly parent: Suite | undefined;
+    readonly name: string;
+    readonly call: Call;
+    readonly timeout: number;
+    flag: Flag;
+    private _beforeAll;
+    private _beforeEach;
+    private _afterAll;
+    private _afterEach;
+    private _suites;
+    private _specs;
+    private _children;
+    private _setup;
+    constructor(parent: Suite | undefined, name: string, call: Call, timeout?: number, flag?: Flag);
+    static [Symbol.hasInstance](instance: any): boolean;
+    get specs(): number;
+    /** Add a child {@link Suite} to this */
+    addSuite(suite: Suite): void;
+    /** Add a {@link Spec} to this */
+    addSpec(spec: Spec): void;
+    /** Add a _before all_ {@link Hook} to this */
+    addBeforeAllHook(hook: Hook): void;
+    /** Add a _before each_ {@link Hook} to this */
+    addBeforeEachHook(hook: Hook): void;
+    /** Add a _after all_ {@link Hook} to this */
+    addAfterAllHook(hook: Hook): void;
+    /** Add a _after each_ {@link Hook} to this */
+    addAfterEachHook(hook: Hook): void;
+    /**
+     * Setup this {@link Suite} invoking its main function, then initializing all
+     * children {@link Suite Suites}, and finally normalizing execution flags.
+     */
+    setup(): Promise<void>;
+    /**
+     * Execute this suite, executing all {@link Hook hooks} and children
+     * {@link Spec specs} and  {@link Suite suites}
+     */
+    execute(executor: Executor, skip?: boolean): Promise<Error | void>;
+}
+/** Our {@link Spec} implementation */
+export declare class Spec {
+    readonly parent: Suite;
+    readonly name: string;
+    readonly call: Call;
+    readonly timeout: number;
+    flag: Flag;
+    before: Hook[];
+    after: Hook[];
+    constructor(parent: Suite, name: string, call: Call, timeout?: number, flag?: Flag);
+    static [Symbol.hasInstance](instance: any): boolean;
+    /** Execute this spec */
+    execute(executor: Executor, skip?: boolean): Promise<void>;
+}
+/** Our {@link Hook} implementation */
+export declare class Hook {
+    readonly parent: Suite | Spec;
+    readonly name: 'beforeAll' | 'afterAll' | 'beforeEach' | 'afterEach';
+    readonly call: Call;
+    readonly timeout: number;
+    readonly flag: Exclude<Flag, 'only'>;
+    constructor(parent: Suite | Spec, name: 'beforeAll' | 'afterAll' | 'beforeEach' | 'afterEach', call: Call, timeout?: number, flag?: Exclude<Flag, 'only'>);
+    static [Symbol.hasInstance](instance: any): boolean;
+    /** Execute this hook */
+    execute(executor: Executor): Promise<boolean>;
+    /** Clone this associating it with a new {@link Suite} or {@link Spec} */
+    clone(parent: Suite | Spec): Hook;
+}