Struct ManagedPythonInstallations 

pub struct ManagedPythonInstallations { /* private fields */ }

A collection of uv-managed Python installations installed on the current system.

Implementations

impl ManagedPythonInstallations

pub async fn lock(&self) -> Result<LockedFile, Error>

Grab a file lock for the managed Python distribution directory to prevent concurrent access across processes.

pub fn from_settings(install_dir: Option<PathBuf>) -> Result<Self, Error>

Prefer, in order:

1. The specific Python directory passed via the install_dir argument.
2. The specific Python directory specified with the UV_PYTHON_INSTALL_DIR environment variable.
3. A directory in the system-appropriate user-level data directory, e.g., ~/.local/uv/python.
4. A directory in the local data directory, e.g., ./.uv/python.

pub fn temp() -> Result<Self, Error>

Create a temporary Python installation directory.

pub fn scratch(&self) -> PathBuf

Return the location of the scratch directory for managed Python installations.

pub fn init(self) -> Result<Self, Error>

Initialize the Python installation directory.

Ensures the directory is created.

pub fn find_all( &self, ) -> Result<impl DoubleEndedIterator<Item = ManagedPythonInstallation> + use<>, Error>

Iterate over each Python installation in this directory.

Pythons are sorted by PythonInstallationKey, for the same implementation name, the newest versions come first. This ensures a consistent ordering across all platforms.

pub fn find_matching_current_platform( &self, ) -> Result<impl DoubleEndedIterator<Item = ManagedPythonInstallation> + use<>, Error>

Iterate over Python installations that support the current platform.

pub fn find_version<'a>( &'a self, version: &'a PythonVersion, ) -> Result<impl DoubleEndedIterator<Item = ManagedPythonInstallation> + 'a, Error>

Iterate over managed Python installations that satisfy the requested version on this platform.

Errors

• The platform metadata cannot be read
• A directory for the installation cannot be read

pub fn root(&self) -> &Path

Trait Implementations

impl Clone for ManagedPythonInstallations

fn clone(&self) -> ManagedPythonInstallations

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ManagedPythonInstallations

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl PartialEq for ManagedPythonInstallations

fn eq(&self, other: &ManagedPythonInstallations) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for ManagedPythonInstallations

impl StructuralPartialEq for ManagedPythonInstallations