sofie-flags 0.2.0

Feature flags: declared as constants, stored in the database, cached in process and evaluated per request.
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

use std::marker::PhantomData;

/// `added` and `retire_after_days` are read from the source by `sofie check`, not at run time.
#[derive(Clone, Copy, Debug, PartialEq, Eq)]
pub struct Feature {
    name: &'static str,
}

impl Feature {
    /// `name` is `<module>.<flag>`, unique in the app.
    #[must_use]
    pub const fn new(name: &'static str) -> Self {
        Self { name }
    }

    /// `date` is `YYYY-MM-DD`; `sofie check` reports the flag once it is older than
    /// `retire_after_days`, 90 unless set.
    #[must_use]
    pub const fn added(self, _date: &'static str) -> Self {
        self
    }

    #[must_use]
    pub const fn retire_after_days(self, _days: u32) -> Self {
        self
    }

    #[must_use]
    pub const fn name(self) -> &'static str {
        self.name
    }
}

pub struct Variants<V> {
    feature: Feature,
    variant: PhantomData<fn() -> V>,
}

impl<V> Clone for Variants<V> {
    fn clone(&self) -> Self {
        *self
    }
}

impl<V> Copy for Variants<V> {}

impl<V> Variants<V> {
    #[must_use]
    pub const fn new(name: &'static str) -> Self {
        Self {
            feature: Feature::new(name),
            variant: PhantomData,
        }
    }

    #[must_use]
    pub const fn added(self, _date: &'static str) -> Self {
        self
    }

    #[must_use]
    pub const fn retire_after_days(self, _days: u32) -> Self {
        self
    }

    #[must_use]
    pub const fn feature(self) -> Feature {
        self.feature
    }
}