ڰj[.SrSSKrSSKrSSKJr SSKJr SSKJr SSK J r SSK J r J r Jr SSKJr SS KJrJrJrJrJrJrJr \R2"\5r\R8"S 5r\R8"S 5r\R8"S 5rS r 1Skr!\"5r"\"5r#"SS5r$\$r%"SS5r&"SS\5r'"SS\&5r("SS\&5r)"SS\&5r*"SS5r+"SS\5r,"SS 5r-"S!S"5r."S#S$5r/g)%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 CopySourcec\rSrSrSrSrSrSrSrSr Sr S r S r S r S rS rSrSrSrSrSrSrSrSrSrSrSrSrSrg)RuleSetStandardLibrary:z5Rule actions to be performed by the EndpointProvider.cXlgNpartitions_data)selfrs W/home/mande/repo/quber/.venv/lib/python3.13/site-packages/botocore/endpoint_provider.py__init__RuleSetStandardLibrary.__init__=s.c:[U[5=(a SU;$)zODetermine if an object is a function object. :type argument: Any :rtype: bool fn isinstancedictrarguments ris_funcRuleSetStandardLibrary.is_func@s (D)>dh.>>r!c:[U[5=(a SU;$)zPDetermine if an object is a reference object. :type argument: Any :rtype: bool refr$r's ris_refRuleSetStandardLibrary.is_refHs (D)?ex.??r!c^[U[5=(a [RU5SL$)zTDetermine if an object contains a template string. :type argument: Any :rtpe: bool N)r%strTEMPLATE_STRING_REsearchr's r is_template"RuleSetStandardLibrary.is_templatePs, x % @"))(34? r!cSn[RU5H8upE nUb*UnURS5nUHn XynM X4U3- nM4X4- nM: U$)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_string[sr(8(>(>u(E $G1$!+"+//#"6,E%3%:N-In%566!)F r!cURU5(aURX5$URU5(aURUS5$UR U5(aUR X5$U$)z[Return evaluated value based on type. :type value: Any :type scope_vars: dict :rtype: Any r,)r) call_functionr-getr3rD)rr;r<s r resolve_value$RuleSetStandardLibrary.resolve_valuensm <<  %%e8 8 [[  >>%,/ /   e $ $//B B r!cT[U5nUS:XaSU3nURSS5$)z8Normalize function names. :type value: str :rtype: str notr@.)rreplace)rr;normalized_names rconvert_func_name(RuleSetStandardLibrary.convert_func_name~s9 (./ e # !/!23O&&sC00r!cUSVs/sHnURX25PM nnURUS5n[X5nU"U6nSU;aUSnX;a [SUS3S9eXrU'U$s snf)zCall the function with the resolved arguments and assign to `scope_vars` when applicable. :type func_signature: dict :type scope_vars: dict :rtype: Any argvr#assignz Assignment z= already exists in scoped variables and cannot be overwrittenmsg)rIrPgetattrr ) rfunc_signaturer<arg func_args func_namefuncr=rTs rrG$RuleSetStandardLibrary.call_functions&f- -   s /-  **>$+?@ t'y! ~ %#H-F#-%fX.AA"(v   sA,c USL$)zAEvaluates whether a value is set. :type value: Any :rytpe: bool Nrr;s ris_setRuleSetStandardLibrary.is_sets D  r!c URS5Hnn[RU5nUbOUR5upV[ U5nU(aUR U5nUbU[ U5:a gXs $XnMp U$)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 rMN)r: GET_ATTR_REr2groupsintrHlen)rr;pathpartmatchnameindexs rget_attrRuleSetStandardLibrary.get_attrs{JJsOD&&t,E #lln E !IIdOE=ESZ$7|# $ r!c USnUSUS'U$)Noutputsidrkr_)r partitionoutputs rformat_partition_output.RuleSetStandardLibrary.format_partition_outputs9%"4v r!cZ[R"USU5SLnXS;=(d U$)N regionRegexregions)rerj)rregionrr matches_regexs ris_partition_match)RuleSetStandardLibrary.is_partition_matchs/=!96B$N 9-->>r!cURSnUb2UH,nURX5(dMURU5s $ USnURU5$)zJMatch a region string to an AWS partition. :type value: str :rtype: dict partitionsr)rr|rt)rr;rrr aws_partitions rr$RuleSetStandardLibrary.aws_partitionsb )),7  ' **5<<77 BB( #1 ++M::r!cRUbURS5(dg[RU5n[ USUSUS45(dgUR S5US'UR S5nUR SS 5RS 5US 'U$![a gf=f) zMParse and validate string for ARN components. :type value: str :rtype: dict Nzarn:rrserviceresourceaccount accountId:/ resourceId) startswith ARN_PARSER parse_arnr allpoprNr:)rr;arn_dictrs 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 B&%B&c^UbUSLaURS5S:agUSLa$[U4SjURS555$[R U5SL$)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 NFrMrTc3H># UHnTRUS5v M g7f)FN)is_valid_host_label).0labelrs r =RuleSetStandardLibrary.is_valid_host_label..s(-E((66-s")countrr:VALID_HOST_LABEL_RErjrr;allow_subdomainss` rr*RuleSetStandardLibrary.is_valid_host_labelsh =,5%++c:JQ:N t #"[[-  #((/t;;r!c[SX455(d$S[U5S[U5S3n[US9eX:H$)z\Evaluates two string values for equality. :type value1: str :type value2: str :rtype: bool c3B# UHn[U[5v M g7fr)r%r0rvals rr7RuleSetStandardLibrary.string_equals..sD3CC:c3''3Cz!Both values must be strings, not  and rMrUrtyper rvalue1value2rVs r string_equals$RuleSetStandardLibrary.string_equals sIDF3CDDD5d6l^5fVWXC)c2 2r!c Ucg[U5$)zKPerform percent-encoding on an input string. :type value: str :rytpe: str N)rr`s r uri_encode!RuleSetStandardLibrary.uri_encodes =e$$r!cUcg[U5nUR URnURnUS;d[ U5S:agUR n[[U55nURS5(dUS3nUURUU[U5=(d [U5S.$![a gf=f)zCParse a URL string into components. :type value: str :rtype: dict N)httpshttprr)scheme authorityrhnormalizedPathisIp) r port ValueErrorrqueryrgrhrrendswithnetlocr r)rr;url_componentsrrrhnormalized_paths r parse_url RuleSetStandardLibrary.parse_url"s =!%     &&$$ * *c%j1n"" 24 89'',,!0 13O'..-.u51)%0     s B33 C?Cc[SX455(d$S[U5S[U5S3n[US9eXL$)z_Evaluates two boolean values for equality. :type value1: bool :type value2: bool :rtype: bool c3B# UHn[U[5v M g7fr)r%boolrs rr8RuleSetStandardLibrary.boolean_equals..NsE4DS:c4((4Drz"Both arguments must be bools, not rrMrUrrs rboolean_equals%RuleSetStandardLibrary.boolean_equalsGsIEV4DEEE6tF|nE$v,WXYC)c2 2r!cHURS5 g![a gf=f)zUEvaluates if a string only contains ASCII characters. :type value: str :rtype: bool asciiTF)encodeUnicodeEncodeErrorr`s ris_asciiRuleSetStandardLibrary.is_asciiSs(   LL !!  s  !!c[U[5(dS[U5S3n[US9eX#:d%[ U5U:dUR U5(dgUSLa [ U5U- n[ U5U- nXU$XU$)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 rMrUNT)r%r0rr rgr)rr;startstopreverserVr_startr_stops r substring RuleSetStandardLibrary.substring_s%%%0e Q?C)c2 2 =CJ-T]]55I5I d?%j4'GZ%'F( (4  r!cU(+$)zXA function implementation of the logical operator `not`. :type value: Any :rtype: bool r_r`s r_notRuleSetStandardLibrary._notvs yr!cUb:[U5S:d+UR5U:wd[R"U5bgUR XS9$)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)rglowerrrjrrs r!aws_is_virtual_hostable_s3_bucket8RuleSetStandardLibrary.aws_is_virtual_hostable_s3_bucket~sO M5zA~{{}%}}U#/'' (  r!rN)__name__ __module__ __qualname____firstlineno____doc__rr)r-r3rDrIrPrGrarmrtr|rrrrrrrrrrr__static_attributes__r_r!rrr:sz?/?@  & 12!0 ?;"6<(   %# J   !. r!rc.\rSrSrSrSSjrSrSrSrg) BaseRuleiz-Base interface for individual endpoint rules.NcXlX lgr conditions documentation)rrrs rrBaseRule.__init__s $*r!c[5er)NotImplementedError)rr<rule_libs revaluateBaseRule.evaluates !##r!c`URHnURX15nUSLdUbM g g)z{Determine if all conditions in a rule are met. :type scope_vars: dict :type rule_lib: RuleSetStandardLibrary :rtype: bool FT)rrG)rr<rrXr=s revaluate_conditionsBaseRule.evaluate_conditionss5#ooN++NGF&..r!rr) rrrrrrrrrr_r!rrrs7+$ r!rc8\rSrSr%Sr\\S'\\S'\\S'Srg)RuleSetEndpointiz.A resolved endpoint object returned by a rule.url propertiesheadersr_N) rrrrrr0__annotations__r&rr_r!rrrs8 H Mr!rc:^\rSrSrU4SjrSrSrSrSrU=r $) EndpointRuleic 2>[TU]"S0UD6 XlgNr_)superrendpoint)rrkwargs __class__s rrEndpointRule.__init__s "6" r!cURX5(agURURSU5nURURR S05UU5nUR X5n[ X4US9$g)zmDetermine if conditions are met to provide a valid endpoint. :type scope_vars: dict :rtype: RuleSetEndpoint rr)rrrN)rrIrresolve_propertiesrHresolve_headersr)rr<rrrrs rrEndpointRule.evaluates  # #J 9 9((u)=zJC00 !!,3J **:@G" r!c n[U[5(a#UVs/sHnURXBU5PM sn$[U[5(a5UR 5VVs0sHupVXPRXbU5_M snn$UR U5(aUR X5$U$s snfs snnf)zTraverse `properties` attribute, resolving any template strings. :type properties: dict/list/str :type scope_vars: dict :type rule_lib: RuleSetStandardLibrary :rtype: dict )r%listrr&itemsr3rD)rrr<rpropkeyr;s rrEndpointRule.resolve_propertiess j$ ' ''&D''(C&  D ) )#-"2"2"4"4JC,,UII"4  ! !* - -33JK K s B,!B1c0nURRS05nUR5H(upVUVs/sHorRXq5PM snX5'M* U$s snf)zIterate through headers attribute resolving all values. :type scope_vars: dict :type rule_lib: RuleSetStandardLibrary :rtype: dict r)rrHrrI)rr<rresolved_headersrheadervaluesitems rrEndpointRule.resolve_headersse--##Ir2%mmoNFEK(EKT&&t8V(  $. (sA)r) rrrrrrrrr __classcell__rs@rrrs!(.  r!rc.^\rSrSrU4SjrSrSrU=r$) ErrorRuleic 2>[TU]"S0UD6 Xlgr)rrerror)rrrrs rrErrorRule.__init__s "6" r!czURX5(a%URURU5n[US9eg)zIf an error rule's conditions are met, raise an error rule. :type scope_vars: dict :type rule_lib: RuleSetStandardLibrary :rtype: EndpointResolutionError rUN)rrIrr )rr<rrs rrErrorRule.evaluates9  # #J 9 9**4::zBE)e4 4r!)r)rrrrrrrrrs@rrrs  r!rc2^\rSrSrSrU4SjrSrSrU=r$)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 >[TU]"S0UD6 UVs/sHn[R"S0UD6PM snUlgs snfr)rr RuleCreatorcreaterules)rrrrulers rrTreeRule.__init__s: "6"=BCUTk((040UC Cs ?cURX5(a>URH.nURUR5U5nU(dM,Us $ g)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<rr rule_results rrTreeRule.evaluatesJ  # #J 9 9 "mmJOO,=xH ;&& # r!)r) rrrrrrrrrrs@rrrsDr!rc0\rSrSr\r\r\r \ S5r Sr g)ri,c URS5n[X5nU"S0UD6$![a [SUS3S9ef=f)zOCreate a rule instance from metadata. :rtype: TreeRule/EndpointRule/ErrorRule rzUnknown rule type: z1. A rule must be of type tree, endpoint or error.rUr_)rrWAttributeErrorr )clsr rule_type rule_classs rrRuleCreator.create1s` JJv&  ( 0J'' '  )))566  s &>r_N) rrrrrrrrrtree classmethodrrr_r!rrr,s#H E D((r!rc$\rSrSrSr\r\r\ r Sr g) ParameterTypeiCz8Translation from `type` attribute to native Python type.r_N) rrrrrr0stringrbooleantuple stringarrayrr_r!rr.r.CsB FGKr!r.c8\rSrSrSrSSjrSrSrSrg) ParameterDefinitioniKz9The spec of an individual parameter defined in a RuleSet.NcXl[[UR55RUlX0lX@l XPl X`l Xpl g![ a [SUS3S9ef=f)NzUnknown parameter type: z>. A parameter must be of type string, boolean, or stringarray.rU) rkrWr.rr;parameter_typer&r rbuiltindefaultrequired deprecated)rrkr6rbuiltInr8r9r:s rrParameterDefinition.__init__Ns  ")~335#e  +   $ ).~.>?OO  s -AA,c[XR5(d$[SURSURS3S9eURbyURS3nURR S5nURR S5nU(aUS U3- nU(a US US3- n[ RU5 g) z_Perform base validation on parameter input. :type value: Any :raises: EndpointParametersError zValue (z) is the wrong type. Must be rMrUNz has been deprecated.messagesince z Deprecated since )r%r6r rkr:rHloggerinfo)rr;depr_strrVr?s rvalidate_input"ParameterDefinition.validate_inpuths%!4!455)dii[)!!%!4!4 5Q8  ?? &))$9:H//%%i0COO''0EbJ&1%:: KK !r!cUcCURb UR$UR(a[SUR3S9eU$UR U5 U$)z>Process input against spec, applying default if value is None.z)Cannot find value for required parameter rU)r8r9r rkrDr`s r process_input!ParameterDefinition.process_inputs^ =||'||#}}-CDII;O     & r!)r7r8r:rrkr6r9)NNNNN) rrrrrrrDrGrr_r!rr4r4Ks%C %40 r!r4c6\rSrSrSrS SjrSrSrSrSr g) RuleSetiz:Collection of rules to derive a routable service endpoint.NcXlURU5UlUVs/sHn[R"S0UD6PM snUl[ U5UlXPlgs snfr) version_ingest_parameter_spec parametersrrrrrr)rrLrNrrrrs rrRuleSet.__init__sW 55jA=BCUTk((040UC .z: *Ds A cUR5VVs0sHeup#U[UUSURS5URS5URS5URS5URS55_Mg snn$s snnf)Nrrr;r8r9r:)rr4rH)rrNrkspecs rrMRuleSet._ingest_parameter_specs)..0  1  %V )##$& 1   sA,BcURR5H.up#URURU55nUcM*XAU'M0 g)zIProcess each input parameter against its spec. :type input_params: dict N)rNrrGrH)r input_paramsrkrQr;s rprocess_input_parameters RuleSet.process_input_parameterssK ////1JD&&|'7'7'=>E %*T"2r!cURU5 URH4nURUR5UR5nUcM2Us $ g)z]Evaluate input parameters against rules returning first match. :type input_parameters: dict N)rUrrr!r)rinput_parametersr evaluations rrRuleSet.evaluatesP %%&67JJD'7'<'<'> NJ%!!r!)rrNrrrLr) rrrrrrrMrUrrr_r!rrJrJs DEI+    r!rJc@\rSrSrSrS SjrSr\"\S9S5r Sr g) EndpointProvideriz9;r!c pURHnURUS5 M UR"S0UD6$r)r`r_resolve_endpoint)rrXrCs rresolve_endpoint!EndpointProvider.resolve_endpoints7**E   -+%%9(899r!)maxsizec UR5nURRU5nUcESRUR 5VVs/sH upEUSU3PM snn5n[ SU3S9eU$s snnf)zXMatch input parameters to a rule. :type input_parameters: dict :rtype: RuleSetEndpoint r@z: z"No endpoint found for parameters: rU)r!r^rjoinrr )rrXparams_for_errorrrr; param_strings rrf"EndpointProvider._resolve_endpoints,002<<(()9:  995E5K5K5MN5MzsC55'"5MNL*9,H  Os A6 )r`r^r) rrrrrrrgr CACHE_SIZErfrr_r!rr\r\s(F?: z*+r!r\)0rloggingryenumrr/rtypingrbotocorerbotocore.compatrrr botocore.exceptionsr botocore.utilsr r r rrrr getLoggerrrAcompiler1rdrroS3_UNREFERENCED_PARAMSrr8rRuleSetStandardLibaryrrrrrrr.r4rJr\r_r!rr{s 447   8 $ZZ 12jj*+ jj% 9 [ ;] ] D /0j> 8> B$x4((.DAAH//dr!