vinezombie 0.3.1

A modular IRCv3 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
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101

use crate::string::{
    ArgSafe, Bytes, CmdSafe, KeySafe, LineSafe, NickSafe, NoNulSafe, Transform, Transformation,
    UserSafe, Utf8Policy, WordSafe,
};

/// ASCII casemapping, generic over whether it's uppercase or lowercase.
///
/// Although this transform is safe to use for
/// [`Nick`][crate::string::Nick] and [`User`][crate::string::User],
/// it is likely the result of a logic error to use this instead of [`IrcCasemap::Ascii`].
/// As such, it does not implement [`NickSafe`] or [`UserSafe`].
#[derive(Clone, Copy, PartialEq, Eq, PartialOrd, Ord, Hash, Debug, Default)]
pub struct AsciiCasemap<const UPPERCASE: bool>;

unsafe impl<const UPPERCASE: bool> Transform for AsciiCasemap<UPPERCASE> {
    type Value = ();

    fn transform<'a>(self, bytes: &Bytes<'a>) -> Transformation<'a, Self::Value> {
        unsafe {
            let bytes = bytes.as_bytes_unsafe();
            if UPPERCASE {
                super::map_bytes(bytes, Utf8Policy::PreserveStrict, u8::to_ascii_uppercase)
            } else {
                super::map_bytes(bytes, Utf8Policy::PreserveStrict, u8::to_ascii_lowercase)
            }
        }
    }
}
unsafe impl<const UC: bool> NoNulSafe for AsciiCasemap<UC> {}
unsafe impl<const UC: bool> LineSafe for AsciiCasemap<UC> {}
unsafe impl<const UC: bool> WordSafe for AsciiCasemap<UC> {}
unsafe impl<const UC: bool> ArgSafe for AsciiCasemap<UC> {}
unsafe impl<const UC: bool> KeySafe for AsciiCasemap<UC> {}
unsafe impl CmdSafe for AsciiCasemap<true> {}

/// Basic IRC-style casemapping.
///
/// Does not map UTF-8 characters, but preserves UTF-8 validity.
/// Maps from uppercase to lowercase.
#[derive(Clone, Copy, PartialEq, Eq, PartialOrd, Ord, Hash, Debug)]
#[non_exhaustive]
pub enum IrcCasemap {
    /// ASCII lowercase mapping.
    Ascii,
    /// ASCII casemapping, plus `[\]` are mapped to `{|}`.
    Rfc1459Strict,
    /// RFC-1459 strict casemapping, plus `~` is mapped to `^`.
    Rfc1459,
}

impl IrcCasemap {
    /// Creates a casemap from the given name.
    pub fn from_name(name: &'static [u8]) -> Option<IrcCasemap> {
        match name {
            b"ascii" => Some(IrcCasemap::Ascii),
            b"rfc1459" => Some(IrcCasemap::Rfc1459),
            b"rfc1459-strict" => Some(IrcCasemap::Rfc1459Strict),
            _ => None,
        }
    }
}

fn rfc1459_strict(byte: &u8) -> u8 {
    if matches!(byte, b'['..=b']') {
        *byte + 32
    } else {
        byte.to_ascii_lowercase()
    }
}

fn rfc1459(byte: &u8) -> u8 {
    if *byte == b'~' {
        b'^'
    } else {
        rfc1459_strict(byte)
    }
}

unsafe impl Transform for IrcCasemap {
    type Value = ();

    fn transform<'a>(self, bytes: &Bytes<'a>) -> Transformation<'a, Self::Value> {
        use super::map_bytes;
        use Utf8Policy::PreserveStrict as U8Pol;
        unsafe {
            let bytes = bytes.as_bytes_unsafe();
            match self {
                IrcCasemap::Ascii => map_bytes(bytes, U8Pol, u8::to_ascii_lowercase),
                IrcCasemap::Rfc1459Strict => map_bytes(bytes, U8Pol, rfc1459_strict),
                IrcCasemap::Rfc1459 => map_bytes(bytes, U8Pol, rfc1459),
            }
        }
    }
}
unsafe impl NoNulSafe for IrcCasemap {}
unsafe impl LineSafe for IrcCasemap {}
unsafe impl WordSafe for IrcCasemap {}
unsafe impl ArgSafe for IrcCasemap {}
unsafe impl NickSafe for IrcCasemap {}
unsafe impl UserSafe for IrcCasemap {}
unsafe impl KeySafe for IrcCasemap {}