Struct FeatureFlags 

pub struct FeatureFlags { /* private fields */ }

Implementations

impl FeatureFlags

pub fn new(cache: BoxedCache) -> Self

pub fn ttl(self, ttl: Duration) -> Self

Override the per-entry TTL. Lower = faster propagation across replicas; higher = less cache load. Default 1 hour.

pub async fn enable(&self, name: &str)

Globally enable the flag for everyone.

pub async fn disable(&self, name: &str)

Globally disable the flag for everyone (overrides per-user enables for the killswitch effect).

pub async fn clear(&self, name: &str, known_user_ids: &[&str])

Drop every record for name — global state, percentage, and known per-user overrides for the supplied list. (We can’t enumerate keys generically through the Cache trait, so callers supply any user ids they want to scrub.)

pub async fn set_percentage(&self, name: &str, percent: u8)

Set a rollout percentage 0..=100. The flag returns true for a stable, hashed slice of user ids — the same id falls inside the percentage on every check, so a user doesn’t flicker between requests.

pub async fn enable_for_user(&self, name: &str, user_id: &str)

Force-enable the flag for a specific user, regardless of global state. Useful for QA / staff dogfood.

pub async fn disable_for_user(&self, name: &str, user_id: &str)

Force-disable the flag for a specific user.

pub async fn is_enabled(&self, name: &str) -> bool

Resolve the flag globally — no per-user awareness. Returns false when:

• the flag was explicitly disabled, OR
• the cache is empty and there’s no rollout percentage record (i.e. the flag has never been touched).

pub async fn is_enabled_for(&self, name: &str, user_id: &str) -> bool

Resolve the flag for a specific user, considering all three modes in this order:

1. Per-user override (enable_for_user / disable_for_user). Whichever wins.
2. Global state (enable / disable). If the global state is off, that’s the answer (killswitch wins).
3. Percentage rollout — if set and > 0, hash the user id and return true when it falls inside the percentage.
4. Default false.

Trait Implementations

impl Clone for FeatureFlags

fn clone(&self) -> FeatureFlags

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.