test() — tailwindcss Function Reference

Architecture documentation for the test() function in utils.ts from the tailwindcss codebase.

Function typescript OxideEngine PreProcessors calls 4

Entity Profile

OxideEngine→ PreProcessors→ test() — tailwindcss Function Reference

Dependency Diagram

graph TD
  f11e3be9_51f8_140b_68b0_f58ddd082595["test()"]
  9ffd1dda_9675_c514_373d_0f4ab4648249["utils.ts"]
  f11e3be9_51f8_140b_68b0_f58ddd082595 -->|defined in| 9ffd1dda_9675_c514_373d_0f4ab4648249
  d0cff1bd_003f_5845_e26a_0dc1e96b292c["predicate()"]
  f11e3be9_51f8_140b_68b0_f58ddd082595 -->|calls| d0cff1bd_003f_5845_e26a_0dc1e96b292c
  6fd82750_ae7b_5040_168c_51948e7e8bf1["overwriteVersionsInPackageJson()"]
  f11e3be9_51f8_140b_68b0_f58ddd082595 -->|calls| 6fd82750_ae7b_5040_168c_51948e7e8bf1
  329ca5ee_2e24_1ec5_6818_8fdc3622dda9["retryAssertion()"]
  f11e3be9_51f8_140b_68b0_f58ddd082595 -->|calls| 329ca5ee_2e24_1ec5_6818_8fdc3622dda9
  dec46249_6b4d_dc36_e8de_2585bc9aac6d["gracefullyRemove()"]
  f11e3be9_51f8_140b_68b0_f58ddd082595 -->|calls| dec46249_6b4d_dc36_e8de_2585bc9aac6d
  style f11e3be9_51f8_140b_68b0_f58ddd082595 fill:#6366f1,stroke:#818cf8,color:#fff

Relationship Graph

Source Code

integrations/utils.ts lines 81–456

export function test(
  name: string,
  config: TestConfig,
  testCallback: TestCallback,
  { only = false, skip = false, debug = false }: TestFlags = {},
) {
  return defaultTest(
    name,
    {
      timeout: config.timeout ?? TEST_TIMEOUT,
      retry: process.env.CI ? 2 : 0,
      only: only || (!process.env.CI && debug),
      skip,
      concurrent: true,
    },
    async (options) => {
      let rootDir = debug ? path.join(REPO_ROOT, '.debug') : TMP_ROOT
      await fs.mkdir(rootDir, { recursive: true })

      let root = await fs.mkdtemp(path.join(rootDir, 'tailwind-integrations'))

      if (debug) {
        console.log('Running test in debug mode. File system will be written to:')
        console.log(root)
        console.log()
      }

      let context = {
        root,
        expect: options.expect,
        parseSourceMap,
        async exec(
          command: string,
          childProcessOptions: ChildProcessOptions = {},
          execOptions: ExecOptions = {},
        ) {
          let cwd = childProcessOptions.cwd ?? root
          if (debug && cwd !== root) {
            let relative = path.relative(root, cwd)
            if (relative[0] !== '.') relative = `./${relative}`
            console.log(`> cd ${relative}`)
          }
          if (debug) console.log(`> ${command}`)
          return new Promise((resolve, reject) => {
            let child = exec(
              command,
              {
                cwd,
                ...childProcessOptions,
                env: {
                  ...process.env,
                  ...childProcessOptions.env,
                },
              },
              (error, stdout, stderr) => {
                if (error) {
                  if (execOptions.ignoreStdErr !== true) console.error(stderr)
                  if (only || debug) {
                    console.error(stdout)
                  }
                  reject(error)
                } else {
                  if (only || debug) {
                    console.log(stdout.toString() + '\n\n' + stderr.toString())
                  }
                  resolve(stdout.toString() + '\n\n' + stderr.toString())
                }
              },
            )
            if (execOptions.stdin) {
              child.stdin?.write(execOptions.stdin)
              child.stdin?.end()
            }
          })
        },
        async spawn(command: string, childProcessOptions: ChildProcessOptions = {}) {
          let resolveDisposal: (() => void) | undefined
          let rejectDisposal: ((error: Error) => void) | undefined
          let disposePromise = new Promise<void>((resolve, reject) => {
            resolveDisposal = resolve
            rejectDisposal = reject