Ban use of print macros in non-test code

With f472bce (Ignore EPIPE in CLI (#746), 2024-07-17) we added the
`_nopipe` variants of the `(e)print(ln)!` macros to avoid panicking when
piping to head(1). However, we do not systematically enforce their use,
which will inevitably lead inconsistent usage within the project.

Add `clippy` lints to ban use of the print macros in all non-test code.
Either the `_nopipe` variants should be used when we don't care if the
input is read, or `write!` when the information is crucial, such as an
interactive session.

Author: wfchandler

cli/src/cmd_auth.rs

@@ -5,6 +5,7 @@
 // Copyright 2024 Oxide Computer Company
 
 use std::fs::File;
+use std::io::{self, Write};
 
 use anyhow::{anyhow, bail, Result};
 use async_trait::async_trait;
@@ -237,12 +238,16 @@ impl CmdAuthLogin {
         };
 
         if opened {
-            println!("Opened this URL in your browser:\n  {}", uri);
+            writeln!(io::stdout(), "Opened this URL in your browser:\n  {}", uri)?;
         } else {
-            println!("Open this URL in your browser:\n  {}", uri);
+            writeln!(io::stdout(), "Open this URL in your browser:\n  {}", uri)?;
         }
 
-        println!("\nEnter the code: {}\n", details.user_code().secret());
+        writeln!(
+            io::stdout(),
+            "\nEnter the code: {}\n",
+            details.user_code().secret()
+        )?;
 
         let token = auth_client
             .exchange_device_access_token(&details)
@@ -357,13 +362,17 @@ impl CmdAuthLogin {
             silo_name,
         } = &user;
 
-        println!("Login successful");
-        println!("  silo: {} ({})", **silo_name, silo_id);
-        println!("  user: {} ({})", display_name, id);
+        writeln!(io::stdout(), "Login successful")?;
+        writeln!(io::stdout(), "  silo: {} ({})", **silo_name, silo_id)?;
+        writeln!(io::stdout(), "  user: {} ({})", display_name, id)?;
         if ctx.config_file().basics.default_profile.is_none() {
-            println!("Profile '{}' set as the default", profile_name);
+            writeln!(
+                io::stdout(),
+                "Profile '{}' set as the default",
+                profile_name
+            )?;
         } else {
-            println!("Use --profile '{}'", profile_name);
+            writeln!(io::stdout(), "Use --profile '{}'", profile_name)?;
         }
 
         Ok(())
@@ -396,7 +405,7 @@ impl CmdAuthLogout {
         if self.all {
             // Clear the entire file for users who want to reset their known hosts.
             let _ = File::create(credentials_path)?;
-            println!("Removed all authentication information");
+            writeln!(io::stdout(), "Removed all authentication information")?;
         } else {
             let profile = ctx
                 .client_config()
@@ -424,10 +433,11 @@ impl CmdAuthLogout {
             });
             std::fs::write(credentials_path, credentials.to_string())
                 .expect("unable to write credentials.toml");
-            println!(
+            writeln!(
+                io::stdout(),
                 "Removed authentication information for profile \"{}\"",
                 profile_name,
-            );
+            )?;
         }
 
         Ok(())

cli/src/cmd_docs.rs

@@ -5,7 +5,7 @@
 // Copyright 2024 Oxide Computer Company
 
 use crate::context::Context;
-use crate::RunnableCmd;
+use crate::{println_nopipe, RunnableCmd};
 
 use super::cmd_version::built_info;
 use anyhow::Result;
@@ -97,7 +97,7 @@ impl RunnableCmd for CmdDocs {
         app.build();
         let json_doc = to_json(&app);
         let pretty_json = serde_json::to_string_pretty(&json_doc)?;
-        println!("{}", pretty_json);
+        println_nopipe!("{}", pretty_json);
         Ok(())
     }
 }

cli/src/cmd_instance.rs

@@ -14,6 +14,7 @@ use oxide::types::{
 
 use oxide::ClientInstancesExt;
 use oxide::{Client, ClientImagesExt};
+use std::io::{self, Write};
 use std::path::PathBuf;
 
 /// Connect to or retrieve data from the instance's serial console.
@@ -196,7 +197,7 @@ impl CmdInstanceSerialHistory {
         let data = req.send().await.map_err(|e| e.into_untyped())?.into_inner();
 
         if self.json {
-            println!("{}", serde_json::to_string(&data)?);
+            writeln!(io::stdout(), "{}", serde_json::to_string(&data)?)?;
         } else {
             let mut tty = thouart::Console::new_stdio(None).await?;
             tty.write_stdout(&data.data).await?;

cli/src/main.rs

@@ -5,6 +5,7 @@
 // Copyright 2024 Oxide Computer Company
 
 #![forbid(unsafe_code)]
+#![cfg_attr(not(test), deny(clippy::print_stdout, clippy::print_stderr))]
 
 use std::io;
 use std::net::IpAddr;