libhaystack 3.2.0

Rust implementation of the Haystack 4 data types, defs, filter, units, and encodings
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

// Copyright (C) 2020 - 2022, J2 Innovations

//! Haystack Units module

pub mod unit;
pub mod unit_dimension;
#[cfg(feature = "units-db")]
pub mod units_generated;

use std::borrow::Cow;

pub use unit::Unit;
pub use unit_dimension::UnitDimensions;

/// The dimensionless default unit
pub static DEFAULT_UNIT: Unit = Unit {
    quantity: None,
    ids: Cow::Borrowed(&[]),
    dimensions: None,
    scale: 0.0,
    offset: 0.0,
};

/// Get unit by name, if it is defined in the units database
#[allow(unused_variables)]
pub fn get_unit(unit: &str) -> Option<&'static Unit> {
    #[cfg(feature = "units-db")]
    {
        units_generated::UNITS.get(unit).copied()
    }
    #[cfg(not(feature = "units-db"))]
    return None;
}

/// Tries to get the unit by name, if none is found, return a default unit
pub fn get_unit_or_default(unit: &str) -> &'static Unit {
    get_unit(unit).unwrap_or(&DEFAULT_UNIT)
}

/// Match units for the dimension
#[allow(unused_variables)]
pub fn match_units(dim: UnitDimensions, scale: f64) -> Vec<&'static Unit> {
    #[cfg(feature = "units-db")]
    {
        units_generated::UNITS
            .values()
            .filter_map(|u| {
                if u.dimensions.as_ref() == Some(&dim) && approx_eq(u.scale, scale) {
                    Some(*u)
                } else {
                    None
                }
            })
            .collect()
    }
    #[cfg(not(feature = "units-db"))]
    return Vec::default();
}

#[cfg(feature = "units-db")]
fn approx_eq(a: f64, b: f64) -> bool {
    if a == b {
        return true;
    }
    let min_precision = f64::min(f64::abs(a / 1e3), f64::abs(b / 1e3));
    f64::abs(a - b) <= min_precision
}