links_core 0.2.12

Core create of the links collection
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

/// converts a number to a string with thousands separator
#[cfg(feature = "unittest")]
#[macro_export]
macro_rules! fmt_num {
    ($num:expr) => {
        num_format::ToFormattedString::to_formatted_string(&$num, &num_format::Locale::en)
    };
}
#[cfg(feature = "unittest")]
#[macro_export]
macro_rules! assert_error_kind_on_target_family {
    ($err:expr, $unix_kind:path) => {{
        #[cfg(target_family = "windows")]
        {
            let kind = format!("{:?}", $err.kind());
            assert_eq!(kind.as_str(), "Uncategorized"); // not available on stable rust toolchain, workaround ErrorKind::Uncategorized
        }
        #[cfg(target_family = "unix")]
        {
            assert_eq!($err.kind(), $unix_kind)
        }
    }};
}

/// returns raw fd or socket number depending on the target family
#[macro_export]
macro_rules! cross_os_fd {
    ($stream:expr) => {{
        #[cfg(target_family = "unix")]
        {
            use std::os::fd::AsRawFd;
            $stream.as_raw_fd()
        }
        #[cfg(target_family = "windows")]
        {
            use std::os::windows::io::AsRawSocket;
            $stream.as_raw_socket()
        }
    }};
}

// ========================================================
pub fn short_instance_type_name<T: Sized>(_: T) -> &'static str {
    use std::any::type_name;
    type_name::<T>().split('<').next().unwrap().split("::").last().unwrap_or("Unknown")
}

pub fn short_type_name<T: ?Sized>() -> &'static str {
    use std::any::type_name;
    type_name::<T>().split('<').next().unwrap().split("::").last().unwrap_or("Unknown")
}

// ========================================================
/// Will endure that the short name of Self is matching the name of struct, resolved via [Self] argument.
/// This prevents invalid names in Debug/Display output after refactoring without performance penalty at run time.
/// Will panic in debug build only if the name is not matching and always resolves to the literal name in release build.
#[macro_export]
macro_rules! asserted_short_name {
    ($name:literal, $ty:ty) => {{
        #[cfg(debug_assertions)]
        {
            use std::any::type_name;
            let expected_short_name = type_name::<$ty>().split('<').next().unwrap().split("::").last().unwrap_or("Unknown");
            debug_assert_eq!($name, expected_short_name, "Please check that you correct manual Debug & Display impl after refactoring");
            expected_short_name
        }
        #[cfg(not(debug_assertions))]
        {
            $name
        }
    }};
}

// ========================================================