Implement --show-version-specifiers for tool list

crates/uv-cli/src/lib.rs

@@ -3164,6 +3164,8 @@ pub struct ToolListArgs {
     /// Whether to display the path to each tool environment and installed executable.
     #[arg(long)]
     pub show_paths: bool,
+    #[arg(long)]
+    pub show_version_specifiers: bool,
 
     // Hide unused global Python options.
     #[arg(long, hide = true)]

crates/uv/src/commands/tool/list.rs

@@ -12,7 +12,12 @@ use crate::commands::ExitStatus;
 use crate::printer::Printer;
 
 /// List installed tools.
-pub(crate) async fn list(show_paths: bool, cache: &Cache, printer: Printer) -> Result<ExitStatus> {
+pub(crate) async fn list(
+    show_paths: bool,
+    show_version_specifiers: bool,
+    cache: &Cache,
+    printer: Printer,
+) -> Result<ExitStatus> {
     let installed_tools = InstalledTools::from_settings()?;
     let _lock = match installed_tools.lock().await {
         Ok(lock) => lock,
@@ -50,15 +55,30 @@ pub(crate) async fn list(show_paths: bool, cache: &Cache, printer: Printer) -> R
             }
         };
 
+        let mut version_specifier = String::new();
+        if show_version_specifiers {
+            if let Some(source) = tool.requirements().iter().find_map(|req| {
+                (req.name == name)
+                    .then_some(req.source.to_string())
+                    .filter(|s| !s.is_empty())
+            }) {
+                version_specifier.push_str(&format!(r#" (specifier: "{source}")"#));
+            }
+        }
+
         if show_paths {
             writeln!(
                 printer.stdout(),
                 "{} ({})",
-                format!("{name} v{version}").bold(),
-                installed_tools.tool_dir(&name).simplified_display().cyan()
+                format!("{name} v{version}{version_specifier}").bold(),
+                installed_tools.tool_dir(&name).simplified_display().cyan(),
             )?;
         } else {
-            writeln!(printer.stdout(), "{}", format!("{name} v{version}").bold())?;
+            writeln!(
+                printer.stdout(),
+                "{}",
+                format!("{name} v{version}{version_specifier}").bold()
+            )?;
         }
 
         // Output tool entrypoints

crates/uv/src/commands/tool/run.rs

@@ -80,7 +80,7 @@ pub(crate) async fn run(
 ) -> anyhow::Result<ExitStatus> {
     // treat empty command as `uv tool list`
     let Some(command) = command else {
-        return tool_list(false, &cache, printer).await;
+        return tool_list(false, false, &cache, printer).await;
     };
 
     let (target, args) = command.split();

crates/uv/src/lib.rs

@@ -872,7 +872,13 @@ async fn run(cli: Cli) -> Result<ExitStatus> {
             // Initialize the cache.
             let cache = cache.init()?;
 
-            commands::tool_list(args.show_paths, &cache, printer).await
+            commands::tool_list(
+                args.show_paths,
+                args.show_version_specifiers,
+                &cache,
+                printer,
+            )
+            .await
         }
         Commands::Tool(ToolNamespace {
             command: ToolCommand::Upgrade(args),

crates/uv/src/settings.rs

@@ -457,15 +457,23 @@ impl ToolUpgradeSettings {
 #[derive(Debug, Clone)]
 pub(crate) struct ToolListSettings {
     pub(crate) show_paths: bool,
+    pub(crate) show_version_specifiers: bool,
 }
 
 impl ToolListSettings {
     /// Resolve the [`ToolListSettings`] from the CLI and filesystem configuration.
     #[allow(clippy::needless_pass_by_value)]
     pub(crate) fn resolve(args: ToolListArgs, _filesystem: Option<FilesystemOptions>) -> Self {
-        let ToolListArgs { show_paths, .. } = args;
+        let ToolListArgs {
+            show_paths,
+            show_version_specifiers,
+            ..
+        } = args;
 
-        Self { show_paths }
+        Self {
+            show_paths,
+            show_version_specifiers,
+        }
     }
 }
 

crates/uv/tests/tool_list.rs

@@ -252,3 +252,46 @@ fn tool_list_deprecated() -> Result<()> {
 
     Ok(())
 }
+
+#[test]
+fn tool_list_show_version_specifiers() {
+    let context = TestContext::new("3.12").with_filtered_exe_suffix();
+    let tool_dir = context.temp_dir.child("tools");
+    let bin_dir = context.temp_dir.child("bin");
+
+    // Install `black`
+    context
+        .tool_install()
+        .arg("black<24.3.0")
+        .env("UV_TOOL_DIR", tool_dir.as_os_str())
+        .env("XDG_BIN_HOME", bin_dir.as_os_str())
+        .assert()
+        .success();
+
+    uv_snapshot!(context.filters(), context.tool_list().arg("--show-version-specifiers")
+    .env("UV_TOOL_DIR", tool_dir.as_os_str())
+    .env("XDG_BIN_HOME", bin_dir.as_os_str()), @r###"
+    success: true
+    exit_code: 0
+    ----- stdout -----
+    black v24.2.0 (specifier: "<24.3.0")
+    - black
+    - blackd
+
+    ----- stderr -----
+    "###);
+
+    // with paths
+    uv_snapshot!(context.filters(), context.tool_list().arg("--show-version-specifiers").arg("--show-paths")
+    .env("UV_TOOL_DIR", tool_dir.as_os_str())
+    .env("XDG_BIN_HOME", bin_dir.as_os_str()), @r###"
+    success: true
+    exit_code: 0
+    ----- stdout -----
+    black v24.2.0 (specifier: "<24.3.0") ([TEMP_DIR]/tools/black)
+    - black ([TEMP_DIR]/bin/black)
+    - blackd ([TEMP_DIR]/bin/blackd)
+
+    ----- stderr -----
+    "###);
+}

docs/reference/cli.md

@@ -3141,7 +3141,7 @@ uv tool list [OPTIONS]
 
 </dd><dt><code>--show-paths</code></dt><dd><p>Whether to display the path to each tool environment and installed executable</p>
 
-</dd><dt><code>--verbose</code>, <code>-v</code></dt><dd><p>Use verbose output.</p>
+</dd><dt><code>--show-version-specifiers</code></dt><dt><code>--verbose</code>, <code>-v</code></dt><dd><p>Use verbose output.</p>
 
 <p>You can configure fine-grained logging using the <code>RUST_LOG</code> environment variable. (&lt;https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives&gt;)</p>