rework log verbosity (-vvv)

crates/uv-static/src/env_vars.rs

@@ -548,6 +548,9 @@ impl EnvVars {
     /// for more.
     pub const RUST_LOG: &'static str = "RUST_LOG";
 
+    /// Give log messages more detailed context
+    pub const UV_LOG_CONTEXT: &'static str = "UV_LOG_CONTEXT";
+
     /// Use to set the stack size used by uv.
     ///
     /// The value is in bytes, and the default is typically 2MB (2097152).

crates/uv/src/lib.rs

@@ -279,9 +279,10 @@ async fn run(mut cli: Cli) -> Result<ExitStatus> {
     let duration_layer = None::<tracing_subscriber::layer::Identity>;
     logging::setup_logging(
         match globals.verbose {
-            0 => logging::Level::Default,
-            1 => logging::Level::Verbose,
-            2.. => logging::Level::ExtraVerbose,
+            0 => logging::Level::Off,
+            1 => logging::Level::DebugUv,
+            2 => logging::Level::TraceUv,
+            3.. => logging::Level::TraceAll,
         },
         duration_layer,
         globals.color,

crates/uv/src/logging.rs

@@ -20,18 +20,15 @@ use tracing_tree::time::Uptime;
 use tracing_tree::HierarchicalLayer;
 
 use uv_cli::ColorChoice;
-#[cfg(feature = "tracing-durations-export")]
 use uv_static::EnvVars;
 
 #[derive(Debug, Default, Clone, Copy, PartialEq, Eq)]
 pub(crate) enum Level {
-    /// Suppress all tracing output by default (overridable by `RUST_LOG`).
     #[default]
-    Default,
-    /// Show debug messages by default (overridable by `RUST_LOG`).
-    Verbose,
-    /// Show messages in a hierarchical span tree. By default, debug messages are shown (overridable by `RUST_LOG`).
-    ExtraVerbose,
+    Off,
+    DebugUv,
+    TraceUv,
+    TraceAll,
 }
 
 struct UvFormat {
@@ -120,15 +117,24 @@ pub(crate) fn setup_logging(
     durations: impl Layer<Registry> + Send + Sync,
     color: ColorChoice,
 ) -> anyhow::Result<()> {
+    // We use directives here to ensure `RUST_LOG` can override them
     let default_directive = match level {
-        Level::Default => {
-            // Show nothing, but allow `RUST_LOG` to override.
+        Level::Off => {
+            // Show nothing
             tracing::level_filters::LevelFilter::OFF.into()
         }
-        Level::Verbose | Level::ExtraVerbose => {
-            // Show `DEBUG` messages from the CLI crate, but allow `RUST_LOG` to override.
+        Level::DebugUv => {
+            // Show `DEBUG` messages from the CLI crate (and ERROR/WARN/INFO)
             Directive::from_str("uv=debug").unwrap()
         }
+        Level::TraceUv => {
+            // Show `TRACE` messages from the CLI crate (and ERROR/WARN/INFO/DEBUG)
+            Directive::from_str("uv=trace").unwrap()
+        }
+        Level::TraceAll => {
+            // Show all `TRACE` messages (and ERROR/WARN/INFO/DEBUG)
+            Directive::from_str("trace").unwrap()
+        }
     };
 
     // Only record our own spans.
@@ -160,40 +166,38 @@ pub(crate) fn setup_logging(
         };
     let writer = std::sync::Mutex::new(anstream::AutoStream::new(std::io::stderr(), color_choice));
 
-    match level {
-        Level::Default | Level::Verbose => {
-            // Regardless of the tracing level, show messages without any adornment.
-            let format = UvFormat {
-                display_timestamp: false,
-                display_level: true,
-                show_spans: false,
-            };
-
-            tracing_subscriber::registry()
-                .with(durations_layer)
-                .with(
-                    tracing_subscriber::fmt::layer()
-                        .event_format(format)
-                        .with_writer(writer)
-                        .with_ansi(ansi)
-                        .with_filter(filter),
-                )
-                .init();
-        }
-        Level::ExtraVerbose => {
-            // Regardless of the tracing level, include the uptime and target for each message.
-            tracing_subscriber::registry()
-                .with(durations_layer)
-                .with(
-                    HierarchicalLayer::default()
-                        .with_targets(true)
-                        .with_timer(Uptime::default())
-                        .with_writer(writer)
-                        .with_ansi(ansi)
-                        .with_filter(filter),
-                )
-                .init();
-        }
+    let detailed_logging = std::env::var(EnvVars::UV_LOG_CONTEXT).is_ok();
+    if detailed_logging {
+        // Regardless of the tracing level, include the uptime and target for each message.
+        tracing_subscriber::registry()
+            .with(durations_layer)
+            .with(
+                HierarchicalLayer::default()
+                    .with_targets(true)
+                    .with_timer(Uptime::default())
+                    .with_writer(writer)
+                    .with_ansi(ansi)
+                    .with_filter(filter),
+            )
+            .init();
+    } else {
+        // Regardless of the tracing level, show messages without any adornment.
+        let format = UvFormat {
+            display_timestamp: false,
+            display_level: true,
+            show_spans: false,
+        };
+
+        tracing_subscriber::registry()
+            .with(durations_layer)
+            .with(
+                tracing_subscriber::fmt::layer()
+                    .event_format(format)
+                    .with_writer(writer)
+                    .with_ansi(ansi)
+                    .with_filter(filter),
+            )
+            .init();
     }
 
     Ok(())

docs/configuration/environment.md

@@ -173,6 +173,10 @@ a link mode.
 Equivalent to the `--locked` command-line argument. If set, uv will assert that the
 `uv.lock` remains unchanged.
 
+### `UV_LOG_CONTEXT`
+
+Give log messages more detailed context
+
 ### `UV_NATIVE_TLS`
 
 Equivalent to the `--native-tls` command-line argument. If set to `true`, uv will