paracord 0.1.0

A fast, simple, multi-threaded string interning library
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

use std::hash::{BuildHasher, Hash};

use serde::de::{DeserializeSeed, Visitor};

use crate::{slice, Key, ParaCord};

pub struct SerdeVisitor<'a, S>(pub &'a ParaCord<S>);

impl<S: BuildHasher> Visitor<'_> for SerdeVisitor<'_, S> {
    type Value = Key;

    fn expecting(&self, formatter: &mut std::fmt::Formatter) -> std::fmt::Result {
        formatter.write_str("a string value")
    }

    fn visit_str<E>(self, v: &str) -> Result<Self::Value, E>
    where
        E: serde::de::Error,
    {
        Ok(self.0.get_or_intern(v))
    }
}

impl<'de, S: BuildHasher> DeserializeSeed<'de> for &ParaCord<S> {
    type Value = Key;

    fn deserialize<D>(self, deserializer: D) -> Result<Self::Value, D::Error>
    where
        D: Deserializer<'de>,
    {
        deserializer.deserialize_str(SerdeVisitor(self))
    }
}

impl<'de, T: Deserialize<'de> + Hash + Eq + Copy, S: BuildHasher> DeserializeSeed<'de>
    for &slice::ParaCord<T, S>
{
    type Value = Key;

    fn deserialize<D>(self, deserializer: D) -> Result<Self::Value, D::Error>
    where
        D: Deserializer<'de>,
    {
        let v = Vec::<T>::deserialize(deserializer)?;
        Ok(self.get_or_intern(&v))
    }
}

#[doc(hidden)]
#[macro_export]
macro_rules! custom_key_serde {
    ($key:ident) => {
        const _: () = {
            use $crate::__private::serde::{
                Deserialize, Deserializer, SerdeVisitor, Serialize, Serializer,
            };

            /// Serialize the key as the interned-string
            impl Serialize for $key {
                fn serialize<S>(&self, serializer: S) -> ::core::result::Result<S::Ok, S::Error>
                where
                    S: Serializer,
                {
                    serializer.serialize_str(self.as_str())
                }
            }

            /// Deserializes and interns a string
            impl<'de> Deserialize<'de> for $key {
                fn deserialize<D>(deserializer: D) -> ::core::result::Result<Self, D::Error>
                where
                    D: Deserializer<'de>,
                {
                    deserializer
                        .deserialize_str(SerdeVisitor(Self::paracord()))
                        .map(Self)
                }
            }
        };
    };
}

pub use custom_key_serde;
pub use serde::{Deserialize, Deserializer, Serialize, Serializer};