address 0.20.0-rc.3

Network address types with strict validation, owned & borrowed variants, and standard library conversions.
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

//! Serde support for the address types.
//!
//! This module is private, so its docs are not published. The wire contract these impls must uphold is stated in
//! the README, under `Serde Wire Contract`, which is the crate's front page.

pub(crate) use from_str_visitor::*;
pub(crate) use from_string_visitor::*;
pub(crate) use try_from_str_visitor::*;

mod from_str_visitor;
mod from_string_visitor;
mod try_from_str_visitor;

mod impl_serde_string;
mod impl_serde_string_or_binary;
mod ip_address;

#[cfg(test)]
pub(crate) mod test_util {
    use serde::Serialize;
    use serde::de::DeserializeOwned;
    use std::fmt::Debug;

    /// Asserts the value serializes to the `expected` JSON & deserializes back to an equal value.
    pub(crate) fn assert_json<T>(value: T, expected: &str)
    where
        T: Serialize + DeserializeOwned + PartialEq + Debug,
    {
        let json: String = serde_json::to_string(&value).unwrap();
        assert_eq!(json, expected, "value={:?}", value);

        let parsed: T = serde_json::from_str(json.as_str()).unwrap();
        assert_eq!(parsed, value, "value={:?}", value);
    }

    /// Asserts the value survives a postcard round trip & returns its encoded bytes.
    pub(crate) fn assert_postcard<T>(value: T) -> Vec<u8>
    where
        T: Serialize + DeserializeOwned + PartialEq + Debug,
    {
        let bytes: Vec<u8> = postcard::to_allocvec(&value).unwrap();

        let parsed: T = postcard::from_bytes(bytes.as_slice()).unwrap();
        assert_eq!(parsed, value, "value={:?}", value);

        bytes
    }
}