args() — tailwindcss Function Reference

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

Function typescript CommandLineInterface Renderer calls 1

Entity Profile

CommandLineInterface→ Renderer→ args() — tailwindcss Function Reference

Dependency Diagram

graph TD
  1aa953df_1d07_87e9_0511_dceb7d1d33bf["args()"]
  f680db01_c2c6_090b_99ee_9df802d112b2["args.ts"]
  1aa953df_1d07_87e9_0511_dceb7d1d33bf -->|defined in| f680db01_c2c6_090b_99ee_9df802d112b2
  d5c7ae01_387d_fa61_01c9_115a12448d83["convert()"]
  1aa953df_1d07_87e9_0511_dceb7d1d33bf -->|calls| d5c7ae01_387d_fa61_01c9_115a12448d83
  style 1aa953df_1d07_87e9_0511_dceb7d1d33bf fill:#6366f1,stroke:#818cf8,color:#fff

Relationship Graph

Source Code

packages/@tailwindcss-cli/src/utils/args.ts lines 70–122

export function args<const T extends Arg>(options: T, argv = process.argv.slice(2)): Result<T> {
  for (let [idx, value] of argv.entries()) {
    if (value === '-') {
      argv[idx] = '__IO_DEFAULT_VALUE__'
    }
  }

  let parsed = parse(argv)

  for (let key in parsed) {
    let value = parsed[key]

    if (key !== '_' && Array.isArray(value)) {
      value = value[value.length - 1]
    }

    if (value === '__IO_DEFAULT_VALUE__') {
      value = '-'
    }

    parsed[key] = value
  }

  let result: { _: string[]; [key: string]: unknown } = {
    _: parsed._,
  }

  for (let [
    flag,
    { type, alias, default: defaultValue = type === 'boolean' ? false : null },
  ] of Object.entries(options)) {
    // Start with the default value
    result[flag] = defaultValue

    // Try to find the `alias`, and map it to long form `flag`
    if (alias) {
      let key = alias.slice(1)
      if (parsed[key] !== undefined) {
        result[flag] = convert(parsed[key], type)
      }
    }

    // Try to find the long form `flag`
    {
      let key = flag.slice(2)
      if (parsed[key] !== undefined) {
        result[flag] = convert(parsed[key], type)
      }
    }
  }

  return result as Result<T>
}