kv 0.24.0

An embedded key/value store 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
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143

use std::mem;
use std::time::SystemTime;

use crate::{Error, Raw};

/// A Key can be used as a key to a database
pub trait Key<'a>: Sized + AsRef<[u8]> {
    /// Convert from Raw
    fn from_raw_key(r: &'a Raw) -> Result<Self, Error>;

    /// Wrapper around AsRef<[u8]>
    fn to_raw_key(&self) -> Result<Raw, Error> {
        Ok(self.as_ref().into())
    }
}

impl<'a> Key<'a> for Raw {
    fn from_raw_key(x: &Raw) -> Result<Self, Error> {
        Ok(x.clone())
    }
}

impl<'a> Key<'a> for &'a [u8] {
    fn from_raw_key(x: &'a Raw) -> Result<&'a [u8], Error> {
        Ok(x.as_ref())
    }
}

impl<'a> Key<'a> for &'a str {
    fn from_raw_key(x: &'a Raw) -> Result<Self, Error> {
        Ok(std::str::from_utf8(x.as_ref())?)
    }
}

impl<'a> Key<'a> for Vec<u8> {
    fn from_raw_key(r: &Raw) -> Result<Self, Error> {
        Ok(r.to_vec())
    }
}

impl<'a> Key<'a> for String {
    fn from_raw_key(x: &Raw) -> Result<Self, Error> {
        Ok(std::str::from_utf8(x.as_ref())?.to_string())
    }
}

impl<'a> Key<'a> for Integer {
    fn from_raw_key(x: &Raw) -> Result<Integer, Error> {
        Ok(Integer::from(x.as_ref()))
    }
}

/// Integer key type
#[derive(Debug, Clone, Copy, PartialEq, PartialOrd)]
pub struct Integer([u8; 16]);

impl From<u128> for Integer {
    fn from(i: u128) -> Integer {
        unsafe { Integer(mem::transmute(i.to_be())) }
    }
}

impl From<u64> for Integer {
    fn from(i: u64) -> Integer {
        let i = i as u128;
        i.into()
    }
}

impl From<u32> for Integer {
    fn from(i: u32) -> Integer {
        let i = i as u128;
        i.into()
    }
}

impl From<i32> for Integer {
    fn from(i: i32) -> Integer {
        let i = i as u128;
        i.into()
    }
}

impl From<usize> for Integer {
    fn from(i: usize) -> Integer {
        let i = i as u128;
        i.into()
    }
}

impl From<Integer> for u128 {
    #[cfg(target_endian = "big")]
    fn from(i: Integer) -> u128 {
        unsafe { mem::transmute(i.0) }
    }

    #[cfg(target_endian = "little")]
    fn from(i: Integer) -> u128 {
        u128::from_be(unsafe { mem::transmute(i.0) })
    }
}

impl From<Integer> for u64 {
    fn from(i: Integer) -> u64 {
        let i: u128 = i.into();
        i as u64
    }
}

impl From<Integer> for usize {
    fn from(i: Integer) -> usize {
        let i: u128 = i.into();
        i as usize
    }
}

impl AsRef<[u8]> for Integer {
    fn as_ref(&self) -> &[u8] {
        &self.0
    }
}

impl<'a> From<&'a [u8]> for Integer {
    fn from(buf: &'a [u8]) -> Integer {
        let mut dst = Integer::from(0u128);
        dst.0[..16].clone_from_slice(&buf[..16]);
        dst
    }
}

impl Integer {
    /// Current timestamp in seconds from the Unix epoch
    pub fn timestamp() -> Result<Integer, Error> {
        let ts = SystemTime::now().duration_since(SystemTime::UNIX_EPOCH)?;
        Ok(Integer::from(ts.as_secs() as u128))
    }

    /// Current timestamp in milliseconds from the Unix epoch
    pub fn timestamp_ms() -> Result<Integer, Error> {
        let ts = SystemTime::now().duration_since(SystemTime::UNIX_EPOCH)?;
        Ok(Integer::from(ts.as_millis()))
    }
}