Y&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 \"5r!\"5r""SS5r#\#r$"SS5r%"SS\5r&"SS\%5r'"SS\%5r("SS\%5r)"SS5r*"SS\5r+"SS5r,"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}(?dh.>>rc:[U[5=(a SU;$)zPDetermine if an object is a reference object. :type argument: Any :rtype: bool refr!r$s ris_refRuleSetStandardLibrary.is_refEs (D)?ex.??rc^[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_templateMs, x % @"))(34? rcSn[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_stringXsr(8(>(>u(E $G1$!+"+//#"6,E%3%:N-In%566!)F rcURU5(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*getr0rA)rr8r9s r resolve_value$RuleSetStandardLibrary.resolve_valueksm <<  %%e8 8 [[  >>%,/ /   e $ $//B B rcT[U5nUS:XaSU3nURSS5$)z8Normalize function names. :type value: str :rtype: str notr=.)rreplace)rr8normalized_names rconvert_func_name(RuleSetStandardLibrary.convert_func_name{s9 (./ e # !/!23O&&sC00rcUSVs/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)rFrMgetattrr ) rfunc_signaturer9arg func_args func_namefuncr:rQs rrD$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 Nrr8s ris_setRuleSetStandardLibrary.is_sets D  rcURS5Hgn[RU5nUbHUR5upV[ U5nUR U5nUbU[ U5:a gXs $XnMi U$)a8Find 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 rJN)r7 GET_ATTR_REr/groupsintrElen)rr8pathpartmatchnameindexs rget_attrRuleSetStandardLibrary.get_attrsxJJsOD&&t,E #lln E  $=ESZ$7|# $ rc USnUSUS'U$)Noutputsidrhr\)r partitionoutputs rformat_partition_output.RuleSetStandardLibrary.format_partition_outputs9%"4v rcZ[R"USU5SLnXS;=(d U$)N regionRegexregions)rerg)rregionro matches_regexs ris_partition_match)RuleSetStandardLibrary.is_partition_matchs/=!96B$N 9-->>rcURSnUb2UH,nURX5(dMURU5s $ USnURU5$)zJMatch a region string to an AWS partition. :type value: str :rtype: dict partitionsr)rryrq)rr8r|ro aws_partitions rr}$RuleSetStandardLibrary.aws_partitionsb )),7  ' **5<<77 BB( #1 ++M::rcRUbURS5(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:roserviceresourceaccount accountId:/ resourceId) startswith ARN_PARSER parse_arnr allpoprKr7)rr8arn_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 NFrJrTc3H># UHnTRUS5v M g7f)FN)is_valid_host_label).0labelrs r =RuleSetStandardLibrary.is_valid_host_label..s(-E((66-s")countrr7VALID_HOST_LABEL_RErgrr8allow_subdomainss` rr*RuleSetStandardLibrary.is_valid_host_labelsh =,5%++c:JQ:N t #"[[-  #((/t;;rc[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"r-rvals rr7RuleSetStandardLibrary.string_equals..sD3CC:c3''3Cz!Both values must be strings, not  and rJrRrtyper rvalue1value2rSs r string_equals$RuleSetStandardLibrary.string_equalssIDF3CDDD5d6l^5fVWXC)c2 2rc Ucg[U5$)zKPerform percent-encoding on an input string. :type value: str :rytpe: str N)rr]s r uri_encode!RuleSetStandardLibrary.uri_encodes =e$$rcUcg[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 authorityrenormalizedPathisIp) r port ValueErrorrqueryrdrerrendswithnetlocr r)rr8url_componentsrrrenormalized_paths r parse_url RuleSetStandardLibrary.parse_urls =!%     &&$$ * *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..JsE4DS:c4((4Drz"Both arguments must be bools, not rrJrRrrs rboolean_equals%RuleSetStandardLibrary.boolean_equalsCsIEV4DEEE6tF|nE$v,WXYC)c2 2rcHURS5 g![a gf=f)zUEvaluates if a string only contains ASCII characters. :type value: str :rtype: bool asciiTF)encodeUnicodeEncodeErrorr]s ris_asciiRuleSetStandardLibrary.is_asciiOs(   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 rJrRNT)r"r-rr rdr)rr8startstopreverserSr_startr_stops r substring RuleSetStandardLibrary.substring[s%%%0e Q?C)c2 2 =CJ-T]]55I5I d?%j4'GZ%'F( (4  rcU(+$)zXA function implementation of the logical operator `not`. :type value: Any :rtype: bool r\r]s r_notRuleSetStandardLibrary._notrs yrcUb:[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)rdlowerrrgrrs r!aws_is_virtual_hostable_s3_bucket8RuleSetStandardLibrary.aws_is_virtual_hostable_s3_bucketzsO M5zA~{{}%}}U#/'' (  rrN)__name__ __module__ __qualname____firstlineno____doc__rr&r*r0rArFrMrDr^rjrqryr}rrrrrrrrrr__static_attributes__r\rrrr7sz?/?@  & 12!. ?;"6<(   %# J   !. rrc.\rSrSrSrSSjrSrSrSrg) BaseRuleiz-Base interface for individual endpoint rules.NcXlX lgr conditions documentation)rrrs rrBaseRule.__init__s $*rc[5er)NotImplementedError)rr9rule_libs revaluateBaseRule.evaluates !##rc`URHnURX15nUSLdUbM g g)z{Determine if all conditions in a rule are met. :type scope_vars: dict :type rule_lib: RuleSetStandardLibrary :rtype: bool FT)rrD)rr9rrUr:s revaluate_conditionsBaseRule.evaluate_conditionss5#ooN++NGF&..rrr) rrrrrrrrrr\rrrrs7+$ rrc8\rSrSr%Sr\\S'\\S'\\S'Srg)RuleSetEndpointiz.A resolved endpoint object returned by a rule.url propertiesheadersr\N) rrrrrr-__annotations__r#rr\rrrrs8 H Mrrc:^\rSrSrU4SjrSrSrSrSrU=r $) EndpointRuleic 2>[TU]"S0UD6 XlgNr\)superrendpoint)rrkwargs __class__s rrEndpointRule.__init__s "6" rcURX5(agURURSU5nURURR S05UU5nUR X5n[ X4US9$g)zmDetermine if conditions are met to provide a valid endpoint. :type scope_vars: dict :rtype: RuleSetEndpoint rr)rrrN)rrFrresolve_propertiesrEresolve_headersr)rr9rrrrs rrEndpointRule.evaluates  # #J 9 9((u)=zJC00 !!,3J **:@G" rc 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#itemsr0rA)rrr9rpropkeyr8s 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)rrErrF)rr9rresolved_headersrheadervaluesitems rrEndpointRule.resolve_headersse--##Ir2%mmoNFEK(EKT&&t8V(  $. (sA)r) rrrrrrrrr __classcell__rs@rrrs!(.  rrc.^\rSrSrU4SjrSrSrU=r$) ErrorRuleic 2>[TU]"S0UD6 Xlgr)rrerror)rrrrs rrErrorRule.__init__s "6" rczURX5(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 rRN)rrFrr )rr9rrs rrErrorRule.evaluates9  # #J 9 9**4::zBE)e4 4r)r)rrrrrrrr r s@rrrs  rrc2^\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)rr9rr rule_results rrTreeRule.evaluatesJ  # #J 9 9 "mmJOO,=xH ;&& # r)r) rrrrrrrrr r s@rrrsDrrc0\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.rRr\)rrTAttributeErrorr )clsr rule_type rule_classs rrRuleCreator.create-s` JJv&  ( 0J'' '  )))566  s &>r\N) rrrrrrrrrtree classmethodrrr\rrrr(s#H E D((rrc \rSrSrSr\r\rSr g) ParameterTypei?z8Translation from `type` attribute to native Python type.r\N) rrrrrr-stringrbooleanrr\rrr+r+?sB FGrr+c8\rSrSrSrSSjrSrSrSrg) ParameterDefinitioniFz9The spec of an individual parameter defined in a RuleSet.NcXl[[UR55RUlX0lX@l XPl X`l Xpl g![ a [SUS3S9ef=f)NzUnknown parameter type: z0. A parameter must be of type string or boolean.rR) rhrTr+rr8parameter_typer#r rbuiltindefaultrequired deprecated)rrhr1rbuiltInr3r4r5s rrParameterDefinition.__init__Is  ")~335#e  +   $ ).~.>?AA  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 rJrRNz has been deprecated.messagesince z Deprecated since )r"r1r rhr5rEloggerinfo)rr8depr_strrSr:s rvalidate_input"ParameterDefinition.validate_inputcs%!4!455)dii[)!!%!4!4 5Q8  ?? &))$9:H//%%i0COO''0EbJ&1%:: KK !rcUcEURb UR$UR(a[SUR35eU$UR U5 U$)z>Process input against spec, applying default if value is None.z)Cannot find value for required parameter )r3r4r rhr?r]s r process_input!ParameterDefinition.process_input{s^ =||'||#}}-? {K     & r)r2r3r5rrhr1r4)NNNNN) rrrrrrr?rBrr\rrr/r/Fs%C %40 rr/c6\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)rrGrIrr|rrs rrRuleSet.__init__sW 55jA=BCUTk((040UC .z: *Ds A cUR5VVs0sHeup#U[UUSURS5URS5URS5URS5URS55_Mg snn$s snnf)Nrrr6r3r4r5)rr/rE)rrIrhspecs rrHRuleSet._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)rIrrBrE)r input_paramsrhrLr8s rprocess_input_parameters RuleSet.process_input_parameterssK ////1JD&&|'7'7'=>E %*T"2rcURU5 URH4nURUR5UR5nUcM2Us $ g)z]Evaluate input parameters against rules returning first match. :type input_parameters: dict N)rPrrrr)rinput_parametersr evaluations rrRuleSet.evaluatesP %%&67JJD'7'<'<'> NJ%!!r)rrIrrrGr) rrrrrrrHrPrrr\rrrErEs DEI+    rrEc6\rSrSrSrSr\"\S9S5rSr g)EndpointProviderizros 447   8 $ZZ 12jj*+ jj% [ ;\ \ B /0j> 8> B$x4((.DAAH//dr