@goast/typescript 0.4.4 → 0.5.1-k6.1

package/src/deps/jsr.io/@std/testing/1.0.9/bdd.ts

@@ -1,1288 +0,0 @@
-// Copyright 2018-2025 the Deno authors. MIT license.
-
-/**
- * A {@link https://en.wikipedia.org/wiki/Behavior-driven_development | BDD} interface
- * to `Deno.test()` API.
- *
- * With `@std/testing/bdd` module you can write your tests in a familiar format for
- * grouping tests and adding setup/teardown hooks used by other JavaScript testing
- * frameworks like Jasmine, Jest, and Mocha.
- *
- * The `describe` function creates a block that groups together several related
- * tests. The `it` function registers an individual test case.
- *
- * ## Hooks
- *
- * There are 4 types of hooks available for test suites. A test suite can have
- * multiples of each type of hook, they will be called in the order that they are
- * registered. The `afterEach` and `afterAll` hooks will be called whether or not
- * the test case passes. The *All hooks will be called once for the whole group
- * while the *Each hooks will be called for each individual test case.
- *
- * - `beforeAll`: Runs before all of the tests in the group.
- * - `afterAll`: Runs after all of the tests in the group finish.
- * - `beforeEach`: Runs before each of the individual test cases in the group.
- * - `afterEach`: Runs after each of the individual test cases in the group.
- *
- * If a hook is registered at the top level, a global test suite will be registered
- * and all tests will belong to it. Hooks registered at the top level must be
- * registered before any individual test cases or test suites.
- *
- * ## Focusing tests
- *
- * If you would like to run only specific test cases, you can do so by calling
- * `it.only` instead of `it`. If you would like to run only specific test suites,
- * you can do so by calling `describe.only` instead of `describe`.
- *
- * There is one limitation to this when using the flat test grouping style. When
- * `describe` is called without being nested, it registers the test with
- * `Deno.test`. If a child test case or suite is registered with `it.only` or
- * `describe.only`, it will be scoped to the top test suite instead of the file. To
- * make them the only tests that run in the file, you would need to register the
- * top test suite with `describe.only` too.
- *
- * ## Ignoring tests
- *
- * If you would like to not run specific individual test cases, you can do so by
- * calling `it.ignore` instead of `it`. If you would like to not run specific test
- * suites, you can do so by calling `describe.ignore` instead of `describe`.
- *
- * ## Sanitization options
- *
- * Like `Deno.TestDefinition`, the `DescribeDefinition` and `ItDefinition` have
- * sanitization options. They work in the same way.
- *
- * - `sanitizeExit`: Ensure the test case does not prematurely cause the process to
- *   exit, for example via a call to Deno.exit. Defaults to true.
- * - `sanitizeOps`: Check that the number of async completed ops after the test is
- *   the same as number of dispatched ops. Defaults to true.
- * - `sanitizeResources`: Ensure the test case does not "leak" resources - ie. the
- *   resource table after the test has exactly the same contents as before the
- *   test. Defaults to true.
- *
- * ## Permissions option
- *
- * Like `Deno.TestDefinition`, the `DescribeDefinition` and `ItDefinition` have a
- * `permissions` option. They specify the permissions that should be used to run an
- * individual test case or test suite. Set this to `"inherit"` to keep the calling
- * thread's permissions. Set this to `"none"` to revoke all permissions.
- *
- * This setting defaults to `"inherit"`.
- *
- * There is currently one limitation to this, you cannot use the permissions option
- * on an individual test case or test suite that belongs to another test suite.
- * That's because internally those tests are registered with `t.step` which does
- * not support the permissions option.
- *
- * ## Comparing to Deno\.test
- *
- * The default way of writing tests is using `Deno.test` and `t.step`. The
- * `describe` and `it` functions have similar call signatures to `Deno.test`,
- * making it easy to switch between the default style and the behavior-driven
- * development style of writing tests. Internally, `describe` and `it` are
- * registering tests with `Deno.test` and `t.step`.
- *
- * Below is an example of a test file using `Deno.test` and `t.step`. In the
- * following sections there are examples of how the same test could be written with
- * `describe` and `it` using nested test grouping, flat test grouping, or a mix of
- * both styles.
- *
- * ```ts
- * import {
- *   assertEquals,
- *   assertStrictEquals,
- *   assertThrows,
- * } from "@std/assert";
- *
- * class User {
- *   static users: Map<string, User> = new Map();
- *   name: string;
- *   age?: number;
- *
- *   constructor(name: string) {
- *     if (User.users.has(name)) {
- *       throw new Deno.errors.AlreadyExists(`User ${name} already exists`);
- *     }
- *     this.name = name;
- *     User.users.set(name, this);
- *   }
- *
- *   getAge(): number {
- *     if (!this.age) {
- *       throw new Error("Age unknown");
- *     }
- *     return this.age;
- *   }
- *
- *   setAge(age: number) {
- *     this.age = age;
- *   }
- * }
- *
- * Deno.test("User.users initially empty", () => {
- *   assertEquals(User.users.size, 0);
- * });
- *
- * Deno.test("User constructor", () => {
- *   try {
- *     const user = new User("Kyle");
- *     assertEquals(user.name, "Kyle");
- *     assertStrictEquals(User.users.get("Kyle"), user);
- *   } finally {
- *     User.users.clear();
- *   }
- * });
- *
- * Deno.test("User age", async (t) => {
- *   const user = new User("Kyle");
- *
- *   await t.step("getAge", () => {
- *     assertThrows(() => user.getAge(), Error, "Age unknown");
- *     user.age = 18;
- *     assertEquals(user.getAge(), 18);
- *   });
- *
- *   await t.step("setAge", () => {
- *     user.setAge(18);
- *     assertEquals(user.getAge(), 18);
- *   });
- * });
- * ```
- *
- * ### Nested test grouping
- *
- * Tests created within the callback of a `describe` function call will belong to
- * the new test suite it creates. The hooks can be created within it or be added to
- * the options argument for describe.
- *
- * ```ts
- * import {
- *   assertEquals,
- *   assertStrictEquals,
- *   assertThrows,
- * } from "@std/assert";
- * import {
- *   afterEach,
- *   beforeEach,
- *   describe,
- *   it,
- * } from "@std/testing/bdd";
- *
- * class User {
- *   static users: Map<string, User> = new Map();
- *   name: string;
- *   age?: number;
- *
- *   constructor(name: string) {
- *     if (User.users.has(name)) {
- *       throw new Deno.errors.AlreadyExists(`User ${name} already exists`);
- *     }
- *     this.name = name;
- *     User.users.set(name, this);
- *   }
- *
- *   getAge(): number {
- *     if (!this.age) {
- *       throw new Error("Age unknown");
- *     }
- *     return this.age;
- *   }
- *
- *   setAge(age: number) {
- *     this.age = age;
- *   }
- * }
- *
- * describe("User", () => {
- *   it("users initially empty", () => {
- *     assertEquals(User.users.size, 0);
- *   });
- *
- *   it("constructor", () => {
- *     try {
- *       const user = new User("Kyle");
- *       assertEquals(user.name, "Kyle");
- *       assertStrictEquals(User.users.get("Kyle"), user);
- *     } finally {
- *       User.users.clear();
- *     }
- *   });
- *
- *   describe("age", () => {
- *     let user: User;
- *
- *     beforeEach(() => {
- *       user = new User("Kyle");
- *     });
- *
- *     afterEach(() => {
- *       User.users.clear();
- *     });
- *
- *     it("getAge", function () {
- *       assertThrows(() => user.getAge(), Error, "Age unknown");
- *       user.age = 18;
- *       assertEquals(user.getAge(), 18);
- *     });
- *
- *     it("setAge", function () {
- *       user.setAge(18);
- *       assertEquals(user.getAge(), 18);
- *     });
- *   });
- * });
- * ```
- *
- * ### Flat test grouping
- *
- * The `describe` function returns a unique symbol that can be used to reference
- * the test suite for adding tests to it without having to create them within a
- * callback. The gives you the ability to have test grouping without any extra
- * indentation in front of the grouped tests.
- *
- * ```ts
- * import {
- *   assertEquals,
- *   assertStrictEquals,
- *   assertThrows,
- * } from "@std/assert";
- * import {
- *   describe,
- *   it,
- * } from "@std/testing/bdd";
- *
- * class User {
- *   static users: Map<string, User> = new Map();
- *   name: string;
- *   age?: number;
- *
- *   constructor(name: string) {
- *     if (User.users.has(name)) {
- *       throw new Deno.errors.AlreadyExists(`User ${name} already exists`);
- *     }
- *     this.name = name;
- *     User.users.set(name, this);
- *   }
- *
- *   getAge(): number {
- *     if (!this.age) {
- *       throw new Error("Age unknown");
- *     }
- *     return this.age;
- *   }
- *
- *   setAge(age: number) {
- *     this.age = age;
- *   }
- * }
- *
- * const userTests = describe("User");
- *
- * it(userTests, "users initially empty", () => {
- *   assertEquals(User.users.size, 0);
- * });
- *
- * it(userTests, "constructor", () => {
- *   try {
- *     const user = new User("Kyle");
- *     assertEquals(user.name, "Kyle");
- *     assertStrictEquals(User.users.get("Kyle"), user);
- *   } finally {
- *     User.users.clear();
- *   }
- * });
- *
- * const ageTests = describe({
- *   name: "age",
- *   suite: userTests,
- *   beforeEach(this: { user: User }) {
- *     this.user = new User("Kyle");
- *   },
- *   afterEach() {
- *     User.users.clear();
- *   },
- * });
- *
- * it(ageTests, "getAge", function () {
- *   const { user } = this;
- *   assertThrows(() => user.getAge(), Error, "Age unknown");
- *   user.age = 18;
- *   assertEquals(user.getAge(), 18);
- * });
- *
- * it(ageTests, "setAge", function () {
- *   const { user } = this;
- *   user.setAge(18);
- *   assertEquals(user.getAge(), 18);
- * });
- * ```
- *
- * ### Mixed test grouping
- *
- * Both nested test grouping and flat test grouping can be used together. This can
- * be useful if you'd like to create deep groupings without all the extra
- * indentation in front of each line.
- *
- * ```ts
- * import {
- *   assertEquals,
- *   assertStrictEquals,
- *   assertThrows,
- * } from "@std/assert";
- * import {
- *   describe,
- *   it,
- * } from "@std/testing/bdd";
- *
- * class User {
- *   static users: Map<string, User> = new Map();
- *   name: string;
- *   age?: number;
- *
- *   constructor(name: string) {
- *     if (User.users.has(name)) {
- *       throw new Deno.errors.AlreadyExists(`User ${name} already exists`);
- *     }
- *     this.name = name;
- *     User.users.set(name, this);
- *   }
- *
- *   getAge(): number {
- *     if (!this.age) {
- *       throw new Error("Age unknown");
- *     }
- *     return this.age;
- *   }
- *
- *   setAge(age: number) {
- *     this.age = age;
- *   }
- * }
- *
- * describe("User", () => {
- *   it("users initially empty", () => {
- *     assertEquals(User.users.size, 0);
- *   });
- *
- *   it("constructor", () => {
- *     try {
- *       const user = new User("Kyle");
- *       assertEquals(user.name, "Kyle");
- *       assertStrictEquals(User.users.get("Kyle"), user);
- *     } finally {
- *       User.users.clear();
- *     }
- *   });
- *
- *   const ageTests = describe({
- *     name: "age",
- *     beforeEach(this: { user: User }) {
- *       this.user = new User("Kyle");
- *     },
- *     afterEach() {
- *       User.users.clear();
- *     },
- *   });
- *
- *   it(ageTests, "getAge", function () {
- *     const { user } = this;
- *     assertThrows(() => user.getAge(), Error, "Age unknown");
- *     user.age = 18;
- *     assertEquals(user.getAge(), 18);
- *   });
- *
- *   it(ageTests, "setAge", function () {
- *     const { user } = this;
- *     user.setAge(18);
- *     assertEquals(user.getAge(), 18);
- *   });
- * });
- * ```
- *
- * @module
- */
-import * as dntShim from "../../../../../_dnt.test_shims.js";
-
-
-import { getAssertionState } from "../../internal/1.0.5/assertion_state.js";
-import { AssertionError } from "../../assert/1.0.11/assertion_error.js";
-import {
-  type DescribeDefinition,
-  globalSanitizersState,
-  type HookNames,
-  type ItDefinition,
-  type TestSuite,
-  TestSuiteInternal,
-} from "./_test_suite.js";
-export type { DescribeDefinition, ItDefinition, TestSuite };
-
-/** The arguments for an ItFunction. */
-export type ItArgs<T> =
-  | [options: ItDefinition<T>]
-  | [
-    name: string,
-    options: Omit<ItDefinition<T>, "name">,
-  ]
-  | [
-    name: string,
-    fn: (this: T, t: dntShim.Deno.TestContext) => void | Promise<void>,
-  ]
-  | [fn: (this: T, t: dntShim.Deno.TestContext) => void | Promise<void>]
-  | [
-    name: string,
-    options: Omit<ItDefinition<T>, "fn" | "name">,
-    fn: (this: T, t: dntShim.Deno.TestContext) => void | Promise<void>,
-  ]
-  | [
-    options: Omit<ItDefinition<T>, "fn">,
-    fn: (this: T, t: dntShim.Deno.TestContext) => void | Promise<void>,
-  ]
-  | [
-    options: Omit<ItDefinition<T>, "fn" | "name">,
-    fn: (this: T, t: dntShim.Deno.TestContext) => void | Promise<void>,
-  ]
-  | [
-    suite: TestSuite<T>,
-    name: string,
-    options: Omit<ItDefinition<T>, "name" | "suite">,
-  ]
-  | [
-    suite: TestSuite<T>,
-    name: string,
-    fn: (this: T, t: dntShim.Deno.TestContext) => void | Promise<void>,
-  ]
-  | [
-    suite: TestSuite<T>,
-    fn: (this: T, t: dntShim.Deno.TestContext) => void | Promise<void>,
-  ]
-  | [
-    suite: TestSuite<T>,
-    name: string,
-    options: Omit<ItDefinition<T>, "fn" | "name" | "suite">,
-    fn: (this: T, t: dntShim.Deno.TestContext) => void | Promise<void>,
-  ]
-  | [
-    suite: TestSuite<T>,
-    options: Omit<ItDefinition<T>, "fn" | "suite">,
-    fn: (this: T, t: dntShim.Deno.TestContext) => void | Promise<void>,
-  ]
-  | [
-    suite: TestSuite<T>,
-    options: Omit<ItDefinition<T>, "fn" | "name" | "suite">,
-    fn: (this: T, t: dntShim.Deno.TestContext) => void | Promise<void>,
-  ];
-
-/** Generates an ItDefinition from ItArgs. */
-function itDefinition<T>(...args: ItArgs<T>): ItDefinition<T> {
-  let [
-    suiteOptionsOrNameOrFn,
-    optionsOrNameOrFn,
-    optionsOrFn,
-    fn,
-  ] = args;
-  let suite: TestSuite<T> | undefined = undefined;
-  let name: string;
-  let options:
-    | ItDefinition<T>
-    | Omit<ItDefinition<T>, "fn">
-    | Omit<ItDefinition<T>, "name">
-    | Omit<ItDefinition<T>, "fn" | "name">;
-  if (
-    typeof suiteOptionsOrNameOrFn === "object" &&
-    typeof (suiteOptionsOrNameOrFn as TestSuite<T>).symbol === "symbol"
-  ) {
-    suite = suiteOptionsOrNameOrFn as TestSuite<T>;
-  } else {
-    fn = optionsOrFn as typeof fn;
-    optionsOrFn = optionsOrNameOrFn as typeof optionsOrFn;
-    optionsOrNameOrFn = suiteOptionsOrNameOrFn as typeof optionsOrNameOrFn;
-  }
-  if (typeof optionsOrNameOrFn === "string") {
-    name = optionsOrNameOrFn;
-    if (typeof optionsOrFn === "function") {
-      fn = optionsOrFn;
-      options = {};
-    } else {
-      options = optionsOrFn!;
-      if (!fn) fn = (options as Omit<ItDefinition<T>, "name">).fn;
-    }
-  } else if (typeof optionsOrNameOrFn === "function") {
-    fn = optionsOrNameOrFn;
-    name = fn.name;
-    options = {};
-  } else {
-    options = optionsOrNameOrFn!;
-    if (typeof optionsOrFn === "function") {
-      fn = optionsOrFn;
-    } else {
-      fn = (options as ItDefinition<T>).fn;
-    }
-    name = (options as ItDefinition<T>).name ?? fn.name;
-  }
-
-  return {
-    ...(suite !== undefined ? { suite } : {}),
-    ...options,
-    name,
-    fn,
-  };
-}
-
-/** Registers an individual test case. */
-export interface it {
-  <T>(...args: ItArgs<T>): void;
-
-  /** Registers an individual test case with only set to true. */
-  only<T>(...args: ItArgs<T>): void;
-
-  /** Registers an individual test case with ignore set to true. */
-  ignore<T>(...args: ItArgs<T>): void;
-
-  /**
-   * Registers an individual test case with ignore set to true. Alias of
-   * `.ignore()`.
-   */
-  skip<T>(...args: ItArgs<T>): void;
-}
-
-/**
- * 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<T>(...args: ItArgs<T>) {
-  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 = globalSanitizersState.sanitizeExit,
-      sanitizeOps = globalSanitizersState.sanitizeOps,
-      sanitizeResources = globalSanitizersState.sanitizeResources,
-    } = options;
-    const opts: dntShim.Deno.TestDefinition = {
-      name,
-      async fn(t) {
-        TestSuiteInternal.runningCount++;
-        try {
-          await fn.call({} as T, t);
-        } finally {
-          TestSuiteInternal.runningCount--;
-        }
-
-        if (assertionState.checkAssertionErrorState()) {
-          throw new AssertionError(
-            "Expected at least one assertion to be called but received none",
-          );
-        }
-
-        if (assertionState.checkAssertionCountSatisfied()) {
-          throw new AssertionError(
-            `Expected at least ${assertionState.assertionCount} assertion to be called, ` +
-              `but received ${assertionState.assertionTriggeredCount}`,
-          );
-        }
-
-        assertionState.resetAssertionState();
-      },
-    };
-    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<T>(...args: ItArgs<T>): void {
-  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<T>(...args: ItArgs<T>): void {
-  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<T>(...args: ItArgs<T>): void {
-  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<T>(...args: ItArgs<T>) {
-  it(...args);
-}
-
-/**
- * Only execute this test case.
- *
- * @example Usage
- * ```ts
- * import { describe, test } from "@std/testing/bdd";
- * import { assertEquals } from "@std/assert";
- *
- * describe("example", () => {
- *   test("should pass", () => {
- *     assertEquals(2 + 2, 4);
- *   });
- *
- *   test.only("should pass too", () => {
- *     assertEquals(3 + 4, 7);
- *   });
- * });
- * ```
- *
- * @param args The test case
- */
-test.only = function itOnly<T>(...args: ItArgs<T>): void {
-  it.only(...args);
-};
-
-/**
- * Ignore this test case.
- *
- * @example Usage
- * ```ts
- * import { describe, test } from "@std/testing/bdd";
- * import { assertEquals } from "@std/assert";
- *
- * describe("example", () => {
- *   test("should pass", () => {
- *     assertEquals(2 + 2, 4);
- *   });
- *
- *   test.ignore("should pass too", () => {
- *     assertEquals(3 + 4, 7);
- *   });
- * });
- * ```
- *
- * @param args The test case
- */
-test.ignore = function itIgnore<T>(...args: ItArgs<T>): void {
-  it.ignore(...args);
-};
-
-/** Skip this test case.
- *
- * @example Usage
- * ```ts
- * import { describe, test } from "@std/testing/bdd";
- * import { assertEquals } from "@std/assert";
- *
- * describe("example", () => {
- *   test("should pass", () => {
- *     assertEquals(2 + 2, 4);
- *   });
- *
- *   test.skip("should pass too", () => {
- *     assertEquals(3 + 4, 7);
- *   });
- * });
- * ```
- *
- * @param args The test case
- */
-test.skip = function itSkip<T>(...args: ItArgs<T>): void {
-  it.ignore(...args);
-};
-
-function addHook<T>(
-  name: HookNames,
-  fn: (this: T) => void | Promise<void>,
-) {
-  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 group.
- * Useful for async setup in `describe` blocks. Outside them,
- * top-level initialization code should be used instead.
- *
- * @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<T>(
-  fn: (this: T) => void | Promise<void>,
-) {
-  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<T>(
-  fn: (this: T) => void | Promise<void>,
-) {
-  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<T>(
-  fn: (this: T) => void | Promise<void>,
-) {
-  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<T>(
-  fn: (this: T) => void | Promise<void>,
-) {
-  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<T>(
-  fn: (this: T) => void | Promise<void>,
-) {
-  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<T>(
-  fn: (this: T) => void | Promise<void>,
-) {
-  addHook("afterEach", fn);
-}
-
-/** The arguments for a DescribeFunction. */
-export type DescribeArgs<T> =
-  | [options: DescribeDefinition<T>]
-  | [name: string]
-  | [
-    name: string,
-    options: Omit<DescribeDefinition<T>, "name">,
-  ]
-  | [name: string, fn: () => void | undefined]
-  | [fn: () => void | undefined]
-  | [
-    name: string,
-    options: Omit<DescribeDefinition<T>, "fn" | "name">,
-    fn: () => void | undefined,
-  ]
-  | [
-    options: Omit<DescribeDefinition<T>, "fn">,
-    fn: () => void | undefined,
-  ]
-  | [
-    options: Omit<DescribeDefinition<T>, "fn" | "name">,
-    fn: () => void | undefined,
-  ]
-  | [
-    suite: TestSuite<T>,
-    name: string,
-  ]
-  | [
-    suite: TestSuite<T>,
-    name: string,
-    options: Omit<DescribeDefinition<T>, "name" | "suite">,
-  ]
-  | [
-    suite: TestSuite<T>,
-    name: string,
-    fn: () => void | undefined,
-  ]
-  | [
-    suite: TestSuite<T>,
-    fn: () => void | undefined,
-  ]
-  | [
-    suite: TestSuite<T>,
-    name: string,
-    options: Omit<DescribeDefinition<T>, "fn" | "name" | "suite">,
-    fn: () => void | undefined,
-  ]
-  | [
-    suite: TestSuite<T>,
-    options: Omit<DescribeDefinition<T>, "fn" | "suite">,
-    fn: () => void | undefined,
-  ]
-  | [
-    suite: TestSuite<T>,
-    options: Omit<DescribeDefinition<T>, "fn" | "name" | "suite">,
-    fn: () => void | undefined,
-  ];
-
-/** Generates a DescribeDefinition from DescribeArgs. */
-function describeDefinition<T>(
-  ...args: DescribeArgs<T>
-): DescribeDefinition<T> {
-  let [
-    suiteOptionsOrNameOrFn,
-    optionsOrNameOrFn,
-    optionsOrFn,
-    fn,
-  ] = args;
-  let suite: TestSuite<T> | undefined = undefined;
-  let name: string;
-  let options:
-    | DescribeDefinition<T>
-    | Omit<DescribeDefinition<T>, "fn">
-    | Omit<DescribeDefinition<T>, "name">
-    | Omit<DescribeDefinition<T>, "fn" | "name">;
-  if (
-    typeof suiteOptionsOrNameOrFn === "object" &&
-    typeof (suiteOptionsOrNameOrFn as TestSuite<T>).symbol === "symbol"
-  ) {
-    suite = suiteOptionsOrNameOrFn as TestSuite<T>;
-  } else {
-    fn = optionsOrFn as typeof fn;
-    optionsOrFn = optionsOrNameOrFn as typeof optionsOrFn;
-    optionsOrNameOrFn = suiteOptionsOrNameOrFn as typeof optionsOrNameOrFn;
-  }
-  if (typeof optionsOrNameOrFn === "string") {
-    name = optionsOrNameOrFn;
-    if (typeof optionsOrFn === "function") {
-      fn = optionsOrFn;
-      options = {};
-    } else {
-      options = optionsOrFn ?? {};
-      if (fn === undefined) {
-        fn = (options as Omit<DescribeDefinition<T>, "name">).fn;
-      }
-    }
-  } else if (typeof optionsOrNameOrFn === "function") {
-    fn = optionsOrNameOrFn;
-    name = fn.name;
-    options = {};
-  } else {
-    options = optionsOrNameOrFn ?? {};
-    if (typeof optionsOrFn === "function") {
-      fn = optionsOrFn;
-    } else {
-      fn = (options as DescribeDefinition<T>).fn;
-    }
-    name = (options as DescribeDefinition<T>).name ?? fn?.name ?? "";
-  }
-
-  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. */
-export interface describe {
-  <T>(...args: DescribeArgs<T>): TestSuite<T>;
-
-  /** Registers a test suite with only set to true. */
-  only<T>(...args: DescribeArgs<T>): TestSuite<T>;
-
-  /** Registers a test suite with ignore set to true. */
-  ignore<T>(...args: DescribeArgs<T>): TestSuite<T>;
-
-  /** Registers a test suite with ignore set to true. Alias of `.ignore()`. */
-  skip<T>(...args: ItArgs<T>): void;
-}
-
-/**
- * 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<T>(
-  ...args: DescribeArgs<T>
-): TestSuite<T> {
-  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<T>(
-  ...args: DescribeArgs<T>
-): TestSuite<T> {
-  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<T>(
-  ...args: DescribeArgs<T>
-): TestSuite<T> {
-  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<T>(
-  ...args: DescribeArgs<T>
-): TestSuite<T> {
-  return describe.ignore(...args);
-};