U M8c6Z@stdZddlZddlZddlmZddlmZddlmZddl m Z ddl m Z ddl mZmZmZdd lmZdd lmZmZmZmZmZmZeeZed Zed Zed Z dZ!eZ"eZ#GdddZ$e$Z%GdddZ&Gddde Z'Gddde&Z(Gddde&Z)Gddde&Z*GdddZ+GdddeZ,Gdd d Z-Gd!d"d"Z.Gd#d$d$Z/dS)%a| NOTE: All classes and functions in this module are considered private and are subject to abrupt breaking changes. Please do not use them directly. To view the raw JSON that the objects in this module represent, please go to any `endpoint-rule-set.json` file in /botocore/data/// or you can look at the test files in /tests/unit/data/endpoints/valid-rules/ N)Enum) lru_cache) Formatter) NamedTuple) xform_name)IPV4_REquoteurlparse)EndpointResolutionError) ArnParserInvalidArnExceptionis_valid_ipv4_endpoint_urlis_valid_ipv6_endpoint_urlnormalize_url_pathpercent_encodez\{[a-zA-Z#]+\}z(\w+)\[(\d+)\]z^(?!-)[a-zA-Z\d-]{1,63}(?/tmp/pip-unpacked-wheel-ozje0y8b/botocore/endpoint_provider.py__init__:szRuleSetStandardLibrary.__init__cCst|tod|kS)zgDetermine if an object is a function object. :type argument: Any :rtype: bool fn isinstancedictrargumentrrris_func=szRuleSetStandardLibrary.is_funccCst|tod|kS)zhDetermine if an object is a reference object. :type argument: Any :rtype: bool refrrrrris_refEszRuleSetStandardLibrary.is_refcCst|tot|dk S)zlDetermine if an object contains a template string. :type argument: Any :rtpe: bool N)rstrTEMPLATE_STRING_REsearchrrrr is_templateMs  z"RuleSetStandardLibrary.is_templatec Csbd}t|D]N\}}}}|dk rT|}|d}|D] } || }q4|||7}q||7}q|S)zResolve and inject values into a template string. :type value: str :type scope_vars: dict :rtype: str N#)STRING_FORMATTERparsesplit) rvalue scope_varsresultliteral reference_Ztemplate_valueZtemplate_paramsparamrrrresolve_template_stringXs   z.RuleSetStandardLibrary.resolve_template_stringcCsH||r|||S||r.||dS||rD|||S|S)z{Return evaluated value based on type. :type value: Any :type scope_vars: dict :rtype: Any r )r call_functionr!getr%r2)rr+r,rrr resolve_valueks     z$RuleSetStandardLibrary.resolve_valuecCs(t|}|dkrd|}|ddS)zPNormalize function names. :type value: str :rtype: str notr0.)rreplace)rr+Znormalized_namerrrconvert_func_name{s  z(RuleSetStandardLibrary.convert_func_namecsnfdd|dD}|d}t|}||}d|krj|d}|krbtd|dd||<|S) zCall the function with the resolved arguments and assign to `scope_vars` when applicable. :type func_signature: dict :type scope_vars: dict :rtype: Any csg|]}|qSrr5).0argr,rrr sz8RuleSetStandardLibrary.call_function..argvrassignz Assignment z= already exists in scoped variables and cannot be overwrittenmsg)r9getattrr )rfunc_signaturer, func_args func_namefuncr-r@rr=rr3s   z$RuleSetStandardLibrary.call_functioncCs|dk S)zYEvaluates whether a value is set. :type value: Any :rytpe: bool Nrrr+rrris_setszRuleSetStandardLibrary.is_setcCsr|dD]b}t|}|dk rd|\}}t|}||}|dksR|t|krXdS||S||}q |S)apFind an attribute within a value given a path string. The path can contain the name of the attribute and an index in brackets. A period separating attribute names indicates the one to the right is nested. The index will always occur at the end of the path. :type value: dict or list :type path: str :rtype: Any r7N)r* GET_ATTR_REr$groupsintr4len)rr+pathpartmatchnameindexrrrget_attrs      zRuleSetStandardLibrary.get_attrcCs|d}|d|d<|S)NoutputsidrQr)r partitionoutputrrrformat_partition_outputs z.RuleSetStandardLibrary.format_partition_outputcCs$t|d|dk }||dkp"|S)NZ regionRegexZregions)rerP)rZregionrVZ matches_regexrrris_partition_matchsz)RuleSetStandardLibrary.is_partition_matchcCsH|jd}|dk r6|D]}|||r||Sq|d}||S)zbMatch a region string to an AWS partition. :type value: str :rtype: dict partitionsNr)rrZrX)rr+r[rV aws_partitionrrrr\s  z$RuleSetStandardLibrary.aws_partitioncCs|dks|dsdSzt|}Wntk r:YdSXt|d|d|dfsZdS|d|d<|d}|dd d |d <|S) zeParse and validate string for ARN components. :type value: str :rtype: dict Nzarn:rVZserviceresourceaccountZ accountId:/Z resourceId) startswith ARN_PARSERZ parse_arnr allpopr8r*)rr+Zarn_dictr]rrr aws_parse_arns z$RuleSetStandardLibrary.aws_parse_arncsT|dks|dkr"|ddkr"dS|dkrFtfdd|dDSt|dk S)zEvaluates whether a value is a valid host label per RFC 1123. If allow_subdomains is True, split on `.` and validate each component separately. :type value: str :type allow_subdomains: bool :rtype: bool NFr7rTc3s|]}|dVqdSFN)is_valid_host_labelr;labelrrr sz=RuleSetStandardLibrary.is_valid_host_label..)countrcr*VALID_HOST_LABEL_RErPrr+allow_subdomainsrrjrrgs  z*RuleSetStandardLibrary.is_valid_host_labelcCsBtdd||fDs:dt|dt|d}t|d||kS)z|Evaluates two string values for equality. :type value1: str :type value2: str :rtype: bool css|]}t|tVqdSr)rr"r;valrrrrksz7RuleSetStandardLibrary.string_equals..z!Both values must be strings, not  and r7rArctyper rZvalue1Zvalue2rBrrr string_equalss z$RuleSetStandardLibrary.string_equalscCs|dkr dSt|S)zcPerform percent-encoding on an input string. :type value: str :rytpe: str N)rrHrrr uri_encodesz!RuleSetStandardLibrary.uri_encodecCs|dkr dSt|}z |jWntk r4YdSX|j}|j}|dksVt|dkrZdS|j}tt|}| ds|d}||j ||t |pt |dS)z[Parse a URL string into components. :type value: str :rtype: dict N)httpshttprr`)scheme authorityrNZnormalizedPathZisIp) r port ValueErrorrzqueryrMrNrrendswithnetlocr r)rr+Zurl_componentsrzr~rNZnormalized_pathrrr parse_urls,    z RuleSetStandardLibrary.parse_urlcCsBtdd||fDs:dt|dt|d}t|d||kS)zEvaluates two boolean values for equality. :type value1: bool :type value2: bool :rtype: bool css|]}t|tVqdSr)rboolrprrrrkJsz8RuleSetStandardLibrary.boolean_equals..z"Both arguments must be bools, not rrr7rArsrurrrboolean_equalsCs z%RuleSetStandardLibrary.boolean_equalscCs,z|dWdStk r&YdSXdS)zmEvaluates if a string only contains ASCII characters. :type value: str :rtype: bool asciiTFN)encodeUnicodeEncodeErrorrHrrris_asciiOs  zRuleSetStandardLibrary.is_asciicCs~t|ts$dt|d}t|d||ksBt||ksB||sFdS|dkrrt||}t||}|||S|||S)aComputes a substring given the start index and end index. If `reverse` is True, slice the string from the end instead. :type value: str :type start: int :type end: int :type reverse: bool :rtype: str zInput must be a string, not r7rANT)rr"rtr rMr)rr+startstopreverserBZr_startZr_stoprrr substring[s     z RuleSetStandardLibrary.substringcCs| S)zpA function implementation of the logical operator `not`. :type value: Any :rtype: bool rrHrrr_notrszRuleSetStandardLibrary._notcsd|dks.t|dks.||ks.t|dk r2dS|dkrVtfdd|dDSj|ddS) aEvaluates whether a value is a valid bucket name for virtual host style bucket URLs. To pass, the value must meet the following criteria: 1. is_valid_host_label(value) is True 2. length between 3 and 63 characters (inclusive) 3. does not contain uppercase characters 4. is not formatted as an IP address If allow_subdomains is True, split on `.` and validate each component separately. :type value: str :type allow_subdomains: bool :rtype: bool NFTc3s|]}|dVqdSrf)!aws_is_virtual_hostable_s3_bucketrhrjrrrkszKRuleSetStandardLibrary.aws_is_virtual_hostable_s3_bucket..r7)ro)rMlowerrrPrcr*rgrnrrjrrzs    z8RuleSetStandardLibrary.aws_is_virtual_hostable_s3_bucketN)__name__ __module__ __qualname____doc__rrr!r%r2r5r9r3rIrSrXrZr\rergrvrwrrrrrrrrrrr7s0    %  rc@s*eZdZdZd ddZddZddZdS) BaseRulez-Base interface for individual endpoint rules.NcCs||_||_dSr) conditions documentation)rrrrrrrszBaseRule.__init__cCs tdSr)NotImplementedError)rr,rule_librrrevaluateszBaseRule.evaluatecCs2|jD]&}|||}|dks&|dkrdSqdS)zDetermine if all conditions in a rule are met. :type scope_vars: dict :type rule_lib: RuleSetStandardLibrary :rtype: bool FNT)rr3)rr,rrDr-rrrevaluate_conditionss   zBaseRule.evaluate_conditions)N)rrrrrrrrrrrrs rc@s*eZdZUdZeed<eed<eed<dS)RuleSetEndpointz.A resolved endpoint object returned by a rule.url propertiesheadersN)rrrrr"__annotations__rrrrrrs rcs4eZdZfddZddZddZddZZS) EndpointRulec stjf|||_dSr)superrendpoint)rrkwargs __class__rrrszEndpointRule.__init__cCsT|||rP||jd|}||jdi||}|||}t|||dSdS)zDetermine if conditions are met to provide a valid endpoint. :type scope_vars: dict :rtype: RuleSetEndpoint rr)rrrN)rr5rresolve_propertiesr4resolve_headersr)rr,rrrrrrrrs   zEndpointRule.evaluatecs^t|tr fdd|DSt|trDfdd|DS|rZ|S|S)zTraverse `properties` attribute, resolving any template strings. :type properties: dict/list/str :type scope_vars: dict :type rule_lib: RuleSetStandardLibrary :rtype: dict csg|]}|qSrr)r;proprr,rrrr>sz3EndpointRule.resolve_properties..cs i|]\}}||qSrrr;keyr+rrr sz3EndpointRule.resolve_properties..)rlistritemsr%r2)rrr,rrrrrs    zEndpointRule.resolve_propertiescs@i}|jdi}|D] \}}fdd|D||<q|S)zIterate through headers attribute resolving all values. :type scope_vars: dict :type rule_lib: RuleSetStandardLibrary :rtype: dict rcsg|]}|qSrr:)r;itemrr,rrr>sz0EndpointRule.resolve_headers..)rr4r)rr,rZresolved_headersrheadervaluesrrrrs  zEndpointRule.resolve_headers)rrrrrrr __classcell__rrrrrs rcs$eZdZfddZddZZS) ErrorRulec stjf|||_dSr)rrerror)rrrrrrrszErrorRule.__init__cCs(|||r$||j|}t|ddS)zIf an error rule's conditions are met, raise an error rule. :type scope_vars: dict :type rule_lib: RuleSetStandardLibrary :rtype: EndpointResolutionError rAN)rr5rr )rr,rrrrrrs  zErrorRule.evaluate)rrrrrrrrrrrs rcs(eZdZdZfddZddZZS)TreeRulezA tree rule is non-terminal meaning it will never be returned to a provider. Additionally this means it has no attributes that need to be resolved. c s"tjf|dd|D|_dS)NcSsg|]}tjf|qSr RuleCreatorcreater;rulerrrr>sz%TreeRule.__init__..)rrrules)rrrrrrrszTreeRule.__init__cCs8|||r4|jD] }|||}|r|SqdS)zIf a tree rule's conditions are met, iterate its sub-rules and return first result found. :type scope_vars: dict :type rule_lib: RuleSetStandardLibrary :rtype: RuleSetEndpoint/EndpointResolutionError N)rrrcopy)rr,rrZ rule_resultrrrrs    zTreeRule.evaluate)rrrrrrrrrrrrs rc@s$eZdZeZeZeZe ddZ dS)rcKsN|d}zt||}Wn&tk r>td|ddYn X|f|SdS)z_Create a rule instance from metadata. :rtype: TreeRule/EndpointRule/ErrorRule rtzUnknown rule type: z1. A rule must be of type tree, endpoint or error.rAN)rdrCAttributeErrorr )clsrZ rule_typeZ rule_classrrrr2s  zRuleCreator.createN) rrrrrrrrtree classmethodrrrrrr,s rc@seZdZdZeZeZdS) ParameterTypez8Translation from `type` attribute to native Python type.N)rrrrr"stringrbooleanrrrrrDsrc@s*eZdZdZd ddZddZddZdS) ParameterDefinitionz9The spec of an individual parameter defined in a RuleSet.NcCsf||_ztt|j|_Wn&tk rBtd|ddYnX||_||_ ||_ ||_ ||_ dS)NzUnknown parameter type: z0. A parameter must be of type string or boolean.rA) rQrCrrr+parameter_typerr rbuiltindefaultrequired deprecated)rrQrrbuiltInrrrrrrrNs   zParameterDefinition.__init__cCst||js(td|jd|jdd|jdk r|jd}|jd}|jd}|rh|d |7}|r||d |d7}t|dS) zwPerform base validation on parameter input. :type value: Any :raises: EndpointParametersError zValue (z) is the wrong type. Must be r7rANz has been deprecated.messagesince z Deprecated since )rrr rQrr4loggerinfo)rr+Zdepr_strrBrrrrvalidate_inpuths      z"ParameterDefinition.validate_inputcCs>|dkr0|jdk r|jS|jr:td|jn |||S)z>Process input against spec, applying default if value is None.Nz)Cannot find value for required parameter )rrr rQrrHrrr process_inputs   z!ParameterDefinition.process_input)NNNNN)rrrrrrrrrrrrKs rc@s2eZdZdZd ddZddZddZd d ZdS) RuleSetz:Collection of rules to derive a routable service endpoint.NcCs6||_|||_dd|D|_t||_||_dS)NcSsg|]}tjf|qSrrrrrrr>sz$RuleSet.__init__..)version_ingest_parameter_spec parametersrrrr)rrrrr[rrrrrs   zRuleSet.__init__cCsdd|DS)Nc SsHi|]@\}}|t||d|d|d|d|d|dqS)rtrrrrr)rr4)r;rQspecrrrrs z2RuleSet._ingest_parameter_spec..)r)rrrrrrs zRuleSet._ingest_parameter_speccCs8|jD](\}}|||}|dk r |||<q dS)zYProcess each input parameter against its spec. :type input_params: dict N)rrrr4)rZ input_paramsrQrr+rrrprocess_input_parameterss  z RuleSet.process_input_parameterscCs<|||jD]&}|||j}|dk r|SqdS)zmEvaluate input parameters against rules returning first match. :type input_parameters: dict N)rrrrr)rinput_parametersrZ evaluationrrrrs    zRuleSet.evaluate)N)rrrrrrrrrrrrrs   rc@s*eZdZdZddZeedddZdS)EndpointProviderzsz5EndpointProvider.resolve_endpoint..z"No endpoint found for parameters: rA)rrrjoinrr )rrZparams_for_errorrZ param_stringrrrresolve_endpoints z!EndpointProvider.resolve_endpointN)rrrrrr CACHE_SIZErrrrrrsr)0rloggingrYenumr functoolsrrrtypingrZbotocorerZbotocore.compatrrr Zbotocore.exceptionsr Zbotocore.utilsr r r rrr getLoggerrrcompiler#rJrmrrbr(rZRuleSetStandardLibaryrrrrrrrrrrrrrrsB          gAD2