Add test case for uv python list downloads

Author: zanieb

crates/uv/tests/it/common/mod.rs

@@ -205,10 +205,10 @@ impl TestContext {
             self.filters
                 .push(("python.exe".to_string(), "python".to_string()));
         } else {
-            self.filters
-                .push((r"python\d".to_string(), "python".to_string()));
             self.filters
                 .push((r"python\d.\d\d".to_string(), "python".to_string()));
+            self.filters
+                .push((r"python\d".to_string(), "python".to_string()));
         }
         self
     }
@@ -224,6 +224,25 @@ impl TestContext {
         self
     }
 
+    /// Add extra standard filtering for Python installation `bin/` directories, which are not
+    /// present on Windows but are on Unix. See [`TestContext::with_filtered_virtualenv_bin`] for
+    /// the virtual environment equivalent.
+    #[must_use]
+    pub fn with_filtered_python_install_bin(mut self) -> Self {
+        if cfg!(unix) {
+            self.filters.push((
+                r"[\\/]bin/python".to_string(),
+                "/[INSTALL-BIN]/python".to_string(),
+            ));
+        } else {
+            self.filters.push((
+                r"[\\/]/python".to_string(),
+                "/[INSTALL-BIN]/python".to_string(),
+            ));
+        }
+        self
+    }
+
     /// Add extra filtering for ` -> <PATH>` symlink display for Python versions in the test
     /// context, e.g., for use in `uv python list`.
     #[must_use]

crates/uv/tests/it/python_list.rs

@@ -280,3 +280,114 @@ fn python_list_unsupported_version() {
     error: Invalid version request: Python <3.13 does not support free-threading but 3.12t was requested.
     ");
 }
+
+#[test]
+fn python_list_downloads() {
+    let context: TestContext = TestContext::new_with_versions(&[]).with_filtered_python_keys();
+
+    // We do not test showing all interpreters — as it differs per platform
+    // Instead, we choose a Python version where our available distributions are stable
+
+    // Test the default display, which requires reverting the test context disabling Python downloads
+    uv_snapshot!(context.filters(), context.python_list().arg("3.10").env_remove("UV_PYTHON_DOWNLOADS"), @r"
+    success: true
+    exit_code: 0
+    ----- stdout -----
+    cpython-3.10.16-[PLATFORM]    <download available>
+
+    ----- stderr -----
+    ");
+
+    // Show patch versions
+    uv_snapshot!(context.filters(), context.python_list().arg("3.10").arg("--all-versions").env_remove("UV_PYTHON_DOWNLOADS"), @r"
+    success: true
+    exit_code: 0
+    ----- stdout -----
+    cpython-3.10.16-[PLATFORM]    <download available>
+    cpython-3.10.15-[PLATFORM]    <download available>
+    cpython-3.10.14-[PLATFORM]    <download available>
+    cpython-3.10.13-[PLATFORM]    <download available>
+    cpython-3.10.12-[PLATFORM]    <download available>
+    cpython-3.10.11-[PLATFORM]    <download available>
+    cpython-3.10.9-[PLATFORM]     <download available>
+    cpython-3.10.8-[PLATFORM]     <download available>
+    cpython-3.10.7-[PLATFORM]     <download available>
+    cpython-3.10.6-[PLATFORM]     <download available>
+    cpython-3.10.5-[PLATFORM]     <download available>
+    cpython-3.10.4-[PLATFORM]     <download available>
+    cpython-3.10.3-[PLATFORM]     <download available>
+    cpython-3.10.2-[PLATFORM]     <download available>
+    cpython-3.10.0-[PLATFORM]     <download available>
+
+    ----- stderr -----
+    ");
+}
+
+#[test]
+#[cfg(feature = "python-managed")]
+fn python_list_downloads_installed() {
+    use assert_cmd::assert::OutputAssertExt;
+
+    let context: TestContext = TestContext::new_with_versions(&[])
+        .with_filtered_python_keys()
+        .with_filtered_python_names()
+        .with_filtered_python_install_bin()
+        .with_managed_python_dirs();
+
+    // We do not test showing all interpreters — as it differs per platform
+    // Instead, we choose a Python version where our available distributions are stable
+
+    // First, the download is shown as available
+    uv_snapshot!(context.filters(), context.python_list().arg("3.10").env_remove("UV_PYTHON_DOWNLOADS"), @r"
+    success: true
+    exit_code: 0
+    ----- stdout -----
+    cpython-3.10.16-[PLATFORM]    <download available>
+
+    ----- stderr -----
+    ");
+
+    // TODO(zanieb): It'd be nice to test `--show-urls` here too but we need special filtering for
+    // the URL
+
+    // But not if `--only-installed` is used
+    uv_snapshot!(context.filters(), context.python_list().arg("3.10").arg("--only-installed").env_remove("UV_PYTHON_DOWNLOADS"), @r"
+    success: true
+    exit_code: 0
+    ----- stdout -----
+
+    ----- stderr -----
+    ");
+
+    // Install a Python version
+    context.python_install().arg("3.10").assert().success();
+
+    // Then, it should be listed as installed instead of available
+    uv_snapshot!(context.filters(), context.python_list().arg("3.10").env_remove("UV_PYTHON_DOWNLOADS"), @r"
+    success: true
+    exit_code: 0
+    ----- stdout -----
+    cpython-3.10.16-[PLATFORM]    managed/cpython-3.10.16-[PLATFORM]/[INSTALL-BIN]/python
+
+    ----- stderr -----
+    ");
+
+    // But, the display should be reverted if `--only-downloads` is used
+    uv_snapshot!(context.filters(), context.python_list().arg("3.10").arg("--only-downloads").env_remove("UV_PYTHON_DOWNLOADS"), @r"
+    success: true
+    exit_code: 0
+    ----- stdout -----
+    cpython-3.10.16-[PLATFORM]    <download available>
+
+    ----- stderr -----
+    ");
+
+    // And should not be shown if `--no-managed-python` is used
+    uv_snapshot!(context.filters(), context.python_list().arg("3.10").arg("--no-managed-python").env_remove("UV_PYTHON_DOWNLOADS"), @r"
+    success: true
+    exit_code: 0
+    ----- stdout -----
+
+    ----- stderr -----
+    ");
+}