feat: move debug logging behind an environment variable

src/command_helpers.rs

@@ -18,13 +18,15 @@ use crate::{Error, ErrorKind, Object};
 pub(crate) struct CargoOutput {
     pub(crate) metadata: bool,
     pub(crate) warnings: bool,
+    pub(crate) debug: bool,
 }
 
 impl CargoOutput {
-    pub(crate) const fn new() -> Self {
+    pub(crate) fn new() -> Self {
         Self {
             metadata: true,
             warnings: true,
+            debug: std::env::var("CC_ENABLE_DEBUG_OUTPUT").is_ok(),
         }
     }
 
@@ -40,6 +42,13 @@ impl CargoOutput {
         }
     }
 
+    pub(crate) fn print_debug(&self, arg: &dyn Display) {
+        if self.metadata {
+            println!("cargo:rerun-if-env-changed=CC_ENABLE_DEBUG_OUTPUT");
+        }
+        println!("{}", arg);
+    }
+
     fn stdio_for_warnings(&self) -> Stdio {
         if self.warnings {
             Stdio::piped()
@@ -217,7 +226,7 @@ fn wait_on_child(
         }
     };
 
-    cargo_output.print_warning(&status);
+    cargo_output.print_debug(&status);
 
     if status.success() {
         Ok(())
@@ -326,7 +335,7 @@ pub(crate) fn spawn(
         }
     }
 
-    cargo_output.print_warning(&format_args!("running: {:?}", cmd));
+    cargo_output.print_debug(&format_args!("running: {:?}", cmd));
 
     let cmd = ResetStderr(cmd);
     let child = cmd.0.stderr(cargo_output.stdio_for_warnings()).spawn();

src/lib.rs

@@ -1119,6 +1119,16 @@ impl Build {
         self
     }
 
+    /// Define whether compile debug information should be emitted for cargo. Defaults to
+    /// `false`.
+    ///
+    /// If enabled, the compiler will emit debug information when generating object files,
+    /// such as the command invoked and the exit status.
+    pub fn cargo_debug(&mut self, cargo_debug: bool) -> &mut Build {
+        self.cargo_output.debug = cargo_debug;
+        self
+    }
+
     /// Adds a native library modifier that will be added to the
     /// `rustc-link-lib=static:MODIFIERS=LIBRARY_NAME` metadata line
     /// emitted for cargo if `cargo_metadata` is enabled.