cumulo-dipa 0.1.1

dipa makes it easy to efficiently delta encode large Rust data structures.
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

use crate::sequence::{SequenceModificationDelta, SequenceModificationDeltaOwned};
use crate::{CreatedDelta, Diffable, Patchable};

impl<'s, 'e> Diffable<'s, 'e, String> for String {
    type Delta = Vec<SequenceModificationDelta<'e, u8>>;
    type DeltaOwned = Vec<SequenceModificationDeltaOwned<u8>>;

    fn create_delta_towards(&self, end_state: &'e String) -> CreatedDelta<Self::Delta> {
        self.as_bytes().create_delta_towards(&end_state.as_bytes())
    }
}

impl Patchable<Vec<SequenceModificationDeltaOwned<u8>>> for String {
    fn apply_patch(&mut self, patch: Vec<SequenceModificationDeltaOwned<u8>>) {
        // TODO: More efficient implementation without copying.. Just quickly getting things working.
        let mut bytes = self.as_bytes().to_vec();

        bytes.apply_patch(patch);

        *self = String::from_utf8(bytes).unwrap()
    }
}

impl<'s, 'e> Diffable<'s, 'e, str> for str {
    type Delta = Vec<SequenceModificationDelta<'e, u8>>;
    type DeltaOwned = Vec<SequenceModificationDeltaOwned<u8>>;

    fn create_delta_towards(&'s self, end_state: &'e str) -> CreatedDelta<Self::Delta> {
        self.as_bytes().create_delta_towards(&end_state.as_bytes())
    }
}

#[cfg(test)]
mod tests {
    use crate::sequence::SequenceModificationDelta;
    use crate::DipaImplTester;

    /// Verify that we can diff and patch strings.
    #[test]
    fn string_dipa() {
        DipaImplTester {
            label: Some("String unchanged"),
            start: &mut "XYZ".to_string(),
            end: &"XYZ".to_string(),
            expected_delta: vec![],
            // 1 for vec length
            expected_serialized_patch_size: 1,
            expected_did_change: false,
        }
        .test();

        DipaImplTester {
            label: Some("String changed"),
            start: &mut "ABCDE".to_string(),
            end: &"ABDE".to_string(),
            expected_delta: vec![SequenceModificationDelta::DeleteOne { index: 2 }],
            // 1 for vec length, 1 for variant, 1 for index
            expected_serialized_patch_size: 3,
            expected_did_change: true,
        }
        .test();
    }
}