Function getMultiServicePythonRunner

packages/python/src/start-dev-server.ts:559–588

(
  workPath: string,
  env: NodeJS.ProcessEnv,
  systemPython: string,
  uvPath: string | null
)

}

async function getMultiServicePythonRunner(
  workPath: string,
  env: NodeJS.ProcessEnv,
  systemPython: string,
  uvPath: string | null
): Promise<PythonRunner> {
  // Use an existing .venv/venv if present and allowed (single Python service in a project).
  const { pythonCmd, venvRoot } = useVirtualEnv(workPath, env, systemPython);
  if (venvRoot) {
    debug(`Using existing virtualenv at ${venvRoot} for multi-service dev`);
    return { command: pythonCmd, args: [] };
  }

  // Create a per-service .venv, so deps are managed separately.
  const venvPath = join(workPath, '.venv');
  await ensureVenv({
    pythonVersion: { pythonPath: systemPython },
    venvPath,
    uvPath,
    quiet: true,
  });
  debug(`Created virtualenv at ${venvPath} for multi-service dev`);

  const pythonBin = getVenvPythonBin(venvPath);
  const binDir = getVenvBinDir(venvPath);
  env.VIRTUAL_ENV = venvPath;
  env.PATH = `${binDir}${delimiter}${env.PATH || ''}`;

  return { command: pythonBin, args: [] };
}

export const startDevServer: StartDevServer = async opts => {
  const {