Merge pull request #5636 from gibfahn/styles_const

refactor(styles): make styles example use a const

Author: epage

Cargo.lock

@@ -63,7 +63,7 @@ clap_lex = { path = "../clap_lex", version = "0.7.0" }
 unicase = { version = "2.6.0", optional = true }
 strsim = { version = "0.11.0",  optional = true }
 anstream = { version = "0.6.7", optional = true }
-anstyle = "1.0.0"
+anstyle = "1.0.8"
 terminal_size = { version = "0.3.0", optional = true }
 backtrace = { version = "0.3.73", optional = true }
 unicode-width = { version = "0.1.9", optional = true }

clap_builder/Cargo.toml

@@ -1199,13 +1199,13 @@ impl Command {
     /// ```no_run
     /// # use clap_builder as clap;
     /// # use clap::{Command, ColorChoice, builder::styling};
-    /// let styles = styling::Styles::styled()
-    ///     .header(styling::AnsiColor::Green.on_default() | styling::Effects::BOLD)
-    ///     .usage(styling::AnsiColor::Green.on_default() | styling::Effects::BOLD)
-    ///     .literal(styling::AnsiColor::Blue.on_default() | styling::Effects::BOLD)
+    /// const STYLES: styling::Styles = styling::Styles::styled()
+    ///     .header(styling::AnsiColor::Green.on_default().bold())
+    ///     .usage(styling::AnsiColor::Green.on_default().bold())
+    ///     .literal(styling::AnsiColor::Blue.on_default().bold())
     ///     .placeholder(styling::AnsiColor::Cyan.on_default());
     /// Command::new("myprog")
-    ///     .styles(styles)
+    ///     .styles(STYLES)
     ///     .get_matches();
     /// ```
     #[cfg(feature = "color")]

clap_builder/src/builder/command.rs

@@ -15,12 +15,12 @@ fn main() {
     #[cfg(feature = "color")]
     {
         use clap::builder::styling;
-        let styles = styling::Styles::styled()
-            .header(styling::AnsiColor::Green.on_default() | styling::Effects::BOLD)
-            .usage(styling::AnsiColor::Green.on_default() | styling::Effects::BOLD)
-            .literal(styling::AnsiColor::Blue.on_default() | styling::Effects::BOLD)
+        const STYLES: styling::Styles = styling::Styles::styled()
+            .header(styling::AnsiColor::Green.on_default().bold())
+            .usage(styling::AnsiColor::Green.on_default().bold())
+            .literal(styling::AnsiColor::Blue.on_default().bold())
             .placeholder(styling::AnsiColor::Cyan.on_default());
-        cmd = cmd.styles(styles);
+        cmd = cmd.styles(STYLES);
     }
     cmd.get_matches();
 }