Enum PythonRequest 

pub enum PythonRequest {
    Default,
    Any,
    Version(VersionRequest),
    Directory(PathBuf),
    File(PathBuf),
    ExecutableName(String),
    Implementation(ImplementationName),
    ImplementationVersion(ImplementationName, VersionRequest),
    Key(PythonDownloadRequest),
}

A request to find a Python installation.

See [PythonRequest::from_str].

Variants

Default

An appropriate default Python installation

This may skip some Python installations, such as pre-release versions or alternative implementations.

Any

Any Python installation

Version(VersionRequest)

A Python version without an implementation name e.g. 3.10 or >=3.12,<3.13

Directory(PathBuf)

A path to a directory containing a Python installation, e.g. .venv

File(PathBuf)

A path to a Python executable e.g. ~/bin/python

ExecutableName(String)

The name of a Python executable (i.e. for lookup in the PATH) e.g. foopython3

Implementation(ImplementationName)

A Python implementation without a version e.g. pypy or pp

ImplementationVersion(ImplementationName, VersionRequest)

A Python implementation name and version e.g. pypy3.8 or pypy@3.8 or pp38

Key(PythonDownloadRequest)

A request for a specific Python installation key e.g. cpython-3.12-x86_64-linux-gnu Generally these refer to managed Python downloads.

Implementations

impl PythonRequest

pub fn parse(value: &str) -> Self

Create a request from a string.

This cannot fail, which means weird inputs will be parsed as PythonRequest::File or PythonRequest::ExecutableName.

This is intended for parsing the argument to the --python flag. See also try_from_tool_name below.

pub fn try_from_tool_name(value: &str) -> Result<Option<Self>, Error>

Try to parse a tool name as a Python version, e.g. uvx python311.

The PythonRequest::parse constructor above is intended for the --python flag, where the value is unambiguously a Python version. This alternate constructor is intended for uvx or uvx --from, where the executable could be either a Python version or a package name. There are several differences in behavior:

• This only supports long names, including e.g. pypy39 but not pp39 or 39.
• On Windows only, this allows pythonw as an alias for python.
• This allows python by itself (and on Windows, pythonw) as an alias for default.

This can only return Err if @ is used. Otherwise, if no match is found, it returns Ok(None).

pub fn includes_patch(&self) -> bool

Check if this request includes a specific patch version.

pub fn includes_prerelease(&self) -> bool

Check if this request includes a specific prerelease version.

pub fn satisfied(&self, interpreter: &Interpreter, cache: &Cache) -> bool

Check if a given interpreter satisfies the interpreter request.

pub fn to_canonical_string(&self) -> String

Serialize the request to a canonical representation.

Self::parse should always return the same request when given the output of this method.

Trait Implementations

impl Clone for PythonRequest

fn clone(&self) -> PythonRequest

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PythonRequest

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

Formats the value using the given formatter.

impl Default for PythonRequest

fn default() -> PythonRequest

Returns the “default value” for a type.

impl<'a> Deserialize<'a> for PythonRequest

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>

where D: Deserializer<'a>,

Deserialize this value from the given Serde deserializer.

impl Display for PythonRequest

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

Formats the value using the given formatter.

impl Hash for PythonRequest

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for PythonRequest

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

fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>

where S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for PythonRequest

impl StructuralPartialEq for PythonRequest