ferrum-email-core 0.1.5

Core types, traits, and node tree for the Ferrum Email framework
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65

//! Color type for the Ferrum Email framework.
//!
//! Provides a type-safe color representation supporting hex, RGB, and named colors.

use std::fmt;

/// A color value for use in email styles.
#[derive(Debug, Clone, PartialEq)]
pub enum Color {
    /// Hex color (stored without the `#` prefix).
    Hex(String),
    /// RGB color.
    Rgb(u8, u8, u8),
    /// RGBA color with alpha (0.0–1.0).
    Rgba(u8, u8, u8, f32),
    /// A named CSS color.
    Named(String),
    /// Transparent.
    Transparent,
}

impl Color {
    /// Create a color from a hex string (with or without `#`).
    pub fn hex(hex: &str) -> Self {
        let hex = hex.strip_prefix('#').unwrap_or(hex);
        Color::Hex(hex.to_string())
    }

    /// Create a color from RGB values.
    pub fn rgb(r: u8, g: u8, b: u8) -> Self {
        Color::Rgb(r, g, b)
    }

    /// Create a color from RGBA values.
    pub fn rgba(r: u8, g: u8, b: u8, a: f32) -> Self {
        Color::Rgba(r, g, b, a)
    }

    /// White (#ffffff).
    pub fn white() -> Self {
        Color::Hex("ffffff".to_string())
    }

    /// Black (#000000).
    pub fn black() -> Self {
        Color::Hex("000000".to_string())
    }

    /// Transparent.
    pub fn transparent() -> Self {
        Color::Transparent
    }
}

impl fmt::Display for Color {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        match self {
            Color::Hex(hex) => write!(f, "#{hex}"),
            Color::Rgb(r, g, b) => write!(f, "rgb({r},{g},{b})"),
            Color::Rgba(r, g, b, a) => write!(f, "rgba({r},{g},{b},{a})"),
            Color::Named(name) => write!(f, "{name}"),
            Color::Transparent => write!(f, "transparent"),
        }
    }
}