jKj(dZddlmZddlmZmZmZmZmZm Z m Z m Z ddl m Z edGddZeGd d ZGd d Zy )uCFeatureFlagEvaluations — a snapshot of feature flag values for a single distinct_id. Returned by Client.evaluate_flags(). Branch on .is_enabled() / .get_flag(), then pass the same snapshot to capture() via the `flags` option so events carry the exact flag values the code branched on, with no additional /flags request. ) dataclass)AnyCallableDictListMappingOptionalSetUnion) FlagValueT)frozenceZdZUdZeed<eed<eeed<eeed<ee ed<ee ed<eeed<eed <y ) _EvaluatedFlagRecordzEInternal per-flag record stored by a FeatureFlagEvaluations instance.keyenabledvariantpayloadidversionreasonlocally_evaluatedN) __name__ __module__ __qualname____doc__str__annotations__boolr rintq/Users/ahmed/devFolder/Ultron/claude-voice/.venv/lib/python3.12/site-packages/posthog/feature_flag_evaluations.pyrrsGO H M c] c]  c] SMr!rc8eZdZUdZeded<eegdfed<y)_FeatureFlagEvaluationsHostuCallbacks the evaluations object uses to talk back to the client. Kept as a plain dataclass of callables so the class stays decoupled from the full Client surface — this also makes it trivial to construct a fake host in tests. ).N#capture_flag_called_event_if_neededN log_warning)rrrrrrrr r!r"r$r$s% *2))<<3%+&&r!r$ceZdZdZ ddededeeefdee ee ee ffdee deed ee d e d e d ee ed dfdZded e fdZded eefdZded eefdZddZdeed dfdZed eefdZd eeeffdZed efdZed eee ee fffdZdeeefd dfdZded dfdZy)FeatureFlagEvaluationsusA point-in-time snapshot of feature flag evaluations for a single distinct_id. Returned by :meth:`Client.evaluate_flags` — branch on :meth:`is_enabled` / :meth:`get_flag` and pass the same object to :meth:`Client.capture` via the ``flags`` option so the captured event carries the exact flag values the code branched on. Example:: flags = posthog.evaluate_flags(distinct_id, person_properties={"plan": "enterprise"}) if flags.is_enabled("new-dashboard"): render_new_dashboard() posthog.capture("page_viewed", distinct_id=distinct_id, flags=flags) To narrow the set of flags that get attached to a captured event, use the in-memory helpers :meth:`only` and :meth:`only_accessed`. To narrow the set of flags requested from the server in the first place, pass ``flag_keys`` to :meth:`Client.evaluate_flags`. Nhost distinct_idflagsgroups disable_geoip request_id evaluated_aterrors_while_computing quota_limitedaccessedreturnc ||_||_||_t|xsi|_||_||_||_||_| |_ | t| |_ yt|_ y)uNInternal — instances are created by the SDK via ``Client.evaluate_flags()``.N) _host _distinct_id_flagsdict_groups_disable_geoip _request_id _evaluated_at_errors_while_computing_quota_limitedset _accessed) selfr)r*r+r,r-r.r/r0r1r2s r"__init__zFeatureFlagEvaluations.__init__<sj ' 37 "3E +%)'=$+4<4H3x=cer!rc|jj|}|j||rt|jSdS)a$Return whether the flag is enabled. Fires ``$feature_flag_called`` on the first access per (distinct_id, flag, value) tuple, deduped via the SDK's cache. Flags that were not returned from the underlying evaluation are treated as disabled (returns ``False``). F)r7get_record_accessrrrArflags r" is_enabledz!FeatureFlagEvaluations.is_enabledUs:{{s# C %)tDLL!4u4r!c|jj|}|j||sy|jsy|j |jSdS)a(Return the flag value. Fires ``$feature_flag_called`` on first access. Returns the variant string for multivariate flags, ``True`` for enabled flags without a variant, ``False`` for disabled flags, and ``None`` for flags that were not returned by the evaluation. NFT)r7rDrErrrFs r"get_flagzFeatureFlagEvaluations.get_flag`sL{{s# C ||#||7t||ATAr!cX|jj|}|r |jSdS)zReturn the payload associated with a flag. Does not count as an access for :meth:`only_accessed` and does not fire any event. N)r7rDrrFs r"get_flag_payloadz'FeatureFlagEvaluations.get_flag_payloados' {{s##t||--r!c|jDcic]!}||jvs||j|#}}|j|Scc}w)u1Return a filtered copy containing only flags accessed via :meth:`is_enabled` or :meth:`get_flag` before this call. Order-dependent: if nothing has been accessed yet, the returned snapshot is empty. The method honors its name — pre-access if you want a populated result. )r@r7 _clone_with)rAkfiltereds r" only_accessedz$FeatureFlagEvaluations.only_accessedwsK04~~R~!dkkAQAt{{1~%~R))Ss AAkeysci}g}|D]6}|jj|}||||<&|j|8|r-|jj ddj ||j |S)zReturn a filtered copy containing only flags with the given keys. Keys that are not present in the evaluation are dropped and logged as a warning. zpFeatureFlagEvaluations.only() was called with flag keys that are not in the evaluation set and will be dropped: z, )r7rDappendr5r&joinrN)rArRrPmissingrrGs r"onlyzFeatureFlagEvaluations.onlys57C;;??3'D $ s#   JJ " "77;yy7I6JL ))r!cHt|jjS)z6Return the flag keys that are part of this evaluation.)listr7rRrAs r"rRzFeatureFlagEvaluations.keyssDKK$$&''r!ci}g}|jjD]S\}}|jsdn|j |jnd}||d|<|jsC|j |U|rt ||d<|S)uBuild the ``$feature/*`` and ``$active_feature_flags`` properties for an event. Internal — called by capture() when an event is captured with ``flags=...``. FT $feature/z$active_feature_flags)r7itemsrrrTsorted)rA properties active_flagsrrGvalues r"_get_event_propertiesz,FeatureFlagEvaluations._get_event_propertiess &( "$ **,IC||&*ll&>dllD  -2J3%( )||##C(- 282FJ. /r!c|jSN)r6rZs r"_internal_distinct_idz,FeatureFlagEvaluations._internal_distinct_ids   r!c|jSrd)r9rZs r"_internal_groupsz'FeatureFlagEvaluations._internal_groupss ||r!ct|j|j||j|j|j |j |j|jt|j S)N) r)r*r+r,r-r.r/r0r1r2) r(r5r6r9r:r;r<r=r>r?r@)rAr+s r"rNz"FeatureFlagEvaluations._clone_withsf&))<<--''++#'#?#?--(  r!c|jj||jsy|jj |}|d}n)|j sd}n|j |j nd}d|d|d|r |jndd||i}|l|j|j|d<|jr|j|d<|jr|j|d <|jr|j|d <|jr|j|d <|jr|r |js|j|d <g}|jr|jd |j r|jd||jd|rdj#||d<|j$j'|j|||j(|j*|y)NFTz $feature_flagz$feature_flag_responserr\z$feature_flag_payloadz$feature_flag_idz$feature_flag_versionz$feature_flag_reasonz$feature_flag_request_idz$feature_flag_evaluated_aterrors_while_computing_flagsr1 flag_missing,z$feature_flag_error)r*rresponser,r-r_)r@addr6r7rDrrrrrrrr;r<r=rTr>rUr5r%r9r:)rArrGrmr_errorss r"rEz%FeatureFlagEvaluations._record_accesss 3   {{s# <,0HH'+||'?t||TH S $h 4!7!7Uu x &   ||'6:ll 23ww15 -.||6:ll 23{{59[[ 12   595E5EJ1 2   t0F0F7;7I7IJ3 4   ' ' MM8 9    MM/ * < MM. ) 030@J, - 66))<<--! 7 r!)NNNNFFN)r3r()rrrrr$rrrr rr rrr rBrHr rJrrLrQrrWpropertyrRrbrergrNrEr r!r"r(r((s0;?(,$(&*',#'+T)TTC--. T eCHo!567 T  ~ TSMTsmT!%TT3s8$T T2 5c 5d 5 BC BHY$7 B.C.HSM.**c*'?*&(d3i(( tCH~(!s!!$sE#s(O';"< #334 ! &; #; $; r!r(N)r dataclassesrtypingrrrrrr r r posthog.typesr rr$r(r r!r"rts^"KKK# $    '' '] ] r!