prismqueer 0.1.1

The spectral-triple substrate — five operations (focus, project, split, shift, settle), the Prism trait, zero deps. The foundation.
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

//! Luminosity — how much signal is getting through.

/// How much signal is getting through.
/// The ternary state of a beam or crystal.
#[derive(Debug, Clone, PartialEq)]
pub enum Luminosity {
    /// Full signal. Zero holonomy. Crystal.
    Light,
    /// Partial signal. Nonzero holonomy. Oscillating.
    Dimmed(f64),
    /// No signal. Error and loss propagate. Fixpoint.
    Dark,
}

impl Luminosity {
    pub fn is_light(&self) -> bool {
        matches!(self, Luminosity::Light)
    }
    pub fn is_dimmed(&self) -> bool {
        matches!(self, Luminosity::Dimmed(_))
    }
    pub fn is_dark(&self) -> bool {
        matches!(self, Luminosity::Dark)
    }

    pub fn holonomy(&self) -> Option<f64> {
        match self {
            Luminosity::Light => Some(0.0),
            Luminosity::Dimmed(h) => Some(*h),
            Luminosity::Dark => None,
        }
    }

    pub fn from_holonomy(h: f64) -> Self {
        if h == 0.0 {
            Luminosity::Light
        } else if h.is_finite() {
            Luminosity::Dimmed(h)
        } else {
            Luminosity::Dark
        }
    }
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn luminosity_states() {
        let light = Luminosity::Light;
        let dimmed = Luminosity::Dimmed(0.3);
        let dark = Luminosity::Dark;

        assert!(light.is_light());
        assert!(!light.is_dark());
        assert!(dimmed.is_dimmed());
        assert_eq!(dimmed.holonomy(), Some(0.3));
        assert!(dark.is_dark());
        assert_eq!(dark.holonomy(), None);
    }

    #[test]
    fn luminosity_from_holonomy() {
        assert!(Luminosity::from_holonomy(0.0).is_light());
        assert!(Luminosity::from_holonomy(0.5).is_dimmed());
        assert!(Luminosity::from_holonomy(f64::INFINITY).is_dark());
    }
}