Rename PythonRequest::Any -> PythonRequest::Default

crates/uv-python/src/discovery.rs

@@ -36,9 +36,12 @@ use crate::{Interpreter, PythonVersion};
 /// See [`PythonRequest::from_str`].
 #[derive(Debug, Clone, PartialEq, Eq, Default)]
 pub enum PythonRequest {
-    /// Use any discovered Python installation
+    /// Use an appropriate default Python installation
+    ///
+    /// This may skip some Python installations, such as pre-release versions or alternative
+    /// implementations.
     #[default]
-    Any,
+    Default,
     /// A Python version without an implementation name e.g. `3.10` or `>=3.12,<3.13`
     Version(VersionRequest),
     /// A path to a directory containing a Python installation, e.g. `.venv`
@@ -776,7 +779,7 @@ pub fn find_python_installations<'a>(
                 ))))
             }
         }
-        PythonRequest::Any => Box::new({
+        PythonRequest::Default => Box::new({
             debug!("Searching for Python interpreter in {preference}");
             python_interpreters(None, None, environments, preference, cache).map(|result| {
                 result
@@ -976,7 +979,7 @@ pub fn find_best_python_installation(
 
     // If a Python version was requested but cannot be fulfilled, just take any version
     debug!("Looking for Python installation with any version");
-    let request = PythonRequest::Any;
+    let request = PythonRequest::Default;
     Ok(
         find_python_installation(&request, environments, preference, cache)?.map_err(|err| {
             // Use a more general error in this case since we looked for multiple versions
@@ -1142,7 +1145,7 @@ impl PythonRequest {
     pub fn parse(value: &str) -> Self {
         // e.g. `any`
         if value.eq_ignore_ascii_case("any") {
-            return Self::Any;
+            return Self::Default;
         }
 
         // e.g. `3.12.1`, `312`, or `>=3.12`
@@ -1246,7 +1249,7 @@ impl PythonRequest {
         }
 
         match self {
-            PythonRequest::Any => true,
+            PythonRequest::Default => true,
             PythonRequest::Version(version_request) => {
                 version_request.matches_interpreter(interpreter)
             }
@@ -1330,7 +1333,7 @@ impl PythonRequest {
 
     pub(crate) fn allows_prereleases(&self) -> bool {
         match self {
-            Self::Any => false,
+            Self::Default => false,
             Self::Version(version) => version.allows_prereleases(),
             Self::Directory(_) | Self::File(_) | Self::ExecutableName(_) => true,
             Self::Implementation(_) => false,
@@ -1348,7 +1351,7 @@ impl PythonRequest {
     /// [`Self::parse`] should always return the same request when given the output of this method.
     pub fn to_canonical_string(&self) -> String {
         match self {
-            Self::Any => "any".to_string(),
+            Self::Default => "any".to_string(),
             Self::Version(version) => version.to_string(),
             Self::Directory(path) => path.display().to_string(),
             Self::File(path) => path.display().to_string(),
@@ -1801,7 +1804,7 @@ impl fmt::Display for VersionRequest {
 impl fmt::Display for PythonRequest {
     fn fmt(&self, f: &mut Formatter<'_>) -> fmt::Result {
         match self {
-            Self::Any => write!(f, "any Python"),
+            Self::Default => write!(f, "any Python"),
             Self::Version(version) => write!(f, "Python {version}"),
             Self::Directory(path) => write!(f, "directory `{}`", path.user_display()),
             Self::File(path) => write!(f, "path `{}`", path.user_display()),
@@ -1883,7 +1886,7 @@ impl fmt::Display for PythonNotFound {
         };
 
         match self.request {
-            PythonRequest::Any => {
+            PythonRequest::Default => {
                 write!(f, "No interpreter found in {sources}")
             }
             _ => {
@@ -1961,7 +1964,7 @@ mod tests {
 
     #[test]
     fn interpreter_request_from_str() {
-        assert_eq!(PythonRequest::parse("any"), PythonRequest::Any);
+        assert_eq!(PythonRequest::parse("any"), PythonRequest::Default);
         assert_eq!(
             PythonRequest::parse("3.12"),
             PythonRequest::Version(VersionRequest::from_str("3.12").unwrap())
@@ -2123,7 +2126,7 @@ mod tests {
 
     #[test]
     fn interpreter_request_to_canonical_string() {
-        assert_eq!(PythonRequest::Any.to_canonical_string(), "any");
+        assert_eq!(PythonRequest::Default.to_canonical_string(), "any");
         assert_eq!(
             PythonRequest::Version(VersionRequest::from_str("3.12").unwrap()).to_canonical_string(),
             "3.12"

crates/uv-python/src/downloads.rs

@@ -173,7 +173,7 @@ impl PythonDownloadRequest {
                     .with_version(version.clone()),
             ),
             PythonRequest::Key(request) => Some(request.clone()),
-            PythonRequest::Any => Some(Self::default()),
+            PythonRequest::Default => Some(Self::default()),
             // We can't download a managed installation for these request kinds
             PythonRequest::Directory(_)
             | PythonRequest::ExecutableName(_)

crates/uv-python/src/environment.rs

@@ -80,7 +80,7 @@ impl fmt::Display for EnvironmentNotFound {
             EnvironmentPreference::OnlyVirtual => SearchType::Virtual,
         };
 
-        if matches!(self.request, PythonRequest::Any) {
+        if matches!(self.request, PythonRequest::Default) {
             write!(f, "No {search_type} found")?;
         } else {
             write!(f, "No {search_type} found for {}", self.request)?;

crates/uv-python/src/installation.rs

@@ -87,7 +87,7 @@ impl PythonInstallation {
         cache: &Cache,
         reporter: Option<&dyn Reporter>,
     ) -> Result<Self, Error> {
-        let request = request.unwrap_or_else(|| &PythonRequest::Any);
+        let request = request.unwrap_or_else(|| &PythonRequest::Default);
 
         // Search for the installation
         match Self::find(request, environments, preference, cache) {