Struct ManagedPythonInstallation 

pub struct ManagedPythonInstallation { /* private fields */ }

A uv-managed Python installation on the current system.

Implementations

impl ManagedPythonInstallation

pub fn new(path: PathBuf, download: &ManagedPythonDownload) -> Self

pub fn executable(&self, windowed: bool) -> PathBuf

The path to this managed installation’s Python executable.

If the installation has multiple executables i.e., python, python3, etc., this will return the canonical executable name which the other names link to. On Unix, this is python{major}.{minor}{variant} and on Windows, this is python{exe}.

If windowed is true, pythonw.exe is selected over python.exe on windows, with no changes on non-windows.

pub fn version(&self) -> PythonVersion

The PythonVersion of the toolchain.

pub fn implementation(&self) -> ImplementationName

pub fn path(&self) -> &Path

pub fn key(&self) -> &PythonInstallationKey

pub fn platform(&self) -> &Platform

pub fn build(&self) -> Option<&str>

The build version of this installation, if available.

pub fn minor_version_key(&self) -> &PythonInstallationMinorVersionKey

pub fn satisfies(&self, request: &PythonRequest) -> bool

pub fn ensure_canonical_executables(&self) -> Result<(), Error>

Ensure the environment contains the canonical Python executable names.

pub fn ensure_minor_version_link(&self, preview: Preview) -> Result<(), Error>

Ensure the environment contains the symlink directory (or junction on Windows) pointing to the patch directory for this minor version.

pub fn update_minor_version_link(&self, preview: Preview) -> Result<(), Error>

If the environment contains a symlink directory (or junction on Windows), update it to the latest patch directory for this minor version.

Unlike [ensure_minor_version_link], will not create a new symlink directory if one doesn’t already exist,

pub fn ensure_externally_managed(&self) -> Result<(), Error>

Ensure the environment is marked as externally managed with the standard EXTERNALLY-MANAGED file.

pub fn ensure_sysconfig_patched(&self) -> Result<(), Error>

Ensure that the sysconfig data is patched to match the installation path.

pub fn ensure_dylib_patched(&self) -> Result<(), Error>

On macOS, ensure that the install_name for the Python dylib is set correctly, rather than pointing at /install/lib/libpython{version}.dylib. This is necessary to ensure that native extensions written in Rust link to the correct location for the Python library.

See https://github.com/astral-sh/uv/issues/10598 for more information.

pub fn ensure_build_file(&self) -> Result<(), Error>

Ensure the build version is written to a BUILD file in the installation directory.

pub fn is_bin_link(&self, path: &Path) -> bool

Returns true if the path is a link to this installation’s binary, e.g., as created by [create_bin_link].

pub fn is_upgrade_of(&self, other: &Self) -> bool

Returns true if self is a suitable upgrade of other.

pub fn url(&self) -> Option<&str>

pub fn sha256(&self) -> Option<&str>

Trait Implementations

impl Clone for ManagedPythonInstallation

fn clone(&self) -> ManagedPythonInstallation

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ManagedPythonInstallation

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

Formats the value using the given formatter.

impl Display for ManagedPythonInstallation

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

Formats the value using the given formatter.

impl From<&ManagedPythonInstallation> for PythonDownloadRequest

fn from(installation: &ManagedPythonInstallation) -> Self

Converts to this type from the input type.

impl Ord for ManagedPythonInstallation

fn cmp(&self, other: &ManagedPythonInstallation) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for ManagedPythonInstallation

fn eq(&self, other: &ManagedPythonInstallation) -> 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 PartialOrd for ManagedPythonInstallation

fn partial_cmp(&self, other: &ManagedPythonInstallation) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Eq for ManagedPythonInstallation

impl StructuralPartialEq for ManagedPythonInstallation