feat(commands): add a docs command to easily access the user, dev and config documentation

Cargo.toml

@@ -96,6 +96,7 @@ indicatif = "0.17"
 itertools = "0.13"
 merge = "0.1"
 once_cell = "1.19"
+open = "5.1.2"
 self_update = { version = "0.41", default-features = false, optional = true, features = ["rustls", "archive-tar", "compression-flate2"] }
 toml = "0.8"
 

src/application.rs

@@ -16,6 +16,14 @@ use crate::{commands::EntryPoint, config::RusticConfig};
 /// Application state
 pub static RUSTIC_APP: AppCell<RusticApp> = AppCell::new();
 
+// Constants
+pub mod constants {
+    pub const RUSTIC_DOCS_URL: &str = "https://rustic.cli.rs/docs";
+    pub const RUSTIC_DEV_DOCS_URL: &str = "https://rustic.cli.rs/dev-docs";
+    pub const RUSTIC_CONFIG_DOCS_URL: &str =
+        "https://github.com/rustic-rs/rustic/blob/main/config/README.md";
+}
+
 /// Rustic Application
 #[derive(Debug)]
 pub struct RusticApp {

src/commands.rs

@@ -7,6 +7,7 @@ pub(crate) mod completions;
 pub(crate) mod config;
 pub(crate) mod copy;
 pub(crate) mod diff;
+pub(crate) mod docs;
 pub(crate) mod dump;
 pub(crate) mod find;
 pub(crate) mod forget;
@@ -38,10 +39,11 @@ use crate::commands::webdav::WebDavCmd;
 use crate::{
     commands::{
         backup::BackupCmd, cat::CatCmd, check::CheckCmd, completions::CompletionsCmd,
-        config::ConfigCmd, copy::CopyCmd, diff::DiffCmd, dump::DumpCmd, forget::ForgetCmd,
-        init::InitCmd, key::KeyCmd, list::ListCmd, ls::LsCmd, merge::MergeCmd, prune::PruneCmd,
-        repair::RepairCmd, repoinfo::RepoInfoCmd, restore::RestoreCmd, self_update::SelfUpdateCmd,
-        show_config::ShowConfigCmd, snapshots::SnapshotCmd, tag::TagCmd,
+        config::ConfigCmd, copy::CopyCmd, diff::DiffCmd, docs::DocsCmd, dump::DumpCmd,
+        forget::ForgetCmd, init::InitCmd, key::KeyCmd, list::ListCmd, ls::LsCmd, merge::MergeCmd,
+        prune::PruneCmd, repair::RepairCmd, repoinfo::RepoInfoCmd, restore::RestoreCmd,
+        self_update::SelfUpdateCmd, show_config::ShowConfigCmd, snapshots::SnapshotCmd,
+        tag::TagCmd,
     },
     config::{progress_options::ProgressOptions, AllRepositoryOptions, RusticConfig},
     {Application, RUSTIC_APP},
@@ -95,6 +97,9 @@ enum RusticCmd {
     /// Note that the exclude options only apply for comparison with a local path
     Diff(DiffCmd),
 
+    /// Open the documentation
+    Docs(DocsCmd),
+
     /// dump the contents of a file in a snapshot to stdout
     Dump(DumpCmd),
 

src/commands/docs.rs

@@ -0,0 +1,61 @@
+//! `docs` subcommand
+
+use abscissa_core::{status_err, Application, Command, Runnable, Shutdown};
+use anyhow::Result;
+use clap::Subcommand;
+
+use crate::{
+    application::constants::{RUSTIC_CONFIG_DOCS_URL, RUSTIC_DEV_DOCS_URL, RUSTIC_DOCS_URL},
+    RUSTIC_APP,
+};
+
+#[derive(Command, Debug, Clone, Copy, Default, Subcommand, Runnable)]
+enum DocsTypeSubcommand {
+    #[default]
+    /// Show the user documentation
+    User,
+    /// Show the development documentation
+    Dev,
+    /// Show the configuration documentation
+    Config,
+}
+
+/// Opens the documentation in the default browser.
+#[derive(Clone, Command, Default, Debug, clap::Parser)]
+pub struct DocsCmd {
+    #[clap(subcommand)]
+    cmd: Option<DocsTypeSubcommand>,
+}
+
+impl Runnable for DocsCmd {
+    fn run(&self) {
+        if let Err(err) = self.inner_run() {
+            status_err!("{}", err);
+            RUSTIC_APP.shutdown(Shutdown::Crash);
+        };
+    }
+}
+
+impl DocsCmd {
+    fn inner_run(&self) -> Result<()> {
+        let user_string = match self.cmd {
+            // Default to user docs if no subcommand is provided
+            Some(DocsTypeSubcommand::User) | None => {
+                open::that(RUSTIC_DOCS_URL)?;
+                format!("Opening the user documentation at {RUSTIC_DOCS_URL}")
+            }
+            Some(DocsTypeSubcommand::Dev) => {
+                open::that(RUSTIC_DEV_DOCS_URL)?;
+                format!("Opening the development documentation at {RUSTIC_DEV_DOCS_URL}")
+            }
+            Some(DocsTypeSubcommand::Config) => {
+                open::that(RUSTIC_CONFIG_DOCS_URL)?;
+                format!("Opening the configuration documentation at {RUSTIC_CONFIG_DOCS_URL}")
+            }
+        };
+
+        println!("{user_string}");
+
+        Ok(())
+    }
+}