cidre 0.14.0

Apple frameworks bindings for 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
86
87
88
89
90
91
92
93
94
95

use std::marker::PhantomData;

use crate::{arc, define_cls, define_opts, ns, objc};

define_opts!(
    #[doc(alias = "NSOrderedCollectionDifferenceCalculationOptions")]
    pub OrderedCollectionDiffCalcOpts(usize)
);

impl OrderedCollectionDiffCalcOpts {
    /// Insertion changes do not store a reference to the inserted object.
    #[doc(alias = "NSOrderedCollectionDifferenceCalculationOmitInsertedObjects")]
    pub const OMIT_INSERTED_OBJS: Self = Self(1 << 0);

    /// Insertion changes do not store a reference to the removed object.
    #[doc(alias = "NSOrderedCollectionDifferenceCalculationOmitRemovedObjects")]
    pub const OMIT_REMOVED_OBJS: Self = Self(1 << 1);

    /// Assume objects that were uniquely removed and inserted were moved.
    /// This is useful when diffing based on identity instead of equality.
    #[doc(alias = "NSOrderedCollectionDifferenceCalculationInferMoves")]
    pub const INFER_MOVES: Self = Self(1 << 2);
}

#[doc(alias = "NSOrderedCollectionDifference")]
#[repr(transparent)]
pub struct OrderedCollectionDiff<T: objc::Obj>(ns::Id, PhantomData<T>);

unsafe impl<T> Send for OrderedCollectionDiff<T> where T: objc::Obj + Send {}

impl<T: objc::Obj> objc::Obj for OrderedCollectionDiff<T> {}

impl<T: objc::Obj> arc::A<OrderedCollectionDiff<T>> {
    #[objc::msg_send(initWithChanges:)]
    pub fn init_with_changes(
        self,
        changes: &ns::Array<ns::OrderedCollectionChange<T>>,
    ) -> arc::R<OrderedCollectionDiff<T>>;
}

impl<T: objc::Obj> OrderedCollectionDiff<T> {
    define_cls!(NS_ORDERED_COLLECTION_DIFFERENCE);

    #[inline]
    pub fn with_changes(changes: &ns::Array<ns::OrderedCollectionChange<T>>) -> arc::R<Self> {
        Self::alloc().init_with_changes(changes)
    }

    #[objc::msg_send(insertions)]
    pub fn insertions(&self) -> arc::R<ns::Array<ns::OrderedCollectionChange<T>>>;

    #[objc::msg_send(removals)]
    pub fn removals(&self) -> arc::R<ns::Array<ns::OrderedCollectionChange<T>>>;

    #[objc::msg_send(hasChanges)]
    pub fn has_changes(&self) -> bool;

    #[objc::msg_send(inverseDifference)]
    pub fn inverse(&self) -> arc::R<Self>;
}

#[derive(Debug, Clone, Copy, PartialEq, Eq)]
#[doc(alias = "NSOrderedCollectionDifferenceInverseDiffingOptions")]
#[repr(i64)]
pub enum OrderedCollectionDiffInverseOpts {
    InsertedObjsFirst = 0,
    RemovedObjsFirst = 1,
}

#[link(name = "ns", kind = "static")]
unsafe extern "C" {
    static NS_ORDERED_COLLECTION_DIFFERENCE: &'static objc::Class<OrderedCollectionDiff<ns::Id>>;
}

#[cfg(test)]
mod tests {
    use crate::ns;

    #[test]
    fn basics() {
        let insert_change = ns::OrderedCollectionChange::<ns::String>::with_obj(
            Some(ns::str!(c"c")),
            ns::CollectionChangeType::Insert,
            0,
        );
        let changes = ns::arr![insert_change];

        let diff = ns::OrderedCollectionDiff::<ns::String>::with_changes(&changes);
        assert!(diff.has_changes());
        assert!(diff.insertions().len() > 0);

        let inverse = diff.inverse();
        assert!(inverse.has_changes());
    }
}