Function getBashPath

src/node/utils/main/bashPath.ts:231–275

(
  params: {
    platform?: NodeJS.Platform;
    env?: NodeJS.ProcessEnv;
    execSyncFn?: (command: string, options: ExecSyncOptionsWithStringEncoding) => string;
    existsSyncFn?: (path: string) => boolean;
    nowFn?: () => number;
  } = {}
)

 * @throws Error if Git Bash cannot be found on Windows
 */
export function getBashPath(
  params: {
    platform?: NodeJS.Platform;
    env?: NodeJS.ProcessEnv;
    execSyncFn?: (command: string, options: ExecSyncOptionsWithStringEncoding) => string;
    existsSyncFn?: (path: string) => boolean;
    nowFn?: () => number;
  } = {}
): string {
  const platform = params.platform ?? process.platform;

  // On Unix/Linux/macOS, bash is in PATH
  if (platform !== "win32") {
    return "bash";
  }

  // Use cached path if available
  if (cachedBashPath !== null) {
    return cachedBashPath;
  }

  const nowFn = params.nowFn ?? Date.now;
  const now = nowFn();
  if (
    cachedBashPathError &&
    now - cachedBashPathError.lastCheckedMs < BASH_PATH_ERROR_COOLDOWN_MS
  ) {
    throw new Error(cachedBashPathError.message);
  }

  try {
    cachedBashPath = getBashPathForPlatform({
      platform,
      env: params.env,
      execSyncFn: params.execSyncFn,
      existsSyncFn: params.existsSyncFn,
    });
    cachedBashPathError = null;
    return cachedBashPath;
  } catch (error) {
    const message = getErrorMessage(error);
    cachedBashPathError = { message, lastCheckedMs: now };
    throw error;
  }
}

/** Reset cached bash path (used by tests). */
export function resetBashPathCache(): void {