/JfwpdZddlmZddlmZmZddlmZddlm Z m Z ddl m Z m Z mZeZGddeZGd d eZGd d eZGd deZGddeZGddZGddeZGddeZGddeZGddeZGddeZGddeZGdd eZGd!d"Z Gd#d$Z!Gd%d&Z"Gd'd(Z#Gd)d*Z$Gd+d,Z%d-S).z-Abstractions to interact with service models.) defaultdict) NamedTupleUnion) OrderedDict)MissingServiceIdErrorUndefinedModelAttributeError)CachedPropertyhyphenize_service_idinstance_cacheceZdZdS)NoShapeFoundErrorN__name__ __module__ __qualname__Q/home/alex/cs2snipeproduction/venv/lib/python3.11/site-packages/botocore/model.pyr r Drr ceZdZdS)InvalidShapeErrorNrrrrrrrrrceZdZdS)OperationNotFoundErrorNrrrrrr#rrrceZdZdS)InvalidShapeReferenceErrorNrrrrrr'rrrceZdZdZdS) ServiceIdc t|SN)r selfs r hyphenizezServiceId.hyphenize,s#D)))rN)rrrr"rrrrr+s#*****rrceZdZdZgdZgdZeZd dZe dZ e dZ e dZ d Z d Zed ZdS) Shapez3Object representing a shape from the service model.) locationName queryName flattenedlocationpayload streamingtimestampFormat xmlNamespace resultWrapper xmlAttribute eventstreamevent eventheader eventpayload jsonvaluer+ hostLabel)requiredminmaxpattern sensitiveenumidempotencyTokenerror exceptionendpointdiscoveryid retryabledocumentunion contextParamclientContextParamsrequiresLengthNc||_|d|_|dd|_||_|t }||_i|_dS)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_namegetrG _shape_modelUnresolvableShapeMap_shape_resolver_cache)r! shape_name shape_modelshape_resolvers r__init__zShape.__init__^s[( $V,(___bAA'  ! 233N- rc|j}i}|jD]}||jvr ||||<d|vr|d|d<|S)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. r%rI)rLSERIALIZED_ATTRSpop)r!model serializationattrs rrXzShape.serializationsi.! ) 2 2Dt(((&+Dk d# ] * *$1$5$5n$E$EM& !rcT|j}i}|jD]}||jvr ||||<|S)aMetadata 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. )rLMETADATA_ATTRS)r!rWmetadatarYs rr\zShape.metadatasD.!' - -Dt(((!&trc8|jdgS)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. r5r\rKr s rrequired_memberszShape.required_memberss}  R000rc6|j|SrrNresolve_shape_refr! shape_refs r_resolve_shape_refzShape._resolve_shape_ref#55i@@@rc2d|jjd|jdS)N<(z)> __class__rrIr s r__repr__zShape.__repr__s":4>*::TY::::rcdSrrr s revent_stream_namezShape.event_stream_namestrr)rrr__doc__rUr[rMAP_TYPErSr rXr\r_rerlpropertyrnrrrr$r$0s== &N$H    D^@^:11^1AAA;;;Xrr$c|eZdZedZedZedZedZedZdS)StructureShapec|jd|}|}|D]\}}||||<|S)Nmembers)rLrKrpitemsre)r!ru shape_membersrIrds rruzStructureShape.membersso#'' 4==??CC  &}} E EOD)"&"9"9)"D"DM$  rc|jD]#\}}|jdr|cS$dS)Nr/)rurvrXrK)r! member_namemembers rrnz StructureShape.event_stream_namesS#'<#5#5#7#7 # # K#'' 66 #"""" #trc|jddsdS|jdi}|d}|r|S|jS)Nr=Fr<code)r\rKrI)r!error_metadatar|s r error_codezStructureShape.error_codes`}  e44 4**7B77!!&))  Kyrc8|jddS)Nr@Fr^r s ris_document_typezStructureShape.is_document_types}  U333rc8|jddS)NrAFr^r s ris_tagged_unionzStructureShape.is_tagged_unions}  %000rN) rrrr rurnr~rrrrrrsrss  ^ ^ ^44^411^111rrsc$eZdZedZdS) ListShapecB||jdS)NrzrerLr s rrzzListShape.members&&t'8'BCCCrN)rrrr rzrrrrrs2DD^DDDrrc:eZdZedZedZdS)MapShapecB||jdS)Nkeyrr s rrz MapShape.keys&&t'8'?@@@rcB||jdS)Nvaluerr s rrzMapShape.value s&&t'8'ABBBrN)rrrr rrrrrrrsPAA^ACC^CCCrrc$eZdZedZdS) StringShapec8|jdgS)Nr:r^r s rr:zStringShape.enums}  ,,,rN)rrrr r:rrrrrs---^---rrc4eZdZUeed<eeefed<dS)StaticContextParameterrIrN)rrrstr__annotations__rboolrrrrrs0 III s rrc$eZdZUeed<eed<dS)ContextParameterrIryNrrrrrrrrrrs' IIIrrc.eZdZUeed<eed<eed<dS)ClientContextParameterrIrFrGNrrrrrrs0 III IIIrrceZdZdZddZddZdZedZdZ edZ ed Z e d Z ed Zed Zed ZedZedZedZedZedZedZedZedZdZedZejdZdZdS) ServiceModelzQ :ivar service_description: The parsed service description dictionary. Nc||_|di|_t|di|_t |_||_i|_dS)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. r\shapesN) _service_descriptionrKr\ ShapeResolverrNNOT_SET_signature_version _service_name_instance_cache)r!service_description service_names rrSzServiceModel.__init__,sh*%8!+// B?? ,  # #Hb 1 1  #*)!rc8|j||Sr)rNget_shape_by_namer!rP member_traitss r shape_forzServiceModel.shape_forKs"#55     rc8|j|dSr)_error_code_cacherK)r!r~s rshape_for_error_codez!ServiceModel.shape_for_error_codePs%))*d;;;rc6i}|jD]}|j}|||<|Sr) error_shapesr~)r!error_code_cache error_shaper|s rrzServiceModel._error_code_cacheSs6, 1 1K)D%0 T " "rc6|j|Srrarcs rrbzServiceModel.resolve_shape_ref[rfrcRt|jdiS)NrlistrrKr s r shape_nameszServiceModel.shape_names^s#D-11(B??@@@rcg}|jD]G}||}|jddr||H|S)Nr=F)rrr\rKappend)r!rrPrs rrzServiceModel.error_shapesbs` * 1 1J..44K#'' U;; 1##K000rc |jd|}n#t$rt|wxYwt|||SN operations)rKeyErrorrOperationModel)r!operation_namerWs roperation_modelzServiceModel.operation_modelksV 9-l;NKEE 9 9 9(88 8 9eT>:::s0c8|jddSNrGrH)rrKr s rrGzServiceModel.documentationss(,,_bAAArcRt|jdgSrrr s roperation_nameszServiceModel.operation_namesws#D-11,CCDDDrc,|j|jS|jS)aThe 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 rrzServiceModel.service_name{s   )% %' 'rc t|dS#t$rt|jwxYw)N serviceId)r)r_get_metadata_propertyrrrr s r service_idzServiceModel.service_idsW IT88EEFF F+ I I I'T5GHHH H Is !$ AcL|jd}||j}|S)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)r\rKr)r! signing_names rrzServiceModel.signing_names-}((77  /Lrc,|dS)N apiVersionrr s r api_versionzServiceModel.api_versions**<888rc,|dS)Nprotocolrr s rrzServiceModel.protocols**:666rc,|dS)NendpointPrefixrr s rrzServiceModel.endpoint_prefixs**+;<<z:ServiceModel.client_context_parameters..sP   & I #v&'8      r)rrKrvr!paramss rclient_context_parametersz&ServiceModel.client_context_parameterssF*../DbII  *0     rcd |j|S#t$rtd|d|wxYw)N"z," not defined in the metadata of the model: )r\rrr!rIs rrz#ServiceModel._get_metadata_propertysT =& &   .LDLLdLL  s  /cn|jtur!|jd}||_|jS)NsignatureVersion)rrr\rK)r!signature_versions rrzServiceModel.signature_versions8  "g - - $ 1 12D E E &7D #&&rc||_dSr)r)r!rs rrzServiceModel.signature_versions"'rc0|jjd|jdS)Nri))rkrrr s rrlzServiceModel.__repr__s!.)@@D,=@@@@rr)rrrrorSrrr rrbrrr rrGrrrrrrrrrrrrqrsetterrlrrrrr%se """">    <<<  ^ AAAAA^A^;;^;BB^BEE^E((^( II^I   ^ 99^977^7==^=^ ^   ^  ''X' (((AAAAArrc$eZdZd dZedZedZedZedZ edZ edZ ed Z ed Z ed Zed Zed ZedZedZedZedZedZedZedZedZedZdZdZdZedZedZdZdZ dZ!dZ"dS)!rNc||_||_||_|d|_|j|_|di|_dS)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. rIhttpN)_operation_model_service_model _api_namerK _wire_namer\r)r!r service_modelrIs rrSzOperationModel.__init__sW8!0+*--f55%. #''33 rc,|j|jS|jSr)r wire_namer s rrIzOperationModel.name s > %> !> !rc6|jdS)aRThe 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``. rIrrKr s rrzOperationModel.wire_names$((000rc|jSr)rr s rrzOperationModel.service_models ""rc8|jddSrrr s rrGzOperationModel.documentation"s$(("===rc8|jddS)N deprecatedFrr s rrzOperationModel.deprecated&s$((u===rc8|jddS)Nendpointdiscoveryrr s rrz!OperationModel.endpoint_discovery*s$(()s= 40 0 04"44  !( +   rc^|j}|sgSd|jDS)NcDg|]\}}d|jv|jd|S)r;)r\rrIshapes rrz5OperationModel.idempotent_members..OsC   u!U^33124 333rrrurv)r!rs ridempotent_membersz!OperationModel.idempotent_membersIsG&  I  !,!4!:!:!.YsE   e #EIIg4F4F G G G   r)rrKrvrs rstatic_context_parametersz(OperationModel.static_context_parametersVsD&**+@"EE  %||~~    rcd|jsgSd|jjDS)Ncg|]?\}}d|jvr1d|jdvt|jdd|@S)rBrI)rIry)r\rr s rrz5OperationModel.context_parameters..csj   e//%.888 ^N3F;     988rrr s rcontext_parametersz!OperationModel.context_parameters^sG I  $/7==??     rc6|jdS)Nrequestcompressionrr s rrequest_compressionz"OperationModel.request_compressionms$(()=>>>rc6|jdS)Nauthtyperr s r auth_typezOperationModel.auth_typeq$((444rcpjdg}tfd|DS)Nerrorsc3LK|]}j|VdSr)rrb)rsr!s r z.OperationModel.error_shapes..xs4MMD'99!<<MMMMMMr)rrKr)r!rs` rrzOperationModel.error_shapesus>&**8R88MMMMfMMMMMMrc6|jdS)Nendpointrr s rr&zOperationModel.endpointzrrc8|jddS)NhttpChecksumRequiredFrr s rhttp_checksum_requiredz%OperationModel.http_checksum_required~s$(()?GGGrc8|jdiS)N httpChecksumrr s r http_checksumzOperationModel.http_checksums$((<<>^>>>^>DD^D EE^E  ^   ^    ^    ^    ^  ??^?55^5NN^N55^5HH^H==^=99^9::^:88899966^677^7:::;;;   >>>>>rrc4eZdZdZeeeedZdZ ddZ dZ dS)rzResolves shape references.) structurermapstringc"||_i|_dSr) _shape_map _shape_cache)r! shape_maps rrSzShapeResolver.__init__s#rNc^ |j|}n#t$rt|wxYw |j|dt }n #t$rt d|wxYw|r)|}||||||}|S)NrFz&Shape is missing required key 'type': ) rJrr SHAPE_CLASSESrKr$rcopyupdate)r!rPrrQ shape_clsresults rrzShapeResolver.get_shape_by_names 0/*5KK 0 0 0#J// / 0 *..{6/BEJJII   #FFF    .%**,,K   } - - -:{D99 s *&AA2c(t|dkrd|vr||dS|} |d}n #t$rt d|wxYw|||S)Nrz(Invalid model, missing shape reference: )lenrrOrVrr)r!rdrrPs rrbzShapeResolver.resolve_shape_refs y>>Q  7i#7#7)))G*<== =%NN,,M *..w77    0JyJJ ))*mDD Ds AA;r) rrrrorsrrrrNrSrrbrrrrrsk$$$ M"EEEEErrc eZdZdZddZdZdS)rMzEA ShapeResolver that will throw ValueErrors when shapes are resolved.Nc(td|d)NzAttempted to lookup shape '!', but no shape map was provided. ValueErrorrs rrz&UnresolvableShapeMap.get_shape_by_names" W* W W W   rc(td|d)NzAttempted to resolve shape 'rXrYrcs rrbz&UnresolvableShapeMap.resolve_shape_refs* !9 ! ! !   rr)rrrrorrbrrrrMrMs=OO         rrMcTeZdZdZdZddZdZdZdZdZ d Z d Z d Z d Z d ZdS)DenormalizedStructureBuilderaBuild 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. ) rHintegerbooleanrBfloat timestamplongdoublecharNct|_t|_|!|jd|_dSdS)NrF)rruShapeNameGenerator_name_generatornew_shape_namerIrs rrSz%DenormalizedStructureBuilder.__init__0sC"}} 133 <,;;KHHDIII >> 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 rTType)r capitalize)r!rJ current_indexs rrhz!ShapeNameGenerator.new_shape_namesP4 ###q(###(3 &&((==m===rN)rrrrorSrhrrrrfrfs<,,,>>>>>rrfN)&ro collectionsrtypingrrbotocore.compatrbotocore.exceptionsrrbotocore.utilsr r r objectr Exceptionr rrrrrr$rsrrrrrrrrrrMr]rfrrrrs43######$$$$$$$$''''''POOOOOOOOO &((                     Y           ******** bbbbbbbbJ'1'1'1'1'1U'1'1'1TDDDDDDDD CCCCCuCCC-----%--- Z z Z {A{A{A{A{A{A{A{A|T>T>T>T>T>T>T>T>n3E3E3E3E3E3E3E3El         QFQFQFQFQFQFQFQFh'>'>'>'>'>'>'>'>'>'>r