fav_core 0.0.11

Fav's core crate; A collection of traits.
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
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156

//! Attribute,
//! managing the resources' attributes

#[cfg(feature = "derive")]
pub use fav_derive::Attr;

/// The resource's id.
/// # Example
/// ```
/// # use fav_core::attr::Id;
/// let id: Id = 123.into();
/// assert_eq!(id, Id::I32(123));
/// let id: Id = "123".into();
/// assert_eq!(id, Id::I32(123));
/// let id: Id = "68719476735".into();
/// assert_eq!(id, Id::I64(68719476735)); // 68719476735 is 0xFFFF_FFFF_F, which > i32::MAX
/// let id: Id = "abc".into();
/// assert_eq!(id, Id::String("abc"));
/// ```
#[allow(missing_docs)]
#[derive(Debug)]
pub enum Id<'a> {
    I64(i64),
    I32(i32),
    String(&'a str),
}

impl PartialEq for Id<'_> {
    fn eq(&self, other: &Self) -> bool {
        match (self, other) {
            (Id::I64(a), Id::I64(b)) => a == b,
            (Id::I32(a), Id::I32(b)) => a == b,
            (Id::I64(a), Id::I32(b)) => *a == *b as i64,
            (Id::I32(a), Id::I64(b)) => *a as i64 == *b,
            (Id::String(a), Id::String(b)) => a == b,
            _ => false,
        }
    }
}

/// Attributes managing trait.
///
/// You may easily implement the `Attr` trait by deriving [`fav_derive::Attr`].
/// # Example
/// ```
/// # #[path = "test_utils/mod.rs"]
/// # mod test_utils;
/// # use test_utils::data::AttrTest;
/// # use fav_core::attr::{Attr, Id};
/// impl Attr for AttrTest {
///     fn id(&self) -> Id {
///        self.id.into()
///     }
///
///     fn title(&self) -> &str {
///         &self.title
///     }
/// }
///
/// let res = AttrTest::default();
///
/// assert_eq!(res.id(), 0.into());
/// assert_eq!(res.title(), "");
/// ```
/// Derive macros example:
/// ```
/// # use fav_core::attr::{Attr, Id};
/// #[derive(Attr)]
/// struct AttrTest {
///     id: i32,
///     title: String,
/// }
/// ```
/// More examples in [`fav_derive::Attr`].
pub trait Attr {
    /// Return the id of the target
    fn id(&self) -> Id;
    /// Return the title of the target
    fn title(&self) -> &str;
}

/// Counting trait
pub trait Count {
    /// Return the count of resources in set
    fn count(&self) -> i32;
}

impl From<i64> for Id<'_> {
    fn from(id: i64) -> Self {
        Id::I64(id)
    }
}

impl From<i32> for Id<'_> {
    fn from(id: i32) -> Self {
        Id::I32(id)
    }
}

impl From<&i64> for Id<'_> {
    fn from(id: &i64) -> Self {
        Id::I64(*id)
    }
}

impl From<&i32> for Id<'_> {
    fn from(id: &i32) -> Self {
        Id::I32(*id)
    }
}

impl<'a> From<&'a str> for Id<'a> {
    fn from(id: &'a str) -> Self {
        match id.parse::<i32>() {
            Ok(id) => Id::I32(id),
            Err(_) => match id.parse::<i64>() {
                Ok(id) => Id::I64(id),
                Err(_) => Id::String(id),
            },
        }
    }
}

impl<'a> From<&'a String> for Id<'a> {
    fn from(id: &'a String) -> Self {
        id.as_str().into()
    }
}

impl From<Id<'_>> for i32 {
    fn from(value: Id) -> Self {
        match value {
            Id::I32(id) => id,
            _ => panic!("Not i32 id"),
        }
    }
}

impl From<Id<'_>> for i64 {
    fn from(value: Id) -> Self {
        match value {
            Id::I64(id) => id,
            _ => panic!("Not i64 id"),
        }
    }
}

impl From<Id<'_>> for String {
    fn from(value: Id) -> Self {
        match value {
            Id::String(id) => id.to_owned(),
            Id::I64(id) => id.to_string(),
            Id::I32(id) => id.to_string(),
        }
    }
}