musli 0.1.1

Müsli is a flexible and efficient serialization 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

use core::mem::transmute;

use super::{MutSliceParser, Parser, SliceParser};

mod sealed {
    pub trait Sealed {}
    impl Sealed for &[u8] {}
    impl Sealed for &str {}
    impl Sealed for &mut &[u8] {}
    impl Sealed for &mut &str {}
}

/// Trait for types which can be converted into a [`Parser`].
pub trait IntoParser<'de>: self::sealed::Sealed {
    /// The parser type being converted into.
    type Parser: Parser<'de>;

    /// Convert into a parser.
    fn into_parser(self) -> Self::Parser;
}

impl<'de> IntoParser<'de> for &'de [u8] {
    type Parser = SliceParser<'de>;

    #[inline]
    fn into_parser(self) -> Self::Parser {
        SliceParser::new(self)
    }
}

impl<'de> IntoParser<'de> for &'de str {
    type Parser = SliceParser<'de, true>;

    #[inline]
    fn into_parser(self) -> Self::Parser {
        SliceParser::new_utf8(self)
    }
}

impl<'a, 'de> IntoParser<'de> for &'a mut &'de [u8] {
    type Parser = MutSliceParser<'a, 'de>;

    #[inline]
    fn into_parser(self) -> Self::Parser {
        MutSliceParser::new(self)
    }
}

impl<'a, 'de> IntoParser<'de> for &'a mut &'de str {
    type Parser = MutSliceParser<'a, 'de, true>;

    #[inline]
    fn into_parser(self) -> Self::Parser {
        // SAFETY: The slice is valid UTF-8 since it comes from a string, and
        // parsing ensures that the slice being processed keeps being valid
        // UTF-8.
        unsafe { MutSliceParser::new_utf8(transmute::<Self, &'a mut &'de [u8]>(self)) }
    }
}