o OjN~@sdZddlmZddlmZddlmZddlmZddl m Z m Z m Z ddl mZmZmZmZeZGdd d eZGd d d eZGd d d eZGdddeZGdddeZGdddZGdddeZGdddeZGdddeZGdddeZGdddeZ GdddeZ!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) NamedTuple)resolve_auth_type) OrderedDict)MissingServiceIdErrorUndefinedModelAttributeError UnsupportedServiceProtocolsError)$PRIORITY_ORDERED_SUPPORTED_PROTOCOLSCachedPropertyhyphenize_service_idinstance_cachec@ eZdZdS)NoShapeFoundErrorN__name__ __module__ __qualname__rrT/var/www/html/pharmsmart-cdr-gen/venv/lib/python3.10/site-packages/botocore/model.pyr#rc@r )InvalidShapeErrorNrrrrrr'rrc@r )OperationNotFoundErrorNrrrrrr+rrc@r )InvalidShapeReferenceErrorNrrrrrr/rrc@seZdZddZdS) ServiceIdcCst|SN)r selfrrr hyphenize4szServiceId.hyphenizeN)rrrrrrrrr3s 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__fs  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. rrB)rESERIALIZED_ATTRSpop)rmodel serializationattrrrrrPs   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. )rEMETADATA_ATTRS)rrOmetadatarQrrrrSs   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/rSrDrrrrrequired_memberss zShape.required_memberscC |j|SrrGresolve_shape_refr shape_refrrr_resolve_shape_ref zShape._resolve_shape_refcCsd|jjd|jdS)N<(z)> __class__rrBrrrr__repr__szShape.__repr__cCsdSrrrrrrevent_stream_nameszShape.event_stream_namer)rrr__doc__rMrRrMAP_TYPErLr rPrSrVr\rbpropertyrcrrrrr8s  "    rc@sHeZdZeddZeddZeddZeddZed d Zd S) StructureShapecCs>|jd|}|}|D] \}}||||<q|S)Nmembers)rErDreitemsr\)rrh shape_membersrBr[rrrrhs zStructureShape.memberscCs,|jD]\}}|jdr|SqdS)Nr))rhrirPrD)r member_namememberrrrrcs  z StructureShape.event_stream_namecCs8|jdds dS|jdi}|d}|r|S|jS)Nr7Fr6code)rSrDrB)rerror_metadatarmrrr error_codes zStructureShape.error_codecC|jddS)Nr:FrUrrrris_document_typezStructureShape.is_document_typecCrp)Nr;FrUrrrris_tagged_unionrrzStructureShape.is_tagged_unionN) rrrr rhrcrorqrsrrrrrgs    rgc@eZdZeddZdS) ListShapecC||jdS)Nrlr\rErrrrrlzListShape.memberN)rrrr rlrrrrruruc@s$eZdZeddZeddZdS)MapShapecCrv)Nkeyrwrrrrr{rxz MapShape.keycCrv)Nvaluerwrrrrr|rxzMapShape.valueN)rrrr r{r|rrrrrz s  rzc@rt) StringShapecCrT)Nr4rUrrrrr4rrzStringShape.enumN)rrrr r4rrrrr}ryr}c@s"eZdZUeed<eeBed<dS)StaticContextParameterrBr|N)rrrstr__annotations__boolrrrrr~s r~c@seZdZUeed<eed<dS)ContextParameterrBrkNrrrrrrrrrr"s  rc@s&eZdZUeed<eed<eed<dS)ClientContextParameterrBr?r@Nrrrrrr's  rc@s6eZdZdZd6ddZd6ddZddZed d Zd d Z ed dZ eddZ e ddZ eddZeddZeddZeddZeddZeddZedd Zed!d"Zed#d$Zed%d&Zed'd(Zed)d*Zed+d,Zd-d.Zed/d0Zejd1d0Zed2d3Zd4d5Z dS)7 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. rSshapesN) _service_descriptionrDrS ShapeResolverrGNOT_SET_signature_version _service_name_instance_cache)rservice_description service_namerrrrL4s  zServiceModel.__init__cCs|j||Sr)rGget_shape_by_namerrI member_traitsrrr shape_forSszServiceModel.shape_forcCs|j|dSr)_error_code_cacherD)rrorrrshape_for_error_codeXz!ServiceModel.shape_for_error_codecCs"i}|jD] }|j}|||<q|Sr) error_shapesro)rerror_code_cache error_shapermrrrr[s   zServiceModel._error_code_cachecCrWrrXrZrrrrYcr]zServiceModel.resolve_shape_refcCst|jdiS)NrlistrrDrrrr shape_namesfzServiceModel.shape_namescCs6g}|jD]}||}|jddr||q|S)Nr7F)rrrSrDappend)rrrIrrrrrjs   zServiceModel.error_shapescCs6z |jd|}Wn tyt|wt|||SN operations)rKeyErrorrOperationModel)roperation_namerOrrroperation_modelss   zServiceModel.operation_modelcCrpNr@rA)rrDrrrrr@{rrzServiceModel.documentationcCst|jdgSrrrrrroperation_namesrzServiceModel.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_prefixrrrrrs 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)rSrDr)r signing_namerrrrs zServiceModel.signing_namecC |dS)N apiVersionrrrrr api_version zServiceModel.api_versioncCr)NprotocolrrrrrrrzServiceModel.protocolcCr)N protocolsrrrrrrrzServiceModel.protocolscCs@|jdrtD] }||jvr|Sqtt|j|jd|jS)Nr)botocore_supported_protocolsservice_supported_protocolsservice)rSrDr rrrr)rrrrrresolved_protocols  zServiceModel.resolved_protocolcCr)NendpointPrefixrrrrrrrzServiceModel.endpoint_prefixcCs(|jD]}||}|jr|SqdSr)rris_endpoint_discovery_operationr operationrOrrrendpoint_discovery_operations  z)ServiceModel.endpoint_discovery_operationcCs6|jD]}||}|jdur|jdrdSqdS)Nr/TF)rrendpoint_discoveryrDrrrrendpoint_discovery_requireds   z(ServiceModel.endpoint_discovery_requiredcC |jdi}dd|DS)Nr=cSs&g|]\}}t||d|ddqS)r?r@)rBr?r@)r).0 param_name param_valrrr sz:ServiceModel.client_context_parameters..)rrDrirparamsrrrclient_context_parameterssz&ServiceModel.client_context_parameterscCs0z|j|WStytd|d|w)N"z," not defined in the metadata of the model: )rSrrrrBrrrrs  z#ServiceModel._get_metadata_propertycCs"|jtur|jd}||_|jS)NsignatureVersion)rrrSrD)rsignature_versionrrrrs  zServiceModel.signature_versioncCs ||_dSr)r)rr|rrrrrcCs d|jvS)NawsQueryCompatiblerSrrrris_query_compatiblerz ServiceModel.is_query_compatiblecC|jjd|jdS)Nr_))rarrrrrrrbzServiceModel.__repr__r)!rrrrdrLrrr rrYrrr rr@rrrrrrrrrrrrrrfrsetterrrbrrrrr-s`                        rc@seZdZdFddZeddZeddZedd 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/Zed0d1Zed2d3Zd4d5Zd6d7Zd8d9Z ed:d;Z!edd?Z#d@dAZ$dBdCZ%dDdEZ&dS)GrNcCs8||_||_||_|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. rBhttpN)_operation_model_service_model _api_namerD _wire_namerSr)rr service_modelrBrrrrLs  zOperationModel.__init__cCs|jdur|jS|jSr)r wire_namerrrrrB+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``. rBrrDrrrrr2s zOperationModel.wire_namecCs|jSr)rrrrrr@szOperationModel.service_modelcCrprrrrrrr@DrrzOperationModel.documentationcCrp)N deprecatedFrrrrrrHrrzOperationModel.deprecatedcCs|jddS)NendpointdiscoveryrrrrrrLsz!OperationModel.endpoint_discoverycCrp)NendpointoperationFrrrrrrRrrz.OperationModel.is_endpoint_discovery_operationcC d|jvrdS|j|jdS)NinputrrrYrrrr input_shapeVs zOperationModel.input_shapecCr)Noutputrrrrr output_shape`s zOperationModel.output_shapecCs"|j}|sgSdd|jDS)NcSs(g|]\}}d|jvr|jdr|qS)r5rrrBshaperrrrqsz5OperationModel.idempotent_members..rrhri)rrrrridempotent_membersks z!OperationModel.idempotent_memberscCr)NstaticContextParamscSs"g|] \}}t||ddqS)r|)rBr|)r~rD)rrBpropsrrrr{sz.)rrDrirrrrstatic_context_parametersxsz(OperationModel.static_context_parameterscCs |jsgSdd|jjDS)NcSs>g|]\}}d|jvrd|jdvrt|jdd|dqS)r<rB)rBrk)rSrrrrrrs  z5OperationModel.context_parameters..rrrrrcontext_parameterss  z!OperationModel.context_parameterscCrT)NoperationContextParamsrrrrroperation_context_parametersrrz+OperationModel.operation_context_parameterscCr)Nrequestcompressionrrrrrrequest_compression z"OperationModel.request_compressioncCr)NauthrrrrrrrzOperationModel.authcCr)Nauthtyperrrrr auth_typerzOperationModel.auth_typecCs|jrt|jS|jSr)rrrrrrrresolved_auth_types z!OperationModel.resolved_auth_typecCr)NunsignedPayloadrrrrrunsigned_payloadrzOperationModel.unsigned_payloadcs$jdg}tfdd|DS)Nerrorsc3s|] }j|VqdSr)rrY)rsrrr sz.OperationModel.error_shapes..)rrDr)rrrrrrszOperationModel.error_shapescCr)NendpointrrrrrrrzOperationModel.endpointcCrp)NhttpChecksumRequiredFrrrrrhttp_checksum_requiredrrz%OperationModel.http_checksum_requiredcCs|jdiS)N httpChecksumrrrrr http_checksumrrzOperationModel.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)rcrh)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)r rrrrrrr]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)rPrDrhrC)rrr# payload_shaperrrr s   z"OperationModel._get_streaming_bodycCr)Nz(name=rr`rrrrrbrzOperationModel.__repr__r)'rrrrLr rBrfrrr@rrrrrrrrrrrrrrrrrrrrrrrrr rrr rbrrrrrsz %                           rc@s8eZdZdZeeeedZddZ d ddZ dd Z dS) rzResolves shape references.) structurermapstringcCs||_i|_dSr) _shape_map _shape_cache)r shape_maprrrrLs zShapeResolver.__init__NcCsz|j|}Wn tyt|wz |j|dt}Wnty,td|w|r8|}||||||}|S)Nr?z&Shape is missing required key 'type': ) rrr SHAPE_CLASSESrDrrcopyupdate)rrIrrJ shape_clsresultrrrrs"    zShapeResolver.get_shape_by_namecCsbt|dkrd|vr||dS|}z|d}Wnty*td|w|||S)Nrz(Invalid model, missing shape reference: )lenrrrNrr)rr[rrIrrrrYs  zShapeResolver.resolve_shape_refr) rrrrdrgrurzr}rrLrrYrrrrrs  rc@s"eZdZdZdddZddZdS)rFzEA 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 'rrrZrrrrY,rz&UnresolvableShapeMap.resolve_shape_refr)rrrrdrrYrrrrrF$s  rFc@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. ) rintegerbooleanr float timestamplongdoublecharNcCs.t|_t|_|dur|jd|_dSdS)Nr )rrhShapeNameGenerator_name_generatornew_shape_namerBrrrrrLds z%DenormalizedStructureBuilder.__init__cCs ||_|S)zp :type members: dict :param members: The denormalized members. :return: self )_members)rrhrrr with_membersjs 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?rh)r)rIrJrK)rr* _build_modelrBrrg)rr denormalizedresolverrrr build_modelvs z(DenormalizedStructureBuilder.build_modelcCs|ddkr|||||<dS|ddkr |||||<dS|ddkr0|||||<dS|d|jvr@||||<dStd|d)Nr?r rrzUnknown shape type: )_build_structure _build_list _build_map SCALAR_TYPES _build_scalarr)rrOrrIrrrr,s   z)DenormalizedStructureBuilder._build_modelcCs\t}||}||d<|dtD]\}}||}d|i||<||||q|S)Nrhr)r_build_initial_shaperDri_get_shape_namer,)rrOrrhrrB member_modelmember_shape_namerrrr0s   z-DenormalizedStructureBuilder._build_structurecCs6||}||}d|i|d<||d|||S)Nrrlr6r5r,)rrOrr8rrrrr1s   z(DenormalizedStructureBuilder._build_listcCsf||d}||d}||}d|i|d<d|i|d<||d||||d|||S)Nr{r|rr9)rrOrkey_shape_namevalue_shape_namerrrrr2s   z'DenormalizedStructureBuilder._build_mapcCsDd|di}d|vr|d|d<tjD] }||vr||||<q|S)Nr?r@)rrR)rrOrrQrrrr5s   z1DenormalizedStructureBuilder._build_initial_shapecCs ||Sr)r5rrOrrrr4s z*DenormalizedStructureBuilder._build_scalarcCs d|vr|dS|j|dS)NrIr?)r(r)r<rrrr6sz,DenormalizedStructureBuilder._get_shape_namer)rrrrdr3rLr+r/r,r0r1r2r5r4r6rrrrr3s$      rc@s eZdZdZddZddZdS)r'zGenerate 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_cacherrrrrLrzShapeNameGenerator.__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 rType)r> capitalize)rrC current_indexrrrr)s z!ShapeNameGenerator.new_shape_nameN)rrrrdrLr)rrrrr's r'N))rd collectionsrtypingr botocore.authrbotocore.compatrbotocore.exceptionsrrrbotocore.utilsr r r r objectr Exceptionrrrrrrrrgrurzr}r~rrrrrrFrr'rrrrs>    &* Yj6