U %FZh@sbdZddlZddlZddlZddlZddlmZmZmZm Z m Z ddl m Z ddl Z ddlZddlZddlmZmZmZddlZejejdeeZdZdZed ZGd d d e ZGd d d e ZGdddZGdddZGdddZ GdddZ!GdddZ"d eeee#e#fdddZ$d!eeee#e#fee#dddZ%GdddZ&dS)"zxFirebase Remote Config Module. This module has required APIs for the clients to use Firebase Remote Config with python. N)DictOptionalLiteralUnionAny)Enum)App _http_client_utils)levelZ _remoteconfig )defaultremotestaticc@s eZdZdZdZdZdZdZdS)PercentConditionOperatorzFEnum representing the available operators for percent conditions. LESS_OR_EQUAL GREATER_THANBETWEENUNKNOWNN)__name__ __module__ __qualname____doc__rrrrrrc/home/aprabhat/apps/x.techxrdev.in/venv/lib/python3.8/site-packages/firebase_admin/remote_config.pyr's rc@sTeZdZdZdZdZdZdZdZdZ dZ d Z d Z d Z d Zd ZdZdZdZdZdZdS)CustomSignalOperatorzLEnum representing the available operators for custom signal conditions. STRING_CONTAINSSTRING_DOES_NOT_CONTAINSTRING_EXACTLY_MATCHESSTRING_CONTAINS_REGEXNUMERIC_LESS_THANNUMERIC_LESS_EQUAL NUMERIC_EQUALNUMERIC_NOT_EQUALNUMERIC_GREATER_THANNUMERIC_GREATER_EQUALSEMANTIC_VERSION_LESS_THANSEMANTIC_VERSION_LESS_EQUALSEMANTIC_VERSION_EQUALSEMANTIC_VERSION_NOT_EQUALSEMANTIC_VERSION_GREATER_THANSEMANTIC_VERSION_GREATER_EQUALrN)rrrrrrrrr r!r"r#r$r%r&r'r(r)r*r+rrrrrr/s$rc@sTeZdZdZddZeddZeddZedd Zed d Z ed d Z dS)_ServerTemplateDataz>Parses, validates and encapsulates template data and metadata.cCsd|kr*|ddk r |d|_q0tdni|_d|krZ|ddk rP|d|_q`tdng|_d|_d|krx|d|_d|_d|krt|dtr|d|_t||_ dS) zInitializes a new ServerTemplateData instance. Args: template_data: The data to be parsed for getting the parameters and conditions. Raises: ValueError: If the template data is not valid. parametersNz2Remote Config parameters must be a non-null object conditionsz2Remote Config conditions must be a non-null objectversionetag) _parameters ValueError _conditions_version_etag isinstancestrjsondumps_template_data_json)self template_datarrr__init__Fs"         z_ServerTemplateData.__init__cCs|jSN)r2r<rrrr-isz_ServerTemplateData.parameterscCs|jSr?)r6r@rrrr1msz_ServerTemplateData.etagcCs|jSr?)r5r@rrrr0qsz_ServerTemplateData.versioncCs|jSr?)r4r@rrrr.usz_ServerTemplateData.conditionscCs|jSr?)r;r@rrrtemplate_data_jsonysz&_ServerTemplateData.template_data_jsonN) rrrrr>propertyr-r1r0r.rArrrrr,Ds#    r,c@sreZdZdZdeeeeefdddZddZ deeee ee ffdd d d Z ed d dZ ddZdS)ServerTemplatezZRepresents a Server Template with implementations for loading and evaluating the template.Nappdefault_configcCsNt|tt|_d|_i|_t|_ |dk rJ|D]}t |||j|<q2dS)aInitializes a ServerTemplate instance. Args: app: App instance to be used. This is optional and the default app instance will be used if not present. default_config: The default config to be used in the evaluated config. N) r Zget_app_service_REMOTE_CONFIG_ATTRIBUTE_RemoteConfigService _rc_service_cache_stringified_default_config threadingRLock_lockr8)r<rErFkeyrrrr>s zServerTemplate.__init__c s,|jIdH}|j ||_W5QRXdS)z0Fetches the server template and caches the data.N)rIget_server_templaterNrJ)r<Zrc_server_templaterrrloadszServerTemplate.load ServerConfig)contextreturnc Cs|jstd|pi}i}|j|jj}|jj}W5QRX|jdk rh|jD]\}}td|||<qPt|||||_ t |j dS)a"Evaluates the cached server template to produce a ServerConfig. Args: context: A dictionary of values to use for evaluating conditions. Returns: A ServerConfig object. Raises: ValueError: If the input arguments are invalid. zmNo Remote Config Server template in cache. Call load() before calling evaluate().Nr ) config_values) rJr3rNr.r-rKitems_Value_ConditionEvaluatorZ _evaluatorrRevaluate)r<rSrUZtemplate_conditionsZtemplate_parametersrOvaluerrrrYs  zServerTemplate.evaluate)rAc Cs.t|}t|}|j ||_W5QRXdS)zUpdates the cache to store the given template is of type ServerTemplateData. Args: template_data_json: A json string representing ServerTemplateData to be cached. N)r9loadsr,rNrJ)r<rAZtemplate_data_mapr=rrrsets zServerTemplate.setc Cs,|jstd|j|jj}W5QRX|S)zRProvides the server template in a JSON format to be used for initialization later.zkNo Remote Config Server template in cache. Call load() before calling toJSON().)rJr3rNrA)r<Z template_jsonrrrto_jsons zServerTemplate.to_json)NN)N)rrrrrrrr8r>rQrintrYr\r]rrrrrC~s & rCc@sHeZdZdZddZddZddZdd Zd d Zd d Z ddZ dS)rRz.Represents a Remote Config Server Side Config.cCs ||_dSr?)_config_values)r<rUrrrr>szServerConfig.__init__cCs||S)Returns the value as a boolean.) _get_value as_booleanr<rOrrr get_booleanszServerConfig.get_booleancCs||S)Returns the value as a string.)ra as_stringrcrrr get_stringszServerConfig.get_stringcCs||S)z Returns the value as an integer.)raas_intrcrrrget_intszServerConfig.get_intcCs||S)zReturns the value as a float.)raas_floatrcrrr get_floatszServerConfig.get_floatcCs||Sz Returns the source of the value.)ra get_sourcercrrrget_value_sourceszServerConfig.get_value_sourcecCs|j|tdS)Nr)r_getrWrcrrrraszServerConfig._get_valueN) rrrrr>rdrgrirkrnrarrrrrRsrRc@s:eZdZdZddZddZddZeedd d Z d S) rHzhInternal class that facilitates sending requests to the Firebase Remote Config backend API. cCsNd}|j|_|j}ddtji}|jdt j }t j ||||d|_ dS)zInitialize a JsonHttpClient with necessary inputs. Args: app: App instance to be used for fetching app specific details required for initializing the http client. z+https://firebaseremoteconfig.googleapis.comzX-FIREBASE-CLIENTzfire-admin-python/{0}Z httpTimeout) credentialbase_urlheaderstimeoutN) Z project_id _project_idrpget_credentialformatfirebase_admin __version__optionsror ZDEFAULT_TIMEOUT_SECONDSZJsonHttpClient_client)r<rEZremote_config_base_urlZapp_credentialZ rc_headersrsrrrr>s  z_RemoteConfigService.__init__c szz.t}|d|jjd|IdH\}}Wn0tjjk r^}z| |W5d}~XYnX| d|d<t |SdS)zRequests for a server template and converts the response to an instance of ServerTemplateData for storing the template parameters and conditions.Nror1) asyncioZget_event_loopZrun_in_executorrzZheaders_and_body_get_urlrequests exceptionsRequestException_handle_remote_config_errorror,)r<looprrr=errorrrrrPsz(_RemoteConfigService.get_server_templatecCs d|jS)zJReturns project prefix for url, in the format of /v1/projects/${projectId}z>/v1/projects/{0}/namespaces/firebase-server/serverRemoteConfig)rvrtr@rrrr|sz_RemoteConfigService._get_url)rcCs t|S)z5Handles errors received from the Cloud Functions API.)r Z#handle_platform_error_from_requests)clsrrrrrsz0_RemoteConfigService._handle_remote_config_errorN) rrrrr>rPr| classmethodrrrrrrrHs rHc@seZdZdZddZddZeeefdddZ d!e ed d d Z d"e ed d dZ d#e ed ddZ edddZee dddZedddZedddZedddZedddZedddZd S)$rXz_Internal class that facilitates sending requests to the Firebase Remote Config backend API.cCs||_||_||_||_dSr?)_contextr4r2r_)r<r.r-rSrUrrrr>!sz_ConditionEvaluator.__init__c Cs||j|j}|jr|jD]\}}|di}|di}d}|rr|D] \}}||krP|rP||}qrqP|r|drtd|q |r|d} td| |j |<q |st d|q |drtd|q td|d|j |<q |j S) z]Internal function that evaluates the cached server template to produce a ServerConfigZconditionalValuesZ defaultValueNZuseInAppDefaultz'Using in-app default value for key '%s'rZrz#No default value found for key '%s') evaluate_conditionsr4rr2rVrologgerinforWr_warning) r<evaluated_conditionsrOZ parameterZconditional_values default_valueZparameter_value_wrapperZcondition_nameZcondition_evaluationZparameter_valuerrrrY's4        z_ConditionEvaluator.evaluaterTcCs.i}|D] }||d|||d<q|S)a%Evaluates a list of conditions and returns a dictionary of results. Args: conditions: A list of NamedCondition objects. context: An EvaluationContext object. Returns: A dictionary that maps condition names to boolean evaluation results. conditionname)evaluate_conditionro)r<r.rSrrrrrrMs z'_ConditionEvaluator.evaluate_conditionsr) nesting_levelrTcCs|tkrtddS|ddk r<||d||dS|ddk rb||d||dS|ddk rtdS|d dk rdS|d dk r||d |S|d dk r||d |Std dS) aRecursively evaluates a condition. Args: condition: The condition to evaluate. context: An EvaluationContext object. nesting_level: The current recursion depth. Returns: The boolean result of the condition evaluation. z+Maximum condition recursion depth exceeded.FZ orConditionNZ andConditiontrueTfalsepercentZ customSignalz#Unknown condition type encountered.)MAX_CONDITION_RECURSION_DEPTHrrroevaluate_or_conditionevaluate_and_conditionevaluate_percent_condition evaluate_custom_signal_condition)r<rrSrrrrr^s.     z&_ConditionEvaluator.evaluate_conditioncCs8|dp g}|D] }||||d}|rdSqdS)a&Evaluates an OR condition. Args: or_condition: The OR condition to evaluate. context: An EvaluationContext object. nesting_level: The current recursion depth. Returns: True if any of the subconditions are true, False otherwise. r.rTFror)r<Z or_conditionrSrsub_conditions sub_conditionresultrrrr~s z)_ConditionEvaluator.evaluate_or_conditioncCs8|dp g}|D] }||||d}|sdSqdS)a(Evaluates an AND condition. Args: and_condition: The AND condition to evaluate. context: An EvaluationContext object. nesting_level: The current recursion depth. Returns: True if all of the subconditions are met; False otherwise. r.rFTr)r<Z and_conditionrSrrrrrrrrs z*_ConditionEvaluator.evaluate_and_conditioncCs |dstddS|d}|d}|d}|d}|sRtddS|rt|d pbd }|d ppd }nd }d }|r|} nd } |r|d nd } | |d} || } | d} |tjjkr| | kS|tjjkr| | kS|tjjkr|| ko |kSStd|dS)zEvaluates a percent condition. Args: percent_condition: The percent condition to evaluate. context: An EvaluationContext object. Returns: True if the condition is met, False otherwise. Zrandomization_idzEMissing randomization_id in context for evaluating percent condition.FseedZpercentOperatorZ microPercentZmicroPercentRangez/Missing percent operator for percent condition.ZmicroPercentUpperBoundrZmicroPercentLowerBound.r/izUnknown percent operator: %s) rorrhash_seeded_randomization_idrrrZrr)r<Zpercent_conditionrSrZpercent_operatorZ micro_percentZmicro_percent_rangeZnorm_percent_upper_boundZnorm_percent_lower_boundZnorm_micro_percentZ seed_prefixZstring_to_hashhash64Zinstance_micro_percentilerrrrs<           z._ConditionEvaluator.evaluate_percent_condition)seeded_randomization_idrTcCs.t}||d|}tt|dS)zHashes a seeded randomization ID. Args: seeded_randomization_id: The seeded randomization ID to hash. Returns: The hashed value. zutf-8)hashlibsha256updateencode hexdigestabsr^)r<rZ hash_objectrrrrrs z0_ConditionEvaluator.hash_seeded_randomization_idcCs|dp i}|dpi}|dp(i}t|||gsFtddS|sNdS||pZi}|sptd|dS|tjjkr|||ddS|tj jkr|||d d S|tj jkr|||d dS|tj jkr|||t j S|tjjkr|||d |d dS|tjjkr4|||d |d dS|tjjkrZ|||d |ddS|tjjkr|||d |ddS|tjjkr|||d |ddS|tjjkr|||d |ddS|tjjkr|||d |ddS|tjjkr|||d |ddS|tjjkr>|||d |ddS|tjjkrd|||d |ddS|tjjkr|||d |ddS|tjjkr|||d |ddStd|dS)aEvaluates a custom signal condition. Args: custom_signal_condition: The custom signal condition to evaluate. context: An EvaluationContext object. Returns: True if the condition is met, False otherwise. ZcustomSignalOperatorZcustomSignalKeyZtargetCustomSignalValueszDMissing operator, key, or target values for custom signal condition.Fz,Custom signal value not found in context: %scSs||kSr?rtargetactualrrrzF_ConditionEvaluator.evaluate_custom_signal_condition..cSs||kSr?rrrrrrrcSs||kSr?)striprrrrrrrcSs|dkSNrrrrrrrrcSs|dkSrrrrrrrrcSs|dkSrrrrrrrrcSs|dkSrrrrrrr"rcSs|dkSrrrrrrr'rcSs|dkSrrrrrrr,rcSs|dkSrrrrrrr3rcSs|dkSrrrrrrr8rcSs|dkSrrrrrrr=rcSs|dkSrrrrrrrBrcSs|dkSrrrrrrrGrcSs|dkSrrrrrrrLrz"Unknown custom signal operator: %s)roallrrdebugrrrZ_compare_stringsrrrresearchr _compare_numbersr!r"r#r$r%r&_compare_semantic_versionsr'r(r)r*r+)r<Zcustom_signal_conditionrSZcustom_signal_operatorcustom_signal_keyZtarget_custom_signal_valuesZactual_custom_signal_valuerrrrs         z4_ConditionEvaluator.evaluate_custom_signal_conditioncCs"|D]}||t|rdSqdS)ajCompares the actual string value of a signal against a list of target values. Args: target_values: A list of target string values. actual_value: The actual value to compare, which can be a string or number. predicate_fn: A function that takes two string arguments (target and actual) and returns a boolean indicating whether the target matches the actual value. Returns: bool: True if the predicate function returns True for any target value in the list, False otherwise. TF)r8)r<Z target_values actual_value predicate_fnrrrrrPsz$_ConditionEvaluator._compare_stringscCs^z6t|}t|}||krdn||kr*dnd}||WStk rXtd|YdSXdS)Nrrz>Invalid numeric value for comparison for custom signal key %s.F)floatr3rr)r<r target_valuerrrrrrrrrds z$_ConditionEvaluator._compare_numberscCs||t|t||S)aCompares the actual semantic version value of a signal against a target value. Calls the predicate function with -1, 0, 1 if actual is less than, equal to, or greater than target. Args: custom_signal_key: The custom signal for which the evaluation is being performed. target_values: A list of target string values. actual_value: The actual value to compare, which can be a string or number. predicate_fn: A function that takes an integer (-1, 0, or 1) and returns a boolean. Returns: bool: True if the predicate function returns True for the result of the comparison, False otherwise. )_compare_versionsr8)r<rrrrrrrros z._ConditionEvaluator._compare_semantic_versionsc Cszdd|dD}dd|dD}tt|t|}|dg|t||dg|t|t||D]L\}} t|dk| dkfrt|| kr|dWS|| krv|dWSqv|dWStk rtd|Yd SXd S) aCompares two semantic version strings. Args: custom_signal_key: The custom singal for which the evaluation is being performed. sem_version_1: The first semantic version string. sem_version_2: The second semantic version string. predicate_fn: A function that takes an integer and returns a boolean. Returns: bool: The result of the predicate function. cSsg|] }t|qSrr^.0partrrr sz9_ConditionEvaluator._compare_versions..rcSsg|] }t|qSrrrrrrrsrrrzHInvalid semantic version format for comparison for custom signal key %s.FN) splitmaxlenextendzipanyr3rr) r<rZ sem_version_1Z sem_version_2rZv1_partsZv2_parts max_lengthZpart1Zpart2rrrrs(  z%_ConditionEvaluator._compare_versionsN)r)r)r)rrrrr>rYrr8boolrr^rrrrrrrrrrrrrrrXs<& "   - o  rXrDcst||d}|IdH|S)aInitializes a new ServerTemplate instance and fetches the server template. Args: app: App instance to be used. This is optional and the default app instance will be used if not present. default_config: The default config to be used in the evaluated config. Returns: ServerTemplate: An object having the cached server template to be used for evaluation. rDN)init_server_templaterQ)rErFtemplaterrrrPs rP)rErFrAcCs"t||d}|dk r|||S)aInitializes a new ServerTemplate instance. Args: app: App instance to be used. This is optional and the default app instance will be used if not present. default_config: The default config to be used in the evaluated config. template_data_json: An optional template data JSON to be set on initialization. Returns: ServerTemplate: A new ServerTemplate instance initialized with an optional template and config. rDN)rCr\)rErFrArrrrrs  rc@seZdZdZdZdZdZdZdddd d d gZefe e d d dZ e dddZ e dddZedddZedddZe dddZdS)rWz3Represents a value fetched from Remote Config. Fr/rg1rtyesyonsourcerZcCs||_||_dS)aInitializes a Value instance. Args: source: The source of the value (e.g., 'default', 'remote', 'static'). "static" indicates the value was defined by a static constant. "default" indicates the value was defined by default config. "remote" indicates the value was defined by config produced by evaluating a template. value: The string value. Nr)r<rrZrrrr>s z_Value.__init__rcCs|jdkr|jSt|jS)rer)rDEFAULT_VALUE_FOR_STRINGr8rZr@rrrrfs z_Value.as_stringcCs$|jdkr|jSt|j|jkS)r`r)rDEFAULT_VALUE_FOR_BOOLEANr8rZlowerBOOLEAN_TRUTHY_VALUESr@rrrrbs z_Value.as_booleancCs<|jdkr|jSz t|jWStk r6|jYSXdSzReturns the value as a number.rN)rDEFAULT_VALUE_FOR_INTEGERr^rZr3r@rrrrhs   z _Value.as_intcCs<|jdkr|jSz t|jWStk r6|jYSXdSr)rDEFAULT_VALUE_FOR_FLOAT_NUMBERrrZr3r@rrrrjs   z_Value.as_floatcCs|jSrl)rr@rrrrmsz_Value.get_sourceN)rrrrrrrrr ValueSourcer8r>rfrrbrrhrjrmrrrrrWs   rW)NN)NNN)'rr{r9loggingrLtypingrrrrrenumrrrr}rwrr r basicConfigINFO getLoggerrrrGrrrrr,rCrRrHrXr8rPrrWrrrrsB  :T/