ڰjN~SrSSKJr SSKJr SSKJr SSKJr SSK J r J r J r SSK JrJrJrJr \"5r"SS \5r"S S \5r"S S \5r"SS\5r"SS\5r"SS5r"SS\5r"SS\5r"SS\5r"SS\5r"SS\5r "SS\5r!"S S!\5r""S"S#5r#"S$S%5r$"S&S'5r%"S(S)5r&"S*S+5r'"S,S-5r(g.)/z-Abstractions to interact with service models.) defaultdict) NamedTuple)resolve_auth_type) OrderedDict)MissingServiceIdErrorUndefinedModelAttributeError UnsupportedServiceProtocolsError)$PRIORITY_ORDERED_SUPPORTED_PROTOCOLSCachedPropertyhyphenize_service_idinstance_cachec\rSrSrSrg)NoShapeFoundError#N__name__ __module__ __qualname____firstlineno____static_attributes__rK/home/mande/repo/quber/.venv/lib/python3.13/site-packages/botocore/model.pyrr#rrc\rSrSrSrg)InvalidShapeError'rNrrrrrr'rrrc\rSrSrSrg)OperationNotFoundError+rNrrrrrr+rrrc\rSrSrSrg)InvalidShapeReferenceError/rNrrrrr"r"/rrr"c\rSrSrSrSrg) ServiceId3c[U5$N)r selfs r hyphenizeServiceId.hyphenize4s #D))rrN)rrrrr+rrrrr%r%3s*rr%c\rSrSrSr/SQr/SQr\rSSjr \ S5r \ S5r \ S 5r S rS r\S 5rS rg)Shape8z3Object representing a shape from the service model.) locationName queryName flattenedlocationpayload streamingtimestampFormat xmlNamespace resultWrapper xmlAttribute eventstreamevent eventheader eventpayload jsonvaluer6 hostLabel)requiredminmaxpattern sensitiveenumidempotencyTokenerror exceptionendpointdiscoveryid retryabledocumentunion contextParamclientContextParamsrequiresLengthNcXlUSUlURSS5UlX lUc [ 5nX0l0Ulg)a :type shape_name: string :param shape_name: The name of the shape. :type shape_model: dict :param shape_model: The shape model. This would be the value associated with the key in the "shapes" dict of the service model (i.e ``model['shapes'][shape_name]``) :type shape_resolver: botocore.model.ShapeResolver :param shape_resolver: A shape resolver object. This is used to resolve references to other shapes. For scalar shape types (string, integer, boolean, etc.), this argument is not required. If a shape_resolver is not provided for a complex type, then a ``ValueError`` will be raised when an attempt to resolve a shape is made. type documentationN)name type_namegetrR _shape_modelUnresolvableShapeMap_shape_resolver_cache)r* shape_name shape_modelshape_resolvers r__init__Shape.__init__fsK( $V,(___bA'  ! 23N- rcURn0nURHnX0R;dMXX#'M SU;aURS5US'U$)aSerialization information about the shape. This contains information that may be needed for input serialization or response parsing. This can include: * name * queryName * flattened * location * payload * streaming * xmlNamespace * resultWrapper * xmlAttribute * jsonvalue * timestampFormat :rtype: dict :return: Serialization information about the shape. r0rT)rWSERIALIZED_ATTRSpop)r*model serializationattrs rrdShape.serializations_.!! ))D(((&+k #* ] *$1$5$5n$EM& !rcvURn0nURHnX0R;dMXX#'M U$)aMMetadata about the shape. This requires optional information about the shape, including: * min * max * pattern * enum * sensitive * required * idempotencyToken * document * union * contextParam * clientContextParams * requiresLength :rtype: dict :return: Metadata about the shape. )rWMETADATA_ATTRS)r*rcmetadatares rriShape.metadatas@.!!''D(((!&(rc:URRS/5$)zA list of members that are required. A structure shape can define members that are required. This value will return a list of required members. If there are no required members an empty list is returned. r@rirVr)s rrequired_membersShape.required_memberss}}  R00rc8URRU5$r(rYresolve_shape_refr* shape_refs r_resolve_shape_refShape._resolve_shape_ref##55i@@rcPSURRSURS3$)N<(z)> __class__rrTr)s r__repr__Shape.__repr__s&4>>**+1TYYKr::rcgr(rr)s revent_stream_nameShape.event_stream_namesr)rZrWrYrRrTrUr()rrrr__doc__rarhrMAP_TYPEr^r rdrirmrtr|propertyrrrrrr.r.8s}= &N$H D@:11A;rr.cd\rSrSr\S5r\S5r\S5r\S5r\S5r Sr g) StructureShapecURRSUR55nUR5nUR5Hup4UR U5X#'M U$)Nmembers)rWrVritemsrt)r*r shape_membersrTrss rrStructureShape.memberssX##'' 4==?C  &}}OD"&"9"9)"DM  /rcURR5H)upURRS5(dM'Us $ g)Nr:)rrrdrV)r* member_namemembers rr StructureShape.event_stream_names>#'<<#5#5#7 K##'' 66""$8rcURRSS5(dgURRS05nURS5nU(aU$UR$)NrHFrGcode)rirVrT)r*error_metadatars r error_codeStructureShape.error_codesT}}  e44**7B7!!&) Kyyrc:URRSS5$)NrKFrlr)s ris_document_typeStructureShape.is_document_types}}  U33rc:URRSS5$)NrLFrlr)s ris_tagged_unionStructureShape.is_tagged_unions}}  %00rrN) rrrrr rrrrrrrrrrrsd   4411rrc$\rSrSr\S5rSrg) ListShapeic>URURS5$)NrrtrWr)s rrListShape.members&&t'8'8'BCCrrN)rrrrr rrrrrrrsDDrrc4\rSrSr\S5r\S5rSrg)MapShapei c>URURS5$)Nkeyrr)s rr MapShape.keys&&t'8'8'?@@rc>URURS5$)Nvaluerr)s rrMapShape.values&&t'8'8'ABBrrN)rrrrr rrrrrrrr s,AACCrrc$\rSrSr\S5rSrg) StringShapeic:URRS/5$)NrErlr)s rrEStringShape.enums}}  ,,rrN)rrrrr rErrrrrrs--rrc0\rSrSr%\\S'\\-\S'Srg)StaticContextParameterirTrrN)rrrrstr__annotations__boolrrrrrrs I #:rrc*\rSrSr%\\S'\\S'Srg)ContextParameteri"rTrrNrrrrrrrrrrrr"s Irrc4\rSrSr%\\S'\\S'\\S'Srg)ClientContextParameteri'rTrQrRrNrrrrrr's I Irrc\rSrSrSrSSjrSSjrSr\S5r Sr \S 5r \S 5r \ S 5r\S 5r\S 5r\S5r\S5r\S5r\S5r\S5r\S5r\S5r\S5r\S5r\S5r\S5rSr\S5r\R>S5r\S5r Sr!Sr"g) ServiceModeli-zI :ivar service_description: The parsed service description dictionary. NcXlURS05Ul[URS055Ul[ UlX l0Ulg)a :type service_description: dict :param service_description: The service description model. This value is obtained from a botocore.loader.Loader, or from directly loading the file yourself:: service_description = json.load( open('/path/to/service-description-model.json')) model = ServiceModel(service_description) :type service_name: str :param service_name: The name of the service. Normally this is the endpoint prefix defined in the service_description. However, you can override this value to provide a more convenient name. This is done in a few places in botocore (ses instead of email, emr instead of elasticmapreduce). If this value is not provided, it will default to the endpointPrefix defined in the model. rishapesN) _service_descriptionrVri ShapeResolverrYNOT_SET_signature_version _service_name_instance_cache)r*service_description service_names rr^ServiceModel.__init__4sS*%8!+// B? ,  # #Hb 1 #*)!rc8URRX5$r()rYget_shape_by_namer*r[ member_traitss r shape_forServiceModel.shape_forSs##55   rc:URRUS5$r()_error_code_cacherV)r*rs rshape_for_error_code!ServiceModel.shape_for_error_codeXs%%))*d;;rcP0nURHnURnX!U'M U$r() error_shapesr)r*error_code_cache error_shapers rrServiceModel._error_code_cache[s3,,K))D%0T "- rc8URRU5$r(rprrs rrqServiceModel.resolve_shape_refcrvrcL[URRS055$)NrlistrrVr)s r shape_namesServiceModel.shape_namesfs D--11(B?@@rc/nURHHnURU5nURRSS5(dM7UR U5 MJ U$)NrHF)rrrirVappend)r*rr[rs rrServiceModel.error_shapesjsT **J..4K##'' U;;##K0+rcrURSUn[X U5$![a [U5ef=fN operations)rKeyErrorrOperationModel)r*operation_namercs roperation_modelServiceModel.operation_modelssG 9--l;NKEe>:: 9(8 8 9s 6c:URRSS5$NrRrS)rrVr)s rrRServiceModel.documentation{s((,,_bAArcL[URRS/55$rrr)s roperation_namesServiceModel.operation_namess D--11,CDDrcLURb UR$UR$)asThe name of the service. This defaults to the endpointPrefix defined in the service model. However, this value can be overriden when a ``ServiceModel`` is created. If a service_name was not provided when the ``ServiceModel`` was created and if there is no endpointPrefix defined in the service model, then an ``UndefinedModelAttributeError`` exception will be raised. )rendpoint_prefixr)s rrServiceModel.service_names(    )%% %'' 'rcz[URS55$![a [URS9ef=f)N serviceId)r)r%_get_metadata_propertyrrrr)s r service_idServiceModel.service_ids@ IT88EF F+ I'T5G5GH H Is:cZURRS5nUc URnU$)zThe name to use when computing signatures. If the model does not define a signing name, this value will be the endpoint prefix defined in the model. signingName)rirVr)r* signing_names rrServiceModel.signing_names/}}((7  //Lrc$URS5$)N apiVersionrr)s r api_versionServiceModel.api_versions**<88rc$URS5$)Nprotocolrr)s rrServiceModel.protocols**:66rc$URS5$)N protocolsrr)s rrServiceModel.protocolss**;77rcURRS5(aC[HnXR;dMUs $ [ [URUR S9eUR $)Nr)botocore_supported_protocolsservice_supported_protocolsservice)rirVr rr rr)r*rs rresolved_protocolServiceModel.resolved_protocolsa ==  [ ) )@~~-#OA3-Q,0NN)) }}rc$URS5$)NendpointPrefixrr)s rrServiceModel.endpoint_prefixs**+;<a@@r)rrrrYrrir()#rrrrrr^rrr rrqrrr rrRrrrrrrrrrrrrrrr setterr%r|rrrrrr-s "> <  AAA;;BBEE(( II   997788"==     '' ((55Arrc\rSrSrS&Sjr\S5r\S5r\S5r \S5r \S5r \S 5r \S 5r \S 5r\S 5r\S 5r\S5r\S5r\S5r\S5r\S5r\S5r\S5r\S5r\S5r\S5r\S5r\S5r\S5r\S5rSrSr Sr!\S5r"\S 5r#S!r$S"r%S#r&S$r'S%r(g)'riNcXlX lX0lURS5UlUR UlURS05Ulg)a :type operation_model: dict :param operation_model: The operation model. This comes from the service model, and is the value associated with the operation name in the service model (i.e ``model['operations'][op_name]``). :type service_model: botocore.model.ServiceModel :param service_model: The service model associated with the operation. :type name: string :param name: The operation name. This is the operation name exposed to the users of this model. This can potentially be different from the "wire_name", which is the operation name that *must* by provided over the wire. For example, given:: "CreateCloudFrontOriginAccessIdentity":{ "name":"CreateCloudFrontOriginAccessIdentity2014_11_06", ... } The ``name`` would be ``CreateCloudFrontOriginAccessIdentity``, but the ``self.wire_name`` would be ``CreateCloudFrontOriginAccessIdentity2014_11_06``, which is the value we must send in the corresponding HTTP request. rThttpN)_operation_model_service_model _api_namerV _wire_namerir-)r*r service_modelrTs rr^OperationModel.__init__sJ8!0+*--f5%.. #''3 rcLURb UR$UR$r()r0 wire_namer)s rrTOperationModel.name+s >> %>> !>> !rc8URRS5$)a"The wire name of the operation. In many situations this is the same value as the ``name``, value, but in some services, the operation name exposed to the user is different from the operation name we send across the wire (e.g cloudfront). Any serialization code should use ``wire_name``. rTr.rVr)s rr5OperationModel.wire_name2s$$((00rcUR$r()r/r)s rr2OperationModel.service_model@s"""rc:URRSS5$rr8r)s rrROperationModel.documentationDs$$(("==rc:URRSS5$)N deprecatedFr8r)s rr?OperationModel.deprecatedHs$$((u==rc:URRSS5$)Nendpointdiscoveryr8r)s rr!OperationModel.endpoint_discoveryLs$$(()>rc8URRS5$)Nauthr8r)s rreOperationModel.auths$$((00rc8URRS5$)Nauthtyper8r)s r auth_typeOperationModel.auth_type$$((44rcfUR(a[UR5$UR$r()rerrir)s rresolved_auth_type!OperationModel.resolved_auth_types" 99$TYY/ /~~rc8URRS5$)NunsignedPayloadr8r)s runsigned_payloadOperationModel.unsigned_payloads$$(():;;rcf^TRRS/5n[U4SjU55$)Nerrorsc3Z># UH nTRRU5v M" g7fr()r/rq).0sr*s r .OperationModel.error_shapes..s%MfD''99!<>>>DD EE              GG??1155 <<NN55HH==99::896677:; >rrc<\rSrSrSr\\\\S.r Sr S Sjr Sr Sr g) rizResolves shape references.) structurermapstringcXl0Ulgr() _shape_map _shape_cache)r* shape_maps rr^ShapeResolver.__init__s#rNc:URUnURR US[ 5nU(a!UR5nURU5 U"XU5nU$![a [U5ef=f![a [ SU35ef=f)NrQz&Shape is missing required key 'type': ) rrr SHAPE_CLASSESrVr.rcopyupdate)r*r[rr\ shape_clsresults rrShapeResolver.get_shape_by_names 0//*5K **..{6/BEJI %**,K   } -:D9  0#J/ / 0 #8 F  sA(#B(A>Bc[U5S:XaSU;aURUS5$UR5nURS5nURX25$![a [ SU35ef=f)NrQz(Invalid model, missing shape reference: )lenrrrbrr")r*rsrr[s rrqShapeResolver.resolve_shape_refs y>Q 7i#7)))G*<= =%NN,M *..w7 ))*D D  0>ykJ s AA6)rrr()rrrrrrrrrrr^rrqrrrrrrs*$$ M"Errc(\rSrSrSrSSjrSrSrg)rXi$zEA ShapeResolver that will throw ValueErrors when shapes are resolved.Nc [SUS35e)NzAttempted to lookup shape '!', but no shape map was provided. ValueErrorrs rr&UnresolvableShapeMap.get_shape_by_name's)*5V W  rc [SUS35e)NzAttempted to resolve shape 'rrrrs rrq&UnresolvableShapeMap.resolve_shape_ref,s *9+6  !  rrr()rrrrrrrqrrrrrXrX$sO  rrXc\\rSrSrSrSrSSjrSrSrSr S r S r S r S r S rSrSrg)DenormalizedStructureBuilderi3aZBuild a StructureShape from a denormalized model. This is a convenience builder class that makes it easy to construct ``StructureShape``s based on a denormalized model. It will handle the details of creating unique shape names and creating the appropriate shape map needed by the ``StructureShape`` class. Example usage:: builder = DenormalizedStructureBuilder() shape = builder.with_members({ 'A': { 'type': 'structure', 'members': { 'B': { 'type': 'structure', 'members': { 'C': { 'type': 'string', } } } } } }).build_model() # ``shape`` is now an instance of botocore.model.StructureShape :type dict_type: class :param dict_type: The dictionary type to use, allowing you to opt-in to using OrderedDict or another dict type. This can be particularly useful for testing when order matters, such as for documentation. ) rintegerbooleanrfloat timestamplongdoublecharNc[5Ul[5UlUc!URR S5Ulgg)Nr)rrShapeNameGenerator_name_generatornew_shape_namerTrs rr^%DenormalizedStructureBuilder.__init__ds8"} 13 <,,;;KHDI rcXlU$)zP :type members: dict :param members: The denormalized members. :return: self )_members)r*rs r with_members)DenormalizedStructureBuilder.with_membersjs  rc[5nSURS.nURX!UR5 [ US9n[ URXRUS9$)zBuild the model based on the provided members. :rtype: botocore.model.StructureShape :return: The built StructureShape object. r)rQr)r)r[r\r])rr _build_modelrTrr)r*r denormalizedresolvers r build_model(DenormalizedStructureBuilder.build_modelvs]}}  , : 62yyyy)#  rc USS:XaURX5X#'gUSS:XaURX5X#'gUSS:XaURX5X#'gUSUR;aUR U5X#'g[ SUS35e)NrQrrrzUnknown shape type: )_build_structure _build_list _build_map SCALAR_TYPES _build_scalarr)r*rcrr[s rr)DenormalizedStructureBuilder._build_models =K '!%!6!6u!EF  6]f $!%!1!1%!@F  6]e #!%!?F  6]d// /!%!3!3E!:F #&:5=/$JK Krc[5nURU5nX4S'URS[55R5H.upVUR U5nSU0X5'UR XbU5 M0 U$)NrrQ)r_build_initial_shaperVr_get_shape_namer)r*rcrrrQrT member_modelmember_shape_names rr-DenormalizedStructureBuilder._build_structures{-))%0"i"'))I{}"E"K"K"M D $ 4 4\ B $&78GM   l4E F#N rcURU5nURU5nSU0US'URUSX#5 U$)NrQrrrr)r*rcrrrQs rr(DenormalizedStructureBuilder._build_listsK 007))%0"$56h %/6E rcURUS5nURUS5nURU5nSU0US'SU0US'URUSX#5 URUSX$5 U$)NrrrQr)r*rcrkey_shape_namevalue_shape_namerQs rr'DenormalizedStructureBuilder._build_maps--eEl;//g?))%00e !#34g %,? %.&C rcxSUS0nSU;aUSUS'[RHnX1;dM XX#'M U$)NrQrR)r.rh)r*rcrQres rr1DenormalizedStructureBuilder._build_initial_shapesP E&M  e #%*?%;E/ "((D}#k ) rc$URU5$r()rr*rcs rr*DenormalizedStructureBuilder._build_scalars((//rcTSU;aUS$URRUS5$)Nr[rQ)rrrs rr,DenormalizedStructureBuilder._get_shape_names0 5 & &''66uV}E Er)rrrrTr()rrrrrrr^rrrrrrrrrrrrrrr3sD"H LI  ( L  0Frrc$\rSrSrSrSrSrSrg)rizGenerate unique shape names for a type. This class can be used in conjunction with the DenormalizedStructureBuilder to generate unique shape names for a given type. c,[[5Ulgr()rint _name_cacher)s rr^ShapeNameGenerator.__init__s&s+rcxURU==S- ss'URUnUR5SU3$)aGenerate a unique shape name. This method will guarantee a unique shape name each time it is called with the same type. :: >>> s = ShapeNameGenerator() >>> s.new_shape_name('structure') 'StructureType1' >>> s.new_shape_name('structure') 'StructureType2' >>> s.new_shape_name('list') 'ListType1' >>> s.new_shape_name('list') 'ListType2' :type type_name: string :param type_name: The type name (structure, list, map, string, etc.) :rtype: string :return: A unique shape name for the given type rType)r capitalize)r*rU current_indexs rr!ShapeNameGenerator.new_shape_namesE4 #q(#((3 &&()m_==r)rN)rrrrrr^rrrrrrrs,>rrN))r collectionsrtypingr botocore.authrbotocore.compatrbotocore.exceptionsrrr botocore.utilsr r r r objectr Exceptionrrrr"rr%r.rrrrrrrrrrrXrrrrrr s!4#+'  (     Y   ** bbJ'1U'1TDD CuC-%- Z z Z UAUApf>f>R3E3El   QFQFh'>'>r