@goast/typescript 0.4.1-beta1 → 0.4.1

package/esm/deps/jsr.io/@std/testing/1.0.3/bdd.d.ts.map

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

package/esm/deps/jsr.io/@std/testing/1.0.3/bdd.js

@@ -0,0 +1,576 @@
+// Copyright 2018-2024 the Deno authors. All rights reserved. MIT license.
+import { getAssertionState } from "../../internal/1.0.4/assertion_state.js";
+import { AssertionError } from "../../assert/1.0.6/assertion_error.js";
+import { TestSuiteInternal, } from "./_test_suite.js";
+/** Generates an ItDefinition from ItArgs. */
+function itDefinition(...args) {
+    var _a;
+    let [suiteOptionsOrNameOrFn, optionsOrNameOrFn, optionsOrFn, fn,] = args;
+    let suite = undefined;
+    let name;
+    let options;
+    if (typeof suiteOptionsOrNameOrFn === "object" &&
+        typeof suiteOptionsOrNameOrFn.symbol === "symbol") {
+        suite = suiteOptionsOrNameOrFn;
+    }
+    else {
+        fn = optionsOrFn;
+        optionsOrFn = optionsOrNameOrFn;
+        optionsOrNameOrFn = suiteOptionsOrNameOrFn;
+    }
+    if (typeof optionsOrNameOrFn === "string") {
+        name = optionsOrNameOrFn;
+        if (typeof optionsOrFn === "function") {
+            fn = optionsOrFn;
+            options = {};
+        }
+        else {
+            options = optionsOrFn;
+            if (!fn)
+                fn = options.fn;
+        }
+    }
+    else if (typeof optionsOrNameOrFn === "function") {
+        fn = optionsOrNameOrFn;
+        name = fn.name;
+        options = {};
+    }
+    else {
+        options = optionsOrNameOrFn;
+        if (typeof optionsOrFn === "function") {
+            fn = optionsOrFn;
+        }
+        else {
+            fn = options.fn;
+        }
+        name = (_a = options.name) !== null && _a !== void 0 ? _a : fn.name;
+    }
+    return {
+        ...(suite !== undefined ? { suite } : {}),
+        ...options,
+        name,
+        fn,
+    };
+}
+/**
+ * Registers an individual test case.
+ *
+ * @example Usage
+ * ```ts
+ * import { describe, it } from "@std/testing/bdd";
+ * import { assertEquals } from "@std/assert";
+ *
+ * describe("example", () => {
+ *   it("should pass", () => {
+ *     // test case
+ *     assertEquals(2 + 2, 4);
+ *   });
+ * });
+ * ```
+ *
+ * @typeParam T The self type of the function to implement the test case
+ * @param args The test case
+ */
+export function it(...args) {
+    if (TestSuiteInternal.runningCount > 0) {
+        throw new Error("Cannot register new test cases after already registered test cases start running");
+    }
+    const assertionState = getAssertionState();
+    const options = itDefinition(...args);
+    const { suite } = options;
+    const testSuite = suite
+        ? TestSuiteInternal.suites.get(suite.symbol)
+        : TestSuiteInternal.current;
+    if (!TestSuiteInternal.started)
+        TestSuiteInternal.started = true;
+    if (testSuite) {
+        TestSuiteInternal.addStep(testSuite, options);
+    }
+    else {
+        const { name, fn, ignore, only, permissions, sanitizeExit, sanitizeOps, sanitizeResources, } = options;
+        const opts = {
+            name,
+            async fn(t) {
+                TestSuiteInternal.runningCount++;
+                try {
+                    await fn.call({}, t);
+                }
+                finally {
+                    TestSuiteInternal.runningCount--;
+                }
+                if (assertionState.checkAssertionErrorStateAndReset()) {
+                    throw new AssertionError("Expected at least one assertion to be called but received none");
+                }
+            },
+        };
+        if (ignore !== undefined) {
+            opts.ignore = ignore;
+        }
+        if (only !== undefined) {
+            opts.only = only;
+        }
+        if (permissions !== undefined) {
+            opts.permissions = permissions;
+        }
+        if (sanitizeExit !== undefined) {
+            opts.sanitizeExit = sanitizeExit;
+        }
+        if (sanitizeOps !== undefined) {
+            opts.sanitizeOps = sanitizeOps;
+        }
+        if (sanitizeResources !== undefined) {
+            opts.sanitizeResources = sanitizeResources;
+        }
+        TestSuiteInternal.registerTest(opts);
+    }
+}
+/**
+ * Only execute this test case.
+ *
+ * @example Usage
+ * ```ts
+ * import { describe, it } from "@std/testing/bdd";
+ * import { assertEquals } from "@std/assert";
+ *
+ * describe("example", () => {
+ *   it("should pass", () => {
+ *     assertEquals(2 + 2, 4);
+ *   });
+ *
+ *   it.only("should pass too", () => {
+ *     assertEquals(3 + 4, 7);
+ *   });
+ * });
+ * ```
+ *
+ * @param args The test case
+ */
+it.only = function itOnly(...args) {
+    const options = itDefinition(...args);
+    return it({
+        ...options,
+        only: true,
+    });
+};
+/**
+ * Ignore this test case.
+ *
+ * @example Usage
+ * ```ts
+ * import { describe, it } from "@std/testing/bdd";
+ * import { assertEquals } from "@std/assert";
+ *
+ * describe("example", () => {
+ *   it("should pass", () => {
+ *     assertEquals(2 + 2, 4);
+ *   });
+ *
+ *   it.ignore("should pass too", () => {
+ *     assertEquals(3 + 4, 7);
+ *   });
+ * });
+ * ```
+ *
+ * @param args The test case
+ */
+it.ignore = function itIgnore(...args) {
+    const options = itDefinition(...args);
+    return it({
+        ...options,
+        ignore: true,
+    });
+};
+/** Skip this test case.
+ *
+ * @example Usage
+ * ```ts
+ * import { describe, it } from "@std/testing/bdd";
+ * import { assertEquals } from "@std/assert";
+ *
+ * describe("example", () => {
+ *   it("should pass", () => {
+ *     assertEquals(2 + 2, 4);
+ *   });
+ *
+ *   it.skip("should pass too", () => {
+ *     assertEquals(3 + 4, 7);
+ *   });
+ * });
+ * ```
+ *
+ * @param args The test case
+ */
+it.skip = function itSkip(...args) {
+    it.ignore(...args);
+};
+/**
+ * Alias of {@linkcode it}
+ *
+ * Registers an individual test case.
+ *
+ * @example Usage
+ * ```ts
+ * import { test } from "@std/testing/bdd";
+ * import { assertEquals } from "@std/assert";
+ *
+ * test("a test case", () => {
+ *   // test case
+ *   assertEquals(2 + 2, 4);
+ * });
+ * ```
+ *
+ * @typeParam T The self type of the function to implement the test case
+ * @param args The test case
+ */
+export function test(...args) {
+    it(...args);
+}
+function addHook(name, fn) {
+    if (!TestSuiteInternal.current) {
+        if (TestSuiteInternal.started) {
+            throw new Error("Cannot add global hooks after a global test is registered");
+        }
+        TestSuiteInternal.current = new TestSuiteInternal({
+            name: "global",
+            [name]: fn,
+        });
+    }
+    else {
+        TestSuiteInternal.setHook(TestSuiteInternal.current, name, fn);
+    }
+}
+/**
+ * Run some shared setup before all of the tests in the suite.
+ *
+ * @example Usage
+ * ```ts
+ * import { describe, it, beforeAll } from "@std/testing/bdd";
+ * import { assertEquals } from "@std/assert";
+ *
+ * beforeAll(() => {
+ *  console.log("beforeAll");
+ * });
+ *
+ * describe("example", () => {
+ *   it("should pass", () => {
+ *     // test case
+ *     assertEquals(2 + 2, 4);
+ *   });
+ * });
+ * ```
+ *
+ * @typeParam T The self type of the function
+ * @param fn The function to implement the setup behavior.
+ */
+export function beforeAll(fn) {
+    addHook("beforeAll", fn);
+}
+/**
+ * Alias of {@linkcode beforeAll}
+ *
+ * Run some shared setup before all of the tests in the suite.
+ *
+ * @example Usage
+ * ```ts
+ * import { describe, it, before } from "@std/testing/bdd";
+ * import { assertEquals } from "@std/assert";
+ *
+ * before(() => {
+ *  console.log("before");
+ * });
+ *
+ * describe("example", () => {
+ *   it("should pass", () => {
+ *     // test case
+ *     assertEquals(2 + 2, 4);
+ *   });
+ * });
+ * ```
+ *
+ * @typeParam T The self type of the function
+ * @param fn The function to implement the setup behavior.
+ */
+export function before(fn) {
+    beforeAll(fn);
+}
+/**
+ * Run some shared teardown after all of the tests in the suite.
+ *
+ * @example Usage
+ * ```ts
+ * import { describe, it, afterAll } from "@std/testing/bdd";
+ * import { assertEquals } from "@std/assert";
+ *
+ * afterAll(() => {
+ *  console.log("afterAll");
+ * });
+ *
+ * describe("example", () => {
+ *   it("should pass", () => {
+ *     // test case
+ *     assertEquals(2 + 2, 4);
+ *   });
+ * });
+ * ```
+ *
+ * @typeParam T The self type of the function
+ * @param fn The function to implement the teardown behavior.
+ */
+export function afterAll(fn) {
+    addHook("afterAll", fn);
+}
+/**
+ * Alias of {@linkcode afterAll}.
+ *
+ * Run some shared teardown after all of the tests in the suite.
+ *
+ * @example Usage
+ * ```ts
+ * import { describe, it, after } from "@std/testing/bdd";
+ * import { assertEquals } from "@std/assert";
+ *
+ * after(() => {
+ *  console.log("after");
+ * });
+ *
+ * describe("example", () => {
+ *   it("should pass", () => {
+ *     // test case
+ *     assertEquals(2 + 2, 4);
+ *   });
+ * });
+ * ```
+ *
+ * @typeParam T The self type of the function
+ * @param fn The function to implement the teardown behavior.
+ */
+export function after(fn) {
+    afterAll(fn);
+}
+/**
+ * Run some shared setup before each test in the suite.
+ *
+ * @example Usage
+ * ```ts
+ * import { describe, it, beforeEach } from "@std/testing/bdd";
+ * import { assertEquals } from "@std/assert";
+ *
+ * beforeEach(() => {
+ *  console.log("beforeEach");
+ * });
+ *
+ * describe("example", () => {
+ *   it("should pass", () => {
+ *     // test case
+ *     assertEquals(2 + 2, 4);
+ *   });
+ * });
+ * ```
+ *
+ * @typeParam T The self type of the function
+ * @param fn The function to implement the shared setup behavior
+ */
+export function beforeEach(fn) {
+    addHook("beforeEach", fn);
+}
+/**
+ * Run some shared teardown after each test in the suite.
+ *
+ * @example Usage
+ * ```ts
+ * import { describe, it, afterEach } from "@std/testing/bdd";
+ * import { assertEquals } from "@std/assert";
+ *
+ * afterEach(() => {
+ *  console.log("afterEach");
+ * });
+ *
+ * describe("example", () => {
+ *   it("should pass", () => {
+ *     // test case
+ *     assertEquals(2 + 2, 4);
+ *   });
+ * });
+ * ```
+ *
+ * @typeParam T The self type of the function
+ * @param fn The function to implement the shared teardown behavior
+ */
+export function afterEach(fn) {
+    addHook("afterEach", fn);
+}
+/** Generates a DescribeDefinition from DescribeArgs. */
+function describeDefinition(...args) {
+    var _a, _b;
+    let [suiteOptionsOrNameOrFn, optionsOrNameOrFn, optionsOrFn, fn,] = args;
+    let suite = undefined;
+    let name;
+    let options;
+    if (typeof suiteOptionsOrNameOrFn === "object" &&
+        typeof suiteOptionsOrNameOrFn.symbol === "symbol") {
+        suite = suiteOptionsOrNameOrFn;
+    }
+    else {
+        fn = optionsOrFn;
+        optionsOrFn = optionsOrNameOrFn;
+        optionsOrNameOrFn = suiteOptionsOrNameOrFn;
+    }
+    if (typeof optionsOrNameOrFn === "string") {
+        name = optionsOrNameOrFn;
+        if (typeof optionsOrFn === "function") {
+            fn = optionsOrFn;
+            options = {};
+        }
+        else {
+            options = optionsOrFn !== null && optionsOrFn !== void 0 ? optionsOrFn : {};
+            if (fn === undefined) {
+                fn = options.fn;
+            }
+        }
+    }
+    else if (typeof optionsOrNameOrFn === "function") {
+        fn = optionsOrNameOrFn;
+        name = fn.name;
+        options = {};
+    }
+    else {
+        options = optionsOrNameOrFn !== null && optionsOrNameOrFn !== void 0 ? optionsOrNameOrFn : {};
+        if (typeof optionsOrFn === "function") {
+            fn = optionsOrFn;
+        }
+        else {
+            fn = options.fn;
+        }
+        name = (_b = (_a = options.name) !== null && _a !== void 0 ? _a : fn === null || fn === void 0 ? void 0 : fn.name) !== null && _b !== void 0 ? _b : "";
+    }
+    if (suite === undefined) {
+        suite = options.suite;
+    }
+    if (suite === undefined && TestSuiteInternal.current) {
+        const { symbol } = TestSuiteInternal.current;
+        suite = { symbol };
+    }
+    return {
+        ...options,
+        suite: suite,
+        name,
+        fn: fn,
+    };
+}
+/**
+ * Registers a test suite.
+ *
+ * @example Usage
+ * ```ts
+ * import { describe, it } from "@std/testing/bdd";
+ * import { assertEquals } from "@std/assert";
+ *
+ * describe("example", () => {
+ *   it("should pass", () => {
+ *     // test case
+ *     assertEquals(2 + 2, 4);
+ *   });
+ * });
+ * ```
+ *
+ * @typeParam T The self type of the test suite body.
+ * @param args The test suite body.
+ * @returns The test suite
+ */
+export function describe(...args) {
+    if (TestSuiteInternal.runningCount > 0) {
+        throw new Error("Cannot register new test suites after already registered test cases start running");
+    }
+    const options = describeDefinition(...args);
+    if (!TestSuiteInternal.started)
+        TestSuiteInternal.started = true;
+    const { symbol } = new TestSuiteInternal(options);
+    return { symbol };
+}
+/**
+ * Only execute this test suite.
+ *
+ * @example Usage
+ * ```ts
+ * import { describe, it, beforeAll } from "@std/testing/bdd";
+ * import { assertEquals } from "@std/assert";
+ *
+ * describe("example", () => {
+ *   it("should pass", () => {
+ *     assertEquals(2 + 2, 4);
+ *   });
+ * });
+ *
+ * // Only this test suite will run
+ * describe.only("example 2", () => {
+ *   it("should pass too", () => {
+ *     assertEquals(3 + 4, 7);
+ *   });
+ * });
+ * ```
+ *
+ * @param args The test suite body
+ */
+describe.only = function describeOnly(...args) {
+    const options = describeDefinition(...args);
+    return describe({
+        ...options,
+        only: true,
+    });
+};
+/**
+ * Ignore the test suite.
+ *
+ * @example Usage
+ * ```ts
+ * import { describe, it, beforeAll } from "@std/testing/bdd";
+ * import { assertEquals } from "@std/assert";
+ *
+ * describe("example", () => {
+ *   it("should pass", () => {
+ *     assertEquals(2 + 2, 4);
+ *   });
+ * });
+ *
+ * describe.ignore("example 2", () => {
+ *   it("should pass too", () => {
+ *     assertEquals(3 + 4, 7);
+ *   });
+ * });
+ * ```
+ *
+ * @param args The test suite body
+ */
+describe.ignore = function describeIgnore(...args) {
+    const options = describeDefinition(...args);
+    return describe({
+        ...options,
+        ignore: true,
+    });
+};
+/**
+ * Skip the test suite.
+ *
+ * @example Usage
+ * ```ts
+ * import { describe, it, beforeAll } from "@std/testing/bdd";
+ * import { assertEquals } from "@std/assert";
+ *
+ * describe("example", () => {
+ *   it("should pass", () => {
+ *     assertEquals(2 + 2, 4);
+ *   });
+ * });
+ *
+ * describe.skip("example 2", () => {
+ *   it("should pass too", () => {
+ *     assertEquals(3 + 4, 7);
+ *   });
+ * });
+ * ```
+ *
+ * @param args The test suite body
+ */
+describe.skip = function describeSkip(...args) {
+    return describe.ignore(...args);
+};