Struct DbFeatureDriver 

#[non_exhaustive]
pub struct DbFeatureDriver { /* private fields */ }

Feature flag driver backed by a database table rullst_feature_flags.

Uses a concurrent process-local cache with a configurable TTL. Lookup latency depends on contention, key/value size, hardware, and build profile.

Note on Database Pool Initialization

This driver requires a live database pool to function. If feature flags are evaluated before the database connection pool has been initialized (e.g., in early application startup or static constructors), this driver will gracefully return None (falling through to subsequent drivers in the chain) rather than blocking or panicking.

Implementations

impl DbFeatureDriver

pub fn new() -> DbFeatureDriver

Creates a new DbFeatureDriver with a default cache TTL of 5 seconds.

pub fn with_ttl(ttl: Duration) -> DbFeatureDriver

Creates a new DbFeatureDriver with a custom cache TTL duration. Overrides the default TTL.

pub fn invalidate_process_cache()

Invalidates cached database flags in every DbFeatureDriver in this process.

Call this only after the corresponding database transaction commits. Other processes and direct database writers remain visible through the configured TTL unless the application distributes this signal itself.

Trait Implementations

impl Default for DbFeatureDriver

fn default() -> DbFeatureDriver

Returns the “default value” for a type.

impl FeatureDriver for DbFeatureDriver

fn enabled<'life0, 'life1, 'async_trait>( &'life0 self, flag: &'life1 str, ) -> Pin<Box<dyn Future<Output = Option<bool>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, DbFeatureDriver: 'async_trait,

Check if a feature flag is enabled.

fn enabled_for<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, flag: &'life1 str, identifier: &'life2 str, ) -> Pin<Box<dyn Future<Output = Option<bool>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, DbFeatureDriver: 'async_trait,

Check if a feature flag is enabled for a specific target identifier.

fn variant<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, flag: &'life1 str, identifier: &'life2 str, ) -> Pin<Box<dyn Future<Output = Option<String>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, DbFeatureDriver: 'async_trait,

Retrieve the variation name assigned to a specific target identifier.