ڰjXSSKrSSKJr SSKJr SSKJr SSKJrJ r SSK J r J r SS K Jr SS KJr SS KJrJr \R("\5r"S S 5rg)N)partial) docstring)ResourceLoadException) ServiceAction WaiterAction) ResourceMetaServiceResource)CollectionFactory) ResourceModel)ResourceHandlerbuild_identifiersc\rSrSrSrSrSrSrSrSr Sr S r S r S r S rS rSrSrSrSrSrSSjrSrg)ResourceFactorya? A factory to create new :py:class:`~boto3.resources.base.ServiceResource` classes from a :py:class:`~boto3.resources.model.ResourceModel`. There are two types of lookups that can be done: one on the service itself (e.g. an SQS resource) and another on models contained within the service (e.g. an SQS Queue resource). c.[5UlXlgN)r _collection_factory_emitter)selfemitters T/home/mande/repo/quber/.venv/lib/python3.13/site-packages/boto3/resources/factory.py__init__ResourceFactory.__init__%s#4#6  c[RSURU5 [UUUR5nSnUR (a%UR RUR 5nURU5 [URUS9nSU0nURUUUUS9 URUUUUS9 URUUUUUS9 URUUUS9 URUUUUS9 URUUUUS9 UnURU:XaS nURS U3n[ /n UR"bUR"R%S U3UU US 9 ['[)U5[+U 5U5$) a Loads a resource from a model, creating a new :py:class:`~boto3.resources.base.ServiceResource` subclass with the correct properties and methods, named based on the service and resource name, e.g. EC2.Instance. :type resource_name: string :param resource_name: Name of the resource to look up. For services, this should match the ``service_name``. :type single_resource_json_definition: dict :param single_resource_json_definition: The loaded json of a single service resource or resource definition. :type service_context: :py:class:`~boto3.utils.ServiceContext` :param service_context: Context about the AWS service :rtype: Subclass of :py:class:`~boto3.resources.base.ServiceResource` :return: The service or resource class. z Loading %s:%sN)resource_modelmeta)attrsr resource_namer)r r!rservice_context)r rr!rr")r rr"r .zcreating-resource-class.)class_attributes base_classesr")loggerdebug service_namer resource_json_definitionsshape service_model shape_forload_rename_mapr _load_identifiers _load_actions_load_attributes_load_collections_load_has_relations _load_waitersr remittypestrtuple) rr!single_resource_json_definitionr"rr*rr cls_namer%s rload_from_definition$ResourceFactory.load_from_definition)s0  _99= '  +  5 5    #11;;$$E &&u-  ( (  D  ')   ')+   ')+   )+     ')+ !  ')+  !  ' '= 8(H%2231XJ?'( == $ MM  *8*5!&) /   CM5#6>>rcURHEnURRUR5 URXT5XR'MG g)z Populate required identifiers. These are arguments without which the resource cannot be used. Identifiers become arguments for operations on the resource. N) identifiersappendname_create_identifier)rr rrr! identifiers rr.!ResourceFactory._load_identifierssF )44J    # #JOO 4%)%<%<&E// "5rcUR(a'URURUUSS9US'USUS'URH nURUUUS9XR'M" g)z Actions on the resource become methods, with the ``load`` method being a special case which sets internal data for attributes, and ``reload`` is an alias for ``load``. T) action_modelr!r"is_loadloadreload)rDr!r"N)rF_create_actionactionsr?)rr r!rr"actions rr/ResourceFactory._load_actionss|    //+00+ / 0E&M $FmE(O$,,F!%!4!4#+ /"5"E++ -rc UR(dgURRUR5nURVs0sH#nUR(dMURU_M% nnUR U5n U R 5H9un upX;aURUXU US9n OURUU U U US9n XU 'M; gs snf)z Load resource attributes based on the resource shape. The shape name is referenced in the resource JSON, but the shape itself is defined in the Botocore service JSON, hence the need for access to the ``service_model``. N)r!rA member_modelr")r!r? snake_casedrMr") r*r+r,r= member_nameget_attributesitems_create_identifier_alias_create_autoload_property)rr rr!rr"r*ir= attributesr? orig_namememberprops rr0 ResourceFactory._load_attributess## --778L8LM$// /}} AMM1 /  $2259 )3)9)9); %D%9"44"/*0!'$3 555"/" $!'$3 6$K!*<  s CCcxURH*nURURUUS9XR'M, g)z Load resource collections from the model. Each collection becomes a :py:class:`~boto3.resources.collection.CollectionManager` instance on the resource instance, which allows you to iterate and filter through the collection's items. )r!collection_modelr"N) collections_create_collectionr?)rr rr"r[s rr1!ResourceFactory._load_collectionssC!/ : : +/+B+B,11!1 /,C,E'' (!;rcURH nURUUUS9XR'M" URH nUR UUUS9XR'M" UR XR5 g)a Load related resources, which are defined via a ``has`` relationship but conceptually come in two forms: 1. A reference, which is a related resource instance and can be ``None``, such as an EC2 instance's ``vpc``. 2. A subresource, which is a resource constructor that will always return a resource instance which shares identifiers/data with this resource, such as ``s3.Bucket('name').Object('key')``. )reference_modelr!r")subresource_modelr!r"N) references_create_referencer? subresources_create_class_partial&_create_available_subresources_command)rr r!rr" reference subresources rr2#ResourceFactory._load_has_relationss(22I%)$:$: )+ /%;%E.. ! 3*66K'+&@&@"-+ /'A'E"" #7 33 .. rcr^UVs/sHo3RPM snm[T5mU4SjnXAS'gs snf)Nc>T$)z Returns a list of all the available sub-resources for this Resource. :returns: A list containing the name of each sub-resource for this resource :rtype: list of str ) factory_self _subresourcess rget_available_subresourcesZResourceFactory._create_available_subresources_command..get_available_subresources s ! rro)r?sorted)rr rdrhrorns @rrf6ResourceFactory._create_available_subresources_commands<=IJ\k))\J }-  !/I*+Ks4cdURH nURUUUS9XR'M" g)z Load resource waiters from the model. Each waiter allows you to wait until a resource reaches a specific state by polling the state of the resource. )resource_waiter_modelr!r"N)waiters_create_waiterr?)rr r!rr"waiters rr3ResourceFactory._load_waiters-s9%,,F!%!4!4&,+ /"5"E++ -rc^U4Sjn[TR5Ul[R"UTSS9Ul[ U5$)z9 Creates a read-only property for identifier attributes. c8>[USTR3S5$N_getattrr?rrAs rget_identifier:ResourceFactory._create_identifier..get_identifierAs 41Z__$5!6= =rF)r!identifier_modelinclude_signature)r6r?__name__rIdentifierDocstring__doc__property)rmrAr!rs ` rr@"ResourceFactory._create_identifier<sD  >#&joo"6!*!>!>''#"  ''rc ^U4Sjn[TR5Ul[R"UR UTRUR USS9Ul[U5$)z: Creates a read-only property that aliases an identifier. c8>[USTR3S5$r{r}rs rr@ResourceFactory._create_identifier_alias..get_identifierZs41Z__$5!6= =rFr(r! attr_name event_emitter attr_modelr) r6rOrrAttributeDocstringr(rrr)rmr!rArMr"rs ` rrR(ResourceFactory._create_identifier_aliasSsa >#&j&<&<"=!*!=!=(55' ,,&//## " ''rc ^U4Sjn[U5Ul[R"URUUUR USS9Ul[U5$)zr Creates a new property on the resource to lazy-load its value via the resource's ``load`` method (if it exists). c>URRcD[US5(aUR5 O"[ UR R S35eURRRT5$)NrFz has no load method)rdatahasattrrFr __class__rget)rr?s rproperty_loaderBResourceFactory._create_autoload_property..property_loaderzseyy~~%4((IIK/>>2233FG99>>%%d+ +rFr)r6rrrr(rrr)rmr!r?rNrMr"rs ` rrS)ResourceFactory._create_autoload_propertyisU" ,$'{#3 "+">">(55'!&//## # ((rc ^[UURS9mU4Sjn[UR5Ul[R "UUR URUURSS9Ul U$)z` Creates a new wait method for each resource where both a waiter and resource model is defined. )waiter_resource_namec>T"U/UQ70UD6 grrl)rargskwargsrws r do_waiter1ResourceFactory._create_waiter..do_waiters 4 )$ )& )rF)r!rr+rtservice_waiter_modelr) r r?r6rrResourceWaiterDocstringrr+rr)rmrtr!r"rrws @rrvResourceFactory._create_waitersu !!6!;!;   *!!6!;!;< %=='&//)77"7!0!E!E#  rc^^^^TRRUTTTRS9mUUUU4Sjn[TR5Ul[ R"TSS9Ul[U5$)zC Creates a new property on the resource to lazy-load a collection. )r!r[r"rc>T"TUTTS9$)N)r[parentfactoryr"rl)rclsr[rmr"s rget_collection:ResourceFactory._create_collection..get_collections!1$ /  rF)r[r) rr:rr6r?rrCollectionDocstringrr)rmr!r[r"rrs` `` @rr]"ResourceFactory._create_collectionsx ..CC'-+&// D   #&&6&;&;"<!*!>!>-" ''rc2^^[URRUURUS9m[SURR55mUU4Sjn[ UR 5Ul[R"USS9Ul [U5$)zB Creates a new property on the resource to lazy-load a reference. ) search_pathrrr"c3># UHoRS:Hv M g7f)rN)source).0rTs r 4ResourceFactory._create_reference..s (L1HH (Lsc>T(a8URRc![US5(aUR5 T"U0URR5$NrF)rrrrF)rhandler needs_datas r get_reference8ResourceFactory._create_reference..get_referencesAdiinn4v9N9N 4TYY^^4 4rF)r`r) rresourcepathanyr=r6r?rrReferenceDocstringrr)rmr`r!r"rrrs @@rrc!ResourceFactory._create_references"'0055 *33+   (7(@(@(L(L   5"%_%9%9!:  ) < <+u!  &&rc^^^^TRRmUUUU4Sjn[T5Ul[R "UTTR SS9UlU$)z Creates a new method which acts as a functools.partial, passing along the instance's low-level `client` to the new resource class' constructor. c0>/nT RRT 05nT RT UT S9nT RRnUb%[ X`5HupxUR U5 M [U/UQ7SURR06"U0UD6$)N)r!r8r"client) r)rr:rr=rr>rrr) rrrpositional_argsjson_def resource_clsr=rAvaluermr?r"ras rcreate_resource>ResourceFactory._create_class_partial..create_resources!O'@@DDT2NH'<<"08 /=L,44@@K&):;)M%J#**51*N.7;yy7G7G rF)r!sub_resource_modelr+r)rr5r6rrSubResourceDocstringr+r)rmrar!r"rr?s`` ` @rre%ResourceFactory._create_class_partials[!))..  6$'t9 "+"@"@'0)77# #  rc J^[XUS9mU(a>U4Sjn[R"URUURUUR SS9nO2U4Sjn[R "UURUUR SS9n[UR5UlXel U$)zK Creates a new method which makes a request to the underlying AWS service. )rr"c>>T"U/UQ70UD6nX0Rlgr)rrrrrresponserJs r do_action1ResourceFactory._create_action..do_action4s !$888!) rF) action_namer!r load_modelr+rcd>T"U/UQ70UD6n[US5(aSURlU$r)rrrrs rrrDs6!$8884((&*DIINr)r!rrDr+r) rrLoadReloadDocstringr?rr+ActionDocstringr6rr)rmrDr!r"rErlazy_docstringrJs @rrHResourceFactory._create_actions    * '::(--+*33'-;;"' N '66+*33)-;;"' N!!2!23 *r)rrN)F)r __module__ __qualname____firstlineno__rrr:r.r/r0r1r2rfr3r@rRrSrvr]rcrerH__static_attributes__rlrrrrsi u?n 0$L " HI" (.(,&)P4(6''R,f <rr)logging functoolsrdocsr exceptionsrrJrr baser r collectionr modelr rrr getLoggerrr&rrlrrrs>.//) 8   8 $}}r