+ iY(Rt^RIt^RIt^RIHt^RIHt^RIHt^RI H t ^RI H t H t Ht^RIHt^RIHtHtHtHtHtHtHt]P2!]4t]P8!R 4t]P8!R 4t]P8!R 4t^dt ]!4t!]!4t"!R R 4t#]#t$!RR4t%!RR]4t&!RR]%4t'!RR]%4t(!RR]%4t)!RR4t*!RR]4t+!RR4t,!RR4t-!R R!4t.R#)"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}(?>dh.>>rc <\V\4;'dRV9#)zPDetermine if an object is a reference object. :type argument: Any :rtype: bool refrr!s&&ris_refRuleSetStandardLibrary.is_refDs (D)??ex.??rc `\V\4;'d\PV4RJ#)zTDetermine if an object contains a template string. :type argument: Any :rtpe: bool N)rstrTEMPLATE_STRING_REsearchr!s&&r is_template"RuleSetStandardLibrary.is_templateLs2 x % @ @"))(34? rc Rp\PV4FEwrEpVe3TpVPR4pVF p Wy,pK W4 V 2, pK=W4, pKG V#)zgResolve and inject values into a template string. :type value: str :type scope_vars: dict :rtype: str #)STRING_FORMATTERparsesplit) rvalue scope_varsresultliteral reference_template_valuetemplate_paramsparams &&& rresolve_template_string.RuleSetStandardLibrary.resolve_template_stringWsr(8(>(>u(E $G1$!+"+//#"6,E%3%:N-In%566!)F rc VPV4'dVPW4#VPV4'dVPVR,4#VP V4'dVP W4#V#)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_value$RuleSetStandardLibrary.resolve_valuejsm <<  %%e8 8 [[  >>%,/ /   e $ $//B B rc V\V4 pVR8XdRV 2pVPRR4#)z8Normalize function names. :type value: str :rtype: str notr:.)rreplace)rr5normalized_names&& rconvert_func_name(RuleSetStandardLibrary.convert_func_namezs9 (./ e # !/!23O&&sC00rc VR,Uu.uFpVPW24NK ppVPVR,4p\W4pV!V!pRV9d$VR,pW9d\RV R2R7hWrV&V#uupi)zCall the function with the resolved arguments and assign to `scope_vars` when applicable. :type func_signature: dict :type scope_vars: dict :rtype: Any argvrassignz Assignment z= already exists in scoped variables and cannot be overwrittenmsg)rCrJgetattrr ) rfunc_signaturer6arg func_args func_namefuncr7rNs &&& rrA$RuleSetStandardLibrary.call_functions&f- -   s /-  **>$+?@ t'y! ~ %#H-F#-%fX.AA"(v   sA=c VRJ#)zAEvaluates whether a value is set. :type value: Any :rytpe: bool Nrr5s&&ris_setRuleSetStandardLibrary.is_sets D  rc &VPR4F{p\PV4pVeXVP4wrV\ V4pV'dVP V4pVeV\ V48dR#W,u#W,pK} V#)a9Find 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 rGN)r4 GET_ATTR_REr,groupsintrBlen)rr5pathpartmatchnameindexs&&& rget_attrRuleSetStandardLibrary.get_attrs{JJsOD&&t,E #lln E !IIdOE=ESZ$7|# $ rc0VR,pVR,VR&V#)outputsidrerY)r partitionoutputs&& rformat_partition_output.RuleSetStandardLibrary.format_partition_outputs9%"4v rcl\P!VR,V4RJpWR,9;'gT#) regionRegexNregions)rerd)rregionrl matches_regexs&&& ris_partition_match)RuleSetStandardLibrary.is_partition_matchs2=!96B$N 9-->>>rc VPR,pVe4VF-pVPW4'gKVPV4u# V^,pVPV4#)zJMatch a region string to an AWS partition. :type value: str :rtype: dict partitions)rrvrn)rr5ryrl aws_partitions&& rrz$RuleSetStandardLibrary.aws_partitionsb )),7  ' **5<<77 BB( #1 ++M::rc xVeVPR4'gR#\PV4p\ TR,TR,TR,34'gR#TP R4TR&TP R4pTP RR 4PR 4TR &T# \dR#i;i) zMParse and validate string for ARN components. :type value: str :rtype: dict Nzarn:rlserviceresourceaccount accountId:/ resourceId) startswith ARN_PARSER parse_arnr allpoprHr4)rr5arn_dictr~s&& r aws_parse_arn$RuleSetStandardLibrary.aws_parse_arns = 0 0 8 8 !++E2H  k "HY$7*9M N   ( Y 7<< +!)!1!1#s!;!A!A#!F#  sB** B98B9c 2aVeVRJdVPR4^8dR#VRJdY\;QJd.V3RlVPR44F 'dK R# R#!V3RlVPR444#\P V4RJ#)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 NFrGTc3H<"TFpSPVR4xK R#5i)FN)is_valid_host_label).0labelrs& r =RuleSetStandardLibrary.is_valid_host_label..s(-E((66-s")countrr4VALID_HOST_LABEL_RErdrr5allow_subdomainssf&&rr*RuleSetStandardLibrary.is_valid_host_labels =,5%++c:JQ:N t #3"[[-33 3 3"[[-  #((/t;;rc \;QJdRW34F 'dK RM RM!RW344'g(R\V4 R\V4 R2p\VR7hW8H#)z\Evaluates two string values for equality. :type value1: str :type value2: str :rtype: bool c3B"TFp\V\4xK R#5ir)rr*rvals& rr7RuleSetStandardLibrary.string_equals..sD3CC:c3''3CFTz!Both values must be strings, not  and rGrOrtyper rvalue1value2rPs&&& r string_equals$RuleSetStandardLibrary.string_equalss\sDF3CDsssDF3CDDD5d6l^5fVWXC)c2 2rc $VfR#\V4#)zKPerform percent-encoding on an input string. :type value: str :rytpe: str N)rrZs&&r uri_encode!RuleSetStandardLibrary.uri_encodes =e$$rc  VfR#\V4pVPTPpTPpTR9g\ T4^8dR#TP p\\T44pTPR4'gT R2pRTRTPRTRTR\T4;'g \T4/# \dR#i;i) zCParse a URL string into components. :type value: str :rtype: dict Nrscheme authorityrbnormalizedPathisIp)httpshttp) rport ValueErrorrqueryrarbrrendswithnetlocr r )rr5url_componentsrrrbnormalized_paths&& r parse_url RuleSetStandardLibrary.parse_urls =!%     &&$$ * *c%j1n"" 24 89'',,!0 13O f .. D o .u511)%0     s B>> C  C c \;QJdRW34F 'dK RM RM!RW344'g(R\V4 R\V4 R2p\VR7hWJ#)z_Evaluates two boolean values for equality. :type value1: bool :type value2: bool :rtype: bool c3B"TFp\V\4xK R#5ir)rboolrs& rr8RuleSetStandardLibrary.boolean_equals..JsE4DS:c4((4DrFTz"Both arguments must be bools, not rrGrOrrs&&& rboolean_equals%RuleSetStandardLibrary.boolean_equalsCs\sEV4DEsssEV4DEEE6tF|nE$v,WXYC)c2 2rc NVPR4R# \dR#i;i)zUEvaluates if a string only contains ASCII characters. :type value: str :rtype: bool asciiTF)encodeUnicodeEncodeErrorrZs&&ris_asciiRuleSetStandardLibrary.is_asciiOs(   LL !!  s  $$c &\V\4'gR\V4 R2p\VR7hW#8g(\ V4V8gVP V4'gR#VRJd)\ V4V, p\ V4V, pWV#WV#)zComputes 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 rGrONT)rr*rr rar)rr5startstopreverserPr_startr_stops&&&&& r substring RuleSetStandardLibrary.substring[s%%%0e Q?C)c2 2 =CJ-T]]55I5I d?%j4'GZ%'F( (4  rc V'*#)zXA function implementation of the logical operator `not`. :type value: Any :rtype: bool rYrZs&&r_notRuleSetStandardLibrary._notrs yrc Ve>\V4^8g.VP4V8wg\P!V4eR#VP WR7#)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 F)r)ralowerrrdrrs&&&r!aws_is_virtual_hostable_s3_bucket8RuleSetStandardLibrary.aws_is_virtual_hostable_s3_bucketzsO M5zA~{{}%}}U#/'' (  rrN)__name__ __module__ __qualname____firstlineno____doc__rr#r'r-r>rCrJrAr[rgrnrvrzrrrrrrrrrr__static_attributes____classdictcell__ __classdict__s@rrr6s?/?@  & 12!0 ?;"6<(   %# J   !.  rrc:a]tRtRtoRtRRltRtRtRtVt R#) BaseRuleiz-Base interface for individual endpoint rules.NcWnW nR#r conditions documentation)rrrs&&&rrBaseRule.__init__s $*rc\4hr)NotImplementedError)rr6rule_libs&&&revaluateBaseRule.evaluates !##rc hVPF!pVPW14pVRJgVeK R# R#)z{Determine if all conditions in a rule are met. :type scope_vars: dict :type rule_lib: RuleSetStandardLibrary :rtype: bool FT)rrA)rr6rrRr7s&&& revaluate_conditionsBaseRule.evaluate_conditionss5#ooN++NGF&..rrr) rrrrrrrrrrrs@rrrs7+$  rrc0a]tRtRtoRtV3RltRtVtR#)RuleSetEndpointiz.A resolved endpoint object returned by a rule.c><V^8dQh/S[;R&S[;R&S[;R&#)url propertiesheaders)r*r )formatrs"r __annotate__RuleSetEndpoint.__annotate__s* H  M rrYN)rrrrr__annotate_func__rrrs@rrrs8rrcDaa]tRtRtoV3RltRtRtRtRtVt V;t #) EndpointRuleic 4<\SV`!R/VBWnR#NrY)superrendpoint)rrkwargs __class__s&&,rrEndpointRule.__init__s "6" rc VPW4'doVPVPR,V4pVPVPP R/4VV4pVP W4p\ W4VR7#R#)zmDetermine if conditions are met to provide a valid endpoint. :type scope_vars: dict :rtype: RuleSetEndpoint rr)rrrN)rrCrresolve_propertiesrBresolve_headersr)rr6rrrrs&&& rrEndpointRule.evaluates  # #J 9 9((u)=zJC00 !!,3J **:@G" rc  p\V\4'd#VUu.uFpVPWBV4NK up#\V\4'd5VP 4UUu/uFwrVWPPWbV4bK upp#VP V4'dVP W4#V#uupiuuppi)zTraverse `properties` attribute, resolving any template strings. :type properties: dict/list/str :type scope_vars: dict :type rule_lib: RuleSetStandardLibrary :rtype: dict )rlistrr itemsr-r>)rrr6rpropkeyr5s&&&& rrEndpointRule.resolve_propertiess j$ ' ''&D''(C&  D ) )#-"2"2"4"4JC,,UII"4  ! !* - -33JK K s B-"B2c /pVPPR/4pVP4F'wrVVUu.uFqrPWq4NK upW5&K) V#uupi)zIterate through headers attribute resolving all values. :type scope_vars: dict :type rule_lib: RuleSetStandardLibrary :rtype: dict r)rrBrrC)rr6rresolved_headersrheadervaluesitems&&& rrEndpointRule.resolve_headersse--##Ir2%mmoNFEK(EKT&&t8V(  $. (sA)r) rrrrrrrrrr __classcell__rrs@@rrrs!(.  rrc8aa]tRtRtoV3RltRtRtVtV;t#) ErrorRuleic 4<\SV`!R/VBWnR#r)rrerror)rrrrs&&,rrErrorRule.__init__s "6" rc VPW4'd)VPVPV4p\VR7hR#)zIf an error rule's conditions are met, raise an error rule. :type scope_vars: dict :type rule_lib: RuleSetStandardLibrary :rtype: EndpointResolutionError rON)rrCrr )rr6rrs&&& rrErrorRule.evaluates9  # #J 9 9**4::zBE)e4 4r)r) rrrrrrrrrrs@@rrrs  rrc<aa]tRtRtoRtV3RltRtRtVtV;t #)TreeRuleizA 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 <\SV`!R/VBVUu.uFp\P!R/VBNK upVnR#uupir)rr RuleCreatorcreaterules)rrrrulers&&, rrTreeRule.__init__s: "6"=BCUTk((040UC Cs?c VPW4'd@VPF/pVPVP4V4pV'gK-Vu# R#)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&&& rrTreeRule.evaluatesJ  # #J 9 9 "mmJOO,=xH ;&& # r)r) rrrrrrrrrrrs@@rrrsDrrc<a]tRtRto]t]t]t ] R4t Rt Vt R#)ri(c VPR4p\W4pV!R/VB# \d\RT R2R7hi;i)zOCreate a rule instance from metadata. :rtype: TreeRule/EndpointRule/ErrorRule rzUnknown rule type: z1. A rule must be of type tree, endpoint or error.rOrY)rrQAttributeErrorr )clsr rule_type rule_classs&, rrRuleCreator.create-s` JJv&  ( 0J'' '  )))566  s &ArYN)rrrrrrrrrtree classmethodrrrrs@rrr(s&H E D((rrc&]tRtRtRt]t]t] t Rt R#) ParameterTypei?z8Translation from `type` attribute to native Python type.rYN) rrrrrr*stringrbooleantuple stringarrayrrYrrr/r/?sB FGKrr/c:a]tRtRtoRtRRltRtRtRtVt R#) ParameterDefinitioniGz9The spec of an individual parameter defined in a RuleSet.NcWn\\VP44PVnY0nY@n YPn Y`n Ypn R# \ d\RT R2R7hi;i)zUnknown parameter type: z>. A parameter must be of type string, boolean, or stringarray.rON) rerQr/rr5parameter_typer'r rbuiltindefaultrequired deprecated)rrer7rbuiltInr9r:r;s&&&&&&&&rrParameterDefinition.__init__Js  ")~335#e  +   $ ).~.>?OO  s -AA1c \WP4'g(\RVP RVP R2R7hVPeVP R2pVPP R4pVPP R4pV'd VR V 2, pV'dVR V R2, p\ PV4R#) z_Perform base validation on parameter input. :type value: Any :raises: EndpointParametersError zValue (z) is the wrong type. Must be rGrONz has been deprecated.messagesince z Deprecated since )rr7r rer;rBloggerinfo)rr5depr_strrPr@s&& rvalidate_input"ParameterDefinition.validate_inputds%!4!455)dii[)!!%!4!4 5Q8  ?? &))$9:H//%%i0COO''0EbJ&1%:: KK !rc VfIVPe VP#VP'd\RVP 2R7hV#VP V4V#)z>Process input against spec, applying default if value is None.z)Cannot find value for required parameter rO)r9r:r rerErZs&&r process_input!ParameterDefinition.process_input|s` =||'||#}}}-CDII;O     & r)r8r9r;rrer7r:)NNNNN) rrrrrrrErHrrrs@rr5r5GsC%40  rr5c@a]tRtRtoRtR RltRtRtRtRt Vt R#) RuleSetiz:Collection of rules to derive a routable service endpoint.NcWnVPV4VnVUu.uFp\P!R/VBNK upVn\ V4VnWPnR#uupir) version_ingest_parameter_spec parametersrrrrrr)rrMrOrryrrs&&&&&& rrRuleSet.__init__sW 55jA=BCUTk((040UC .z: *DsA cVP4UUu/uFiwr#V\VVR,VPR4VPR4VPR4VPR4VPR44bKk upp#uuppi)rrr<r9r:r;)rr5rB)rrOrespecs&& rrNRuleSet._ingest_parameter_specs)..0  1  %V )##$& 1   sA/Bc VPP4F/wr#VPVPV44pVfK+WAV&K1 R#)zIProcess each input parameter against its spec. :type input_params: dict N)rOrrHrB)r input_paramsrerRr5s&& rprocess_input_parameters RuleSet.process_input_parameterssK ////1JD&&|'7'7'=>E %*T"2rc VPV4VPF5pVPVP4VP4pVfK3Vu# R#)z]Evaluate input parameters against rules returning first match. :type input_parameters: dict N)rVrrr"r)rinput_parametersr evaluations&& rrRuleSet.evaluatesP %%&67JJD'7'<'<'> NJ%!!r)rrOrrrMr) rrrrrrrNrVrrrrs@rrKrKs!D+     rrKcHa]tRtRtoRtRt]!]R7R4tRt Vt R#)EndpointProviderizrus 447   8 $ZZ 12jj*+ jj% [ ;] ] D /0j> 8> B$x4((.DAAH//dr