move usage dumping for readme to mod dump_usage

Author: Firestar99

crates/cargo-gpu/src/dump_usage.rs

@@ -0,0 +1,51 @@
+//! Convenience function for internal use. Dumps all the CLI usage instructions. Useful for
+//! updating the README.
+
+use crate::{user_output, Cli};
+
+/// main dump usage function
+pub fn dump_full_usage_for_readme() -> anyhow::Result<()> {
+    use clap::CommandFactory as _;
+    let mut command = Cli::command();
+
+    let mut buffer: Vec<u8> = Vec::default();
+    command.build();
+
+    write_help(&mut buffer, &mut command, 0)?;
+    user_output!("{}", String::from_utf8(buffer)?);
+
+    Ok(())
+}
+
+/// Recursive function to print the usage instructions for each subcommand.
+fn write_help(
+    buffer: &mut impl std::io::Write,
+    cmd: &mut clap::Command,
+    depth: usize,
+) -> anyhow::Result<()> {
+    if cmd.get_name() == "help" {
+        return Ok(());
+    }
+
+    let mut command = cmd.get_name().to_owned();
+    let indent_depth = if depth == 0 || depth == 1 { 0 } else { depth };
+    let indent = " ".repeat(indent_depth * 4);
+    writeln!(
+        buffer,
+        "\n{}* {}{}",
+        indent,
+        command.remove(0).to_uppercase(),
+        command
+    )?;
+
+    for line in cmd.render_long_help().to_string().lines() {
+        writeln!(buffer, "{indent}  {line}")?;
+    }
+
+    for sub in cmd.get_subcommands_mut() {
+        writeln!(buffer)?;
+        write_help(buffer, sub, depth + 1)?;
+    }
+
+    Ok(())
+}

crates/cargo-gpu/src/main.rs

@@ -50,13 +50,15 @@
 
 use anyhow::Context as _;
 
+use crate::dump_usage::dump_full_usage_for_readme;
 use build::Build;
 use clap::Parser as _;
 use install::Install;
 use show::Show;
 
 mod build;
 mod config;
+mod dump_usage;
 mod install;
 mod install_toolchain;
 mod legacy_target_specs;
@@ -209,54 +211,6 @@ fn cache_dir() -> anyhow::Result<std::path::PathBuf> {
     })
 }
 
-/// Convenience function for internal use. Dumps all the CLI usage instructions. Useful for
-/// updating the README.
-fn dump_full_usage_for_readme() -> anyhow::Result<()> {
-    use clap::CommandFactory as _;
-    let mut command = Cli::command();
-
-    let mut buffer: Vec<u8> = Vec::default();
-    command.build();
-
-    write_help(&mut buffer, &mut command, 0)?;
-    user_output!("{}", String::from_utf8(buffer)?);
-
-    Ok(())
-}
-
-/// Recursive function to print the usage instructions for each subcommand.
-fn write_help(
-    buffer: &mut impl std::io::Write,
-    cmd: &mut clap::Command,
-    depth: usize,
-) -> anyhow::Result<()> {
-    if cmd.get_name() == "help" {
-        return Ok(());
-    }
-
-    let mut command = cmd.get_name().to_owned();
-    let indent_depth = if depth == 0 || depth == 1 { 0 } else { depth };
-    let indent = " ".repeat(indent_depth * 4);
-    writeln!(
-        buffer,
-        "\n{}* {}{}",
-        indent,
-        command.remove(0).to_uppercase(),
-        command
-    )?;
-
-    for line in cmd.render_long_help().to_string().lines() {
-        writeln!(buffer, "{indent}  {line}")?;
-    }
-
-    for sub in cmd.get_subcommands_mut() {
-        writeln!(buffer)?;
-        write_help(buffer, sub, depth + 1)?;
-    }
-
-    Ok(())
-}
-
 /// Returns a string suitable to use as a directory.
 ///
 /// Created from the spirv-builder source dep and the rustc channel.