K:gI rUdZddlZddlZddlZddlmZmZmZddlmZddl m Z m Z m Z m Z mZmZmZmZmZmZmZmZmZmZmZmZddlmZddlmZddlmZm Z dd l!m"Z"m#Z#m$Z$m%Z%m&Z&m'Z'm(Z(m)Z)dd l*m+Z+m,Z,m-Z-dd l.m/Z0dd l1m2Z2m3Z3e rdd l4m5Z5ee6edfZ7ee8d<edZ9eddZ:edZ;edZ<edZ=edZ>Gddee;efej~Z@Gddee;eGd?d@eOeDe0jZ[eMdAdBGdCdDe@eLeLdfeDe0jZ]eMdEdFGdGdHeOeDe0jZ_eMdEdFd7d8GdIdJeOeDee0je0jfZ`eMdKdLGdMdNeOeDe0jZbGdOdPeEe9ZcGdQdReceedeefZfGdSdTecedZgGdUdVeceeZheMdWdXGdYdZefeDe0jZjeMdWdXGd[d\egeDe0jZkeMdWdXGd]d^eheDe0jZleMd_Gd`dae@emememfeDe0jZoeMdbdcGdddeegeDe0jZqeMdfdgGdhdiefeDe0jZseMdjdkGdldmefeDe0jZueMdnGdodpegeDe0jZwGdqdre@eLedfZxeMdsGdtduexeDe0jZzeMdvdwGdxdye@eLedfeDe0jZ|eMdzd{Gd|d}e@ededfeDe0jZ~Gd~dee;e`_, which allows us to define methods and type annotations for getting and setting attribute values. >>> from pyairtable.orm import Model, fields >>> class Contact(Model): ... class Meta: ... ... ... name = fields.TextField("Name") ... is_registered = fields.CheckboxField("Registered") ... >>> contact = Contact(name="George", is_registered=True) >>> assert contact.name == "George" >>> reveal_type(contact.name) # -> str >>> contact.to_record() { "id": recS6qSLw0OCA6Xul", "createdTime": "2021-07-14T06:42:37.000Z", "fields": { "Name": "George", "Registered": True, } } N)datedatetime timedelta)Enum) TYPE_CHECKINGAnyCallableClassVarDictGenericListLiteralOptionalSetTupleTypeTypeVarUnioncastoverload)Self) TypeAlias)formulasutils) AITextDictAttachmentDict BarcodeDict ButtonDictCollaboratorDictCollaboratorEmailDictCreateAttachmentDictRecordId)MissingValueErrorMultipleValuesErrorUnsavedRecordError)schema)AttachmentsListChangeTrackingListModel) _ClassInfo.r+TT_Linkedr*)boundT_APIT_ORM T_ORM_List T_Missingc $eZdZUdZdZeeed<dZee ed<dZ e ed<dZ e eded <dZe eed < d'd ed e de e d dfdZde ded dfdZed efdZedddee d efdZedddee d eeeffdZde ddee d eeeeffdZddde ed dfdZd(dZde d e fdZde d e fdZde d dfdZd)dZ d efdZ!d e"e#ee ffdZ$de d d fd!Z%de d d fd"Z&de d d fd#Z'de d d fd$Z(de d d fd%Z)de d d fd&Z*y)*FieldaE A generic class for an Airtable field descriptor that will be included in an ORM model. Type-checked subclasses should provide three type parameters: * ``T_API``, indicating the JSON-serializable type returned by the API * ``T_ORM``, indicating the type used to store values internally * ``T_Missing``, indicating the type of value returned if the field is empty Subclasses should also define ``valid_types`` as a type or tuple of types, which will be used to validate the type of field values being set via this descriptor. valid_typesN missing_valueFreadonlyr*_model_attribute_name field_name validate_typereturnc4||_||_|||_yy)a Args: field_name: The name of the field in Airtable. validate_type: Whether to raise a TypeError if anything attempts to write an object of an unsupported type as a field value. If ``False``, you may encounter unpredictable behavior from the Airtable API. readonly: If ``True``, any attempt to write a value to this field will raise an ``AttributeError``. Each field implements appropriate default values, but you may find it useful to mark fields as readonly if you know that the access token your code uses does not have permission to modify specific fields. N)r;r<r8)selfr;r<r8s R/var/www/html/lionshead/venv/lib/python3.12/site-packages/pyairtable/orm/fields.py__init__zField.__init__vs'$%*  $DM ownernamec ||_||_y)zM Called when an instance of Field is created within a class. N)r9r:)r?rCrDs r@ __set_name__zField.__set_name__s #rBc|jr1|jr%|jjd|jS|jdS)z Describes the field for the purpose of logging an error message. Handles an edge case where a field is created directly onto a class that already exists; in those cases, __set_name__ is not called. .z field)r9r:__name__r;r?s r@ _descriptionzField._descriptionsH ;;4//kk**+1T-A-A,BC C//$F++rBinstancecyNr5r?rLrCs r@__get__z Field.__get__EHrBcyrNr5rOs r@rPz Field.__get__s#&rBc|s|S |j|j}|t t |j St t|S#ttf$rt t |j cYSwxYwrN)_fieldsr;KeyErrorAttributeErrorrr2r7r0)r?rLrCvalues r@rPz Field.__get__suK 7$$T__5E = 4#5#56 6E5!! .) 7 4#5#56 6 7sA )A76A7rWc|j|jr||j|t|dsi|_||j|j <t|drd|j |j <yy)NrT_changedT)_raise_if_readonlyr<valid_or_raisehasattrrTr;rYr?rLrWs r@__set__z Field.__set__ss !   %"3    &x+!H ,1) 8Z (15H  doo . )rBc2td|j)Nzcannot delete )rVrK)r?rLs r@ __delete__zField.__delete__s~d.?.?-@ABBrBc|S)zK Calculate the value which should be persisted to the API. r5r?rWs r@to_record_valuezField.to_record_value  rBc|S)zX Convert a value from the API into the value's internal representation. r5rbs r@to_internal_valuezField.to_internal_valuerdrBc |jrQt||js:t|jjd|jdt |yy)zV Validate the type of the given value and raise TypeError if invalid.  value must be ; got N)r6 isinstance TypeError __class__rItyperbs r@r[zField.valid_or_raises`   Jud6F6F$G>>**+?4;K;K:LFSWX]S^R_` %H rBcL|jrt|jdy)Nz is read-only)r8rVrKrJs r@rZzField._raise_if_readonlys' == D$5$5#6m!DE E rBct|jg}||jDcgc] \}}|d|c}}z }|jjdzdj |zdzScc}}w)N=(, ))reprr; _repr_fieldsrlrIjoin)r?argskeyvals r@__repr__zField.__repr__ssT__%& D4E4E4GH4GjsCC5#!4GHH~~&&,tyy>DDIsA0c:d|jfd|jfgS)Nr8r<)r8r<rJs r@ruzField._repr_fieldss&  ' d00 1  rBzformulas.Comparisonc.tj||S)zX Build an :class:`~pyairtable.formulas.EQ` comparison using this field. )rEQrbs r@eqzField.eq{{4''rBc.tj||S)zX Build an :class:`~pyairtable.formulas.NE` comparison using this field. )rNErbs r@nezField.nerrBc.tj||S)zW Build a :class:`~pyairtable.formulas.GT` comparison using this field. )rGTrbs r@gtzField.gtrrBc.tj||S)zX Build an :class:`~pyairtable.formulas.LT` comparison using this field. )rLTrbs r@ltzField.ltrrBc.tj||S)zX Build a :class:`~pyairtable.formulas.GTE` comparison using this field. )rGTErbs r@gtez Field.gte||D%((rBc.tj||S)zY Build an :class:`~pyairtable.formulas.LTE` comparison using this field. )rLTErbs r@ltez Field.lte rrB)TN)rLr*r=N)r=N)+rI __module__ __qualname____doc__r6r r+__annotations__r7rr8boolr9rrr:strrArFpropertyrKrSelfTyperPrr0r2r^r`rcrfr[rZrzr rrur~rrrrrr5rBr@r4r4WsV  )+K*%*$(M8C='Hd'+FHT'] #*&*OXc]) ##' %%%4. %  %4$#$S$T$,c,,HHT#YH8HH&&(,S & ui && " ) "26s) " x ) * "666D6CSS ss CDFE#E  d5c?3 (( 5( (( 5( (( 5( (( 5( ))!6) ))!6)rBr4) metaclassceZdZdZedddeedefdZedddeede fdZde ddeede ee fffd Zddd e e ddffd Z xZ S) _Requires_API_ORMa" A mix-in for a Field class which indicates two things: 1. It should never receive a null value from the Airtable API. 2. It should never allow other code to set it as None (or the empty string). If either of those conditions occur, the field will raise an exception. rLNrCr=cyrNr5rOs r@rPz_Requires_API_ORM.__get__rQrBr*cyrNr5rOs r@rPz_Requires_API_ORM.__get__!rQrBcft|||}||dk(rt|jd|S)Nz received an empty value)superrPr#rK)r?rLrCrWrls r@rPz_Requires_API_ORM.__get__$s?%0 =ERK#t'8'8&99Q$RS S rBrWc^|dvrt|jdt| ||y)N)Nrz does not accept empty values)r#rKrr^r?rLrWrls r@r^z_Requires_API_ORM.__set__,s3 J #t'8'8&99V$WX X %(rB)rIrrrrrrrrPr0rrr^ __classcell__rls@r@rrsHHT#YH8HH HHS HeHH )26s) x )))D))rBr T_FieldSchemaceZdZdZdefdZy) _FieldSchemaz\ A mix-in for a Field class which indicates that its field has a particular schema. r=c*t|ts td|jst|jdt t |jjjjj|jS)z: Retrieve the schema for the given field. z1field_schema() must be called on a Field instancez was not defined on a Model) rjr4 RuntimeErrorr9rKrrmetatabler&fieldr;rJs r@ field_schemaz_FieldSchema.field_schema:su$&RS S{{$"3"3!44OPQ Q 4;;++1188:@@Q  rBN)rIrrrrrr5rBr@rr5s  m  rBr _BasicField_BasicFieldWithMissingValue _RequiresAnyFieldT_Fieldclsr=c|}t|jdkDrV|jsJ|jd}|turt |dt|jdkDr |jsJ|j|_|S)zQ Reuses the class's first parent class's docstring if it's undocumented. z needs a docstring)len__mro__rr4r)rfrom_clss r@_use_inherited_docstringrYsH h ! #H,<,<##A& u #&89: : h ! #H,<,<""CK JrBct||jr*tjdd|jxsd|_|S)zJ Modifies the class docstring to indicate read-only vs. writable. z)Accepts (?:only )?((?:[^.`]+|`[^`]+`)+)\.zRead only. Returns \1.r)rr8resubr)rs r@_maybe_readonly_docstringrfs<S! ||ff 8 % KK 2  JrB refs_tagsc t|dk(r(|d|djjddf}t|dk(rdnd}d|jd t |d d d |dd d Dzd t d t ffd }|S)z Appends the class docstring with a link to the Airtable API documentation for the field type. If the class is undocumented, reuses the class's first parent class's docstring. rr rz and rrz'For more about this field type, see %s.c34K|]\}}d|d|dyw)`z6 `__Nr5).0reftags r@ z'_field_api_docstring..|s-H>JS# C5Fse4P>sNrr=c`t|t|tj||SrN)rrr_append_docstring_text)r link_texts r@_wrapperz&_field_api_docstring.._wrappers( %!#& $$S)4 rB)rlowerreplacervzipr)rjoinerrrs @r@_field_api_docstringrts  9~q\9Q<#5#5#7#?#?R#HI I!+WF9FKKHi!ni1o>H=I g' OrBct|t|d}|js|dz }|dz }tj|||S)z Appends the class's docstring so that it includes a note about required values. If the class is undocumented, reuses the class's first parent class's docstring. z&If the Airtable API returns ``null``, z6or if a caller sets this field to ``None`` or ``''``, zDthis field raises :class:`~pyairtable.exceptions.MissingValueError`.)rrr8rr)rappends r@_required_value_docstringrsK S!c" 5F <<JJ TTF   f- JrBceZdZdZdZeZy) _StringFieldzX Accepts ``str``. Returns ``""`` instead of ``None`` if the field is empty. rN)rIrrrr7rr6r5rBr@rrs MKrBrEmail emailtextc eZdZy) EmailFieldNrIrrr5rBr@rrrBrz Sync sourceceZdZdZy)ExternalSyncSourceFieldTNrIrrr8r5rBr@rr HrBrceZdZdZdZy)ManualSortFieldz Read-only. Returns ``""`` instead of ``None`` if the field is empty. The ``manualSort`` field type is used to define a manual sort order for a list view. Its use or behavior via the API is not documented. TNrIrrrr8r5rBr@rrsHrBrz Long text multilinetextc eZdZy)MultilineTextFieldNrr5rBr@rrrrBrPhonec eZdZy)PhoneNumberFieldNrr5rBr@rrrrBrz Rich textc eZdZy) RichTextFieldNrr5rBr@rrrrBrz Single selectselectceZdZdZeZy) SelectFieldz Represents a single select dropdown field. Accepts ``str`` or ``None``. This will return ``None`` if no value is set, and will only return ``""`` if an empty dropdown option is available and selected. N)rIrrrrr6r5rBr@rrsKrBrzSingle line text simpletextc eZdZy)SingleLineTextFieldNrr5rBr@rrrrBrc eZdZy) TextFieldNrr5rBr@rr  rBrUrlurltextc eZdZy)UrlFieldNrr5rBr@rrrrBrc,eZdZdZdeddffd ZxZS)_NumericFieldBasezU Base class for Number, Float, and Integer. Shares a common validation rule. rWr=Nc t|tr:t|jjd|j dt |t|!|y)Nrhri) rjrrkrlrIr6rmrr[r?rWrls r@r[z _NumericFieldBase.valid_or_raisesW eT ">>**+?4;K;K:LFSWX]S^R_`  u%rB)rIrrrrr[rrs@r@rrs &C&D&&rBrceZdZdZeefZy) _NumberFieldzW Number field with unspecified precision. Accepts either ``int`` or ``float``. N)rIrrrintfloatr6r5rBr@rrs,KrBrceZdZdZeZy) _IntegerFieldzK Number field with integer precision. Accepts only ``int`` values. N)rIrrrrr6r5rBr@rrsKrBrceZdZdZeZy) _FloatFieldzM Number field with decimal precision. Accepts only ``float`` values. N)rIrrrrr6r5rBr@rrsKrBrNumberdecimalorintegernumberc eZdZy) NumberFieldNrr5rBr@rrrrBrc eZdZy) IntegerFieldNrr5rBr@r r rrBr c eZdZy) FloatFieldNrr5rBr@r r &rrBr CheckboxceZdZdZdZeZy) CheckboxFieldz\ Accepts ``bool``. Returns ``False`` instead of ``None`` if the field is empty. FN)rIrrrr7rr6r5rBr@rr+s MKrBrCountcountceZdZdZy) CountFieldTNrr5rBr@rr6sHrBrCurrencycurrencynumberc eZdZy) CurrencyFieldNrr5rBr@rr;rrBrPercent percentnumberc eZdZy) PercentFieldNrr5rBr@rr@rrBrRatingc,eZdZdZdeddffd ZxZS) RatingFieldz< Accepts ``int`` values that are greater than zero. rWr=NcDt|||dkr tdy)Nrzrating cannot be below 1)rr[ ValueErrorrs r@r[zRatingField.valid_or_raiseKs( u% 1978 8 rB)rIrrrrr[rrs@r@rrEs 9C9D99rBrc4eZdZdZeZdedefdZdedefdZy)_DatetimeFieldzm Accepts only `datetime `_ values. rWr=c,tj|S)zb Convert a ``datetime`` into an ISO 8601 string, e.g. "2014-09-05T12:34:56.000Z". )rdatetime_to_iso_strrbs r@rcz_DatetimeField.to_record_value]s((//rBc,tj|S)zb Convert an ISO 8601 string, e.g. "2014-09-05T07:00:00.000Z" into a ``datetime``. )rdatetime_from_iso_strrbs r@rfz _DatetimeField.to_internal_valuecs**511rBN) rIrrrrr6rrcrfr5rBr@r!r!Vs4K0X0#0 2s2x2rBr!z Date and timec eZdZy) DatetimeFieldNrr5rBr@r'r'jrrBr'Datedateonlyc4eZdZdZeZdedefdZdedefdZy) DateFieldze Accepts only `date `_ values. rWr=c,tj|S)zP Convert a ``date`` into an ISO 8601 string, e.g. "2014-09-05". )rdate_to_iso_strrbs r@rczDateField.to_record_valuews$$U++rBc,tj|S)zP Convert an ISO 8601 string, e.g. "2014-09-05" into a ``date``. )rdate_from_iso_strrbs r@rfzDateField.to_internal_value}s&&u--rBN) rIrrrrr6rrcrfr5rBr@r+r+os4K,T,c, .s.t.rBr+Durationdurationnumberc>eZdZdZeZdedefdZdee efdefdZ y) DurationFieldz Duration field. Accepts only `timedelta `_ values. rWr=c"|jS)zC Convert a ``timedelta`` into a number of seconds. ) total_secondsrbs r@rczDurationField.to_record_values""$$rBct|S)zC Convert a number of seconds into a ``timedelta``. )seconds)rrbs r@rfzDurationField.to_internal_values''rBN) rIrrrrr6rrcrrrfr5rBr@r3r3s=K%Y%5% (uS%Z'8(Y(rBr3ceZdZUdZeZeeed<e ee ed<de ddffd Z e ddd ee defd Ze dd d ee defd Zde d d ee deeeffd Zdd de ee ddffd Zdd defdZde ddffd ZxZS)_ListFieldBaseat Generic type for a field that stores a list of values. Not for direct use; should be subclassed by concrete field types (below). Generic type parameters: * ``T_API``: The type of value returned by the Airtable API. * ``T_ORM``: The type of value stored internally. * ``T_ORM_List``: The type of list object that will be returned. list_class contains_typekwargsr=Nc |jdd|_|jdt|_|jr2t |jt st d|jt |jt st d|jt|jtst d|jt|$di|S)Nr;r:z$contains_type= expected a type, got z!list_class= expected a type, got z3list_class= expected Type[ChangeTrackingList], got r5) popr;r(r:rjrmrk issubclassr__init_subclass__)rr<rls r@r@z _ListFieldBase.__init_subclass__s"JJ=L2DE   Z0A0A4%HB3CTCTBUVW W#..$/??OPQ Q#..*<=EcnnEUV w(2622rBrLrCcyrNr5rOs r@rPz_ListFieldBase.__get__rQrBr*cyrNr5rOs r@rPz_ListFieldBase.__get__sJMrBc,|s|S|j|SrN)_get_list_valuerOs r@rPz_ListFieldBase.__get__sK##H--rBrWc t|trbt||jsLt|jtsJt |jt sJ|j|||}t |||yN)rmodel)rjlistr:rmr?r(rr^rs r@r^z_ListFieldBase.__set__se eT ":eT__+Mdoot4 44doo/AB BBOOEXOFE %(rBcj|jj|j}|g}t||jsLt|jt sJt |jtsJ|j |||}||j|j<tt|SrF) rTgetr;rjr:rmr?r(rr1r]s r@rDz_ListFieldBase._get_list_values  $$T__5 =E%1doot4 44doo/AB BBOOEXOFE -2)J&&rBc t|||jrB|D]<}t||jrt d|jdt |yyNz expected ri)rr[r;rjrkrmr?rWobjrls r@r[z_ListFieldBase.valid_or_raises[ u%   !#t'9'9:#i0B0B/C6$s)$UVV rB)rIrrrrHr6rr1rrr0rr@rrrPrr r^rDr[rrs@r@r9r9sKZ  DK(( 3 3 3HHT#YH8HH MMS MjMM. ).26s). x# $.))e0E)$)''J'(WCWDWWrBr9ceZdZdZy) _ListFieldz Generic type for a field that stores a list of values. Not for direct use; should be subclassed by concrete field types (below). NrIrrrr5rBr@rPrPsrBrPceZdZeZy)_LinkFieldOptionsN)rIrrobjectLinkSelfr5rBr@rSrSs xHrBrSzLink to another record foreignkeyc zeZdZUdZeeeeje e fe d<dZ e ee d< ddedeeeeje e fdede ed ef fd Zed e e fd Zd eeeeffd Zdddddd e ede ed dffdZddd ee ffd Zdeeee fd eefdZded dffd ZxZS) LinkFieldz Represents a MultipleRecordLinks field. Returns and accepts lists of Models. Can also be used with a lookup field that pulls from a MultipleRecordLinks field, provided the field is created with ``readonly=True``. _linked_modelN _max_retriever;rGr<r8lazycddlm}|tjusCt |t s3t |t r t||stdt |t|)|||||_ ||_ y)aA Args: field_name: Name of the Airtable field. model: Model class representing the linked table. There are a few options: 1. You can provide a ``str`` that is the fully qualified module and class name. For example, ``"your.module.Model"`` will import ``Model`` from ``your.module``. 2. You can provide a ``str`` that is *just* the class name, and it will be imported from the same module as the model class. 3. You can provide the sentinel value :data:`~LinkSelf`, and the link field will point to the same model where the link field is created. validate_type: Whether to raise a TypeError if attempting to write an object of an unsupported type as a field value. If ``False``, you may encounter unpredictable behavior from the Airtable API. readonly: If ``True``, any attempt to write a value to this field will raise an ``AttributeError``. This will not, however, prevent any modification of the list object returned by this field. lazy: If ``True``, this field will return empty objects with only IDs; call :meth:`~pyairtable.orm.Model.fetch` to retrieve values. rr)z&expected str, Model, or LinkSelf; got r<r8N) pyairtable.ormr*rSrUrjrrmr?rkrrArY_lazy)r?r;rGr<r8r[r*rls r@rAzLinkField.__init__sp< ) &// /%%5$'Jue,DDT%[MRS S =8T" rBr=cbt|jtr|jjd\}}}|s:|jt |j d|jj}tj|}t||}ttt||_|jS|jtjurJ|jt |j dttt|j|_|jS)z Resolve a :class:`~pyairtable.orm.Model` class based on the ``model=`` constructor parameter to this field instance. rHz not created on a Model)rjrYr rpartitionr9rrKr importlib import_modulegetattrrrr-rSrU)r?modpath_clsnamemodrs r@ linked_modelzLinkField.linked_model@s d((# ."&"4"4"?"?"D GQ;;&&$*;*;)< #//88h8##89F 6!  % % '%%9t'9'9: - ;E"%2 Xu 56; -G(d(( )( ' -( 's0=EEE8E ,E6EEE'cD|j|t| |S)av Unlike most other field classes, LinkField does not store its internal representation (T_ORM) in instance._fields after Model.from_record(). They will first be stored as a list of IDs. We defer creating Model objects until they're requested for the first time, so we can avoid infinite recursion during to_internal_value(). )rwrrD)r?rLrls r@rDzLinkField._get_list_values! hw&x00rBrWcvtd|Drttt|S|Dcgc]}t |tr|}}|j |td|Dst |jd|Dcgc] }t |tr|n |j"c}Scc}wcc}w)zT Build the list of record IDs which should be persisted to the API. c3<K|]}t|tywrN)rjr)rrts r@rz,LinkField.to_record_value..s15az!S!5c3<K|]}|jywrN)exists)rrvs r@rz,LinkField.to_record_value..s9v6==?r{z contains an unsaved record) allrr rrjr[r%rKrp)r?rWrtrrs r@rczLinkField.to_record_values 151 1S 5) )$>e:a+=1e> G$999%(9(9'::U%VW W;@A5aZ3'QTT15AA?BsB1B1 %B6c t|||D]<}t||jrt d|jdt |yrL)rr[rjrirkrmrMs r@r[zLinkField.valid_or_raisesM u%Cc4#4#45)D,=,=+>fT#YK PQQrB)TNF)rIrrrrrrrSrUrr-rrZrrrrArrir rrrurwr(rDrcr[rrs@r@rXrXsqg&7&@&@A4>QRR#'M8C=' ##' ))S'"3"<"<=tH~MN) ) 4. )  )V"d8n"", d5c?3  $"& BBtn B $ B  BH 1 14Fx4P 1BT%X *>%?BDIB*RCRDRRrBrXcpeZdZdZej ejd ddede ee e je efdedeed ed ef fd Zd eeeeffd Zeddde ed efdZeddde ed eefdZdedde ed e eeeffdZdddeed dfdZdeded dffd Zdee eefd eefdZej ej6dddddd eedeed dfdZeej ej:d e efdZxZS)SingleLinkFielda Represents a MultipleRecordLinks field which we assume will only ever contain one link. Returns and accepts a single instance of the linked model, which will be converted to/from a list of IDs when communicating with the Airtable API. See `Link to another record `__. .. warning:: If Airtable returns multiple IDs for a SingleLinkField and you modify the field value, only the first ID will be saved to the API once you call ``.save()``. The other IDs will be lost. By default, a SingleLinkField will ignore the 2nd...Nth IDs if it receives multiple IDs from the API. This behavior can be overridden by passing ``raise_if_many=True`` to the constructor. .. code-block:: python from pyairtable.orm import Model, fields as F class Book(Model): class Meta: ... author = F.SingleLinkField("Author", Person) editor = F.SingleLinkField("Editor", Person, raise_if_many=True) Given the model configuration above and the data below, one field will silently return a single value, while the other field will throw an exception. .. code-block:: python >>> book = Book.from_record({ ... "id": "recZ6qSLw0OCA61ul", ... "createdTime": ..., ... "fields": { ... "Author": ["reculZ6qSLw0OCA61", "rec61ulZ6qSLw0OCA"], ... "Editor": ["recLw0OCA61ulZ6qS", "recOCA61ulZ6qSLw0"], ... } ... }) >>> book.author >>> book.editor Traceback (most recent call last): ... MultipleValues: Book.editor got more than one linked record z raise_if_many: If ``True``, this field will raise a :class:`~pyairtable.orm.fields.MultipleValues` exception upon being accessed if the underlying field contains multiple values.)rNr;rGr<r8r[ raise_if_manyct||||||_tt||||||_d|j _y)Nr])r<r8r[r)rrA_raise_if_manyrXr- _link_fieldrZ)r?r;rGr<r8r[rrls r@rAzSingleLinkField.__init__sR" =8T+$X.  '  *+&rBr=cd|jjfd|jfd|jfd|jjfd|j fgS)NrGr<r8r[r)rrYr<r8r_rrJs r@ruzSingleLinkField._repr_fieldss\ d&&44 5 d00 1  ' T%%++ , d11 2   rBrLrCcyrNr5rOs r@rPzSingleLinkField.__get__&rQrBr*cyrNr5rOs r@rPzSingleLinkField.__get__)sRUrBc|s|S|jrMt|jj|jxsgdkDrt |j d|jj||} |dS#t$rYywxYw)Nrz got more than one linked recordr) rrrTrJr;r$rKrrP IndexError)r?rLrClinkss r@rPzSingleLinkField.__get__,sK   3x'7'7';';DOO'L'RPR#SVW#W%$$%%EF   ((59 8O  s;B B  B rWcJ|dn|g}|jj||yrN)rr^)r?rLrWvaluess r@r^zSingleLinkField.__set__;s%UG   62rBrDc^t||||jj||yrN)rrFr)r?rCrDrls r@rFzSingleLinkField.__set_name__?s( UD) %%eT2rBc8|jj|SrN)rrcrbs r@rczSingleLinkField.to_record_valueCs//66rBrkrlc@|jj|||y)Nrk)rrw)r?rLr[rls r@rwzSingleLinkField.populateFs !!(w!GrBc.|jjSrN)rrirJs r@rizSingleLinkField.linked_modelPs,,,rB)TNFF)rIrrrrdocstring_fromrXrArrrrSrUrr-rrr rrrurrrPr^rFrcrwrrirrs@r@rrs3 .`U P##'#++S'"3"<"<=tH~MN+ + 4. +  +++* d5c?3 HHT#YH8HH UUS Uhx>PUU  ) 26s)  x(++ , 330B3t33#3S3T37T%X *>%?7DI7U),,- $"& HHtn H $ H  H.HU)001-d8n-2-rBrceZdZdZeZy) _DictFieldz Generic field type that stores a single dict. Not for use via API; should be subclassed by concrete field types (below). N)rIrrrdictr6r5rBr@rrVs KrBrzAI TextceZdZdZdZy) AITextFieldz2 Read-only field that returns a ``dict``. TNrr5rBr@rr_sHrBr AttachmentsmultipleattachmentceZdZdZy)AttachmentsFieldz Accepts a list of :class:`~pyairtable.api.types.AttachmentDict` or :class:`~pyairtable.api.types.CreateAttachmentDict`. NrQr5rBr@rrhsrBr)r:r;BarcodeceZdZdZy) BarcodeFieldzG Accepts a list of :class:`~pyairtable.api.types.BarcodeDict`. NrQr5rBr@rrwsrBrButtonceZdZdZdZy) ButtonFieldzS Read-only field that returns a :class:`~pyairtable.api.types.ButtonDict`. TNrr5rBr@rr~HrBr CollaboratorceZdZdZy)CollaboratorFieldz Accepts a :class:`~pyairtable.api.types.CollaboratorDict` or :class:`~pyairtable.api.types.CollaboratorEmailDict`. NrQr5rBr@rrs rBrz Created byceZdZdZdZy)CreatedByFieldzD Returns a :class:`~pyairtable.api.types.CollaboratorDict`. TNrr5rBr@rrrrBrz Created timeceZdZdZy)CreatedTimeFieldTNrr5rBr@rrs HrBrzLast modified byceZdZdZdZy)LastModifiedByFieldzO Read-only. Returns a :class:`~pyairtable.api.types.CollaboratorDict`. TNrr5rBr@rrs HrBrzLast modified timeceZdZdZy)LastModifiedTimeFieldTNrr5rBr@rrrrBrLookupceZdZdZdZy) LookupFielda Generic field class for a lookup, which returns a list of values. pyAirtable does not inspect field configuration at runtime or during type checking. If you use mypy, you can declare which type(s) the lookup returns: >>> from pyairtable.orm import fields as F >>> class MyTable(Model): ... Meta = fake_meta() ... lookup = F.LookupField[str]("My Lookup") ... >>> rec = MyTable.first() >>> rec.lookup ["First value", "Second value", ...] TNrr5rBr@rrs HrBrzMultiple collaboratorsmulticollaboratorceZdZdZy)MultipleCollaboratorsFieldz Accepts a list of :class:`~pyairtable.api.types.CollaboratorDict` or :class:`~pyairtable.api.types.CollaboratorEmailDict`. NrQr5rBr@rrs rBr)r;zMultiple select multiselectceZdZdZy)MultipleSelectFieldz$ Accepts a list of ``str``. NrQr5rBr@rrsrBrz Auto number autonumberceZdZdZy)AutoNumberFieldTNrr5rBr@rrs HrBrc eZdZy)RequiredAITextFieldNrr5rBr@rrrrBrc eZdZy)RequiredBarcodeFieldNrr5rBr@rrrrBrc eZdZy)RequiredCollaboratorFieldNrr5rBr@rrrrBrc eZdZy)RequiredCountFieldNrr5rBr@rrrrBrc eZdZy)RequiredCurrencyFieldNrr5rBr@rrrrBrc eZdZy)RequiredDateFieldNrr5rBr@rrrrBrc eZdZy)RequiredDatetimeFieldNrr5rBr@rrrrBrc eZdZy)RequiredDurationFieldNrr5rBr@rr#rrBrc eZdZy)RequiredEmailFieldNrr5rBr@rr(rrBrc eZdZy)RequiredFloatFieldNrr5rBr@rr-rrBrc eZdZy)RequiredIntegerFieldNrr5rBr@rr2rrBrc eZdZy)RequiredNumberFieldNrr5rBr@rr7rrBrc eZdZy)RequiredPercentFieldNrr5rBr@rr<rrBrc eZdZy)RequiredPhoneNumberFieldNrr5rBr@rrArrBrc eZdZy)RequiredRatingFieldNrr5rBr@rrFrrBrc eZdZy)RequiredRichTextFieldNrr5rBr@rrKrrBrc eZdZy)RequiredSelectFieldNrr5rBr@rrPrrBrc eZdZy)RequiredTextFieldNrr5rBr@rrUrrBrc eZdZy)RequiredSingleLineTextFieldNrr5rBr@rrZrrBrc eZdZy)RequiredMultilineTextFieldNrr5rBr@rr_rrBrc eZdZy)RequiredUrlFieldNrr5rBr@rrdrrBrrf ALL_FIELDSREADONLY_FIELDSaiText autoNumberbarcodebuttoncheckbox createdBy createdTimecurrencyrdateTimedurationemailexternalSyncSourceformulalastModifiedBylastModifiedTimelookup manualSort multilineTextmultipleAttachmentsmultipleCollaboratorsmultipleLookupValuesmultipleRecordLinksmultipleSelectsnumberpercent phoneNumberratingrichTextrollupsingleCollaboratorsingleLineText singleSelecturlFIELD_TYPES_TO_CLASSESFIELD_CLASSES_TO_TYPES)@rrrrrrrrrrrrrrrrr+r'r3rrr4r r rrrXrUrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)rabcrbrrrrenumrtypingrrr r r r r rrrrrrrrrtyping_extensionsrrr pyairtablerrpyairtable.api.typesrrrrrr r!r"pyairtable.exceptionsr#r$r%pyairtable.modelsr&Spyairtable.orm.listsr'r(r^r*rmr+rr,r-r/r0r1r2ABCMetar4r FieldSchemarrrrrrrrrrrrrEmailFieldSchemarExternalSyncSourceFieldSchemarManualSortFieldSchemarMultilineTextFieldSchemarPhoneNumberFieldSchemarRichTextFieldSchemarSingleSelectFieldSchemarSingleLineTextFieldSchemarrUrlFieldSchemarrrrrrrNumberFieldSchemarr r rCheckboxFieldSchemarCountFieldSchemarCurrencyFieldSchemarPercentFieldSchemarRatingFieldSchemarr!DateTimeFieldSchemar'DateFieldSchemar+DurationFieldSchemar3r9rPrSrUMultipleRecordLinksFieldSchemarXrrAITextFieldSchemarMultipleAttachmentsFieldSchemarrBarcodeFieldSchemarButtonFieldSchemarSingleCollaboratorFieldSchemarCreatedByFieldSchemarCreatedTimeFieldSchemarLastModifiedByFieldSchemarLastModifiedTimeFieldSchemarMultipleLookupValuesFieldSchemar MultipleCollaboratorsFieldSchemarMultipleSelectsFieldSchemarAutoNumberFieldSchemarrrrrrrrrrrrrrrrrrrrrrvarsitemsrjr? startswithrr8rNotImplementedrr__all__)rD field_classrrxrys00000r@r;s6  ..&/'&    *D$dE*;$<<= I= CL :W - \ " K z)GE5)+ , z)z)u -uUE55H/I)<q}}=  7=) &q!Tz* Y*).q!QwY7(A. 9.CcM*)* )4c3m(<#= > ' g  7 w SXwi6H-I, 7 w (.s3g{+ |A,>,>? , m$,q>>?%lL1H1H$Ik?3 |A4N4N'O 4 g |\!2J2J%K  k" L,q/D/D"E # ox0%S$'a6O6O)P1(,7 , Q5P5P(Q 8 (, _U q22A4N4NNOP V eY' |\!*:*:; (  & A &$U3:%67%c*#E*h 89 , Q-@-@ A : h 89 =,q/B/B"C : h 89 l1+>+>? : j!E$d*+\!:O:O-P"gw' Q-?-? @(j"23 L,q/D/D"E 4 i1 <a.B.B!C 2 h9-a.A.A!B9 9 2U3$./2(o& NL1F1F$G ' fj).c4o& Q5F5F(G.*.(j"23(E#y$./a>S>S1T(4(2QW E5* $% $u+tE{J ./QWh1&8&; ;<  % %. =FR H8$ & 112FR>FRRH- H $s)Xt #$112H-VQi *Z(,q7J7J*K!m%9: n.BBC_T112 ; i :k*L9M9M,N! h z j$$%   n%u%'<<=>001&l#   ''( $ n%c8m$))*&() ,q/J/J"K**+L!>!>?,h*Q-a.O.O!P (.0CDu%'<<=>334E'7sO\!">">?s8m\2 cN(()3 +y'<   <;)?    e$&;;<=   Ys^   M9U3:5F+G   #4S$Y#?   M+   +'8c'B   9S>   "5y~   !3Ys^   x3  "V\\^#+k+t$;&5 OOC +# CX 8B'RzS\\z'RT(^$R$5 k$5/$5|$5 k $5  $5  Z $5$5#$5 $5 I$5 $5 $5 Z$51$5~$5 )!$5"-#$5$ k%$5&/'$5(Y)$5*++$5,7-$5.K/$5091$52*3$54 k5$56|7$58#9$5: k;$5< =$5> n?$5@+A$5BiC$5DKE$5F 8G$5S$x.01$X: 6 < < > M >*3#*# > MM:T(^SX568A A#(Sp N:s04l!$l'7l'l2- l,;l,?l2,l2