o poi@sdZddlmZddlZddlZddlZddlmZm Z ddl m Z d=dd Z d>d d Z d?ddZd>ddZd@ddZdAddZdAddZdBddZdBd d!ZdCd%d&ZdDd*d+Ze fdEd-d.Zd/d0Zd1d2ZdFd5d6Zd7d8ZdGd;d<ZdS)Hz Utility methods for marshmallow.) annotationsN)MappingSequence)missingreturn"typing.TypeGuard[typing.Generator]cCst|p t|S)z%Return True if ``obj`` is a generator)inspectisgeneratorfunction isgeneratorobjr E/home/ubuntu/.local/lib/python3.10/site-packages/marshmallow/utils.py is_generator r!typing.TypeGuard[typing.Iterable]cCst|dr t|d pt|S)zAReturn True if ``obj`` is an iterable object that isn't a string.__iter__strip)hasattrrr r r ris_iterable_but_not_stringsrtyping.TypeGuard[Sequence]cCst|to t|ttf S)z9Return True if ``obj`` is a sequence that isn't a string.) isinstancerstrbytesr r r ris_sequence_but_not_stringsrcCst|o t|t S)zGReturn True if ``obj`` is a collection type, e.g list, tuple, queryset.)rrrr r r r is_collectionrrdatetime dt.datetimeboolcCs|jduo |j|duS)N)tzinfo utcoffset)rr r ris_aware"sr!value typing.Anyc Cs|dus|dur tdt|}|dkrtdztjj|tjjdjddWSty8}ztd|d}~wt yH}ztd|d}~ww) NTFzNot a valid POSIX timestampr)tzrzTimestamp is too largez"Error converting value to datetime) ValueErrorfloatdtr fromtimestamptimezoneutcreplace OverflowErrorOSError)r"excr r rfrom_timestamp(s  r0cCst|}t|dSNi)r'r0r"r r rfrom_timestamp_ms9s r3r'cCs t|s |jtjjd}|S)Nr%)r!r,r(r*r+ timestampr2r r rr4>sr4cCs t|dSr1)r4r2r r r timestamp_msGs r5val str | bytesrcCst|tr |d}t|S)Nzutf-8)rrdecoder)r6r r rensure_text_typeKs  r9dictlistlist[dict[str, typing.Any]]keycsfdd|DS)zExtracts a list of dictionary values from a list of dictionaries. :: >>> dlist = [{'id': 1, 'name': 'foo'}, {'id': 2, 'name': 'bar'}] >>> pluck(dlist, 'id') [1, 2] csg|]}|qSr r ).0dr<r r Yszpluck..r )r:r<r r?rpluckQsrA int | strcCs0t|tsd|vrt||d|St|||S)aHelper for pulling a keyed value off various types of objects. Fields use this method by default to access attributes of the source object. For object `x` and attribute `i`, this method first tries to access `x[i]`, and then falls back to `x.i` if an exception is raised. .. warning:: If an object `x` does not raise an exception when `x[i]` does not exist, `get_value` will never check the value `x.i`. Consider overriding `marshmallow.fields.Field.get_value` in this case. .)rint_get_value_for_keyssplit_get_value_for_keyr r<defaultr r r get_value_s  rJcCs<t|dkrt||d|Stt||d||dd|S)Nr)lenrGrE)r keysrIr r rrEos rEc CsHt|ds t|||Sz||WSttttfy#t|||YSw)N __getitem__)rgetattrKeyError IndexError TypeErrorAttributeErrorrHr r rrGws   rGdctdict[str, typing.Any]cCsdd|vr,|dd\}}||i}t|ts$td|d|d|t|||dS|||<dS)zSet a value in a dict. If `key` contains a '.', it is assumed be a path (i.e. dot-delimited string) to the value's location. :: >>> d = {} >>> set_value(d, 'foo.bar', 42) >>> d {'foo': {'bar': 42}} rCrKz Cannot set z in z due to existing value: N)rF setdefaultrdictr& set_value)rTr<r"headresttargetr r rrXs    rXcCst|s td|d|S)z@Check that an object is callable, else raise a :exc:`TypeError`.zObject z is not callable.)callablerRr r r rcallable_or_raisesr] dt.timedeltarDcCs|jd|jd|jS)zCompute the total microseconds of a timedelta. https://github.com/python/cpython/blob/v3.13.1/Lib/_pydatetime.py#L805-L807 iQi@B)daysseconds microsecondsr2r r rtimedelta_to_microsecondssrb)rr)rr)rr)rrrr)r"r#rr)r"rrr')r6r7rr)r:r;r<r)r<rB)rTrUr<rr"r#)r"r^rrD)__doc__ __future__rrr(rtypingcollections.abcrrmarshmallow.constantsrrrrrr!r0r3r4r5r9rArJrErGrXr]rbr r r rs0