switchbox-flags 0.4.0__tar.gz → 0.5.0__tar.gz

{switchbox_flags-0.4.0 → switchbox_flags-0.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: switchbox-flags
-Version: 0.4.0
+Version: 0.5.0
 Summary: Feature flag SDK with zero dependencies
 Project-URL: Homepage, https://github.com/ignat14/switchbox-sdk-python
 Project-URL: Repository, https://github.com/ignat14/switchbox-sdk-python

{switchbox_flags-0.4.0 → switchbox_flags-0.5.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "switchbox-flags"
-version = "0.4.0"
+version = "0.5.0"
 description = "Feature flag SDK with zero dependencies"
 readme = "README.md"
 license = "MIT"

{switchbox_flags-0.4.0 → switchbox_flags-0.5.0}/switchbox/__init__.py

@@ -1,5 +1,5 @@
 from switchbox.client import Switchbox
 from switchbox.exceptions import SwitchboxError
 
-__version__ = "0.4.0"
+__version__ = "0.5.0"
 __all__ = ["Switchbox", "SwitchboxError"]

{switchbox_flags-0.4.0 → switchbox_flags-0.5.0}/switchbox/evaluator.py

@@ -88,10 +88,16 @@ def evaluate(flag: Flag, user_context: dict | None = None) -> bool | str | int |
 
 
 def _enabled_value(flag: Flag) -> bool | str | int | Any:
-    """Return the appropriate 'enabled' value based on flag type."""
+    """The value served to matched / in-rollout users.
+
+    Boolean flags serve ``True``. Non-boolean flags serve ``enabled_value``
+    (variations, ADR-017), falling back to ``default_value`` when it's unset —
+    so a config without ``enabled_value`` behaves exactly as before. Fallback is
+    at evaluation time (not parse time) so directly-constructed Flags work too,
+    matching the JS SDK's ``?? default_value``."""
     if flag.flag_type == "boolean":
         return True
-    return flag.default_value
+    return flag.enabled_value if flag.enabled_value is not None else flag.default_value
 
 
 def _to_groups(rules: list) -> list[RuleGroup]:

{switchbox_flags-0.4.0 → switchbox_flags-0.5.0}/switchbox/models.py

@@ -29,6 +29,10 @@ class Flag:
     rollout_pct: int
     flag_type: str  # boolean | string | number | json
     default_value: Any
+    # The "on"/matched value for non-boolean flags (variations, ADR-017). None
+    # means "unset" — the evaluator falls back to default_value, so configs
+    # without this key behave exactly as before. Boolean flags ignore it.
+    enabled_value: Any = None
     rules: list[RuleGroup] = field(default_factory=list)
 
 
@@ -62,6 +66,7 @@ class FlagConfig:
                 rollout_pct=flag_data.get("rollout_pct", 0),
                 flag_type=flag_data.get("flag_type", "boolean"),
                 default_value=flag_data.get("default_value"),
+                enabled_value=flag_data.get("enabled_value"),
                 rules=rules,
             )
         return cls(version=data.get("version", ""), flags=flags)

{switchbox_flags-0.4.0 → switchbox_flags-0.5.0}/tests/parity_vectors.json

@@ -34,6 +34,12 @@
     {"name": "DNF: second group matches (OR across groups) -> enabled", "flag_key": "f", "flag": {"enabled": true, "rollout_pct": 0, "flag_type": "boolean", "default_value": false, "rules": [{"conditions": [{"attribute": "country", "operator": "equals", "value": "US"}]}, {"conditions": [{"attribute": "plan", "operator": "equals", "value": "ent"}]}]}, "user": {"plan": "ent"}, "expected": true},
     {"name": "DNF: no group matches (OR across groups) -> default", "flag_key": "f", "flag": {"enabled": true, "rollout_pct": 0, "flag_type": "boolean", "default_value": false, "rules": [{"conditions": [{"attribute": "country", "operator": "equals", "value": "US"}]}, {"conditions": [{"attribute": "plan", "operator": "equals", "value": "ent"}]}]}, "user": {"plan": "free", "country": "EU"}, "expected": false},
     {"name": "DNF: empty-conditions group never matches -> default", "flag_key": "f", "flag": {"enabled": true, "rollout_pct": 0, "flag_type": "boolean", "default_value": false, "rules": [{"conditions": []}]}, "user": {"any": "thing"}, "expected": false},
-    {"name": "DNF back-compat: legacy flat rule still matches -> enabled", "flag_key": "f", "flag": {"enabled": true, "rollout_pct": 0, "flag_type": "boolean", "default_value": false, "rules": [{"attribute": "plan", "operator": "equals", "value": "pro"}]}, "user": {"plan": "pro"}, "expected": true}
+    {"name": "DNF back-compat: legacy flat rule still matches -> enabled", "flag_key": "f", "flag": {"enabled": true, "rollout_pct": 0, "flag_type": "boolean", "default_value": false, "rules": [{"attribute": "plan", "operator": "equals", "value": "pro"}]}, "user": {"plan": "pro"}, "expected": true},
+    {"name": "variation: string flag rule match serves enabled_value", "flag_key": "f", "flag": {"enabled": true, "rollout_pct": 0, "flag_type": "string", "default_value": "Shop", "enabled_value": "Buy now", "rules": [{"conditions": [{"attribute": "plan", "operator": "equals", "value": "pro"}]}]}, "user": {"plan": "pro", "user_id": "u1"}, "expected": "Buy now"},
+    {"name": "variation: string flag no match serves default_value", "flag_key": "f", "flag": {"enabled": true, "rollout_pct": 0, "flag_type": "string", "default_value": "Shop", "enabled_value": "Buy now", "rules": [{"conditions": [{"attribute": "plan", "operator": "equals", "value": "pro"}]}]}, "user": {"plan": "free", "user_id": "u1"}, "expected": "Shop"},
+    {"name": "variation: absent enabled_value falls back to default on match", "flag_key": "f", "flag": {"enabled": true, "rollout_pct": 0, "flag_type": "string", "default_value": "Shop", "rules": [{"conditions": [{"attribute": "plan", "operator": "equals", "value": "pro"}]}]}, "user": {"plan": "pro", "user_id": "u1"}, "expected": "Shop"},
+    {"name": "variation: number flag rollout 100 no context serves enabled_value", "flag_key": "f", "flag": {"enabled": true, "rollout_pct": 100, "flag_type": "number", "default_value": 0, "enabled_value": 42, "rules": []}, "user": null, "expected": 42},
+    {"name": "variation: disabled non-boolean serves default_value", "flag_key": "f", "flag": {"enabled": false, "rollout_pct": 100, "flag_type": "string", "default_value": "Shop", "enabled_value": "Buy now", "rules": []}, "user": {"user_id": "u1"}, "expected": "Shop"},
+    {"name": "variation: boolean flag ignores enabled_value (serves true)", "flag_key": "f", "flag": {"enabled": true, "rollout_pct": 100, "flag_type": "boolean", "default_value": false, "enabled_value": "ignored", "rules": []}, "user": null, "expected": true}
   ]
 }

{switchbox_flags-0.4.0 → switchbox_flags-0.5.0}/uv.lock

@@ -236,7 +236,7 @@ wheels = [
 
 [[package]]
 name = "switchbox-flags"
-version = "0.4.0"
+version = "0.5.0"
 source = { editable = "." }
 
 [package.optional-dependencies]