zbox 0.3.0

Zbox is a zero-details, privacy-focused embeddable file system.
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

mod emap;
mod file;
mod sector;
mod span;
mod vio;

pub use self::file::FileStorage;

use std::io::{Read, Write, ErrorKind, Result as IoResult};
use std::path::Path;

use serde::{Deserialize, Serialize};
use rmp_serde::{Deserializer, Serializer};

use error::Result;
use base::crypto::{Crypto, Key};
use self::vio::imp as vio_imp;

// remove file if it exists
fn remove_file<P: AsRef<Path>>(path: P) -> IoResult<bool> {
    match vio_imp::remove_file(path.as_ref()) {
        Ok(_) => Ok(true),
        Err(ref e) if e.kind() == ErrorKind::NotFound => Ok(false),
        Err(e) => Err(e),
    }
}

// remove dir and its content if it exists
fn remove_dir_all<P: AsRef<Path>>(path: P) -> IoResult<()> {
    match vio_imp::remove_dir_all(path.as_ref()) {
        Ok(_) => Ok(()),
        Err(ref e) if e.kind() == ErrorKind::NotFound => Ok(()),
        Err(e) => Err(e),
    }
}

// serilise, encrypt and save object to disk
fn save_obj<S, P>(obj: &S, path: P, skey: &Key, crypto: &Crypto) -> Result<()>
where
    S: Serialize,
    P: AsRef<Path>,
{
    let mut buf = Vec::new();
    obj.serialize(&mut Serializer::new(&mut buf))?;
    let enc = crypto.encrypt(&buf, skey)?;
    let mut file = vio_imp::OpenOptions::new()
        .write(true)
        .create_new(true)
        .truncate(true)
        .open(path.as_ref())?;
    file.write_all(&enc)?;
    Ok(())
}

// deserilise, decrypt and load object from disk
fn load_obj<'de, D, P>(path: P, skey: &Key, crypto: &Crypto) -> Result<D>
where
    D: Deserialize<'de>,
    P: AsRef<Path>,
{
    let mut buf = Vec::new();
    let mut rd = vio_imp::File::open(path.as_ref())?;
    rd.read_to_end(&mut buf)?;
    let dec = crypto.decrypt(&buf, skey)?;
    let mut de = Deserializer::new(&dec[..]);
    Ok(Deserialize::deserialize(&mut de)?)
}