libvctrl 0.4.0

A robust, content-addressed version control engine for arbitrary data, designed for embedding into applications.
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

#![allow(dead_code)]

use libvctrl::{
    BinaryEncoder, Encoder, Hash, Hasher, MemoryRefStore, MemoryStore, ObjectStore, Sha512Hasher,
    UserID,
};

pub fn setup_store() -> MemoryStore {
    MemoryStore::new()
}

pub fn setup_refs() -> MemoryRefStore {
    MemoryRefStore::new()
}

pub fn encoder() -> BinaryEncoder {
    BinaryEncoder
}

pub fn hasher() -> Sha512Hasher {
    Sha512Hasher
}

pub fn user(name: &str, email: &str) -> UserID {
    UserID::new(name.to_string(), email.to_string()).unwrap()
}

pub fn alice() -> UserID {
    UserID::new("Alice Example".to_string(), "alice@example.com".to_string()).unwrap()
}

pub fn bob() -> UserID {
    UserID::new("Bob Example".to_string(), "bob@example.com".to_string()).unwrap()
}

pub fn blob_hash(data: &[u8]) -> Hash {
    hasher().hash_blob(data)
}

pub fn tree_hash(tree: &libvctrl::Tree) -> Hash {
    let encoder = encoder();
    let hasher = hasher();
    let mut buf = Vec::new();
    encoder.encode_tree(tree, &mut buf).unwrap();
    hasher.hash_tree_encoded(&buf)
}

pub fn commit_hash(commit: &libvctrl::Commit) -> Hash {
    let encoder = encoder();
    let hasher = hasher();
    let mut buf = Vec::new();
    encoder.encode_commit(commit, &mut buf).unwrap();
    hasher.hash_commit_encoded(&buf)
}

pub fn put_blob(store: &mut MemoryStore, data: &[u8]) -> Hash {
    let blob = libvctrl::Blob::new(data.to_vec());
    let hash = blob_hash(data);
    store.put(&hash, &libvctrl::Object::Blob(blob)).unwrap();
    hash
}

pub fn put_tree(store: &mut MemoryStore, tree: &libvctrl::Tree) -> Hash {
    let hash = tree_hash(tree);
    store
        .put(&hash, &libvctrl::Object::Tree(tree.clone()))
        .unwrap();
    hash
}