+ Ii[~cs Rt^RIHt^RIHtHt^RIHt^RIH t ^RI H t H t H t ^RIHtHtHtHt]!4t!RR]4t!R R ]4t!R R ]4t!R R]4t!RR]4t!RR4t!RR]4t!RR]4t!RR]4t!RR]4t !RR]4t!!RR]4t"!RR ]4t#!R!R"4t$!R#R$4t%!R%R&4t&!R'R(4t'!R)R*4t(!R+R,4t)R-#).z-Abstractions to interact with service models.) defaultdict) NamedTupleUnion)resolve_auth_type) OrderedDict)MissingServiceIdErrorUndefinedModelAttributeError UnsupportedServiceProtocolsError)$PRIORITY_ORDERED_SUPPORTED_PROTOCOLSCachedPropertyhyphenize_service_idinstance_cachecs]tRt^#tRtR#)NoShapeFoundErrorN__name__ __module__ __qualname____firstlineno____static_attributes__r 3/usr/lib/python3.14/site-packages/botocore/model.pyr r #rr cs]tRt^'tRtR#)InvalidShapeErrorr Nrr rrrr'rrrcs]tRt^+tRtR#)OperationNotFoundErrorr Nrr rrrr+rrrcs]tRt^/tRtR#)InvalidShapeReferenceErrorr Nrr rrrr/rrrcs&a]tRt^3toRtRtVtR#) ServiceIdcs\V4#N)r self&r hyphenizeZServiceId.hyphenize4s #D))rr N)rrrrrr__classdictcell__ __classdict__@rrr3s**rrcsa]tRt^8toRt.R Ot.R Ot]tR Rlt ] R4t ] R4t ] R4t RtRt]R 4tR tVtR#)Shapez3Object representing a shape from the service model.Nc sWnVR,VnVPRR4VnW nVf \ 4pW0n/VnR#)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_resolver&&&&r__init__ZShape.__init__fsK( $V,(___bA'  ! 23N- rc sVPp/pVPFpW0P9gKW,W#&K! RV9dVPR4VR&V#)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. locationNamer()r+SERIALIZED_ATTRSpop)rmodel serializationattr& rr8ZShape.serializations_.!! ))D(((&+k #* ] *$1$5$5n$EM& !rc sVPp/pVPFpW0P9gKW,W#&K! V#)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. )r+METADATA_ATTRS)rr7metadatar9r:rr<ZShape.metadatas@.!!''D(((!&(rc s:VPPR.4#)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. requiredr<r*rrrrequired_membersZShape.required_memberss}}  R00rc8VPPV4#rr-resolve_shape_refr shape_ref&&r_resolve_shape_refZShape._resolve_shape_ref##55i@@rcsPRVPP RVP R2#)Z<(z)> __class__rr(rrr__repr__ZShape.__repr__s&4>>**+1TYYKr::rcsR#rr rrrevent_stream_nameZShape.event_stream_namesr)r.r+r-r&r(r))r4Z queryNameZ flattenedZlocationpayloadZ streamingtimestampFormatZ xmlNamespaceZ resultWrapperZ xmlAttribute eventstreamZeventZ eventheaderZ eventpayloadZ jsonvaluerNZ hostLabel)r=ZminZmaxZpatternZ sensitiveenumidempotencyTokenerror exceptionZendpointdiscoveryidZ retryabledocumentunion contextParamclientContextParamsZrequiresLengthr)rrrr__doc__r5r;rMAP_TYPEr3r r8r<r?rFrKpropertyrLrr r!r#rr$r$8s= &N$H D@:11A;rr$cspa]tRt^to]R4t]R4t]R4t]R4t]R4t Rt Vt R#)StructureShapecsVPPRVP44pVP4pVP4Fwr4VP V4W#&K V#)members)r+r*rYitemsrF)rr\Z shape_membersr(rDs& rr\ZStructureShape.memberssX##'' 4==?C  &}}OD"&"9"9)"DM  /rcsVPP4F*wrVPPR4'gK(Vu# R#)rON)r\r]r8r*)r member_namemember& rrLZ StructureShape.event_stream_names>#'<<#5#5#7 K##'' 66""$8rcsVPPRR4'gR#VPPR/4pVPR4pV'dV#VP#)rSFNrRcode)r<r*r()rZerror_metadatarar`r error_codeZStructureShape.error_codesT}}  e44**7B7!!&) Kyyrc:VPPRR4#)rTFr>rrris_document_typeZStructureShape.is_document_types}}  U33rcrc)rUFr>rrris_tagged_unionZStructureShape.is_tagged_unions}}  %00rr N) rrrrr r\rLrbrdrerr r!r#rr[r[sg   4411rr[c0a]tRtRto]R4tRtVtR#) ListShapeicFVPVPR,4#)r_rFr+rrrr_ZListShape.members&&t'8'8'BCCrr N)rrrrr r_rr r!r#rrgrgsDDrrgcs@a]tRtRto]R4t]R4tRtVtR#)MapShapei crh)keyrirrrrkZ MapShape.keys&&t'8'8'?@@rcrh)valuerirrrrlZMapShape.values&&t'8'8'ABBrr N) rrrrr rkrlrr r!r#rrjrj s/AACCrrjcrf) StringShapeic:VPPR.4#)rPr>rrrrPZStringShape.enums}}  ,,rr N)rrrrr rPrr r!r#rrmrms--rrmc,a]tRtRtoV3RltRtVtR#)StaticContextParametericsH<V^8dQh/S[;R&S[S[S[3,;R&#)r(rl)strrZboolZformatr""r __annotate__Z#StaticContextParameter.__annotate__s# I s rr NrrrrZ__annotate_func__rr r!r#rrprprrpcro)ContextParameteri"cs2<V^8dQh/S[;R&S[;R&#)rqr(r^rrrsrtrruZContextParameter.__annotate__"s Irr Nrvr!r#rrxrx"rwrrxcro)ClientContextParameteri'cs><V^8dQh/S[;R&S[;R&S[;R&#)rqr(r%r&ryrsrtrruZ#ClientContextParameter.__annotate__'s& I Irr Nrvr!r#rrzrz'rwrrzcsa]tRtRtoRtRRltRRltRt]R4t Rt ]R 4t ]R 4t ] R 4t]R 4t]R 4t]R4t]R4t]R4t]R4t]R4t]R4t]R4t]R4t]R4t]R4t]R4tRt]R4t]P>R4t]R4t Rt!Rt"Vt#R#) ServiceModeli-zI :ivar service_description: The parsed service description dictionary. Nc sWnVPR/4Vn\VPR/44Vn\ VnW n/VnR#)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_descriptionr*r< ShapeResolverr-NOT_SET_signature_version _service_name_instance_cache)rZservice_description service_name&&&rr3ZServiceModel.__init__4sS*%8!+// B? ,  # #Hb 1 #*)!rcs8VPPW4#r)r-get_shape_by_namerr/ member_traitsrr shape_forZServiceModel.shape_forSs##55   rcs:VPPVR4#r)_error_code_cacher*)rrbrErshape_for_error_codeZ!ServiceModel.shape_for_error_codeXs%%))*d;;rcsP/pVPFpVPpW!V&K V#r) error_shapesrb)rZerror_code_cache error_shaperar:rrZServiceModel._error_code_cache[s3,,K))D%0T "- rcr@rrArCrErrBZServiceModel.resolve_shape_refcrGrcsL\VPPR/44#)r|listr}r*rrr shape_namesZServiceModel.shape_namesfs D--11(B?@@rcs.pVPFIpVPV4pVPPRR4'gK8VP V4KK V#)rSF)rrr<r*Zappend)rrr/rr:rrZServiceModel.error_shapesjsT **J..4K##'' U;;##K0+rcsVPR,V,p\Y T4# \d \T4hi;iZ operations)r}KeyErrorrOperationModel)rZoperation_namer7&& roperation_modelZServiceModel.operation_modelssG 9--l;NKEe>:: 9(8 8 9s(?crcr&r')r}r*rrrr&ZServiceModel.documentation{s((,,_bAArcsL\VPPR.44#rrrrroperation_namesZServiceModel.operation_namess D--11,CDDrc NVPe VP#VP#)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_prefixrrrrZServiceModel.service_names(    )%% %'' 'rcs\VPR44# \d\TPR7hi;i)Z serviceId)r)r_get_metadata_propertyrrrrrr service_idZServiceModel.service_ids@ IT88EF F+ I'T5G5GH H Is">c s\VPPR4pVf VPpV#)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. Z signingName)r<r*r)r signing_name& rrZServiceModel.signing_names/}}((7  //Lrc$VPR4#)Z apiVersionrrrr api_versionZServiceModel.api_versions**<88rcr)protocolrrrrrZServiceModel.protocols**:66rcr) protocolsrrrrrZServiceModel.protocolss**;77rcsVPPR4'dH\FpWP9gKVu# \ \VPVP R7hVP #)r)Zbotocore_supported_protocolsZservice_supported_protocolsZservice)r<r*rrrrr)rrrrresolved_protocolZServiceModel.resolved_protocolsa ==  [ ) )@~~-#OA3-Q,0NN)) }}rcr)ZendpointPrefixrrrrrZServiceModel.endpoint_prefixs**+;<a@@r)rr}rr-rr<r)$rrrrrXr3rrr rrBrrr rr&rrrrrrrrrrrrrrZrZsetterrrKrr r!r#rr{r{-s "> <  AAA;;BBEE(( II   997788"==     '' ((55AArr{csa]tRtRtoR&Rlt]R4t]R4t]R4t ]R4t ]R4t ]R 4t ]R 4t ]R 4t]R 4t]R 4t]R4t]R4t]R4t]R4t]R4t]R4t]R4t]R4t]R4t]R4t]R4t]R4t]R4t]R4tRtRt Rt!]R4t"]R 4t#R!t$R"t%R#t&R$t'R%t(Vt)R#)'riNc sWnW nW0nVPR4VnVP VnVPR/4VnR#)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. r(httpN)_operation_model_service_model _api_namer* _wire_namer<r)rr service_modelr(r2rr3ZOperationModel.__init__sJ8!0+*--f5%.. #''3 rcrr)r wire_namerrrr(ZOperationModel.name+s >> %>> !>> !rc s8VPPR4#)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``. r(rr*rrrrZOperationModel.wire_name2s$$((00rcsVP#r)rrrrrZOperationModel.service_model@s"""rcrcrrrrrr&ZOperationModel.documentationDs$$(("==rcrc) deprecatedFrrrrrZOperationModel.deprecatedHs$$((u==rcrc)ZendpointdiscoveryNrrrrrZ!OperationModel.endpoint_discoveryLs$$(()>rcr)authrrrrrZOperationModel.auths$$((00rcr)Zauthtyperrrr auth_typeZOperationModel.auth_type$$((44rcshVP'd\VP4#VP#r)rrrrrrresolved_auth_typeZ!OperationModel.resolved_auth_types$ 999$TYY/ /~~rcr)ZunsignedPayloadrrrrunsigned_payloadZOperationModel.unsigned_payloads$$(():;;rcsfaSPPR.4p\V3RlV44#)Zerrorsc3sZ<"TF pSPPV4xK" R#5ir)rrB)Z.0Zsrs& rZ Z.OperationModel.error_shapes..s%MfD''99!<>>>DD EE              GG??1155 <<NN55HH==99::896677:; >>rrcsNa]tRtRtoRtR]R]R]R]/t Rt R R lt R t R t VtR#) r~izResolves shape references. structurermapstringcs Wn/VnR#r) _shape_map _shape_cache)r shape_maprErr3ZShapeResolver.__init__s#rNcsPVPV,pTPP TR,\ 4pT'd"TP4pTPT4T!YT4pT# \d \T4hi;i \d\ RT 24hi;i)r%z&Shape is missing required key 'type': ) rrr SHAPE_CLASSESr*r$rcopyZupdate)rr/rr0Z shape_clsZresult&&& rrZShapeResolver.get_shape_by_names 0//*5K **..{6/BEJI %**,K   } -:D9  0#J/ / 0 #8 F  sA1'B 1B B%cs\V4^8Xd RV9dVPVR,4#VP4pVPR4pTPY24# \d\ RT 24hi;i)irz(Invalid model, missing shape reference: )Zlenrrr6rr)rrDrr/rrrBZShapeResolver.resolve_shape_refs y>Q 7i#7)))G*<= =%NN,M *..w7 ))*D D  0>ykJ s A##A=)rrr)rrrrrXr[rgrjrmrr3rrBrr r!r#rr~r~s;$ ^  x+ M"EErr~cs4a]tRtRtoRtRRltRtRtVtR#)r,i$zEA ShapeResolver that will throw ValueErrors when shapes are resolved.Nc \RV R24h)zAttempted to lookup shape '!', but no shape map was provided.Z ValueErrorrrrrZ&UnresolvableShapeMap.get_shape_by_name's)*5V W  rcr)zAttempted to resolve shape 'rrrCrErrBZ&UnresolvableShapeMap.resolve_shape_ref,s *9+6  !  rr r) rrrrrXrrBrr r!r#rr,r,$sO   rr,csha]tRtRtoRtRtRRltRtRtRt Rt R t R t R t R tR tRtVtR#)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. Ncs\4Vn\4VnVf#VPP R4VnR#R#)Nr)rr\ShapeNameGenerator_name_generatornew_shape_namer(rrErr3Z%DenormalizedStructureBuilder.__init__ds8"} 13 <,,;;KHDI rc sWnV#)zP :type members: dict :param members: The denormalized members. :return: self )_members)rr\rEr with_membersZ)DenormalizedStructureBuilder.with_membersjs  rc s\4pRRRVP/pVPW!VP4\ VR7p\ VPWP,VR7#)zBuild the model based on the provided members. :rtype: botocore.model.StructureShape :return: The built StructureShape object. r%rr\)r)r/r0r1)rr _build_modelr(r~r[)rr|Z denormalizedZresolverr:r build_modelZ(DenormalizedStructureBuilder.build_modelvsa K t}}  , : 62yyyy)#  rcsXVR,R8XdVPW4W#&R#VR,R8XdVPW4W#&R#VR,R8XdVPW4W#&R#VR,VP9dVP V4W#&R#\ RVR, 24h)r%rrrzUnknown shape type: N)_build_structure _build_list _build_map SCALAR_TYPES _build_scalarr)rr7r|r/r2rrZ)DenormalizedStructureBuilder._build_models =K '!%!6!6u!EF  6]f $!%!1!1%!@F  6]e #!%!?F  6]d// /!%!3!3E!:F #&:5=/$JK Krcs\4pVPV4pW4R&VPR\44P4F.wrVVP V4pRV/W5&VP WbV4K0 V#)r\r)r_build_initial_shaper*r]_get_shape_namer)rr7r|r\rr(Z member_modelmember_shape_names&&& rrZ-DenormalizedStructureBuilder._build_structures{-))%0"i"'))I{}"E"K"K"M D $ 4 4\ B $&78GM   l4E F#N rcsVPV4pVPV4pRV/VR&VPVR,W#4V#)rr_rrr)rr7r|rrs&&& rrZ(DenormalizedStructureBuilder._build_listsK 007))%0"$56h %/6E rcsVPVR,4pVPVR,4pVPV4pRV/VR&RV/VR&VPVR,W#4VPVR,W$4V#)rkrlrr)rr7r|Zkey_shape_nameZvalue_shape_namerrrrZ'DenormalizedStructureBuilder._build_maps--eEl;//g?))%00e !#34g %,? %.&C rcsRVR,/pRV9d VR,VR&\PFpW19gK W,W#&K V#)r%r&)r$r;)rr7rr9rrrZ1DenormalizedStructureBuilder._build_initial_shapesP E&M  e #%*?%;E/ "((D}#k ) rcs$VPV4#r)rrr7rErrZ*DenormalizedStructureBuilder._build_scalars((//rcsfRV9d VR,#VPPVR,4#)r/r%)rrrrErrZ,DenormalizedStructureBuilder._get_shape_names0 5 & &''66uV}E Er)rrr\r() rZintegerZbooleanrZfloatZ timestampZlongZdoubleZcharr)rrrrrXrr3rrrrrrrrrrr r!r#rrr3sM"H LI  ( L  0FFrrcs0a]tRtRtoRtRtRtRtVtR#)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. cs.\\4VnR#r)rZint _name_cacherrrr3ZShapeNameGenerator.__init__s&s+rc sVPV;;,^, uu&VPV,pVP4 RV 2#)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 ZType)rZ capitalize)rr)Z current_indexrrrZ!ShapeNameGenerator.new_shape_namesE4 #q(#((3 &&()m_==r)rN) rrrrrXr3rrr r!r#rrrs,>>rrN)*rXZ collectionsrZtypingrrZ botocore.authrZbotocore.compatrZbotocore.exceptionsrrrZbotocore.utilsrr r r ZobjectrZ Exceptionr rrrrrrr$r[rgrjrmrprxrzr{rr~r,rrr rrrs!4#$+'  (     Y   ** bbJ'1U'1TDD CuC-%- Z z Z UAUApf>f>R3E3El   QFQFh'>'>r