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.txt conains:
0 FeatureA
1 FeatureB
  • 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.txt"); // Load toggles state from file
println!("{}", toggles);
  • With concucrency context
use enum_toggles::EnumToggles;
use log::warn;
use once_cell::sync::Lazy;
use std::env;
use std::ops::Deref;
use strum_macros::{AsRefStr, EnumIter};

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

pub static TOGGLES: Lazy<EnumToggles<MyToggle>> = Lazy::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.