CLI - Add feature to print markdown docs

Cargo.toml

@@ -140,6 +140,7 @@ bytestring = { version = "1.2.0", features = ["serde"] }
 cargo_metadata = "0.17.0"
 chrono = { version = "0.4.24", default-features = false }
 clap = { version = "4.2.4", features = ["derive", "wrap_help"] }
+clap-markdown = "0.1.4"
 colored = "2.0.0"
 console = { version = "0.15.6" }
 convert_case = "0.6.0"

crates/cli/Cargo.toml

@@ -6,6 +6,9 @@ license-file = "LICENSE"
 description = "A command line interface for SpacetimeDB"
 rust-version.workspace = true
 
+[features]
+markdown-docs = []
+
 [lib]
 bench = false
 
@@ -70,6 +73,7 @@ walkdir.workspace = true
 wasmbin.workspace = true
 wasmtime.workspace = true
 webbrowser.workspace = true
+clap-markdown.workspace = true
 
 [target.'cfg(windows)'.dependencies]
 windows-sys = { workspace = true, features = ["Win32_System_Console"] }

crates/cli/src/main.rs

@@ -9,6 +9,7 @@ use spacetimedb_paths::{RootDir, SpacetimePaths};
 #[global_allocator]
 static GLOBAL: MiMalloc = MiMalloc;
 
+#[cfg(not(feature = "markdown-docs"))]
 #[tokio::main]
 async fn main() -> anyhow::Result<ExitCode> {
     // Compute matches before loading the config, because `Config` has an observable `drop` method
@@ -31,6 +32,14 @@ async fn main() -> anyhow::Result<ExitCode> {
     exec_subcommand(config, &paths, root_dir, cmd, subcommand_args).await
 }
 
+#[cfg(feature = "markdown-docs")]
+#[tokio::main]
+async fn main() -> anyhow::Result<ExitCode> {
+    let markdown = clap_markdown::help_markdown_command(&get_command());
+    println!("{}", markdown);
+    Ok(ExitCode::SUCCESS)
+}
+
 fn get_command() -> Command {
     Command::new("spacetime")
         .version(version::CLI_VERSION)