7xj[ndZddlZddlZddlmZddlmZddlmZddl m Z ddl m Z m Z mZddlmZdd lmZmZmZmZmZmZmZejeZejd Zejd Zejd Zd Z hdZ!eZ"eZ#GddZ$e$Z%GddZ&GddeZ'Gdde&Z(Gdde&Z)Gdde&Z*GddZ+GddeZ,Gdd Z-Gd!d"Z.Gd#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) Formatter) NamedTuple) xform_name)IPV4_REquoteurlparse)EndpointResolutionError) ArnParserInvalidArnExceptionis_valid_ipv4_endpoint_urlis_valid_ipv6_endpoint_urllru_cache_weakrefnormalize_url_pathpercent_encodez\{[a-zA-Z#]+\}z(\w*)\[(\d+)\]z^(?!-)[a-zA-Z\d-]{1,63}(?KeyPrefix CopySourceceZdZdZdZdZdZdZdZdZ dZ d Z d Z d Z d Zd ZdZdZdZdZdZdZdZdZdZdZdZdS)RuleSetStandardLibraryz5Rule actions to be performed by the EndpointProvider.c||_dSN)partitions_data)selfrs KC:\Projects\Historical\venv\Lib\site-packages\botocore/endpoint_provider.py__init__zRuleSetStandardLibrary.__init__=s.c4t|tod|vS)zgDetermine if an object is a function object. :type argument: Any :rtype: bool fn isinstancedictrarguments ris_funczRuleSetStandardLibrary.is_func@s (D))>dh.>>rc4t|tod|vS)zhDetermine if an object is a reference object. :type argument: Any :rtype: bool refr!r$s ris_refzRuleSetStandardLibrary.is_refHs (D))?ex.??rcdt|tot|duS)zlDetermine if an object contains a template string. :type argument: Any :rtpe: bool N)r"strTEMPLATE_STRING_REsearchr$s r is_templatez"RuleSetStandardLibrary.is_templatePs2 x % % @"))(334? rcd}t|D]<\}}}}|.|}|d}|D] } || } |||z }7||z }=|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_template_valuetemplate_paramsparams rresolve_template_stringz.RuleSetStandardLibrary.resolve_template_string[s(8(>(>u(E(E " " $GY1$!+"+//#"6"6,;;E%3E%:NNW6n666'! rc||r|||S||r||dS||r|||S|S)z{Return evaluated value based on type. :type value: Any :type scope_vars: dict :rtype: Any r()r& call_functionr)getr.r>)rr5r6s r resolve_valuez$RuleSetStandardLibrary.resolve_valuens <<   C%%eZ88 8 [[   C>>%,// /   e $ $ C//zBB B rcdt|}|dkrd|}|ddS)zPNormalize function names. :type value: str :rtype: str notr:.)rreplace)rr5normalized_names rconvert_func_namez(RuleSetStandardLibrary.convert_func_name~sB (..0 e # #3/33O&&sC000rcfd|dD}|d}t|}||}d|vr%|d}|vrtd|d||<|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 c<g|]}|SrB).0argr6rs r z8RuleSetStandardLibrary.call_function..s9      sJ / /   rargvr assignz Assignment z= already exists in scoped variables and cannot be overwrittenmsg)rHgetattrr )rfunc_signaturer6 func_args func_namefuncr7rQs` ` rr@z$RuleSetStandardLibrary.call_functions     %f-   **>$+?@@ tY''y! ~ % %#H-F##-AfAAA"(Jv  rc |duS)zYEvaluates whether a value is set. :type value: Any :rytpe: bool NrKrr5s ris_setzRuleSetStandardLibrary.is_sets D  rc<|dD]}t|}|_|\}}t |}|r||}||t |krdS||cS||}|S)aqFind 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 tuple :type path: str :rtype: Any rEN)r4 GET_ATTR_REr-groupsintrAlen)rr5pathpartmatchnameindexs rget_attrzRuleSetStandardLibrary.get_attrsJJsOO $ $D&&t,,E #llnn eE ,!IIdOOE=ESZZ$7$744U|###d  rc,|d}|d|d<|S)NoutputsidrdrK)r partitionoutputs rformat_partition_outputz.RuleSetStandardLibrary.format_partition_outputs9%"4v rcTtj|d|du}||dvp|S)N regionRegexregions)rerc)rregionrj matches_regexs ris_partition_matchz)RuleSetStandardLibrary.is_partition_matchs2=!96BB$N 9-->>rc|jd}|2|D]/}|||r||cS0|d}||S)zbMatch a region string to an AWS partition. :type value: str :rtype: dict partitionsNr)rrsrl)rr5rurj aws_partitions rrvz$RuleSetStandardLibrary.aws_partitions ),7  ' C C **5)<<C77 BBBBBC#1 ++M:::rc||dsdS t|}n#t$rYdSwxYwt |d|d|dfsdS|d|d<|d}|dd d |d <|S) zeParse and validate string for ARN components. :type value: str :rtype: dict Nzarn:rjserviceresourceaccount accountId:/ resourceId) startswith ARN_PARSER parse_arnr allpoprFr4)rr5arn_dictrys r aws_parse_arnz$RuleSetStandardLibrary.aws_parse_arns = 0 0 8 8=4 !++E22HH"   44  k "HY$7*9M N   4 ( Y 7 7<< ++!)!1!1#s!;!;!A!A#!F!Fs6 AAc||dur|ddkrdS|dur.tfd|dDSt|duS)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 NFrErTc3DK|]}|dVdS)FN)is_valid_host_label)rMlabelrs r z=RuleSetStandardLibrary.is_valid_host_label..sG((66r)countrr4VALID_HOST_LABEL_RErcrr5allow_subdomainss` rrz*RuleSetStandardLibrary.is_valid_host_labels =,55%++c:J:JQ:N:N5 t # #"[[--  #((//t;;rctd||fDs3dt|dt|d}t|||kS)z|Evaluates two string values for equality. :type value1: str :type value2: str :rtype: bool c3@K|]}t|tVdSr)r"r+rMvals rrz7RuleSetStandardLibrary.string_equals..s,DDC:c3''DDDDDDrz!Both values must be strings, not  and rErRrtyper rvalue1value2rSs r string_equalsz$RuleSetStandardLibrary.string_equals shDDFF3CDDDDD 3Xd6llXXfXXXC)c222 2rc(|dSt|S)zcPerform percent-encoding on an input string. :type value: str :rytpe: str N)rrZs r uri_encodez!RuleSetStandardLibrary.uri_encodes =4e$$$rcv|dSt|} |jn#t$rYdSwxYw|j}|j}|dvst |dkrdS|j}tt|}| ds|d}||j ||t|pt|dS)z[Parse a URL string into components. :type value: str :rtype: dict N)httpshttprr})scheme authorityranormalizedPathisIp) r port ValueErrorrqueryr`rarrendswithnetlocr r)rr5url_componentsrrranormalized_paths r parse_urlz RuleSetStandardLibrary.parse_url"s =4!%        44  &$ * * *c%jj1nn4" 24 8 899'',, 4!0333O'.-.u551)%00    s  ++ctd||fDs3dt|dt|d}t|||uS)zEvaluates two boolean values for equality. :type value1: bool :type value2: bool :rtype: bool c3@K|]}t|tVdSr)r"boolrs rrz8RuleSetStandardLibrary.boolean_equals..Ns,EES:c4((EEEEEErz"Both arguments must be bools, not rrErRrrs rboolean_equalsz%RuleSetStandardLibrary.boolean_equalsGshEEVV4DEEEEE 3YtF||YY$v,,YYYC)c222 2rcT |ddS#t$rYdSwxYw)zmEvaluates if a string only contains ASCII characters. :type value: str :rtype: bool asciiTF)encodeUnicodeEncodeErrorrZs ris_asciizRuleSetStandardLibrary.is_asciiSs@   LL ! ! !4!   55 s  ''cJt|ts#dt|d}t|||ks(t ||ks||sdS|dur.t ||z }t ||z }|||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 rErRNT)r"r+rr r`r)rr5startstopreverserSr_startr_stops r substringz RuleSetStandardLibrary.substring_s%%% 3?e???C)c222 2 D==CJJ--T]]55I5I-4 d??%jj4'GZZ%'F( (U4Z  rc| S)zpA function implementation of the logical operator `not`. :type value: Any :rtype: bool rKrZs r_notzRuleSetStandardLibrary._notvs yrc|?t|dks,||kstj|dS|||S)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 NF)r)r`lowerrrcrrs r!aws_is_virtual_hostable_s3_bucketz8RuleSetStandardLibrary.aws_is_virtual_hostable_s3_bucket~sc M5zzA~~{{}}%%}U##/5'' $4(   rN)__name__ __module__ __qualname____doc__rr&r)r.r>rBrHr@r[rfrlrsrvrrrrrrrrrrrKrrrr:sw??///???@@@    & 1 1 12!!!0 ???;;;"6<<<(     % % %# # # J       !!!.     rrc&eZdZdZddZdZdZdS)BaseRulez-Base interface for individual endpoint rules.Nc"||_||_dSr) conditions documentation)rrrs rrzBaseRule.__init__s$*rctr)NotImplementedError)rr6rule_libs revaluatezBaseRule.evaluates!###rcX|jD]!}|||}|dus|dS"dS)zDetermine if all conditions in a rule are met. :type scope_vars: dict :type rule_lib: RuleSetStandardLibrary :rtype: bool FNT)rr@)rr6rrUr7s revaluate_conditionszBaseRule.evaluate_conditionssH#o  N++NJGGF&.uu#1trr)rrrrrrrrKrrrrsL77++++$$$     rrc2eZdZUdZeed<eed<eed<dS)RuleSetEndpointz.A resolved endpoint object returned by a rule.url propertiesheadersN)rrrrr+__annotations__r#rKrrrrs488 HHH MMMMMrrc0eZdZfdZdZdZdZxZS) EndpointRulec Htjdi|||_dSNrK)superrendpoint)rrkwargs __class__s rrzEndpointRule.__init__s+""6"""  rc$|||ry||jd|}||jdi||}|||}t |||SdS)zDetermine if conditions are met to provide a valid endpoint. :type scope_vars: dict :rtype: RuleSetEndpoint rr)rrrN)rrBrresolve_propertiesrAresolve_headersr)rr6rrrrs rrzEndpointRule.evaluates  # #J 9 9 ((u)=zJJC00 !!,33J **:x@@G"J trct|trfd|DSt|tr"fd|DS|r|S|S)zTraverse `properties` attribute, resolving any template strings. :type properties: dict/list/str :type scope_vars: dict :type rule_lib: RuleSetStandardLibrary :rtype: dict c>g|]}|SrKr)rMproprr6rs rrOz3EndpointRule.resolve_properties..s;''j(CCrcFi|]\}}||SrKr)rMkeyr5rr6rs r z3EndpointRule.resolve_properties..sACT,,UJIIr)r"listr#itemsr.r>)rrr6rs` ``rrzEndpointRule.resolve_propertiess j$ ' ' L&  D ) ) L","2"2"4"4  ! !* - - L33J KK Krci}|jdi}|D]\}}fd|D||<|S)zIterate through headers attribute resolving all values. :type scope_vars: dict :type rule_lib: RuleSetStandardLibrary :rtype: dict rc<g|]}|SrKrL)rMitemrr6s rrOz0EndpointRule.resolve_headers..s6(((=A&&tZ88(((r)rrAr)rr6rresolved_headersrheadervaluess `` rrzEndpointRule.resolve_headerss|-##Ir22%mmoo  NFF(((((EK((( V $ $ r)rrrrrrr __classcell__rs@rrrse!!!!!(.       rrc$eZdZfdZdZxZS) ErrorRulec Htjdi|||_dSr)rrerror)rrrrs rrzErrorRule.__init__s+""6""" rc|||r+||j|}t|dS)zIf an error rule's conditions are met, raise an error rule. :type scope_vars: dict :type rule_lib: RuleSetStandardLibrary :rtype: EndpointResolutionError rRN)rrBrr )rr6rrs rrzErrorRule.evaluatesI  # #J 9 9 5**4:zBBE)e444 4tr)rrrrrrrs@rrrsG       rrc(eZdZdZfdZdZxZS)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 \tjdi|d|D|_dS)Nc0g|]}tjdi|SrK RuleCreatorcreaterMrules rrOz%TreeRule.__init__..)CCCTk(00400CCCrrK)rrrules)rrrrs rrzTreeRule.__init__s9""6"""CCUCCC rc|||r8|jD]0}|||}|r|cS1dS)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)rr6rr rule_results rrzTreeRule.evaluatesh  # #J 9 9 '  ' '"mmJOO,=,=xHH '&&&&'tr)rrrrrrrrs@rrrsVDDDDDrrc0eZdZeZeZeZe dZ dS)rc |d} t||}|di|S#t$rtd|dwxYw)z_Create a rule instance from metadata. :rtype: TreeRule/EndpointRule/ErrorRule rzUnknown rule type: z1. A rule must be of type tree, endpoint or error.rRNrK)rrTAttributeErrorr )clsr rule_type rule_classs rrzRuleCreator.create1s JJv&&  ( i00J:'''' '    )6)666  s /AN) rrrrrrrrtree classmethodrrKrrrr,s<H E D(([(((rrceZdZdZeZeZeZ dS) ParameterTypez8Translation from `type` attribute to native Python type.N) rrrrr+stringrbooleantuple stringarrayrKrrrrCs#BB FGKKKrrc0eZdZdZ ddZdZdZdS)ParameterDefinitionz9The spec of an individual parameter defined in a RuleSet.Nc||_ tt|j|_n"#t $rtd|dwxYw||_||_ ||_ ||_ ||_ dS)NzUnknown parameter type: z>. A parameter must be of type string, boolean, or stringarray.rR) rdrTrrr5parameter_typerr rbuiltindefaultrequired deprecated)rrdrrbuiltInrrrs rrzParameterDefinition.__init__Ns  ")~3355##      )O~OOO   +    $s 1;AcZt||js!td|jd|jd|jm|jd}|jd}|jd}|r|d |z }|r |d |dz }t |dS) zwPerform base validation on parameter input. :type value: Any :raises: EndpointParametersError zValue (z) is the wrong type. Must be rErRNz has been deprecated.messagesince z Deprecated since )r"rr rdrrAloggerinfo)rr5depr_strrSrs rvalidate_inputz"ParameterDefinition.validate_inpuths%!455 )8di88!%!4888  ? &):::H/%%i00CO''00E 'JJJ& ;:%:::: KK ! ! !trc|.|j|jS|jrtd|jn|||S)z>Process input against spec, applying default if value is None.Nz)Cannot find value for required parameter rR)rrr rdr$rZs r process_inputz!ParameterDefinition.process_inputse =|'|#} -ODIOO     & & & r)NNNNN)rrrrrr$r&rKrrrrKs]CC %%%%40     rrc.eZdZdZ ddZdZdZdZdS)RuleSetz:Collection of rules to derive a routable service endpoint.Nc||_|||_d|D|_t ||_||_dS)Nc0g|]}tjdi|Srrrs rrOz$RuleSet.__init__..rr)version_ingest_parameter_spec parametersrrrr)rr+r-rrurs rrzRuleSet.__init__sR 55jAACCUCCC .z:: *rc>d|DS)Nc i|]\}}|t||d|d|d|d|d|dS)rrrrrr)rrA)rMrdspecs rrz2RuleSet._ingest_parameter_spec..s    d %V ))####$$&&    r)r)rr-s rr,zRuleSet._ingest_parameter_specs1   )..00    rc|jD]4\}}|||}||||<5dS)zYProcess each input parameter against its spec. :type input_params: dict N)r-rr&rA)r input_paramsrdr0r5s rprocess_input_parametersz RuleSet.process_input_parameterss\ ///11 + +JD$&&|'7'7'='=>>E %* T"trc|||jD]5}|||j}||cS6dS)zmEvaluate input parameters against rules returning first match. :type input_parameters: dict N)r3rrrr)rinput_parametersr evaluations rrzRuleSet.evaluatesh %%&6777J " "D'7'<'<'>'> NNJ%!!!!&trr)rrrrrr,r3rrKrrr(r(sbDDEI++++            rr(cJeZdZdZddZdZeedZdS)EndpointProviderz9;;rc \|jD]}||d|jdi|Sr)r<r_resolve_endpoint)rr5r=s rresolve_endpointz!EndpointProvider.resolve_endpointsG* . .E   - - - -%t%99(8999r)maxsizec |}|j|}|Ddd|D}t d||S)zpMatch input parameters to a rule. :type input_parameters: dict :rtype: RuleSetEndpoint Nr c"g|] \}}|d| S)z: rK)rMrr5s rrOz6EndpointProvider._resolve_endpoint..s*NNNzsEC""5""NNNrz"No endpoint found for parameters: rR)rr:rjoinrr )rr5params_for_errorr param_strings rrAz"EndpointProvider._resolve_endpoints,0022<(()9::  99NN5E5K5K5M5MNNNL*H,HH rr) rrrrrrBr CACHE_SIZErArKrrr8r8sgFF????::: z***+*rr8)0rloggingrpenumrrrtypingrbotocorerbotocore.compatrrr botocore.exceptionsr botocore.utilsr r r rrrr getLoggerrr!compiler,r]rrIS3_UNREFERENCED_PARAMSrr2rRuleSetStandardLibaryrrrrrrrrr(r8rKrrrUsY 4444444444777777  8 $ $RZ 122bj*++  bj% 988 Y[[ 9;;] ] ] ] ] ] ] ] D /0j> > > > > 8> > > B$x4((((((((.DAAAAAAAAH////////dr