Function tryPythonCandidate

lib/cli.js:92–116

* Try a single Python candidate. Returns { exe, version } or null. * `candidate` is either a bare name or an array of args (e.g. ['py', '-3']).

(candidate)

 * `candidate` is either a bare name or an array of args (e.g. ['py', '-3']).
 */
function tryPythonCandidate(candidate) {
  const args = Array.isArray(candidate) ? candidate : [candidate];
  const exe = args[0];
  const extraArgs = args.slice(1);

  try {
    const out = execFileSync(exe, [...extraArgs, '--version'], {
      encoding: 'utf8',
      timeout: 10_000,
      stdio: ['pipe', 'pipe', 'pipe'],
    });

    const ver = parsePythonVersion(out);
    if (!ver) return null;

    // Require 3.11+
    if (ver.major < 3 || (ver.major === 3 && ver.minor < 11)) {
      return { exe: args.join(' '), version: ver, tooOld: true };
    }

    return { exe: args.join(' '), version: ver, tooOld: false };
  } catch {
    return null;
  }
}

// ---------------------------------------------------------------------------
// Python detection