o "`^h.y@sdZddlmZddlmZmZddlmZddlm Z ddl m Z m Z ddl mZmZmZeZGdd d eZGd d d eZGd d d eZGdddeZGdddeZGdddZGdddeZGdddeZGdddeZGdddeZGdddeZGdddeZ Gd d!d!eZ!Gd"d#d#Z"Gd$d%d%Z#Gd&d'd'Z$Gd(d)d)Z%Gd*d+d+Z&Gd,d-d-Z'd.S)/z-Abstractions to interact with service models.) defaultdict) NamedTupleUnion)resolve_auth_type) OrderedDict)MissingServiceIdErrorUndefinedModelAttributeError)CachedPropertyhyphenize_service_idinstance_cachec@ eZdZdS)NoShapeFoundErrorN__name__ __module__ __qualname__rrL/home/air/shanriGPT/back/venv/lib/python3.10/site-packages/botocore/model.pyr r c@r )InvalidShapeErrorNrrrrrr!rrc@r )OperationNotFoundErrorNrrrrrr%rrc@r )InvalidShapeReferenceErrorNrrrrrr)rrc@seZdZddZdS) ServiceIdcCst|SN)r selfrrr hyphenize.szServiceId.hyphenizeN)rrrrrrrrr-s rc@sneZdZdZgdZgdZeZdddZe ddZ e d d Z e d d Z d dZ ddZeddZdS)Shapez3Object representing a shape from the service model.) locationName queryName flattenedlocationpayload streamingtimestampFormat xmlNamespace resultWrapper xmlAttribute eventstreamevent eventheader eventpayload jsonvaluer$ hostLabel)requiredminmaxpattern sensitiveenumidempotencyTokenerror exceptionendpointdiscoveryid retryabledocumentunion contextParamclientContextParamsrequiresLengthNcCsB||_|d|_|dd|_||_|durt}||_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_namegetr? _shape_modelUnresolvableShapeMap_shape_resolver_cache)r shape_name shape_modelshape_resolverrrr__init__`s  zShape.__init__cCsF|j}i}|jD] }||jvr||||<qd|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. rrA)rDSERIALIZED_ATTRSpop)rmodel serializationattrrrrrOs   zShape.serializationcCs0|j}i}|jD] }||jvr||||<q|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. )rDMETADATA_ATTRS)rrNmetadatarPrrrrRs   zShape.metadatacC|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. r.rRrCrrrrrequired_memberss zShape.required_memberscC |j|SrrFresolve_shape_refr shape_refrrr_resolve_shape_ref zShape._resolve_shape_refcCsd|jjd|jdS)N<(z)> __class__rrArrrr__repr__szShape.__repr__cCsdSrrrrrrevent_stream_nameszShape.event_stream_namer)rrr__doc__rLrQrMAP_TYPErKr rOrRrUr[rapropertyrbrrrrr2s  "    rc@sHeZdZeddZeddZeddZeddZed d Zd S) StructureShapecCs>|jd|}|}|D] \}}||||<q|S)Nmembers)rDrCrditemsr[)rrg shape_membersrArZrrrrgs zStructureShape.memberscCs,|jD]\}}|jdr|SqdS)Nr()rgrhrOrC)r member_namememberrrrrbs  z StructureShape.event_stream_namecCs8|jdds dS|jdi}|d}|r|S|jS)Nr6Fr5code)rRrCrA)rerror_metadatarlrrr error_codes zStructureShape.error_codecC|jddS)Nr9FrTrrrris_document_typezStructureShape.is_document_typecCro)Nr:FrTrrrris_tagged_unionrqzStructureShape.is_tagged_unionN) rrrr rgrbrnrprrrrrrrfs    rfc@eZdZeddZdS) ListShapecC||jdS)Nrkr[rDrrrrrkzListShape.memberN)rrrr rkrrrrrtrtc@s$eZdZeddZeddZdS)MapShapecCru)Nkeyrvrrrrrzrwz MapShape.keycCru)Nvaluervrrrrr{ rwzMapShape.valueN)rrrr rzr{rrrrrys  ryc@rs) StringShapecCrS)Nr3rTrrrrr3rqzStringShape.enumN)rrrr r3rrrrr|rxr|c@s&eZdZUeed<eeefed<dS)StaticContextParameterrAr{N)rrrstr__annotations__rboolrrrrr}s r}c@seZdZUeed<eed<dS)ContextParameterrArjNrrrr~rrrrrrs  rc@s&eZdZUeed<eed<eed<dS)ClientContextParameterrAr>r?Nrrrrrr!s  rc@seZdZdZd0ddZd0ddZddZed d Zd d Z ed dZ eddZ e ddZ eddZeddZeddZeddZeddZeddZedd Zed!d"Zed#d$Zed%d&Zed'd(Zd)d*Zed+d,Zejd-d,Zd.d/ZdS)1 ServiceModelzQ :ivar service_description: The parsed service description dictionary. NcCs<||_|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. rRshapesN) _service_descriptionrCrR ShapeResolverrFNOT_SET_signature_version _service_name_instance_cache)rservice_description service_namerrrrK.s  zServiceModel.__init__cCs|j||Sr)rFget_shape_by_namerrH member_traitsrrr shape_forMszServiceModel.shape_forcCs|j|dSr)_error_code_cacherC)rrnrrrshape_for_error_codeRz!ServiceModel.shape_for_error_codecCs"i}|jD] }|j}|||<q|Sr) error_shapesrn)rerror_code_cache error_shaperlrrrrUs   zServiceModel._error_code_cachecCrVrrWrYrrrrX]r\zServiceModel.resolve_shape_refcCst|jdiS)NrlistrrCrrrr shape_names`zServiceModel.shape_namescCs6g}|jD]}||}|jddr||q|S)Nr6F)rrrRrCappend)rrrHrrrrrds   zServiceModel.error_shapescCs6z |jd|}Wn tyt|wt|||SN operations)rKeyErrorrOperationModel)roperation_namerNrrroperation_modelms   zServiceModel.operation_modelcCroNr?r@)rrCrrrrr?urqzServiceModel.documentationcCst|jdgSrrrrrroperation_namesyrzServiceModel.operation_namescCs|jdur|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. N)rendpoint_prefixrrrrr}s zServiceModel.service_namecCs,zt|dWStyt|jdw)N serviceId)r)r_get_metadata_propertyrrrrrrr service_ids   zServiceModel.service_idcCs|jd}|dur |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. signingNameN)rRrCr)r signing_namerrrrs zServiceModel.signing_namecC |dS)N apiVersionrrrrr api_version zServiceModel.api_versioncCr)NprotocolrrrrrrrzServiceModel.protocolcCr)NendpointPrefixrrrrrrrzServiceModel.endpoint_prefixcCs(|jD]}||}|jr|SqdSr)rris_endpoint_discovery_operationr operationrNrrrendpoint_discovery_operations  z)ServiceModel.endpoint_discovery_operationcCs6|jD]}||}|jdur|jdrdSqdS)Nr.TF)rrendpoint_discoveryrCrrrrendpoint_discovery_requireds    z(ServiceModel.endpoint_discovery_requiredcC |jdi}dd|DS)Nr<cSs&g|]\}}t||d|ddqS)r>r?)rAr>r?)r).0 param_name param_valrrr sz:ServiceModel.client_context_parameters..)rrCrhrparamsrrrclient_context_parameterssz&ServiceModel.client_context_parameterscCs0z|j|WStytd|d|w)N"z," not defined in the metadata of the model: )rRrrrrArrrrs  z#ServiceModel._get_metadata_propertycCs"|jtur|jd}||_|jS)NsignatureVersion)rrrRrC)rsignature_versionrrrrs  zServiceModel.signature_versioncCs ||_dSr)r)rr{rrrrrcC|jjd|jdS)Nr^))r`rrrrrrrazServiceModel.__repr__r)rrrrcrKrrr rrXrrr rr?rrrrrrrrrrrrersetterrarrrrr'sT                     rc@szeZdZdDddZeddZeddZedd Zed d Z ed d Z eddZ eddZ eddZ eddZeddZeddZeddZeddZeddZed d!Zed"d#Zed$d%Zed&d'Zed(d)Zed*d+Zed,d-Zed.d/Zed0d1Zd2d3Zd4d5Zd6d7Zed8d9Z ed:d;Z!dd?Z#d@dAZ$dBdCZ%dS)ErNcCs8||_||_||_|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. rAhttpN)_operation_model_service_model _api_namerC _wire_namerRr)rr service_modelrArrrrKs  zOperationModel.__init__cCs|jdur|jS|jSr)r wire_namerrrrrA s zOperationModel.namecC |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``. rArrCrrrrrs zOperationModel.wire_namecCs|jSr)rrrrrr szOperationModel.service_modelcCrorrrrrrr?$rqzOperationModel.documentationcCro)N deprecatedFrrrrrr(rqzOperationModel.deprecatedcCs|jddS)Nendpointdiscoveryrrrrrr,sz!OperationModel.endpoint_discoverycCro)NendpointoperationFrrrrrr2rqz.OperationModel.is_endpoint_discovery_operationcC d|jvrdS|j|jdS)NinputrrrXrrrr input_shape6s zOperationModel.input_shapecCr)Noutputrrrrr output_shape@s zOperationModel.output_shapecCs"|j}|sgSdd|jDS)NcSs(g|]\}}d|jvr|jdr|qS)r4)rRrrAshaperrrrQs z5OperationModel.idempotent_members..rrgrh)rrrrridempotent_membersKs z!OperationModel.idempotent_memberscCr)NstaticContextParamscSs"g|] \}}t||ddqS)r{)rAr{)r}rC)rrApropsrrrr[sz.)rrCrhrrrrstatic_context_parametersXsz(OperationModel.static_context_parameterscCs |jsgSdd|jjDS)NcSs>g|]\}}d|jvrd|jdvrt|jdd|dqS)r;rA)rArj)rRrrrrrres  z5OperationModel.context_parameters..rrrrrcontext_parameters`s  z!OperationModel.context_parameterscCr)Nrequestcompressionrrrrrrequest_compressiono z"OperationModel.request_compressioncCr)NauthrrrrrrsrzOperationModel.authcCr)Nauthtyperrrrr auth_typewrzOperationModel.auth_typecCs|jrt|jS|jSr)rrrrrrrresolved_auth_type{s z!OperationModel.resolved_auth_typecCr)NunsignedPayloadrrrrrunsigned_payloadrzOperationModel.unsigned_payloadcs$jdg}tfdd|DS)Nerrorsc3s|] }j|VqdSr)rrX)rsrrr sz.OperationModel.error_shapes..)rrCr)rrrrrrszOperationModel.error_shapescCr)NendpointrrrrrrrzOperationModel.endpointcCro)NhttpChecksumRequiredFrrrrrhttp_checksum_requiredrqz%OperationModel.http_checksum_requiredcCs|jdiS)N httpChecksumrrrrr http_checksumrqzOperationModel.http_checksumcC |duSr)get_event_stream_inputrrrrhas_event_stream_inputrz%OperationModel.has_event_stream_inputcCrr)get_event_stream_outputrrrrhas_event_stream_outputrz&OperationModel.has_event_stream_outputcC ||jSr)_get_event_streamrrrrrrr\z%OperationModel.get_event_stream_inputcCrr)rrrrrrrr\z&OperationModel.get_event_stream_outputcCs$|durdS|j}|r|j|SdS)zAReturns the event stream member's shape if any or None otherwise.N)rbrg)rr event_namerrrrs  z OperationModel._get_event_streamcCrr)get_streaming_inputrrrrhas_streaming_inputrz"OperationModel.has_streaming_inputcCrr)get_streaming_outputrrrrhas_streaming_outputrz#OperationModel.has_streaming_outputcCrr)_get_streaming_bodyrrrrrrr\z"OperationModel.get_streaming_inputcCrr)rrrrrrrr\z#OperationModel.get_streaming_outputcCs<|durdS|jd}|dur|j|}|jdkr|SdS)z?Returns the streaming member's shape if any; or None otherwise.Nr"blob)rOrCrgrB)rrr" payload_shaperrrrs   z"OperationModel._get_streaming_bodycCr)Nz(name=rr_rrrrrarzOperationModel.__repr__r)&rrrrKr rArerrr?rrrrrrrrrrrrrrrrrrrrrrrrrrrrarrrrrsv %                          rc@s8eZdZdZeeeedZddZ d ddZ dd Z dS) rzResolves shape references.) structurermapstringcCs||_i|_dSr) _shape_map _shape_cache)r shape_maprrrrKs zShapeResolver.__init__NcCsz|j|}Wn tyt|wz |j|dt}Wnty,td|w|r8|}||||||}|S)Nr>z&Shape is missing required key 'type': ) rrr SHAPE_CLASSESrCrrcopyupdate)rrHrrI shape_clsresultrrrrs"    zShapeResolver.get_shape_by_namecCsbt|dkrd|vr||dS|}z|d}Wnty*td|w|||S)Nrz(Invalid model, missing shape reference: )lenrr rMrr)rrZrrHrrrrXs  zShapeResolver.resolve_shape_refr) rrrrcrfrtryr|rrKrrXrrrrrs  rc@s"eZdZdZdddZddZdS)rEzEA ShapeResolver that will throw ValueErrors when shapes are resolved.NcCtd|d)NzAttempted to lookup shape '!', but no shape map was provided. ValueErrorrrrrr z&UnresolvableShapeMap.get_shape_by_namecCr)NzAttempted to resolve shape 'rrrYrrrrXrz&UnresolvableShapeMap.resolve_shape_refr)rrrrcrrXrrrrrEs  rEc@sfeZdZdZdZdddZddZdd Zd d Zd d Z ddZ ddZ ddZ ddZ ddZdS)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. ) rintegerbooleanrfloat timestamplongdoublecharNcCs.t|_t|_|dur|jd|_dSdS)Nr)rrgShapeNameGenerator_name_generatornew_shape_namerArrrrrK@s z%DenormalizedStructureBuilder.__init__cCs ||_|S)zp :type members: dict :param members: The denormalized members. :return: self )_members)rrgrrr with_membersFs z)DenormalizedStructureBuilder.with_memberscCsBt}d|jd}||||jt|d}t|j||j|dS)zBuild the model based on the provided members. :rtype: botocore.model.StructureShape :return: The built StructureShape object. r)r>rg)r)rHrIrJ)rr _build_modelrArrf)rr denormalizedresolverrrr build_modelRs z(DenormalizedStructureBuilder.build_modelcCs|ddkr|||||<dS|ddkr |||||<dS|ddkr0|||||<dS|d|jvr@||||<dStd|d)Nr>rrrzUnknown shape type: )_build_structure _build_list _build_map SCALAR_TYPES _build_scalarr)rrNrrHrrrr!fs   z)DenormalizedStructureBuilder._build_modelcCs\t}||}||d<|dtD]\}}||}d|i||<||||q|S)Nrgr)r_build_initial_shaperCrh_get_shape_namer!)rrNrrgrrA member_modelmember_shape_namerrrr%rs   z-DenormalizedStructureBuilder._build_structurecCs6||}||}d|i|d<||d|||S)Nrrkr+r*r!)rrNrr-rrrrr&}s   z(DenormalizedStructureBuilder._build_listcCsf||d}||d}||}d|i|d<d|i|d<||d||||d|||S)Nrzr{rr.)rrNrkey_shape_namevalue_shape_namerrrrr's   z'DenormalizedStructureBuilder._build_mapcCsDd|di}d|vr|d|d<tjD] }||vr||||<q|S)Nr>r?)rrQ)rrNrrPrrrr*s   z1DenormalizedStructureBuilder._build_initial_shapecCs ||Sr)r*rrNrrrr)s z*DenormalizedStructureBuilder._build_scalarcCs d|vr|dS|j|dS)NrHr>)rrr1rrrr+sz,DenormalizedStructureBuilder._get_shape_namer)rrrrcr(rKr r$r!r%r&r'r*r)r+rrrrrs$      rc@s eZdZdZddZddZdS)rzGenerate 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. cCstt|_dSr)rint _name_cacherrrrrKrzShapeNameGenerator.__init__cCs.|j|d7<|j|}|d|S)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 r Type)r3 capitalize)rrB current_indexrrrrs z!ShapeNameGenerator.new_shape_nameN)rrrrcrKrrrrrrs rN)(rc collectionsrtypingrr botocore.authrbotocore.compatrbotocore.exceptionsrrbotocore.utilsr r r objectr Exceptionr rrrr~rrrfrtryr|r}rrrrrrErrrrrrs>   &* ?f6