Struct TermAttributes 

pub struct TermAttributes {
    pub init_strategy: ColorInitStrategy,
    pub how_initialized: HowInitialized,
    pub color_support: ColorSupport,
    pub term_bg_hex: Option<String>,
    pub term_bg_rgb: Option<[u8; 3]>,
    pub term_bg_luma: TermBgLuma,
    pub theme: Theme,
}

Manages terminal color attributes and styling based on terminal capabilities and theme The complete styling attributes for terminal output

Fields

init_strategy: ColorInitStrategy

The initialization strategy used

how_initialized: HowInitialized

Indicates how the terminal attributes were initialized (configured, defaulted, or detected)

color_support: ColorSupport

The level of color support available in the terminal

term_bg_hex: Option<String>

The terminal background color as a hex string (e.g., “#1e1e1e”)

term_bg_rgb: Option<[u8; 3]>

The terminal background color as RGB values (red, green, blue)

term_bg_luma: TermBgLuma

The luminance (light/dark) of the terminal background

theme: Theme

The theme used for styling text and interface elements

Implementations

impl TermAttributes

pub fn is_initialized() -> bool

Checks if TermAttributes has been initialized

pub fn try_get() -> Option<&'static Self>

Attempts to get the TermAttributes instance, returning None if not initialized

pub fn get_or_init() -> &'static Self

Gets the TermAttributes instance, initializing with auto-determined strategy if necessary.

This method uses ColorInitStrategy::determine() to automatically choose the best initialization strategy based on available features and environment.

If not already initialized:

• With color_detect feature: performs auto-detection
• Without color_detect: uses safe defaults

Returns

Reference to the TermAttributes instance

Panics

Panics if theme initialization fails

pub fn with_context<F, R>(&self, f: F) -> R

where F: FnOnce() -> R,

Execute a closure with a temporary TermAttributes context This allows testing and temporary overrides without affecting the global state

pub fn current() -> Self

Gets the current context, falling back to the global instance if no context is set

pub fn try_initialize_with_strategy( strategy: &ColorInitStrategy, ) -> Result<&'static Self, String>

Initialize with a specific strategy, for testing and special cases

Returns Ok if successfully initialized or if already initialized with a compatible strategy. Returns Err if already initialized with an incompatible strategy.

Arguments

• strategy - The specific ColorInitStrategy to use

Returns

• Ok(&'static Self) - Reference to the TermAttributes instance
• Err(String) - Error message if incompatible strategy already used

Errors

This function will return an error if the instance is already initialized with an incompatible strategy..

pub fn get_or_init_with_strategy(strategy: &ColorInitStrategy) -> &'static Self

Gets or initializes TermAttributes with the specified strategy

This method initializes TermAttributes with the given strategy if not already initialized, or returns the existing instance if already initialized (regardless of the original strategy).

This is the recommended method when you need a specific initialization strategy.

Arguments

• strategy - The ColorInitStrategy to use for initialization

Returns

Reference to the TermAttributes instance

Panics

Panics if theme initialization fails

pub fn for_testing( color_support: ColorSupport, term_bg_rgb: Option<[u8; 3]>, term_bg_luma: TermBgLuma, theme: Theme, ) -> Self

Creates a new TermAttributes instance for testing purposes

pub fn with_theme( self, theme_name: &str, support: ColorSupport, ) -> StylingResult<Self>

Updates the current theme to the specified built-in theme.

Arguments

• theme_name - Name of the built-in theme to use

Returns

The updated TermAttributes instance

Errors

Returns a ThemeError if:

• The specified theme name is not recognized
• The theme file is corrupted or invalid
• The theme is incompatible with current terminal capabilities
• Theme validation fails

pub const fn with_color_support(self, support: ColorSupport) -> Self

Creates a new instance with the specified color support level

Arguments

• support - The color support level to set

Returns

A new TermAttributes instance with the updated color support

Trait Implementations

impl Clone for TermAttributes

fn clone(&self) -> TermAttributes

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for TermAttributes

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.