Enum ColorInitStrategy 

#[non_exhaustive]
pub enum ColorInitStrategy {
    Configure(ColorSupport, TermBgLuma, Option<[u8; 3]>),
    Default,
    Match,
}

Strategies for initializing terminal color attributes and theme selection

This enum defines different approaches for determining the appropriate color support and theme based on terminal capabilities, configuration, or defaults.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Configure(ColorSupport, TermBgLuma, Option<[u8; 3]>)

Use explicitly configured color support, background luminance, and optional background RGB

Parameters:

• ColorSupport: The configured color support level
• TermBgLuma: The configured background luminance (light/dark)
• Option<[u8; 3]>: Optional RGB values for the background color

Default

Use safe default values without detection or configuration

Falls back to basic color support with dark background theme

Match

Automatically detect terminal capabilities and match appropriate theme

Uses terminal detection to determine color support and background luminance, then selects the best matching theme

Implementations

impl ColorInitStrategy

pub fn determine() -> Self

Determines the appropriate color initialization strategy based on available features and configuration.

This method evaluates the current environment and available features to select the most appropriate strategy for initializing terminal color attributes:

• With color_detect feature: Uses auto-detection unless in test environment
• With config feature only: Uses configuration values or falls back to defaults
• Neither feature: Always uses safe defaults

Returns

A static reference to the determined ColorInitStrategy

Behavior

• In test environments (TEST_ENV set): Always returns Default strategy
• On Windows with color_detect: Uses Configure strategy with detected values
• Other platforms with color_detect: Uses Match strategy for auto-detection
• With config only: Uses Configure or Match based on configuration completeness
• No features: Uses Default strategy

Trait Implementations

impl Clone for ColorInitStrategy

fn clone(&self) -> ColorInitStrategy

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ColorInitStrategy

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

Formats the value using the given formatter.