mxp 1.2.0

Rust implementation of the MXP (Mud eXtension Protocol) standard
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

use std::error::Error;
use std::fmt;
use std::num::ParseIntError;

/// An error which is returned when attempting to create an [`RgbColor`](crate::RgbColor) from a
/// number greater than the maximum hex code value (`0xFFFFFF`).
#[derive(Copy, Clone, Debug, Default, PartialEq, Eq)]
pub struct HexOutOfRangeError(
    /// Value that exceeded the maximum limit of `0xFFFFFF`.
    pub u32,
);

impl fmt::Display for HexOutOfRangeError {
    fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
        f.write_str("number exceeds maximum hex code value")
    }
}

impl Error for HexOutOfRangeError {}

/// An error which can be returned when parsing an [`RgbColor`](crate::RgbColor).
///
#[derive(Clone, Debug, PartialEq, Eq)]
pub enum ParseHexColorError {
    /// The string is not in hexadecimal format (`"#ABCDEF"`).
    NotHex(String),
    /// The string could not be parsed to an integer.
    NotU32(ParseIntError),
    /// The integer parsed from the string exceeds the maximum hex code value (`0xFFFFFF`).
    OutOfRange(u32),
}

impl From<HexOutOfRangeError> for ParseHexColorError {
    fn from(value: HexOutOfRangeError) -> Self {
        Self::OutOfRange(value.0)
    }
}

impl From<ParseIntError> for ParseHexColorError {
    fn from(value: ParseIntError) -> Self {
        Self::NotU32(value)
    }
}

impl fmt::Display for ParseHexColorError {
    fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
        match self {
            Self::NotHex(_) => f.write_str("value is not formatted as a hex code"),
            Self::NotU32(error) => error.fmt(f),
            Self::OutOfRange(_) => f.write_str("number exceeds maximum hex code value"),
        }
    }
}