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
     }

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_virtualenv_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]/[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 -----
+    ");
+}