myko 6.3.0

myko in rust
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

use std::{collections::HashMap, hash::Hash, sync::Arc};

use serde_json::Value;

use crate::core::item::AnyItem;

/// Downcast an `Arc<dyn AnyItem>` to a concrete type.
/// Returns `Some(T)` if the downcast succeeds, `None` otherwise.
///
/// # Example
/// ```rust,no_run
/// use std::{any::Any, sync::Arc};
/// use myko::common::with_id::WithId;
/// use myko::item::AnyItem;
/// use myko::utils::downcast_item;
///
/// #[derive(Clone, Debug, PartialEq, serde::Serialize)]
/// struct Server {
///     id: Arc<str>,
/// }
///
/// impl WithId for Server {
///     fn id(&self) -> Arc<str> {
///         self.id.clone()
///     }
/// }
///
/// impl AnyItem for Server {
///     fn as_any(&self) -> &dyn Any {
///         self
///     }
///
///     fn entity_type(&self) -> &'static str {
///         "Server"
///     }
///
///     fn equals(&self, other: &dyn AnyItem) -> bool {
///         other
///             .as_any()
///             .downcast_ref::<Self>()
///             .map(|typed| self == typed)
///             .unwrap_or(false)
///     }
/// }
///
/// let item: Arc<dyn AnyItem> = Arc::new(Server { id: "server-1".into() });
/// if let Some(server) = downcast_item::<Server>(&item) {
///     assert_eq!(server.id.as_ref(), "server-1");
/// }
/// ```
pub fn downcast_item<T: Clone + 'static>(item: &Arc<dyn AnyItem>) -> Option<T> {
    // AnyItem: Any, so we can use downcast_ref on the trait object
    item.as_any().downcast_ref::<T>().cloned()
}

#[must_use]
pub fn mask_filter(filter: &Value, candidate: &Value) -> bool {
    match (filter, candidate) {
        (Value::Object(map_a), Value::Object(map_b)) => {
            for (key, value_a) in map_a {
                match map_b.get(key) {
                    Some(value_b) => {
                        if !mask_filter(value_a, value_b) {
                            return false;
                        }
                    }
                    None => return false,
                }
            }
            true
        }
        _ => filter == candidate,
    }
}

pub fn assert_default_for_key<K, V, S>(hash_map: &mut HashMap<K, V, S>, key: &K)
where
    K: Hash + Eq + Clone,
    V: Default,
    S: std::hash::BuildHasher,
{
    if !hash_map.contains_key(key) {
        hash_map.insert(key.clone(), V::default());
    }
}