K:gT- jddlmZddlmZddlmZmZmZmZmZm Z m Z m Z m Z m Z ddlZddlZddlmZddlmZmZmZerddlmZGdd ej2Zd ed efd Zdd d eddde ed dfdZGddeZGddeZGddeZ dd e e ee eeffde e e!d dfdZ"y))datetime)partial) TYPE_CHECKINGAnyClassVarDictIterableMappingOptionalSetTypeUnionN)Self)_append_docstring_textdatetime_from_iso_strdatetime_to_iso_str)Apic eZdZUdZej deejddZ ejZ e e efed<ded d ffd Zed d d e e efdddeed efdZxZS) AirtableModelzW Base model for any data structures that will be loaded from the Airtable API. ignoreF)uppercase_first_letterT)extraalias_generatorpopulate_by_name_rawdatareturnNc L|j}|jjD]`\}}||jhD]J}|r|j |x}st |t s*|jtus=t|||<Lbt|,di|||_ y)N) copy model_fieldsitemsaliasget isinstancestr annotationrrsuper__init__r)selfrraw field_name field_modelnamevalue __class__s T/var/www/html/lionshead/venv/lib/python3.12/site-packages/pyairtable/models/_base.pyr)zAirtableModel.__init__+siik(,'8'8'>'>'@ #J #[%6%67TXXd^$;E$;eS)k.D.D.P!6u!=DJ 8(A  4  contextobjapirr4c2|di|}t||||S)ao Construct an instance which is able to update itself using an :class:`~pyairtable.Api`. Args: obj: The JSON data structure used to construct the instance. Will be passed to `parse_obj `_. api: The connection to use for saving updates. context: An object, sequence of objects, or mapping of names to objects which will be used as arguments to ``str.format()`` when constructing the URL for a :class:`~pyairtable.models._base.RestfulModel`. r3r) cascade_api)clsr5r6r4instances r1from_apizAirtableModel.from_api;s (::Hc73r2)__name__ __module__ __qualname____doc__pydantic ConfigDictr inflectioncamelize model_config PrivateAttrrrr&r__annotations__r) classmethodr SelfTyper; __classcell__r0s@r1rrs'8&& 3 3ERL 08//1D$sCx.1st  "&  #s(^ #   r2rr5rcRtjt|jSN)rB underscoretyper<)r5s r1 _context_namerOTs  c!3!3 44r2r3r6rr4c|i}|rt|ts t||i}|jdt }t ||vry|j t |t|tttfr|D]}t|||t|tr,|jD]\}}t||i|d|it|tsyi|t||i}t|tr|j||t|jD] }t!||dx}st|||"y)a Ensure all nested objects have access to the given Api instance, and trigger them to configure their URLs accordingly. Args: api: The instance of the API to set. context: A mapping of class names to instances of that class. N __visited__r3key)r%dictrO setdefaultsetidaddlisttupler8r"r RestfulModel_set_apirNr!getattr)r5r6r4visitedr/rRr, field_values r1r8r8Xs3z'40 )73 **=#%@G #w' KK3#eS)*E sG 4#t))+JC s,Cw,Cs,C D& c= )32-,c2G#|$ S' *3i,, !#z48 8; 8  S' :-r2ceZdZUdZdZeeed<ejZ ded<ejdZ eed<ejdZ e ed <d e d dffd Zd ddeee fd dfdZddeeee fd dfdZxZS)rZa Base model for any data structures that wrap around a REST API endpoint. Subclasses can pass a number of keyword arguments to control serialization behavior: * ``url=``: format string for building the URL to be used when saving changes to this model. _RestfulModel__url_patternr_apidefault_urlN _url_contextkwargsrc d|jd|j|_t| y)Nurl)poprar(__init_subclass__r9rgr0s r1rkzRestfulModel.__init_subclass__s'"JJuc.?.?@ !#r2r6r4c||_||_ |jjdi|d|i|_|jr=|jjds!|j|j|_yyy#t t f$rK}g|j|jDcic]\}}|dk7s ||ncc}}wc}}|_d}~wwxYw)zV Set a link to the API and build the REST URL used for this resource. r*rQNhttpr) rbrfraformatreKeyErrorAttributeErrorargsr" startswith build_url)r*r6r4exckvs r1r[zRestfulModel._set_apis # 1**11GGG$GDI 99TYY11&9 dii0DI:9 .) $+MMOJO&1aqM7IAOJCH   s)%A??C C. C <C CCr5c j|%|jj|j}t|j ||j|j }|j jt|jDcic]}||j j| c}ycc}w)zk Reload the model's contents from the given object, or by making a GET request to the API. Nr3) rbr$rerNr;rf__dict__updater!)r*r5copyablerRs r1_reloadzRestfulModel._reloads ;))-- *C:&&sDIIt?P?P&Q 8r?rarr&rFr@rErbrerfrrkrr[r r|rIrJs@r1rZrZs$&M8C=%&(&&(D%($$$R0D#0,,,T:L#:$$$1E1DcN1t1"  8DcN3  t  r2rZc`eZdZUdZej dZeed<e defdZ d dZ y) CanDeleteModelzD Mix-in for RestfulModel that allows a model to be deleted. Frc_deletedrc|jS)zb Indicates whether the record has been deleted since being returned from the API. )rr*s r1deletedzCanDeleteModel.deleteds }}r2Nc|js td|jjd|jd|_y)zT Delete the record on the server and mark this instance as deleted. z%delete() called with no URL specifiedDELETETN)re RuntimeErrorrbrequestrrs r1deletezCanDeleteModel.deletes6yyFG G (DII. r2rN) r<r=r>r?r@rErboolrFpropertyrrrr2r1r~r~s>*X))%8Hd8  r2r~ceZdZUdZdZeeeee d<dZ eeeee d<dZ ee e d<dZ eee d<dZee e d <d ed dffd Zdd Zdeded dffd ZxZS)CanUpdateModela Mix-in for RestfulModel that allows a model to be modified and saved. Subclasses can pass a number of keyword arguments to control serialization behavior: * ``writable=``: field names that should be written to API on ``save()``. * ``readonly=``: field names that should not be written to API on ``save()``. * ``save_null_values=``: boolean indicating whether ``save()`` should write nulls (default: true) N_CanUpdateModel__writable_CanUpdateModel__readonlyT_CanUpdateModel__save_nonePATCH!_CanUpdateModel__save_http_method"_CanUpdateModel__reload_after_savergrc d|vrd|vr td|jd|j|_|jd|j|_t |jd|j |_|jd|j |_t |jd|j|_|jr/t|ddjd |jDz|jr/t|d djd |jDzt|,d i|y) Nwritablereadonlyz-incompatible kwargs 'writable' and 'readonly'save_null_values save_methodreload_after_savez0The following fields can be modified and saved: z, c3(K|] }d|d ywz``Nr.0fields r1 z3CanUpdateModel.__init_subclass__..GubrNz;The following fields are read-only and cannot be modified: c3(K|] }d|d ywrrrs r1rz3CanUpdateModel.__init_subclass__..rrr) ValueErrorrjrrrrrrrjoinr(rkrls r1rkz CanUpdateModel.__init_subclass__s  J&$8LM MJ?J?vzz*> "B))GGGH  >> "N))GGGH  !+F+r2c<t|ddr td|js td|jrt |jnd}|j rt |j nd}|j d|||j }|D]2}t|j|x}ts%t|||<4|jj|j|j|}|jr|j!|yy)z Save any changes made to the instance's writable fields and update the instance with any refreshed values returned from the API. Will raise ``RuntimeError`` if the record has been deleted. rNzsave() called after delete()z#save() called with no URL specifiedT)by_aliasincludeexclude exclude_none)json)r\rrerrUr model_dumprr%r$rrrbrrrr|)r*rrrrRr/responses r1savezCanUpdateModel.saves 4T *=> >yyDE E*.//#doo&t*.//#doo&t"...  C488C=0%(;/6S 99$$T%<%>.. .44??#:$T***t4??/J$T** D%(r2r)r<r=r>r?rrr r r&rFrrrrrrrkrrrIrJs@r1rrs59J(3-01848J(3-018"&K$&(/ /*.$.,,,0#6))C)D))r2rmemocd| tn|}t|trNt||vry|j t||j t t||S|jD]1}t|tst|ts%t ||3y)a Convenience method to ensure we update forward references for all nested models. Any time a type annotation refers to a nested class that isn't present at the time the attribute is created, we need to tell pydantic to update forward references after all the referenced models exist. Only intended for use within pyAirtable, like: >>> from pyairtable.models._base import AirtableModel, update_forward_refs >>> class A(AirtableModel): ... >>> class B(AirtableModel): ... ... class B_One(AirtableModel): ... ... class B_Two(AirtableModel): ... >>> update_forward_refs(vars()) N)r) rUr%rNrVrW model_rebuildrebuild_modelsvarsvalues issubclassr)r5rr/s r1rr!s(L35dD#t c7d?  C d3id33 eT "z%'G 5t ,r2rL)#r functoolsrtypingrrrrr r r r r rrBr@typing_extensionsrrHpyairtable.utilsrrrpyairtable.api.apir BaseModelrr&rOr8rZr~rintrrr2r1rs   . &3H&&3l5s5s5" /; /; /;c] /;  /;d- =- `\0L)\L)b $ - tM"GCH$55 6 - 3s8  -  -r2