:hedgehog: PostHog is the leading platform for building self-driving products. Our developer tools – AI observability, analytics, session replay, flags, experiments, error tracking, logs, and more – capture all the context agents need to diagnose problems, uncover opportunities, and ship fixes. Steer it all from Slack, web, desktop, or the MCP.
Python ab-testingai-analyticsanalyticscdpdata-warehouseexperimentsfeature-flagsjavascriptproduct-analyticspythonreactsession-replaysurveystypescriptweb-analytics
"""The experiment-rule view of a feature flag's config.
A v1 flag hosting an experiment is a single implicit experiment rule: the flag-wide
``multivariate`` variants, the first release group's rollout percentage, and the
flag-level holdout/aggregation settings. This module derives that normalized rule
config from the v1 ``filters`` format behind a format check, so a document in another
config format is never read as v1. When the rule-level flag model lands, the
derivation gains a v2 branch and consumers are untouched.
The DTO stays deliberately minimal while the rule-level model is being designed:
no seed handling, no reason mapping. It is the seam for the format swap — do not
grow it into a general flag-read layer (``flag.variants`` and friends remain the
right interface for plain reads).
Deliberately free of Django/DRF imports (same reason as ``facade.filters``):
consumer model modules import this at module level.
"""
from dataclasses import dataclass
from products.feature_flags.backend.facade.config import ConfigFormatError, detect_config_format
@dataclass(frozen=True)
class HoldoutRef:
id: int
exclusion_percentage: float | None
@dataclass(frozen=True)
class ExperimentRuleConfig:
variants: list[dict] # v1 variant dicts: {key, rollout_percentage, name?}
rollout_percentage: float | None
assign_variant_by: int | None # v1: the flag's aggregation_group_type_index (None = persons)
holdout: HoldoutRef | None
def experiment_rule_from_filters(current_filters: dict) -> ExperimentRuleConfig:
"""Derive the implicit experiment rule from a flag's ``filters`` dict.
Only config version 1 carries an implicit rule. Any other format raises
``ConfigFormatError`` before any v1 key is read. Legacy filters can carry stray
``version`` keys, so an unsupported discriminator does not imply a v2 shape.
"""
config_format = detect_config_format(current_filters)
if config_format.kind != "v1":
raise ConfigFormatError(config_format)
return _v1_experiment_rule(current_filters)
def _v1_experiment_rule(current_filters: dict) -> ExperimentRuleConfig:
"""Derive the implicit experiment rule from a v1 ``filters`` dict.
Tolerant of legacy null/partial shapes: an explicit null ``multivariate`` reads as no
variants, and a holdout without an ``id`` reads as no holdout.
"""
groups = current_filters.get("groups") or []
holdout = current_filters.get("holdout") or {}
holdout_id = holdout.get("id")
return ExperimentRuleConfig(
# Explicit nulls occur in real flag data (see FeatureFlag.variants) — coalesce them too.
variants=(current_filters.get("multivariate") or {}).get("variants") or [],
rollout_percentage=groups[0].get("rollout_percentage") if groups else None,
assign_variant_by=current_filters.get("aggregation_group_type_index"),
holdout=HoldoutRef(id=holdout_id, exclusion_percentage=holdout.get("exclusion_percentage"))
if holdout_id
else None,
)