@goast/core 0.4.0-beta4 → 0.4.0

package/script/deps/jsr.io/@std/testing/1.0.3/_test_suite.d.ts

@@ -0,0 +1,74 @@
+/** The options for creating a test suite with the describe function. */
+import * as dntShim from "../../../../../_dnt.test_shims.js";
+export interface DescribeDefinition<T> extends Omit<dntShim.Deno.TestDefinition, "fn"> {
+    /** The body of the test suite */
+    fn?: () => void | undefined;
+    /**
+     * The `describe` function returns a `TestSuite` representing the group of tests.
+     * If `describe` is called within another `describe` calls `fn`, the suite will default to that parent `describe` calls returned `TestSuite`.
+     * If `describe` is not called within another `describe` calls `fn`, the suite will default to the `TestSuite` representing the global group of tests.
+     */
+    suite?: TestSuite<T>;
+    /** Run some shared setup before all of the tests in the suite. */
+    beforeAll?: ((this: T) => void | Promise<void>) | ((this: T) => void | Promise<void>)[];
+    /** Run some shared teardown after all of the tests in the suite. */
+    afterAll?: ((this: T) => void | Promise<void>) | ((this: T) => void | Promise<void>)[];
+    /** Run some shared setup before each test in the suite. */
+    beforeEach?: ((this: T) => void | Promise<void>) | ((this: T) => void | Promise<void>)[];
+    /** Run some shared teardown after each test in the suite. */
+    afterEach?: ((this: T) => void | Promise<void>) | ((this: T) => void | Promise<void>)[];
+}
+/** The options for creating an individual test case with the it function. */
+export interface ItDefinition<T> extends Omit<dntShim.Deno.TestDefinition, "fn"> {
+    /** The body of the test case */
+    fn: (this: T, t: dntShim.Deno.TestContext) => void | Promise<void>;
+    /**
+     * The `describe` function returns a `TestSuite` representing the group of tests.
+     * If `it` is called within a `describe` calls `fn`, the suite will default to that parent `describe` calls returned `TestSuite`.
+     * If `it` is not called within a `describe` calls `fn`, the suite will default to the `TestSuite` representing the global group of tests.
+     */
+    suite?: TestSuite<T>;
+}
+/** The names of all the different types of hooks. */
+export type HookNames = "beforeAll" | "afterAll" | "beforeEach" | "afterEach";
+/**
+ * A group of tests.
+ */
+export interface TestSuite<T> {
+    /** The symbol to use for grouping the test suite */
+    symbol: symbol;
+}
+/**
+ * An internal representation of a group of tests.
+ */
+export declare class TestSuiteInternal<T> implements TestSuite<T> {
+    symbol: symbol;
+    protected describe: DescribeDefinition<T>;
+    protected steps: (TestSuiteInternal<T> | ItDefinition<T>)[];
+    protected hasOnlyStep: boolean;
+    constructor(describe: DescribeDefinition<T>);
+    /** Stores how many test suites are executing. */
+    static runningCount: number;
+    /** If a test has been registered yet. Block adding global hooks if a test has been registered. */
+    static started: boolean;
+    /** A map of all test suites by symbol. */
+    static suites: Map<symbol, TestSuiteInternal<any>>;
+    /** The current test suite being registered. */
+    static current: TestSuiteInternal<any> | null;
+    /** The stack of tests that are actively running. */
+    static active: symbol[];
+    /** This is used internally for testing this module. */
+    static reset(): void;
+    /** This is used internally to register tests. */
+    static registerTest(options: dntShim.Deno.TestDefinition): void;
+    /** Updates all steps within top level suite to have ignore set to true if only is not set to true on step. */
+    static addingOnlyStep<T>(suite: TestSuiteInternal<T>): void;
+    /** This is used internally to add steps to a test suite. */
+    static addStep<T>(suite: TestSuiteInternal<T>, step: TestSuiteInternal<T> | ItDefinition<T>): void;
+    /** This is used internally to add hooks to a test suite. */
+    static setHook<T>(suite: TestSuiteInternal<T>, name: HookNames, fn: (this: T) => void | Promise<void>): void;
+    /** This is used internally to run all steps for a test suite. */
+    static run<T>(suite: TestSuiteInternal<T>, context: T, t: dntShim.Deno.TestContext): Promise<void>;
+    static runTest<T>(t: dntShim.Deno.TestContext, fn: (this: T, t: dntShim.Deno.TestContext) => void | Promise<void>, context: T, activeIndex?: number): Promise<void>;
+}
+//# sourceMappingURL=_test_suite.d.ts.map

