telemetry 0.1.3

Telemetry is a mechanism used to capture metrics in an application, to later store the data locally or upload it to a server for statistical analysis.
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

use std::marker::PhantomData;
use std::sync::atomic::{AtomicUsize, Ordering};

/// Witness type, used to specify that the data is specific to a plain histogram.
#[derive(Clone)]
pub struct Plain;

/// Witness type, used to specify that the data is specific to a map histogram.
#[derive(Clone)]
pub struct Map;

/// Witness type, used to specify that the data is specific to a map
/// histogram with keys of a specific type `T`.
pub struct Keyed<T> {
    pub witness: PhantomData<T>,
}
impl<T> Clone for Keyed<T> {
    fn clone(&self) -> Self {
        Keyed {
            witness: PhantomData,
        }
    }
}

/// A key used to communicate with the back-end for a given kind of histograms.
pub struct Key<T> {
    pub witness: PhantomData<T>,
    pub index: usize,
}
impl<T> Clone for Key<T> {
    fn clone(&self) -> Self {
        Key {
            witness: PhantomData,
            index: self.index,
        }
    }
}

/// A key generator. It produces consecutive numbers.
pub struct KeyGenerator<T> {
    counter: AtomicUsize,
    witness: PhantomData<T>,
}
impl<T> KeyGenerator<T> {
    pub fn new() -> KeyGenerator<T> {
        KeyGenerator {
            counter: AtomicUsize::new(0),
            witness: PhantomData,
        }
    }
}
impl KeyGenerator<Plain> {
    pub fn next(&self) -> Key<Plain> {
        Key {
            index: self.counter.fetch_add(1, Ordering::Relaxed),
            witness: PhantomData,
        }
    }
}
impl KeyGenerator<Map> {
    pub fn next<T>(&self) -> Key<Keyed<T>> {
        Key {
            index: self.counter.fetch_add(1, Ordering::Relaxed),
            witness: PhantomData,
        }
    }
}