Function ensurePythonRuntime

bin/ds.js:2961–3081

(home)

}

function ensurePythonRuntime(home) {
  ensureDir(path.join(home, 'runtime'));
  ensureDir(path.join(home, 'runtime', 'bundle'));
  ensureDir(runtimeUvCachePath(home));
  ensureDir(runtimeUvPythonInstallPath(home));
  ensureDir(runtimeToolsPath(home));
  let uvBinary;
  try {
    uvBinary = ensureUvBinary(home);
  } catch (error) {
    printUvInstallGuidance(home, error instanceof Error ? error.message : String(error));
    process.exit(1);
  }
  const runtimePlan = resolvePythonRuntimePlan();
  if (runtimePlan.runtimeKind === 'managed') {
    printManagedPythonFallbackNotice({
      rejectedProbe: runtimePlan.rejectedProbe || null,
      source: runtimePlan.source,
      minimumVersionRequest: runtimePlan.minimumVersionRequest,
      installDir: runtimeUvPythonInstallPath(home),
    });
  }
  const lockPath = ensureUvLockPresent();
  const stampPath = path.join(home, 'runtime', 'bundle', 'python-stamp.json');
  const editable = useEditableProjectInstall();
  const desiredStamp = {
    runtimeManager: 'uv',
    version: packageJson.version,
    pyprojectHash: sha256File(path.join(repoRoot, 'pyproject.toml')),
    uvLockHash: sha256File(lockPath),
    editable,
    sourceTreeHash: editable ? null : hashPythonSourceTree(),
    uvVersion: resolveUvVersion(uvBinary),
    envPath: runtimePythonEnvPath(home),
    source:
      runtimePlan.runtimeKind === 'system'
        ? {
            kind: 'system',
            source: runtimePlan.selectedProbe.source,
            sourceExecutable:
              runtimePlan.selectedProbe.realExecutable
              || runtimePlan.selectedProbe.executable
              || runtimePlan.selectedProbe.binary,
            sourceVersion: runtimePlan.selectedProbe.version,
            sourceMajorMinor: pythonMajorMinor(runtimePlan.selectedProbe),
          }
        : {
            kind: 'uv-managed',
            minimumVersionRequest: runtimePlan.minimumVersionRequest,
          },
  };

  for (let attempt = 0; attempt < 2; attempt += 1) {
    const runtimePython = runtimePythonPath(home);
    const currentStamp = readJsonFile(stampPath);
    const runtimeProbe = fs.existsSync(runtimePython) ? probePython(runtimePython) : null;
    const runtimeBroken = !runtimeProbe || !runtimeProbe.ok || !pythonMeetsMinimum(runtimeProbe);
    const stampChanged = JSON.stringify(currentStamp || null) !== JSON.stringify(desiredStamp);