Continue massaging CLI docs, finish the publisher part of #27

rabbitmq · Dec 24, 2024 · 7ac9dfd · 7ac9dfd
1 parent 69b07c5
commit 7ac9dfd
Show file tree

Hide file tree

Showing 2 changed files with 5 additions and 1 deletion.
diff --git a/src/cli.rs b/src/cli.rs
@@ -241,7 +241,8 @@ pub fn parser() -> Command {
                 .subcommand_value_name("definitions")
                 .subcommands(import_subcommands()),
             Command::new("publish")
-                .about("publish a message")
+                .about(color_print::cstr!("Publishes (<red>inefficiently</red>) message(s) to a queue or a stream. <bold><red>Only suitable for development and test environments</red></bold>."))
+                .after_long_help(color_print::cformat!("<bold>Doc guide</bold>: {}", PUBLISHER_GUIDE_URL))
                 .subcommand_value_name("message")
                 .subcommands(publish_subcommands()),
             Command::new("get")
@@ -963,6 +964,8 @@ fn import_subcommands() -> [Command; 1] {
 pub fn publish_subcommands() -> [Command; 1] {
     [Command::new("message")
         .about("Publishes a message to an exchange")
+        .about(color_print::cstr!("Publishes (<red>inefficiently</red>) message(s) to a queue or a stream. <bold><red>Only suitable for development and test environments</red></bold>. Prefer messaging or streaming protocol clients!"))
+        .after_long_help(color_print::cformat!("<bold>Doc guide</bold>: {}", PUBLISHER_GUIDE_URL))
         .arg(
             Arg::new("routing_key")
                 .short('k')

diff --git a/src/static_urls.rs b/src/static_urls.rs
@@ -38,3 +38,4 @@ pub(crate) const HTTP_API_ACCESS_PERMISSIONS_GUIDE_URL: &str =
 pub(crate) const DEFINITION_GUIDE_URL: &str = "https://rabbitmq.com/docs/definitions";
 pub(crate) const CONSUMER_GUIDE_URL: &str = "https://rabbitmq.com/docs/consumers";
 pub(crate) const POLLING_CONSUMER_GUIDE_URL: &str = "https://rabbitmq.com/docs/consumers#polling";
+pub(crate) const PUBLISHER_GUIDE_URL: &str = "https://rabbitmq.com/docs/publishers";