wSrSSKJr SSKJrJr SSKJr SSKJ r J r SSK J r J r Jr \"5r"SS\5r"S S \5r"S S \5r"S S\5r"SS\5r"SS5r"SS\5r"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%g-).z-Abstractions to interact with service models.) defaultdict) NamedTupleUnion) OrderedDict)MissingServiceIdErrorUndefinedModelAttributeError)CachedPropertyhyphenize_service_idinstance_cachec\rSrSrSrg)NoShapeFoundErrorN__name__ __module__ __qualname____firstlineno____static_attributes__r!lib/third_party/botocore/model.pyr r rr c\rSrSrSrg)InvalidShapeErrorrNrrrrrrrrrc\rSrSrSrg)OperationNotFoundError#rNrrrrrr#rrrc\rSrSrSrg)InvalidShapeReferenceError'rNrrrrr r 'rrr c\rSrSrSrSrg) ServiceId+c[U5$N)r selfs r hyphenizeServiceId.hyphenize,s #D))rrN)rrrrr)rrrrr#r#+s*rr#c\rSrSrSr/SQr/SQr\rSSjr \ S5r \ S5r \ S 5r S rS r\S 5rS rg)Shape0z3Object representing a shape from the service model.) locationName queryName flattenedlocationpayload streamingtimestampFormat xmlNamespace resultWrapper xmlAttribute eventstreamevent eventheader eventpayload jsonvaluer4 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_namegetrP _shape_modelUnresolvableShapeMap_shape_resolver_cache)r( shape_name shape_modelshape_resolvers r__init__Shape.__init__^sK( $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. r.rR)rUSERIALIZED_ATTRSpop)r(model serializationattrs rrbShape.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. )rUMETADATA_ATTRS)r(rametadatarcs rrgShape.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>rgrTr's rrequired_membersShape.required_memberss}}  R00rc8URRU5$r&rWresolve_shape_refr( shape_refs r_resolve_shape_refShape._resolve_shape_ref##55i@@rcPSURRSURS3$)N<(z)> __class__rrRr's r__repr__Shape.__repr__s&4>>**+1TYYKr::rcgr&rr's revent_stream_nameShape.event_stream_namesr)rXrUrWrPrRrSr&)rrrr__doc__r_rfrMAP_TYPEr\r rbrgrkrrrzpropertyr}rrrrr,r,0s}= &N$H D@:11A;rr,cd\rSrSr\S5r\S5r\S5r\S5r\S5r Sr g) StructureShapecURRSUR55nUR5nUR5Hup4UR U5X#'M U$)Nmembers)rUrTritemsrr)r(r shape_membersrRrqs rrStructureShape.memberssX##'' 4==?C  &}}OD"&"9"9)"DM  /rcURR5H)upURRS5(dM'Us $ g)Nr8)rrrbrT)r( member_namemembers rr} StructureShape.event_stream_names>#'<<#5#5#7 K##'' 66""$8rcURRSS5(dgURRS05nURS5nU(aU$UR$)NrFFrEcode)rgrTrR)r(error_metadatars r error_codeStructureShape.error_codesT}}  e44**7B7!!&) Kyyrc:URRSS5$)NrIFrjr's ris_document_typeStructureShape.is_document_types}}  U33rc:URRSS5$)NrJFrjr's ris_tagged_unionStructureShape.is_tagged_unions}}  %00rrN) rrrrr rr}rrrrrrrrrsd   4411rrc$\rSrSr\S5rSrg) ListShapec>URURS5$)NrrrrUr's rrListShape.members&&t'8'8'BCCrrN)rrrrr rrrrrrrsDDrrc4\rSrSr\S5r\S5rSrg)MapShapeic>URURS5$)Nkeyrr's rr MapShape.keys&&t'8'8'?@@rc>URURS5$)Nvaluerr's rrMapShape.value s&&t'8'8'ABBrrN)rrrrr rrrrrrrrs,AACCrrc$\rSrSr\S5rSrg) StringShapeic:URRS/5$)NrCrjr's rrCStringShape.enums}}  ,,rrN)rrrrr rCrrrrrrs--rrc4\rSrSr%\\S'\\\4\S'Srg)StaticContextParameterirRrrN) rrrrstr__annotations__rboolrrrrrrs I s rrc*\rSrSr%\\S'\\S'Srg)ContextParameterirRrrNrrrrrrrrrrrrs Irrc4\rSrSr%\\S'\\S'\\S'Srg)ClientContextParameterirRrOrPrNrrrrrrs I Irrch\rSrSrSrSSjrSSjrSr\S5r Sr \S 5r \S 5r \ S 5r\S 5r\S 5r\S5r\S5r\S5r\S5r\S5r\S5r\S5r\S5r\S5rSr\S5r\R:S5rSrSrg) 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. rgshapesN) _service_descriptionrTrg ShapeResolverrWNOT_SET_signature_version _service_name_instance_cache)r(service_description service_names rr\ServiceModel.__init__,sS*%8!+// B? ,  # #Hb 1 #*)!rc8URRX5$r&)rWget_shape_by_namer(rY member_traitss r shape_forServiceModel.shape_forKs##55   rc:URRUS5$r&)_error_code_cacherT)r(rs rshape_for_error_code!ServiceModel.shape_for_error_codePs%%))*d;;rcP0nURHnURnX!U'M U$r&) error_shapesr)r(error_code_cache error_shapers rrServiceModel._error_code_cacheSs3,,K))D%0T "- rc8URRU5$r&rnrps rroServiceModel.resolve_shape_ref[rtrcL[URRS055$)NrlistrrTr's r shape_namesServiceModel.shape_names^s D--11(B?@@rc/nURHHnURU5nURRSS5(dM7UR U5 MJ U$)NrFF)rrrgrTappend)r(rrYrs rrServiceModel.error_shapesbsT **J..4K##'' U;;##K0+rcrURSUn[X U5$![a [U5ef=fN operations)rKeyErrorrOperationModel)r(operation_nameras roperation_modelServiceModel.operation_modelksG 9--l;NKEe>:: 9(8 8 9s 6c:URRSS5$NrPrQ)rrTr's rrPServiceModel.documentationss((,,_bAArcL[URRS/55$rrr's roperation_namesServiceModel.operation_namesws 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_name{s(    )%% %'' '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)rgrTr)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$)NendpointPrefixrr's rrServiceModel.endpoint_prefixs**+;<TF)rrendpoint_discoveryrTrs rendpoint_discovery_required(ServiceModel.endpoint_discovery_requiredsM--I((3E((4,,00<< .rc URRS05nUR5VVs/sHup#[UUSUSS9PM snn$s snnf)NrLrOrP)rRrOrP)rrTrr)r(params param_name param_vals rclient_context_parameters&ServiceModel.client_context_parameterssg**../DbI*0  *8% #v&'8  *8    sAc`URU$![a [SUSU35ef=f)N"z," not defined in the metadata of the model: )rgrrr(rRs rr#ServiceModel._get_metadata_propertysC ==& & .D6EdVL  s-cUR[La!URRS5nXlUR$)NsignatureVersion)rrrgrT)r(signature_versions rrServiceModel.signature_versions8  " "g - $ 1 12D E &7 #&&&rcXlgr&)r)r(rs rrrs"'rcNURRSURS3$)Nrw))ryrrr's rrzServiceModel.__repr__s'..))*!D,=,=+>a@@r)rrrrWrrgr&) rrrrrr\rrr rrorrr rrPrrrrrrrrrrrrrsetterrzrrrrrr%s "> <  AAA;;BBEE(( II   9977==     '' ((Arrc\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\S5rSrSrSr\S5r\S5rSr Sr!Sr"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. rRhttpN)_operation_model_service_model _api_namerT _wire_namergr)r(r service_modelrRs rr\OperationModel.__init__sJ8!0+*--f5%.. #''3 rcLURb UR$UR$r&)r" wire_namer's rrROperationModel.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``. rRr rTr's rr'OperationModel.wire_names$$((00rcUR$r&)r!r's rr$OperationModel.service_models"""rc:URRSS5$rr*r's rrPOperationModel.documentation"s$$(("==rc:URRSS5$)N deprecatedFr*r's rr1OperationModel.deprecated&s$$((u==rc:URRSS5$)Nendpointdiscoveryr*r's rr!OperationModel.endpoint_discovery*s$$(()s< 400 0""44  ! !( +  rcURnU(d/$URR5VVs/sH/up#SUR;dMURS(dM-UPM1 snn$s snnf)NrD)r<rrrg)r(r<rRshapes ridempotent_members!OperationModel.idempotent_membersIsm&& I"-!4!4!:!:!< !< !U^^3 12 !<   sA- A-#A-c URRS05nUR5VVs/sHup#[X#RS5S9PM snn$s snnf)NstaticContextParamsr)rRr)r rTrr)r(r rRpropss rstatic_context_parameters(OperationModel.static_context_parametersVsX&&**+@"E &||~ -  #IIg4F G-   s$Ac $UR(d/$URRR5VVs/sHFupSUR;dMSURS;dM,[ URSSUS9PMH snn$s snnf)NrKrR)rRr)r<rrrgr)r(rRrCs rcontext_parameters!OperationModel.context_parameters^sI $//77==?  @ /   %..88   ^^N3F;   @    sB B *B c8URRS5$)Nrequestcompressionr*r's rrequest_compression"OperationModel.request_compressionms$$(()=>>rc8URRS5$)Nauthtyper*r's r auth_typeOperationModel.auth_typeq$$((44rcf^TRRS/5n[U4SjU55$)Nerrorsc3Z># UH nTRRU5v M" g7fr&)r!ro).0sr(s r .OperationModel.error_shapes..xs%MfD''99!<>>>DD EE              ??55NN55HH==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)NrOz&Shape is missing required key 'type': ) rrr SHAPE_CLASSESrTr,rcopyupdate)r(rYrrZ 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)NrCz(Invalid model, missing shape reference: )lenrrr`rr )r(rqrrYs rroShapeResolver.resolve_shape_refs y>Q 7i#7)))G*<= =%NN,M *..w7 ))*D D  0>ykJ s AA6)rrr&)rrrrrrrrrrr\rrorrrrrrs*$$ M"Errc(\rSrSrSrSSjrSrSrg)rVizEA 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_names)*5V W  rc [SUS35e)NzAttempted to resolve shape 'rrrps rro&UnresolvableShapeMap.resolve_shape_refs *9+6  !  rrr&)rrrrrrrorrrrrVrVsO  rrVc\\rSrSrSrSrSSjrSrSrSr S r S r S r S r S rSrSrg)DenormalizedStructureBuilderiaZBuild 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_namerRrs rr\%DenormalizedStructureBuilder.__init__0s8"} 13 <,,;;KHDI rcXlU$)zP :type members: dict :param members: The denormalized members. :return: self )_members)r(rs r with_members)DenormalizedStructureBuilder.with_members6s  rc[5nSURS.nURX!UR5 [ US9n[ URXRUS9$)zBuild the model based on the provided members. :rtype: botocore.model.StructureShape :return: The built StructureShape object. r)rOr)r)rYrZr[)rr _build_modelrRrr)r(r denormalizedresolvers r build_model(DenormalizedStructureBuilder.build_modelBs]}}  , : 62yyyy)#  rc USS:XaURX5X#'gUSS:XaURX5X#'gUSS:XaURX5X#'gUSUR;aUR U5X#'g[ SUS35e)NrOrrrzUnknown shape type: )_build_structure _build_list _build_map SCALAR_TYPES _build_scalarr)r(rarrYs rr)DenormalizedStructureBuilder._build_modelVs =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$)NrrC)r_build_initial_shaperTr_get_shape_namer)r(rarrrCrR member_modelmember_shape_names rr-DenormalizedStructureBuilder._build_structurebs{-))%0"i"'))I{}"E"K"K"M D $ 4 4\ B $&78GM   l4E F#N rcURU5nURU5nSU0US'URUSX#5 U$)NrCrrrr)r(rarrrCs rr(DenormalizedStructureBuilder._build_listmsK 007))%0"$56h %/6E rcURUS5nURUS5nURU5nSU0US'SU0US'URUSX#5 URUSX$5 U$)NrrrCr)r(rarkey_shape_namevalue_shape_namerCs rr'DenormalizedStructureBuilder._build_mapts--eEl;//g?))%00e !#34g %,? %.&C rcxSUS0nSU;aUSUS'[RHnX1;dM XX#'M U$)NrOrP)r,rf)r(rarCrcs rr1DenormalizedStructureBuilder._build_initial_shape~sP E&M  e #%*?%;E/ "((D}#k ) rc$URU5$r&)rr(ras rr*DenormalizedStructureBuilder._build_scalars((//rcTSU;aUS$URRUS5$)NrYrO)rrrs rr,DenormalizedStructureBuilder._get_shape_names0 5 & &''66uV}E Er)rrrrRr&)rrrrrrr\rrrrrrrrrrrrrrrsD"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(rS current_indexs rr!ShapeNameGenerator.new_shape_namesE4 #q(#((3 &&()m_==r)rN)rrrrrr\rrrrrrrs,>rrN)&r collectionsrtypingrrbotocore.compatrbotocore.exceptionsrrbotocore.utilsr r r objectr Exceptionr rrr rr#r,rrrrrrrrrrrVrrrrrrs4#$'PO (     Y   ** bbJ'1U'1TDD CuC-%- Z z Z {A{A|T>T>n3E3El   QFQFh'>'>r