fix(log): drop noisy third-party debug/trace logs

docs/configuration.md

@@ -566,6 +566,14 @@ to store the logs but not have them litter your display.
 
 Display HTTP requests/responses in the logs.
 
+### `MISE_LOG_VERBOSE_DEPS=1`
+
+By default, `mise -v` (debug level) suppresses debug logs from noisy
+third-party crates (`h2`, `hyper`, `reqwest`, `rustls`, etc.) that emit a line
+per HTTP/2 frame or socket read. Set this to `1` to let those logs through at
+debug level — or use `-vv`/`MISE_LOG_LEVEL=trace`, which always includes
+them.
+
 ### `MISE_QUIET=1`
 
 Equivalent to `MISE_LOG_LEVEL=warn`.

src/env.rs

@@ -355,6 +355,7 @@ pub static MISE_SELF_UPDATE_DISABLED_PATH: Lazy<Option<PathBuf>> = Lazy::new(||
     )
 });
 pub static MISE_LOG_HTTP: Lazy<bool> = Lazy::new(|| var_is_true("MISE_LOG_HTTP"));
+pub static MISE_LOG_VERBOSE_DEPS: Lazy<bool> = Lazy::new(|| var_is_true("MISE_LOG_VERBOSE_DEPS"));
 
 pub static __USAGE: Lazy<Option<String>> = Lazy::new(|| var("__USAGE").ok());
 

src/logger.rs

@@ -18,15 +18,52 @@ struct Logger {
     log_file: Option<Mutex<File>>,
 }
 
+/// Third-party crate targets that emit very noisy debug logs (often per HTTP/2
+/// frame, per socket read, etc.) and would otherwise overwhelm `-v` output.
+/// These are suppressed at Debug level unless `MISE_LOG_VERBOSE_DEPS=1` is set.
+/// Trace level always lets them through.
+const NOISY_DEP_TARGETS: &[&str] = &[
+    "h2",
+    "hyper",
+    "hyper_util",
+    "mio",
+    "reqwest",
+    "rustls",
+    "tokio_util",
+    "tower",
+    "want",
+];
+
+fn is_noisy_dep_target(target: &str) -> bool {
+    NOISY_DEP_TARGETS
+        .iter()
+        .any(|t| target == *t || target.starts_with(&format!("{t}::")))
+}
+
 impl log::Log for Logger {
     fn enabled(&self, metadata: &Metadata) -> bool {
         metadata.level() <= *self.level.lock().unwrap()
     }
 
     fn log(&self, record: &Record) {
         let term_level = *self.term_level.lock().unwrap();
-        let will_log_file = record.level() <= self.file_level && self.log_file.is_some();
-        let will_log_term = record.level() <= term_level;
+        let mut will_log_file = record.level() <= self.file_level && self.log_file.is_some();
+        let mut will_log_term = record.level() <= term_level;
+
+        // Suppress Debug-level spam from noisy third-party crates (e.g. h2
+        // logging every received DATA frame). Trace still passes through, as
+        // does any level when MISE_LOG_VERBOSE_DEPS=1.
+        if record.level() == Level::Debug
+            && !*env::MISE_LOG_VERBOSE_DEPS
+            && is_noisy_dep_target(record.target())
+        {
+            if self.file_level < LevelFilter::Trace {
+                will_log_file = false;
+            }
+            if term_level < LevelFilter::Trace {
+                will_log_term = false;
+            }
+        }
 
         if !will_log_file && !will_log_term {
             return;