K:gD ddlZddlZddlZddlZddlZddlmZmZddlm Z m Z ddl m Z m Z mZmZmZmZmZmZmZmZmZmZmZddlZddlmZmZmZddlmZm Z m!Z!e rddl"m#Z#edZ$ed d Z%ed Z&ed d Z'edede fZ(dede)fdZ*de)defdZ+deeefde)fdZ,de)defdZ-dAde)de)de fdZ.dee&de/deee&fdZ0dAde de)de1fdZ2e e2d !Z3e e2d"!Z4e e2d#!Z5e e2d$!Z6e e2d%!Z7dBd&e1d'e(de(fd(Z8d d)d*e d+e)d,e1ddfd-Z9d d)d*e d+e)d,e1ddfd.Z:dAd*e d/e)dee(ge(ffd0Z;Gd1d2eee'e%fZdeee)ee)fdee)fd6Z?d7d8d9e)d:ee1ee)fdeege ffd;Z@Gd<d=e)ZAGd>d?ZBgd@ZCy)CN)datedatetime)partialwraps) TYPE_CHECKINGAnyCallableDictGenericIterableIteratorListOptionalSequenceTypeVarUnioncast) ParamSpecProtocolSelf) AnyRecordDictCreateAttachmentByUrl FieldValueApiPRT) covariantTC) contravariantF.)boundvaluereturncF|jdjddS)z Convert ``datetime`` object into Airtable compatible ISO 8601 string e.g. "2014-09-05T12:34:56.000Z" Args: value: datetime object milliseconds)timespec+00:00Z) isoformatreplacer$s M/var/www/html/lionshead/venv/lib/python3.12/site-packages/pyairtable/utils.pydatetime_to_iso_strr/(s" ??N? 3 ; ;Hc JJc^|jdr|dddz}tj|S)z Convert an ISO 8601 datetime string into a ``datetime`` object. Args: value: datetime string, e.g. "2014-09-05T07:00:00.000Z" r*Nr))endswithr fromisoformatr-s r.datetime_from_iso_strr53s1 ~~ccr X%  ! !% ((r0c$|jdS)z Convert a ``date`` or ``datetime`` into an Airtable-compatible ISO 8601 string Args: value: date or datetime object, e.g. "2014-09-05" %Y-%m-%d)strftimer-s r.date_to_iso_strr9?s >>* %%r0cJtj|djS)zw Convert ISO 8601 date string into a ``date`` object. Args: value: date string, e.g. "2014-09-05" r7)rstrptimerr-s r.date_from_iso_strr<Is    UJ / 4 4 66r0urlfilenamecPtjdtd|sd|iS||dS)a Build a ``dict`` in the expected format for creating attachments. When creating an attachment, ``url`` is required, and ``filename`` is optional. Airtable will download the file at the given url and keep its own copy of it. All other attachment object properties will be generated server-side soon afterward. Note: Attachment field values **must** be an array of :class:`~pyairtable.api.types.AttachmentDict` or :class:`~pyairtable.api.types.CreateAttachmentByUrl`; it is not valid to pass a single item to the API. Usage: >>> table = Table(...) >>> profile_url = "https://example.com/profile.jpg" >>> rec = table.create({"Profile Photo": [attachment(profile_url)]}) { 'id': 'recZXOZ5gT9vVGHfL', 'fields': { 'attachment': [ { 'id': 'attu6kbaST3wUuNTA', 'url': 'https://content.airtable.com/...', 'filename': 'profile.jpg' } ] }, 'createdTime': '2021-08-21T22:28:36.000Z' } zXattachment(url, filename) is deprecated; use {'url': url, 'filename': filename} instead.) stacklevelr=r=r>)warningswarnDeprecationWarningrBs r. attachmentrFSs2D MMb (E3<OSh-OOr0iterable chunk_sizec#VKtdt||D] }||||zyw)z Break a sequence into chunks. Args: iterable: Any sequence. chunk_size: Maximum items to yield per chunk. rN)rangelen)rGrHis r.chunkedrM}s01c(mZ 0q1z>**1s')prefixcht|tsy|r|j|syt|dk(S)z Check whether the given value is an Airtable ID. Args: value: The value to check. prefix: If provided, the ID must have the given prefix. F) isinstancestr startswithrK)r$rNs r.is_airtable_idrTs3 eS ! e&&v. u: r0rec)rNapptblfldusrmodify_docstringwrappedcT|r tdtjr]tj D]1\}}tj |st |t|3ttStdtdtdtffd }|S)z Wrap a function or method so that if Airtable returns a 404, we will annotate the error with a helpful note to the user. z|enterprise_only|argskwargsr%c |i|S#tjj$rP}|j=|jjdk(r$g|j dj d|_|d}~wwxYw)NizNOTE: z'() requires an enterprise billing plan.)requests exceptions HTTPErrorresponse status_coder] __qualname__)r]r^excr[s r. _decoratedz#enterprise_only.._decorateds D+F+ +"",, ||'CLL,D,D,KXXW1122YZI  s A8A A33A8) _prepend_docstring_textinspectisclassvarsitems isfunctionsetattrenterprise_onlyrr"rr)r[rZnameobjrgs` r.roros )<=wg,,.ID#!!#&s';</Aw 7^ #     r0 skip_emptyrqtextrsc|jxsd}|r|sy|jd}tjd|x}rt j ||d}|d||_yN z^\s+rz )__doc__lstriprematchtextwrapindentrqrtrsdochas_leading_spacess r.rhrhse ++ C# **T CXXgs333t%7%:;F$se$CKr0c|jxsd}|r|sy|jd}tjd|x}rt j ||d}|d||_yrv)ryrstripr{r|r}r~rs r._append_docstring_textrse ++ C# **T CXXgs333t%7%:;EdV$CKr0appendc0dtdtffd }|S)Nfuncr%cFj|_r t||SN)ryr)rrrqs r._wrapperz docstring_from.._wrappers {{  "4 0 r0)r")rqrrs`` r.docstring_fromrsqQ Or0cDeZdZdedededeffdZddded edefd Z y ) _FetchMethodinstanceownerr%.cyr)selfrrs r.__get__z_FetchMethod.__get__sCr0Fforcerrcyrr)self_rrs r.__call__z_FetchMethod.__call__ssr0N) __name__ __module__rer rr rrboolrrr0r.rrs2GG#G(362BG27BaB4BABr0rrc Fdjjdrdjdztdddtdt dt d tffd }t |jd<t|d ttttf|S) z Wrap a method (e.g. ``Base.shares()``) in a decorator that will save a memoized version of the return value for future reuse, but will also allow callers to pass ``force=True`` to recompute the memoized version. ____cached_Frrrr^r%c ~|s t|dt||fi|ttt|Sr)getattrrnrr)rrr^attrrs r._innerz#cache_unless_forced.._inners> GD$-5 D$T 4V 4 5AwtT*++r0z$Args: force: |kwarg_force_metadata|) rrSrzrr rrr__annotations__rrr)rrrs` @r.cache_unless_forcedrst}}o D tDKK,, 4[).,Q,$,#,!,, '+F7#6#KL  QT"F ++r0c||St|trtj||St|ttfr|j St dt|d)z Given an input that might be a date or datetime, or an ISO 8601 formatted str, convert the value into an ISO 8601 formatted str. zcannot coerce z into ISO 8601 str)rQrRrr4rr+ TypeErrortyper-s r.coerce_iso_strrs`  } %u% %$)*  nT%[M1CD EEr0cF|gSt|tr|gSt|S)zS Given an input that is either a str or an iterable of str, return a list. )rQrRlistr-s r.coerce_list_strrs) } %w ;r0F)requiredfieldsrc ttrhn"dur tndurgn tdtdtdtffd t dk(rt d Sdtdtffd }|S) a Create a function that extracts ID, created time, or field values from a record. Intended to be used in similar situations as `operator.itemgetter `_. >>> record = {"id": "rec001", "fields": {"Name": "Alice"}} >>> fieldgetter("Name")(record) 'Alice' >>> fieldgetter("id")(record) 'rec001' >>> fieldgetter("id", "Name", "Missing")(record) ('rec001', 'Alice', None) Args: fields: The field names to extract from the record. The values ``"id"`` and ``"createdTime"`` are special cased; all other values are interpreted as field names. required: If True, will raise KeyError if a value is missing. If False, missing values will return as None. If a sequence of field names is provided, only those names will be required. TFrecordfieldr%cb|dvr|n|d}|vr||vr t||j|S)N)id createdTimer)KeyErrorget)rrsrcrs r. _get_fieldzfieldgetter.._get_field6s>!66fF8z/fieldgetter.._getter..@sCF5Z.Fs)tuple)rrrs`r._getterzfieldgetter.._getter?sCFCCCr0)rQrRsetrrrKrr)rrrrs`` @r. fieldgetterrs4(C : T v; U x==  6{az33D D#D Nr0ceZdZdZdej j fdZdeffd Z de de fdZ de e de fdZd eee fde fd Zde e de fd Z dd eeee fd e de fd Zde de fdZxZS)Urlah Wrapper for ``str`` that adds Path-like syntax for extending URL components and adding query params. >>> url = Url('http://example.com') >>> url Url('http://example.com') >>> url / 'foo' & {'a': 1, 'b': [2, 3, 4]} Url('http://example.com/foo?a=1&b=2&b=3&b=4') >>> url // [1, 2, 3, 4] Url('http://example.com/1/2/3/4') r%c@tjj|S)z Shortcut for `urllib.parse.urlparse `_. )urllibparseurlparse)rs r._parsez Url._parseSs||$$T**r0cT|jjdt| dS)N()) __class__rsuper__repr__)rrs r.rz Url.__repr__Ys*..))*!EG,<,>+?qAAr0otherc$|j|Sradd_path)rrs r. __truediv__zUrl.__truediv__\s}}U##r0othersc |j|Srr)rrs r. __floordiv__zUrl.__floordiv___st}}f%%r0paramsc$|j|Sr)add_qs)rrs r.__and__z Url.__and__bs{{6""r0cT|s td|j}|jr td|Dcgc] }t |}}|j r+|j d|j jd|jdj|Scc}w)a Build a copy of this URL with additional path segments. >>> url = Url('http://example.com') >>> url.add_path("a", "b", "c") Url('http://example.com/a/b/c') The shorthand ``/`` has the same effect and can be used with a single path segment. The shorthand ``//`` can be used with an iterable of path segments. >>> url / "a" / "b" / "c" Url('http://example.com/a/b/c') >>> url // ["a", "b", "c"] Url('http://example.com/a/b/c') z)add_path() requires at least one argumentz%cannot add path segments after paramsr/)path) rrquery ValueErrorrRrinsertr replace_urljoin)rrparsedrpartss r.rz Url.add_pathes GH H <<DE E)/0U0 ;; LLFKK..s3 4SXXe_551sB% other_paramsc D|s |s td|in|}|j||j}tjj |j }|j||jtjj|dS)ag Build a copy of this URL with additional query parameters. The shorthand ``&`` has the same effect. >>> url = Url('http://example.com') >>> url.add_qs({"a": 1}, b=[2, 3, 4]) Url('http://example.com?a=1&b=2&b=3&b=4') >>> url & {"a": 1, "b": [2, 3, 4]} Url('http://example.com?a=1&b=2&b=3&b=4') z'add_qs() requires at least one argumentT)doseq)r) rupdaterrrparse_qsrr urlencode)rrrrqss r.rz Url.add_qss,EF F~6 l# \\ " "6<< 0 &fll&<&>> url = Url('http://example.com') >>> url.replace(scheme='https', path='/foo') Url('https://example.com/foo') r)rrr urlunparser_replace)rr^s r.rzUrl.replace_urls9~~fll556Ldkkm6L6L6Vv6VWXXr0r)rrreryrr ParseResultrrRrrrrr rr rrrrr __classcell__rs@r.rrEs + 00+ B#B$$$&8C=&T&#d38n##6 6$68,0Nc3h(NN  N0YCYDYr0rc~eZdZUdZeed<ded<d defdZdeded efd Z ded dffd Z e ded dfd Z xZ S) UrlBuildera| Utility for defining URL patterns within an Airtable API class. Each instance of UrlBuilder will inspect its own class attributes and modify them to reflect the actual URL that should be used based on the context (Table, Base, etc.) provided. The pattern for use in pyAirtable is: .. code-block:: python from functools import cached_property from pyairtable.utils import UrlBuilder class SomeObject: attr1: str attr2: int class _urls(UrlBuilder): url1 = "/path/to/{attr1}" url2 = "/path/to/{attr2}" urls = cached_property(_urls) ...which ensures the URLs are built only once and are accessible via ``.urls``, and have the ``SomeObject`` instance available as context, and build readable docstrings for the ``SomeObject`` class documentation. .. warning:: This class is intended for use within pyAirtable only, and is tailored to the type of documentation this library produces. Its behavior may change in the future in ways that are not suitable for other projects. contextrapiNc||_|j||_t|jj D]C\}}|j dst|ts(t|||j|Ey)Nr) r _find_apirrkrrlrSrQrRrn build_url)rrrr$s r.__init__zUrlBuilder.__init__sf >>'*/557KD%s#:eS+A D$u 5 68r0r$r^r%c d|vr8it|j|d|ji}|j|}|jj |S)N{r)rkr format_maprr)rr$r^rs r.rzUrlBuilder.build_urlsQ %<Ldll+LvLvt||LG$$W-Exx!!%((r0c d|jvs|jddrt | di|S t dt |j D}|jjddd}|j}|jjdd}d|d|d |d |d |d |d }t |j D]H\}}|d|jd|} t|tr |d| dz }4t|s@|d| dz }Jt||dy#t$rt | di|cYSwxYw)N.skip_docstringFc3HK|]\}}t|ts|ywr)rQr)rkvs r.rz/UrlBuilder.__init_subclass__..s!V.?FQ:aQTCUa.?s""rrrzURLs associated with :class:`~zf` can be accessed via ``.urls`` using the following syntax: .. code-block:: python >>> z = z(...) >>> z.urls.z Url('https://api.airtable.com/...') These properties are all instances of :class:`~pyairtable.utils.Url`.z::z .. autoattribute:: z :noindex:z .. automethod:: rrr)repopr__init_subclass__nextrkrl StopIterationrsplitrlowerr,rQrcallabler) clsr^ sample_urlparent_clsnameparent_modnameparent_varname docstringrprqqualnamers r.rzUrlBuilder.__init_subclass__s c&& &&**5Eu*M7,6v6 6 7Vd3ioo.?VVJ ))00a8;'--/77SA,^,r s #$ 77QQ&cN C4  CL Ct$ CxS)*KxKCK ) ) )&5x0&S&7S7T7'PC'P3'P0E'PT +hqk +s +x 7L + # s D ~e4 ^E 2 nU3 nU3 ^E 2 TQQ>HL%%C%%PT%GK%%3%t%t%S(A362BC8WQT]C ,hsAv.,<13E,. F# F(3- F8E#x}*<$=>49,1/ /D(3-'(/}os"#/dZY#ZYzdYdYN r0