package/script/deps/jsr.io/@std/testing/1.0.3/_test_suite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_test_suite.d.ts","sourceRoot":"","sources":["../../../../../../src/deps/jsr.io/@std/testing/1.0.3/_test_suite.ts"],"names":[],"mappings":"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"}

package/script/deps/jsr.io/@std/testing/1.0.3/_test_suite.js

@@ -0,0 +1,345 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TestSuiteInternal = void 0;
+const tslib_1 = require("tslib");
+// Copyright 2018-2024 the Deno authors. All rights reserved. MIT license.
+/** The options for creating a test suite with the describe function. */
+const dntShim = tslib_1.__importStar(require("../../../../../_dnt.test_shims.js"));
+/**
+ * An internal representation of a group of tests.
+ */
+class TestSuiteInternal {
+    constructor(describe) {
+        Object.defineProperty(this, "symbol", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "describe", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "steps", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "hasOnlyStep", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.describe = describe;
+        this.steps = [];
+        this.hasOnlyStep = false;
+        const { suite } = describe;
+        if (suite && !TestSuiteInternal.suites.has(suite.symbol)) {
+            throw new Error("Cannot construct Test Suite: suite does not represent a registered test suite");
+        }
+        const testSuite = suite
+            ? TestSuiteInternal.suites.get(suite.symbol)
+            : TestSuiteInternal.current;
+        this.symbol = Symbol();
+        TestSuiteInternal.suites.set(this.symbol, this);
+        const { fn } = describe;
+        if (fn) {
+            const temp = TestSuiteInternal.current;
+            TestSuiteInternal.current = this;
+            try {
+                // deno-lint-ignore no-explicit-any
+                const value = fn();
+                if (value instanceof Promise) {
+                    throw new Error('Returning a Promise from "describe" is not supported: tests must be defined synchronously');
+                }
+            }
+            finally {
+                TestSuiteInternal.current = temp;
+            }
+        }
+        if (testSuite) {
+            TestSuiteInternal.addStep(testSuite, this);
+        }
+        else {
+            const { name, ignore, permissions, sanitizeExit, sanitizeOps, sanitizeResources, } = describe;
+            let { only } = describe;
+            if (!ignore && this.hasOnlyStep) {
+                only = true;
+            }
+            const options = {
+                name,
+                fn: async (t) => {
+                    TestSuiteInternal.runningCount++;
+                    try {
+                        const context = {};
+                        const { beforeAll } = this.describe;
+                        if (typeof beforeAll === "function") {
+                            await beforeAll.call(context);
+                        }
+                        else if (beforeAll) {
+                            for (const hook of beforeAll) {
+                                await hook.call(context);
+                            }
+                        }
+                        try {
+                            TestSuiteInternal.active.push(this.symbol);
+                            await TestSuiteInternal.run(this, context, t);
+                        }
+                        finally {
+                            TestSuiteInternal.active.pop();
+                            const { afterAll } = this.describe;
+                            if (typeof afterAll === "function") {
+                                await afterAll.call(context);
+                            }
+                            else if (afterAll) {
+                                for (const hook of afterAll) {
+                                    await hook.call(context);
+                                }
+                            }
+                        }
+                    }
+                    finally {
+                        TestSuiteInternal.runningCount--;
+                    }
+                },
+            };
+            if (ignore !== undefined) {
+                options.ignore = ignore;
+            }
+            if (only !== undefined) {
+                options.only = only;
+            }
+            if (permissions !== undefined) {
+                options.permissions = permissions;
+            }
+            if (sanitizeExit !== undefined) {
+                options.sanitizeExit = sanitizeExit;
+            }
+            if (sanitizeOps !== undefined) {
+                options.sanitizeOps = sanitizeOps;
+            }
+            if (sanitizeResources !== undefined) {
+                options.sanitizeResources = sanitizeResources;
+            }
+            TestSuiteInternal.registerTest(options);
+        }
+    }
+    /** This is used internally for testing this module. */
+    static reset() {
+        TestSuiteInternal.runningCount = 0;
+        TestSuiteInternal.started = false;
+        TestSuiteInternal.current = null;
+        TestSuiteInternal.active = [];
+    }
+    /** This is used internally to register tests. */
+    static registerTest(options) {
+        options = { ...options };
+        if (options.only === undefined) {
+            delete options.only;
+        }
+        if (options.permissions === undefined) {
+            delete options.permissions;
+        }
+        if (options.ignore === undefined) {
+            delete options.ignore;
+        }
+        if (options.sanitizeExit === undefined) {
+            delete options.sanitizeExit;
+        }
+        if (options.sanitizeOps === undefined) {
+            delete options.sanitizeOps;
+        }
+        if (options.sanitizeResources === undefined) {
+            delete options.sanitizeResources;
+        }
+        dntShim.Deno.test(options);
+    }
+    /** Updates all steps within top level suite to have ignore set to true if only is not set to true on step. */
+    static addingOnlyStep(suite) {
+        if (!suite.hasOnlyStep) {
+            for (let i = 0; i < suite.steps.length; i++) {
+                const step = suite.steps[i];
+                if (!(step instanceof TestSuiteInternal) && !step.only) {
+                    suite.steps.splice(i--, 1);
+                }
+            }
+            suite.hasOnlyStep = true;
+        }
+        const parentSuite = suite.describe.suite;
+        const parentTestSuite = parentSuite &&
+            TestSuiteInternal.suites.get(parentSuite.symbol);
+        if (parentTestSuite) {
+            TestSuiteInternal.addingOnlyStep(parentTestSuite);
+        }
+    }
+    /** This is used internally to add steps to a test suite. */
+    static addStep(suite, step) {
+        if (!suite.hasOnlyStep) {
+            if (step instanceof TestSuiteInternal) {
+                if (step.hasOnlyStep || step.describe.only) {
+                    TestSuiteInternal.addingOnlyStep(suite);
+                }
+            }
+            else {
+                if (step.only)
+                    TestSuiteInternal.addingOnlyStep(suite);
+            }
+        }
+        if (!(suite.hasOnlyStep && !(step instanceof TestSuiteInternal) && !step.only)) {
+            suite.steps.push(step);
+        }
+    }
+    /** This is used internally to add hooks to a test suite. */
+    static setHook(suite, name, fn) {
+        if (suite.describe[name]) {
+            if (typeof suite.describe[name] === "function") {
+                suite.describe[name] = [
+                    suite.describe[name],
+                ];
+            }
+            suite.describe[name].push(fn);
+        }
+        else {
+            suite.describe[name] = fn;
+        }
+    }
+    /** This is used internally to run all steps for a test suite. */
+    static async run(suite, context, t) {
+        const hasOnly = suite.hasOnlyStep || suite.describe.only || false;
+        for (const step of suite.steps) {
+            if (hasOnly && step instanceof TestSuiteInternal &&
+                !(step.hasOnlyStep || step.describe.only || false)) {
+                continue;
+            }
+            const { name, fn, ignore, permissions, sanitizeExit, sanitizeOps, sanitizeResources, } = step instanceof TestSuiteInternal ? step.describe : step;
+            const options = {
+                name,
+                fn: async (t) => {
+                    if (permissions) {
+                        throw new Error("permissions option not available for nested tests");
+                    }
+                    context = { ...context };
+                    if (step instanceof TestSuiteInternal) {
+                        const { beforeAll } = step.describe;
+                        if (typeof beforeAll === "function") {
+                            await beforeAll.call(context);
+                        }
+                        else if (beforeAll) {
+                            for (const hook of beforeAll) {
+                                await hook.call(context);
+                            }
+                        }
+                        try {
+                            TestSuiteInternal.active.push(step.symbol);
+                            await TestSuiteInternal.run(step, context, t);
+                        }
+                        finally {
+                            TestSuiteInternal.active.pop();
+                            const { afterAll } = step.describe;
+                            if (typeof afterAll === "function") {
+                                await afterAll.call(context);
+                            }
+                            else if (afterAll) {
+                                for (const hook of afterAll) {
+                                    await hook.call(context);
+                                }
+                            }
+                        }
+                    }
+                    else {
+                        await TestSuiteInternal.runTest(t, fn, context);
+                    }
+                },
+            };
+            if (ignore !== undefined) {
+                options.ignore = ignore;
+            }
+            if (sanitizeExit !== undefined) {
+                options.sanitizeExit = sanitizeExit;
+            }
+            if (sanitizeOps !== undefined) {
+                options.sanitizeOps = sanitizeOps;
+            }
+            if (sanitizeResources !== undefined) {
+                options.sanitizeResources = sanitizeResources;
+            }
+            await t.step(options);
+        }
+    }
+    static async runTest(t, fn, context, activeIndex = 0) {
+        const suite = TestSuiteInternal.active[activeIndex];
+        const testSuite = suite && TestSuiteInternal.suites.get(suite);
+        if (testSuite) {
+            if (activeIndex === 0)
+                context = { ...context };
+            const { beforeEach } = testSuite.describe;
+            if (typeof beforeEach === "function") {
+                await beforeEach.call(context);
+            }
+            else if (beforeEach) {
+                for (const hook of beforeEach) {
+                    await hook.call(context);
+                }
+            }
+            try {
+                await TestSuiteInternal.runTest(t, fn, context, activeIndex + 1);
+            }
+            finally {
+                const { afterEach } = testSuite.describe;
+                if (typeof afterEach === "function") {
+                    await afterEach.call(context);
+                }
+                else if (afterEach) {
+                    for (const hook of afterEach) {
+                        await hook.call(context);
+                    }
+                }
+            }
+        }
+        else {
+            await fn.call(context, t);
+        }
+    }
+}
+exports.TestSuiteInternal = TestSuiteInternal;
+/** Stores how many test suites are executing. */
+Object.defineProperty(TestSuiteInternal, "runningCount", {
+    enumerable: true,
+    configurable: true,
+    writable: true,
+    value: 0
+});
+/** If a test has been registered yet. Block adding global hooks if a test has been registered. */
+Object.defineProperty(TestSuiteInternal, "started", {
+    enumerable: true,
+    configurable: true,
+    writable: true,
+    value: false
+});
+/** A map of all test suites by symbol. */
+// deno-lint-ignore no-explicit-any
+Object.defineProperty(TestSuiteInternal, "suites", {
+    enumerable: true,
+    configurable: true,
+    writable: true,
+    value: new Map()
+});
+/** The current test suite being registered. */
+// deno-lint-ignore no-explicit-any
+Object.defineProperty(TestSuiteInternal, "current", {
+    enumerable: true,
+    configurable: true,
+    writable: true,
+    value: null
+});
+/** The stack of tests that are actively running. */
+Object.defineProperty(TestSuiteInternal, "active", {
+    enumerable: true,
+    configurable: true,
+    writable: true,
+    value: []
+});