photokit 0.4.5

Safe Rust bindings for Apple's Photos framework — photo library access on macOS
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

use serde::{Deserialize, Serialize};

use crate::fetch_result::PHFetchResult;

#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
/// Move information derived from `PHFetchResultChangeDetails`.
pub struct PHFetchResultMove {
    /// Corresponds to `PHFetchResultMove.fromIndex`.
    pub from_index: usize,
    /// Corresponds to `PHFetchResultMove.toIndex`.
    pub to_index: usize,
}

#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
/// Wraps `PHFetchResultChangeDetails`.
pub struct PHFetchResultChangeDetails<T> {
    /// Corresponds to `PHFetchResultChangeDetails.fetchResultBeforeChanges`.
    pub fetch_result_before_changes: PHFetchResult<T>,
    /// Corresponds to `PHFetchResultChangeDetails.fetchResultAfterChanges`.
    pub fetch_result_after_changes: PHFetchResult<T>,
    /// Corresponds to `PHFetchResultChangeDetails.hasIncrementalChanges`.
    pub has_incremental_changes: bool,
    #[serde(default)]
    /// Corresponds to `PHFetchResultChangeDetails.removedIndexes`.
    pub removed_indexes: Vec<usize>,
    #[serde(default)]
    /// Corresponds to `PHFetchResultChangeDetails.removedObjects`.
    pub removed_objects: Vec<T>,
    #[serde(default)]
    /// Corresponds to `PHFetchResultChangeDetails.insertedIndexes`.
    pub inserted_indexes: Vec<usize>,
    #[serde(default)]
    /// Corresponds to `PHFetchResultChangeDetails.insertedObjects`.
    pub inserted_objects: Vec<T>,
    #[serde(default)]
    /// Corresponds to `PHFetchResultChangeDetails.changedIndexes`.
    pub changed_indexes: Vec<usize>,
    #[serde(default)]
    /// Corresponds to `PHFetchResultChangeDetails.changedObjects`.
    pub changed_objects: Vec<T>,
    #[serde(default)]
    /// Corresponds to `PHFetchResultChangeDetails.moves`.
    pub moves: Vec<PHFetchResultMove>,
}

impl<T> PHFetchResultChangeDetails<T> {
    /// Queries Photos framework state exposed by `PHFetchResultChangeDetails`.
    pub fn has_moves(&self) -> bool {
        !self.moves.is_empty()
    }
}

impl<T: Clone + PartialEq> PHFetchResultChangeDetails<T> {
    /// Wraps a Photos framework operation on `PHFetchResultChangeDetails`.
    pub fn change_details_from_fetch_result(
        from_result: &PHFetchResult<T>,
        to_result: &PHFetchResult<T>,
        changed_objects: &[T],
    ) -> Self {
        let removed_indexes: Vec<usize> = from_result
            .iter()
            .enumerate()
            .filter_map(|(index, object)| (!to_result.contains(object)).then_some(index))
            .collect();
        let removed_objects = from_result.objects_at_indexes(&removed_indexes);

        let inserted_indexes: Vec<usize> = to_result
            .iter()
            .enumerate()
            .filter_map(|(index, object)| (!from_result.contains(object)).then_some(index))
            .collect();
        let inserted_objects = to_result.objects_at_indexes(&inserted_indexes);

        let changed_indexes: Vec<usize> = to_result
            .iter()
            .enumerate()
            .filter_map(|(index, object)| changed_objects.contains(object).then_some(index))
            .collect();
        let changed_objects = to_result.objects_at_indexes(&changed_indexes);

        let moves = from_result
            .iter()
            .enumerate()
            .filter_map(|(from_index, object)| {
                let to_index = to_result.index_of(object)?;
                (from_index != to_index).then_some(PHFetchResultMove {
                    from_index,
                    to_index,
                })
            })
            .collect();

        Self {
            fetch_result_before_changes: from_result.clone(),
            fetch_result_after_changes: to_result.clone(),
            has_incremental_changes: true,
            removed_indexes,
            removed_objects,
            inserted_indexes,
            inserted_objects,
            changed_indexes,
            changed_objects,
            moves,
        }
    }
}