Function ensureUvProject

packages/python/src/install.ts:260–400

({
  workPath,
  rootDir,
  venvPath,
  pythonPackage,
  pythonVersion,
  uv,
  requireBinaryWheels = false,
  cachedLockPath,
}: EnsureUvProjectParams)

}

export async function ensureUvProject({
  workPath,
  rootDir,
  venvPath,
  pythonPackage,
  pythonVersion,
  uv,
  requireBinaryWheels = false,
  cachedLockPath,
}: EnsureUvProjectParams): Promise<UvProjectInfo> {
  const { manifestType } = detectInstallSource(pythonPackage, rootDir);
  const manifest = pythonPackage.manifest;

  let projectDir: string;
  let pyprojectPath: string;
  let lockPath: string | null = null;
  let lockFileProvidedByUser = false;

  if (manifestType === 'uv.lock' || manifestType === 'pylock.toml') {
    // User provided a lock file
    lockFileProvidedByUser = true;
    // Lock file exists - use it directly
    const lockFile =
      pythonPackage.manifest?.lockFile ?? pythonPackage.workspaceLockFile;
    if (!lockFile) {
      throw new Error(
        `Expected lock file path to be resolved, but it was null`
      );
    }
    lockPath = join(rootDir, lockFile.path);
    // Project dir is where the lock file is located
    projectDir = dirname(lockPath);
    pyprojectPath = join(projectDir, 'pyproject.toml');

    if (!fs.existsSync(pyprojectPath)) {
      throw new Error(
        `Expected "pyproject.toml" next to "${lockFile.kind}" in "${projectDir}"`
      );
    }
    console.log(`Installing required dependencies from ${lockFile.kind}...`);
  } else if (manifest) {
    // Manifest exists (native pyproject.toml or converted from Pipfile/requirements.txt)
    projectDir = join(rootDir, dirname(manifest.path));
    pyprojectPath = join(rootDir, manifest.path);

    // Log the original source for user clarity
    const originKind = manifest.origin?.kind;
    if (originKind === PythonManifestConvertedKind.Pipfile) {
      console.log('Installing required dependencies from Pipfile...');
    } else if (originKind === PythonManifestConvertedKind.PipfileLock) {
      console.log('Installing required dependencies from Pipfile.lock...');
    } else if (
      originKind === PythonManifestConvertedKind.RequirementsTxt ||
      originKind === PythonManifestConvertedKind.RequirementsIn
    ) {
      console.log(
        `Installing required dependencies from ${manifest.origin?.path ?? 'requirements.txt'}...`
      );