Crate enum_toggles

Crate enum_toggles 

Source
Expand description

This crate provides a toggle manager that can load from a file. Toggle states are read-only and accessed in O(1) time. There’s a direct relationship where each string name corresponds to a unique name in the enum.

§Example

  • File toggles.yaml conains:
FeatureA: 0
FeatureB: 1
  • Basic usage
use enum_toggles::EnumToggles;
use strum_macros::{AsRefStr, EnumIter};

#[derive(AsRefStr, EnumIter, PartialEq)]
enum MyToggle {
    FeatureA,
    FeatureB,
}

let mut toggles: EnumToggles::<MyToggle> = EnumToggles::new();
toggles.set(MyToggle::FeatureA as usize, true);
toggles.set_by_name("FeatureB", true); // Mapped to MyToggle::FeatureB
// toggles.load_from_file("toggles.yaml"); // Load toggles state from file
println!("{:?}", toggles);
  • With concucrency context
use enum_toggles::EnumToggles;
use log::warn;
use std::env;
use std::ops::Deref;
use std::sync::LazyLock;
use strum_macros::{AsRefStr, EnumIter};

#[derive(AsRefStr, EnumIter, PartialEq)]
enum MyToggle {
    FeatureA,
    FeatureB,
}

pub static TOGGLES: LazyLock<EnumToggles<MyToggle>> = LazyLock::new(|| {
    let mut toggle:EnumToggles<MyToggle> = EnumToggles::new();
    let filepath = env::var("TOGGLES_FILE");
    match filepath {
        Ok(path) => {
            if !path.is_empty() {
                toggle.load_from_file(&path)
            }
        }
        Err(_) => warn!("Environment variable TOGGLES_FILE not set"),
    }
    toggle
});

println!("{:?}", TOGGLES.deref());

Structs§

EnumToggles
Contains the toggle value for each item of the enum T.