U i7gn.@sdZddlmZddlZddlZddlZddlZddlZddl Z ddl Z ddl Z ddl m Z ddlmZmZddlmZddlmZddlmZdd lmZd Zd Zd ZeeehZGd ddZeZddddZddddZ ddddZ!ddddZ"ddddZ#ddddZdddd d!Z$d"dd#d$d%Z%dd"dd&d'Z&e 'd(Z(e 'd)Z)e 'd*Z*d+d,d-d.d/Z+d0d1Z,d2d3Z-d4d5Z.d6dd7d8d9Z/d6dd7d:d;Z0ddZ1dddhdiZ?djdkd7dldmZ@d6d"dndodpZAdS)qz Utility methods for marshmallow.) annotationsN)Mapping)format_datetimeparsedate_to_datetime)pprint)FieldABC)FieldInstanceResolutionError)RemovedInMarshmallow4Warningexcludeincluderaisec@s,eZdZddZddZddZddZd S) _MissingcCsdS)NFselfrr5/tmp/pip-unpacked-wheel-o_a6af_p/marshmallow/utils.py__bool__sz_Missing.__bool__cCs|SNrrrrr__copy__sz_Missing.__copy__cCs|Srr)r_rrr __deepcopy__"sz_Missing.__deepcopy__cCsdS)Nzrrrrr__repr__%sz_Missing.__repr__N)__name__ __module__ __qualname__rrrrrrrrr sr bool)returncCst|pt|S)z%Return True if ``obj`` is a generator)inspectisgeneratorfunction isgeneratorobjrrr is_generator/sr"cCst|drt|d pt|S)zAReturn True if ``obj`` is an iterable object that isn't a string.__iter__strip)hasattrr"r rrris_iterable_but_not_string4sr&cCst|ot|t S)zGReturn True if ``obj`` is a collection type, e.g list, tuple, queryset.)r& isinstancerr rrr is_collection9sr(cCs0z t||WStk r*t||YSXdS)zFReturn True if ``val`` is either a subclass or instance of ``class_``.N) issubclass TypeErrorr')valclass_rrris_instance_or_subclass>s r-cCst|tot|dS)zjReturn True if ``obj`` has keyed tuple behavior, such as namedtuples or SQLAlchemy's KeyedTuples. _fields)r'tupler%r rrris_keyed_tupleFsr0NonecOsHtjdtddt|tjr4ttj|f||nt |f||dS)zPretty-printing function that can pretty-print OrderedDicts like regular dictionaries. Useful for printing the output of :meth:`marshmallow.Schema.dump`. .. deprecated:: 3.7.0 marshmallow.pprint will be removed in marshmallow 4. zQmarshmallow's pprint function is deprecated and will be removed in marshmallow 4.) stacklevelN) warningswarnr r' collections OrderedDictprintjsondumps py_pprint)r!argskwargsrrrrMs rz dt.datetime)datetimercCs|jdk o|j|dk Sr)tzinfo utcoffsetr>rrris_awareasrBstr) datestringrcCst|S)zParse a RFC822-formatted datetime string and return a datetime object. https://stackoverflow.com/questions/885015/how-to-parse-a-rfc-2822-date-time-into-a-python-datetime # noqa: B950 )r)rDrrrfrom_rfcgsrEcCst|S)zrReturn the RFC822-formatted representation of a datetime object. :param datetime datetime: The datetime. )rrArrr rfcformatosrFz(?P\d{4})-(?P\d{1,2})-(?P\d{1,2})[T ](?P\d{1,2}):(?P\d{1,2})(?::(?P\d{1,2})(?:\.(?P\d{1,6})\d{0,6})?)?(?PZ|[+-]\d{2}(?::?\d{2})?)?$z4(?P\d{4})-(?P\d{1,2})-(?P\d{1,2})$zd(?P\d{1,2}):(?P\d{1,2})(?::(?P\d{1,2})(?:\.(?P\d{1,6})\d{0,6})?)?zint | float | dt.timedeltaz dt.timezone)offsetrcCsVt|tjr|d}|dkr$dnd}dtt|d}||}ttj|d|S)z6Return a tzinfo instance with a fixed offset from UTC.<r-+z%02d%02d)minutes)r'dt timedelta total_secondsdivmodabstimezone)rGsignZhhmmnamerrrget_fixed_timezones   rTcCst|}|std|}|do4|ddd|d<|d}|dkrVtjj}nZ|dk rt |dkrzt |d dnd }d t |d d|}|d d kr| }t |}dd| D}||d<tj f|S)zParse a string and return a datetime.datetime. This function supports time zone offsets. When the input contains one, the output uses a timezone with a fixed offset from UTC. z-Not a valid ISO8601-formatted datetime string microsecond0r?ZNrrHrIcSs"i|]\}}|dk r|t|qSrint.0kvrrr sz%from_iso_datetime..)_iso8601_datetime_rematch ValueError groupdictljustpoprLrQutclenr]rTitemsr>)valuerdkwr?Z offset_minsrGrrrfrom_iso_datetimes"     rncCsXt|}|std|}|do4|ddd|d<dd|D}tjf|S)zeParse a string and return a datetime.time. This function doesn't support time zone offsets. z)Not a valid ISO8601-formatted time stringrUrVrWcSs"i|]\}}|dk r|t|qSrr\r^rrrrbsz!from_iso_time..)_iso8601_time_rerdrerfrgrkrLtimerlrdrmrrr from_iso_times rrcCs8t|}|stddd|D}tjf|S)z*Parse a string and return a datetime.date.z)Not a valid ISO8601-formatted date stringcSsi|]\}}|t|qSrr\r^rrrrbsz!from_iso_date..)_iso8601_date_rerdrerfrkrLdaterqrrr from_iso_dates  ruz typing.Any)rlrc Cs|dks|dkrtdt|}|dkr0tdztjj|tjjdjddWStk rz}ztd|W5d}~XYn,t k r}ztd|W5d}~XYnXdS) NTFzNot a valid POSIX timestampr)tzr?zTimestamp is too largez"Error converting value to datetime) refloatrLr> fromtimestamprQrireplace OverflowErrorOSError)rlexcrrrfrom_timestampsr~cCst|}t|dSNi)rxr~rlrrrfrom_timestamp_mssrrxcCs t|s|jtjjd}|S)Nrw)rBrzrLrQri timestamprrrrrsrcCs t|dSr)rrrrr timestamp_mssrcCs|S)zsReturn the ISO8601-formatted representation of a datetime object. :param datetime datetime: The datetime. ) isoformatrArrrrsrzdt.time)rprcCs tj|Sr)rLrpr)rprrr to_iso_timesrzdt.date)rtrcCs tj|Sr)rLrtr)rtrrr to_iso_datesrz str | bytes)r+rcCst|tr|d}t|S)Nzutf-8)r'bytesdecoderC)r+rrrensure_text_types  rzlist[dict[str, typing.Any]]Zdictlistkeycsfdd|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|] }|qSrr)r_drrr szpluck..rrrrrplucksrz int | strrcCs4t|ts$d|kr$t||d|St|||SdS)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. .N)r'r]_get_value_for_keyssplit_get_value_for_keyr!rdefaultrrr get_value s rcCs@t|dkrt||d|Stt||d||dd|SdS)Nr[r)rjrr)r!keysrrrrrs  rc CsNt|dst|||Sz ||WSttttfk rHt|||YSXdS)N __getitem__)r%getattrKeyError IndexErrorr*AttributeErrorrrrrr#s    rzdict[str, typing.Any])dctrrlcCsbd|krV|dd\}}||i}t|tsHtd|d|d|t|||n|||<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}} rr[z Cannot set z in z due to existing value: N)r setdefaultr'dictre set_value)rrrlheadresttargetrrrr-s   rcCst|std|d|S)z@Check that an object is callable, else raise a :exc:`TypeError`.Object z is not callable.)callabler*r rrrcallable_or_raiseDsrztyping.Callablez list[str])funcrcCstt|jSr)listr signature parametersrrrrr _signatureKsrcCs:t|st|rt|St|tjr2t|jSt|S)zGiven a callable, return a list of argument names. Handles `functools.partial` objects and class-based callables. .. versionchanged:: 3.0.0a1 Do not return bound arguments, eg. ``self``. )r isfunctionismethodrr' functoolspartialrrrrr get_func_argsOs   rcCs4t|trt|tst|St|ts,t|SdS)zReturn a Schema instance from a Schema class or instance. :param type|Schema cls_or_instance: Marshmallow Schema class or instance. N)r'typer)rr)Zcls_or_instancerrrresolve_field_instance^s   rz dt.timedeltar]cCs|jd|jd|jS)zCompute the total microseconds of a timedelta https://github.com/python/cpython/blob/bb3e0c240bc60fe08d332ff5955d54197f79751c/Lib/datetime.py#L665-L667 # noqa: B950 iQi@B)daysseconds microsecondsrrrrtimedelta_to_microsecondsmsr)r!rcCs|tkrtd|d|S)Nrz1 is not a valid value for the 'unknown' parameter)_UNKNOWN_VALUESrer rrr validate_unknown_parameter_valueus  r)B__doc__ __future__rr6r>rLrrr9retypingr4collections.abcr email.utilsrrrr;Zmarshmallow.baserZmarshmallow.exceptionsrZmarshmallow.warningsr ZEXCLUDEZINCLUDEZRAISErr missingr"r&r(r-r0rBrErFcompilercrsrorTrnrrrur~rrrrrrrrrrrrrrrrrrrrrrsx