Struct Experiment 

pub struct Experiment {
    pub id: String,
    pub name: String,
    pub description: String,
    pub rollout_percentage: u8,
    pub enabled: bool,
    pub variant_weights: Option<HashMap<String, u8>>,
    pub sticky: bool,
}

Experiment configuration for A/B testing.

Example

use chie_shared::{Experiment, Variant};

let exp = Experiment::new("new_ui_redesign", "Test new UI design")
    .with_rollout_percentage(10); // Start with 10% traffic

// Check if a user is in the experiment
let user_id = "user123";
let variant = exp.assign_variant(user_id);

Fields

id: String

Unique experiment identifier

name: String

Human-readable experiment name

description: String

Experiment description

rollout_percentage: u8

Rollout percentage (0-100)

enabled: bool

Whether the experiment is currently active

variant_weights: Option<HashMap<String, u8>>

Optional variant weights (must sum to 100)

sticky: bool

Sticky assignment: same user always gets same variant

Implementations

impl Experiment

pub fn new(id: impl Into<String>, name: impl Into<String>) -> Self

Create a new experiment.

pub fn with_description(self, description: impl Into<String>) -> Self

Set the experiment description.

pub fn with_rollout_percentage(self, percentage: u8) -> Self

Set the rollout percentage (0-100).

pub fn enabled(self) -> Self

Enable the experiment.

pub fn with_variant_weights(self, weights: HashMap<String, u8>) -> Self

Set custom variant weights.

pub fn non_sticky(self) -> Self

Disable sticky assignment (allow variant to change per request).

pub fn assign_variant(&self, user_id: &str) -> Variant

Assign a variant to a user based on their ID.

Uses a hash-based deterministic assignment for consistency.

pub fn is_enrolled(&self, user_id: &str) -> bool

Check if a user is enrolled in the experiment.

Trait Implementations

impl Clone for Experiment

fn clone(&self) -> Experiment

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Experiment

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Experiment

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Experiment

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.