optify 1.3.1

Simplifies getting the right configuration options for a process using pre-loaded configurations from files (JSON, YAML, etc.) to manage options for experiments or flights. This library is mainly made to support building implementations for other languages such as Node.js, Python, and Ruby. It is not meant to be consumed directly yet.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52

use crate::provider::{constraints::Constraints, SourceValue};
use serde::Deserialize;

#[derive(Clone, Deserialize, Hash, PartialEq, Eq)]
#[serde(default)]
pub struct GetOptionsPreferences {
    /// Allows resolving configurable strings.
    /// Defaults to false: no configurable strings will be resolved.
    /// Configurable strings must have been enabled when the options were built to have them resolved at runtime.
    pub are_configurable_strings_enabled: bool,
    pub are_configurable_values_enabled: bool,
    pub constraints: Option<Constraints>,
    /// Overrides to apply after the built configuration.
    pub overrides: Option<SourceValue>,
    /// Determines if the feature names should be converted to canonical feature names.
    /// Defaults to false: given features names will be converted to canonical feature names before looking for features or options.
    pub skip_feature_name_conversion: bool,
}

impl Default for GetOptionsPreferences {
    fn default() -> Self {
        Self::new()
    }
}

impl GetOptionsPreferences {
    pub fn new() -> Self {
        Self {
            are_configurable_strings_enabled: false,
            are_configurable_values_enabled: false,
            constraints: None,
            overrides: None,
            skip_feature_name_conversion: false,
        }
    }

    pub fn are_configurable_values_enabled(&self) -> bool {
        // Assume that if `are_configurable_strings_enabled` (the legacy value),
        // then they will want configurable lists too.
        self.are_configurable_values_enabled || self.are_configurable_strings_enabled
    }

    pub fn set_constraints(&mut self, constraints: Option<serde_json::Value>) {
        self.constraints = constraints.map(|c| Constraints { constraints: c });
    }

    pub fn set_constraints_json(&mut self, constraints: Option<&str>) {
        self.constraints = constraints.map(|c| Constraints {
            constraints: serde_json::from_str(c).expect("constraints should be valid JSON"),
        });
    }
}