Struct Colors 

pub struct Colors;

Theme-aware color wrapper.

Use these instead of direct .green(), .red(), etc. to respect the active theme. Each method takes a string and a Theme, returning a styled string that adapts to the theme’s color palette.

Example

use netspeed_cli::theme::{Colors, Theme};

// Monochrome always returns plain text (no ANSI escapes)
assert_eq!(Colors::good("OK", Theme::Monochrome), "OK");
assert_eq!(Colors::warn("caution", Theme::Monochrome), "caution");
assert_eq!(Colors::bad("FAIL", Theme::Monochrome), "FAIL");
assert_eq!(Colors::info("note", Theme::Monochrome), "note");

// Other themes add ANSI styling but always preserve the original text
assert!(Colors::good("OK", Theme::Dark).contains("OK"));
assert!(Colors::bad("FAIL", Theme::Light).contains("FAIL"));

Implementations

impl Colors

pub fn good(s: &str, theme: Theme) -> String

Good/success color.

Green in Dark/HighContrast/Light themes, plain text in Monochrome.

Example

use netspeed_cli::theme::{Colors, Theme};

// Monochrome: plain text
assert_eq!(Colors::good("100 Mbps", Theme::Monochrome), "100 Mbps");

// Dark/Light/HighContrast: styled with green (contains the text)
assert!(Colors::good("100 Mbps", Theme::Dark).contains("100 Mbps"));
assert!(Colors::good("100 Mbps", Theme::Light).contains("100 Mbps"));

pub fn warn(s: &str, theme: Theme) -> String

Warning/caution color.

Yellow in Dark/HighContrast/Light themes, plain text in Monochrome.

Example

use netspeed_cli::theme::{Colors, Theme};

assert_eq!(Colors::warn("high latency", Theme::Monochrome), "high latency");
assert!(Colors::warn("high latency", Theme::Dark).contains("high latency"));

pub fn bad(s: &str, theme: Theme) -> String

Error/bad color.

Red in Dark/HighContrast/Light themes, plain text in Monochrome.

Example

use netspeed_cli::theme::{Colors, Theme};

assert_eq!(Colors::bad("FAILED", Theme::Monochrome), "FAILED");
assert!(Colors::bad("FAILED", Theme::Dark).contains("FAILED"));

pub fn info(s: &str, theme: Theme) -> String

Info/neutral color (cyan/blue).

Cyan in Dark/HighContrast, blue in Light, plain text in Monochrome.

Example

use netspeed_cli::theme::{Colors, Theme};

assert_eq!(Colors::info("Server: 1234", Theme::Monochrome), "Server: 1234");
assert!(Colors::info("Server: 1234", Theme::Dark).contains("Server: 1234"));
assert!(Colors::info("Server: 1234", Theme::Light).contains("Server: 1234"));

pub fn dimmed(s: &str, theme: Theme) -> String

Dimmed/secondary text.

Dimmed in Dark/Light, plain text in HighContrast/Monochrome (kept readable at high contrast).

Example

use netspeed_cli::theme::{Colors, Theme};

// Monochrome and HighContrast: plain text (readability over style)
assert_eq!(Colors::dimmed("secondary", Theme::Monochrome), "secondary");
assert_eq!(Colors::dimmed("secondary", Theme::HighContrast), "secondary");

// Dark/Light: dimmed styling (contains the text)
assert!(Colors::dimmed("secondary", Theme::Dark).contains("secondary"));
assert!(Colors::dimmed("secondary", Theme::Light).contains("secondary"));

pub fn bold(s: &str, _theme: Theme) -> String

Bold/emphasized text.

Always applies bold regardless of theme (theme parameter reserved for future theme-specific bold behavior).

Example

use netspeed_cli::theme::{Colors, Theme};

// Bold always contains the original text
assert!(Colors::bold("important", Theme::Dark).contains("important"));
assert!(Colors::bold("important", Theme::Light).contains("important"));
assert!(Colors::bold("important", Theme::Monochrome).contains("important"));

pub fn muted(s: &str, theme: Theme) -> String

Muted/secondary text (bright_black equivalent).

Bright black in Dark/HighContrast, dimmed in Light, plain in Monochrome.

Example

use netspeed_cli::theme::{Colors, Theme};

// Monochrome: plain text
assert_eq!(Colors::muted("hint", Theme::Monochrome), "hint");

// Other themes contain the original text
assert!(Colors::muted("hint", Theme::Dark).contains("hint"));
assert!(Colors::muted("hint", Theme::Light).contains("hint"));
assert!(Colors::muted("hint", Theme::HighContrast).contains("hint"));

pub fn header(s: &str, theme: Theme) -> String

Header/section title color.

Cyan+bold+underline in Dark/HighContrast, blue+bold+underline in Light, plain text in Monochrome (no color/underline).

Example

use netspeed_cli::theme::{Colors, Theme};

// Monochrome: plain text (no color/underline)
assert!(Colors::header("Results", Theme::Monochrome).contains("Results"));

// Dark: cyan + bold + underline
assert!(Colors::header("Results", Theme::Dark).contains("Results"));

// Light: blue + bold + underline
assert!(Colors::header("Results", Theme::Light).contains("Results"));