Method getWorkerCount

src/providers/pythonCompletion.ts:268–307

* Determine worker count based on config and environment * Priority: config.workers > PROMPTFOO_PYTHON_WORKERS env > cliState.maxConcurrency (-j flag) > default 1 * * Explicit Python-specific settings (config.workers, env var) take precedence over * general concurrency hints (-j flag) be

()

   * memory constraints or non-thread-safe scripts.
   */
  private getWorkerCount(): number {
    // 1. Explicit config.workers (highest priority - user knows their script's requirements)
    if (this.config.workers !== undefined) {
      if (this.config.workers < 1) {
        logger.warn(`Invalid worker count ${this.config.workers} in config, using minimum of 1`);
        return 1;
      }
      logger.debug(`Python provider using ${this.config.workers} workers (from config.workers)`);
      return this.config.workers;
    }

    // 2. Environment variable (explicit Python-specific setting)
    const envWorkers = getEnvInt('PROMPTFOO_PYTHON_WORKERS');
    if (envWorkers !== undefined) {
      if (envWorkers < 1) {
        logger.warn(
          `Invalid worker count ${envWorkers} in PROMPTFOO_PYTHON_WORKERS, using minimum of 1`,
        );
        return 1;
      }
      logger.debug(`Python provider using ${envWorkers} workers (from PROMPTFOO_PYTHON_WORKERS)`);
      return envWorkers;
    }

    // 3. CLI -j flag via cliState (general concurrency hint, only when explicitly set)
    if (cliState.maxConcurrency !== undefined) {
      if (cliState.maxConcurrency < 1) {
        logger.warn(
          `Invalid worker count ${cliState.maxConcurrency} from -j flag, using minimum of 1`,
        );
        return 1;
      }
      logger.debug(`Python provider using ${cliState.maxConcurrency} workers (from -j flag)`);
      return cliState.maxConcurrency;
    }

    // 4. Default: 1 worker (memory-efficient, backward compatible)
    logger.debug('Python provider using 1 worker (default)');
    return 1;
  }

  /**
   * Execute the Python script with the specified API type