o Ti9@shUddlmZddlZddlmZmZmZddlmZm Z m Z m Z m Z ddl mZmZmZmZmZddlmZddlmZmZmZmZmZmZmZmZmZdd lm Z dd l!m"Z"dd l#m$Z$m%Z%m&Z&m'Z'm(Z(m)Z)dd l*m+Z+dd l,m-Z-ddl.m/Z/m0Z0m1Z1ddlm2Z2ddl3m4Z4ddl5m6Z6m7Z7erddl8m9Z9gdZ:     d]d^d d!Z;e d"Zid%d$d%d%d%d#fdbd>d?Z? % $ % % % #dcddd@dAZ@eee ge fZAeeBe dBfge fZCdCeDdD<  dedfdIdJZEeee e fge fZF  dedgdNdOZGeGZHdPeDdQ<eIeed%fdhdVdWZJeJZKdPeDdX< didjdZd[ZLeLZMdPeDd\<dS)k) annotationsN)CallableIterableMapping) TYPE_CHECKINGAnyFinalLiteralTypeVar)NOTHING Attribute ConverterFactoryevolve) NoDefault) ANIES TypeAliasadapted_fieldsget_args get_origin is_annotatedis_bare is_bare_final is_generic)deep_copy_with)UnstructureHook)AttributeValidationNoteClassValidationErrorForbiddenExtraKeysErrorIterableValidationErrorIterableValidationNoteStructureHandlerNotFoundError)identity)SimpleStructureHook)AttributeOverridealready_generatingneutral)generate_mapping)generate_unique_filename)_annotated_override_or_defaultfind_structure_handler) BaseConverter)make_dict_structure_fn!make_dict_structure_fn_from_attrsmake_dict_unstructure_fn#make_dict_unstructure_fn_from_attrs make_hetero_tuple_unstructure_fnmake_iterable_unstructure_fnmake_mapping_structure_fnmake_mapping_unstructure_fnomit_if_default bool | Nonerename str | Noneomit struct_hook Callable[[Any, Any], Any] | None unstruct_hookCallable[[Any], Any] | Nonereturnr&cCst|||||S)zOverride how a particular field is handled. :param omit: Whether to skip the field or not. `None` means apply default handling. )r&)r6r8r:r;r=r@G/home/ubuntu/.local/lib/python3.10/site-packages/cattrs/gen/__init__.pyoverride5s rBTFTfrom_converterattrslist[Attribute]cltype[T] converterr- typevar_mapdict[str, Any]_cattrs_omit_if_defaultbool_cattrs_use_linecache_cattrs_use_alias bool | Literal['from_converter']_cattrs_include_init_falsekwargsCallable[[T], dict[str, Any]]c$ Ksd|j} i} g} g} i} |dkrt|dd}|D]}|j}||vr(||}nt|jt}|tkr6|||<|jr:q|jdurE|jsE|sEq|jdur^|sN|n|j }||kr]t ||d||<n|j}|j }d}|j duro|j }n_|jdur|j}t |tr|j|vr||j}n|j}nt|rt|st|st|||}|durt|r|j turt |j ts|j j}z |j|dd}Wnty|j}Ynwn|j}|tk}|sd|}|| |<|| |<|d |d }nd |}|tur|r|jdus|jrd |}t |tr#|j| |<|j| |<|jr|d n|d}n || |<|| |<|}|j}|durd|}t |tra|| |<|| |<d|}|| |<|| |<|d|d|d }n#t |trx|| |<|| |<|d|d }n ||| |<||| |<| d|d|d| d|d|q| d|d|dqd!dd| D}|rd|}| "D] \}}|| |<qd| d|d gd!gd"d| Dd#g| d$g} d%!| }!t#|d&|r| ngd'}"t$t%|!|"d(| | | }#||#_&|#S))a Generate a specialized dict unstructuring function for a list of attributes. Usually used as a building block by more specialized hook factories. Any provided overrides are attached to the generated function under the `overrides` attribute. :param cl: The class for which the function is generated; used mostly for its name, module name and qualname. :param _cattrs_omit_if_default: if true, attributes equal to their default values will be omitted in the result dictionary. :param _cattrs_use_alias: If true, the attribute alias will be used as the dictionary key by default. :param _cattrs_include_init_false: If true, _attrs_ fields marked as `init=False` will be included. .. versionadded:: 24.1.0 .. versionchanged:: 25.2.0 The `_cattrs_use_alias` parameter takes its value from the given converter by default. .. versionchanged:: 26.1.0 `typing.Annotated[T, override()]` is now recognized and can be used to customize unstructuring. .. versionchanged:: 26.1.0 When `_cattrs_omit_if_default` is true and the attribute has an attrs converter specified, the converter is applied to the default value before checking if it is equal to the attribute's value. unstructure_rD use_aliasFNr8 cache_result __c_unstr_z (instance.) instance.__c_def_z (instance)z() __c_conv_ __c_field_(z , instance, z if instance.z != : res[''] = 'z': ,, cSg|] }|d|qS=r@.0ir@r@rA z7make_dict_unstructure_fn_from_attrs..def z (instance): res = {cSg|]}d|qSz r@rjliner@r@rArlz } return res unstructurelinesexec)'__name__getattrnamer+typer(r:initr8aliasrdefaultr= isinstancer rxrrrrrr r __class__get_unstructure_hookRecursionErrorr#r6factory takes_selfrIr appendjoinitemsr*evalcompile overrides)$rErGrIrJrLrNrOrQrRfn_nameglobsrzinvocation_linesinternal_arg_partsa attr_namerBkndhandlert is_identityunstruct_handler_nameinvokedef_namedef_strc conv_name field_nameinternal_arg_linekv total_linesscriptfnameresr@r@rAr1Fs )                                  r1c Kst|}t|p|}i} |dkrt|dd}t|r%t|| } |dur%|}ztj} Wnty9t} | t_Ynw|| vrAt | |zt |||| f||||d|W| || sat`SS| || skt`w)a Generate a specialized dict unstructuring function for an attrs class or a dataclass. Any provided overrides are attached to the generated function under the `overrides` attribute. :param _cattrs_omit_if_default: if true, attributes equal to their default values will be omitted in the result dictionary. :param _cattrs_use_alias: If true, the attribute alias will be used as the dictionary key by default. :param _cattrs_include_init_false: If true, _attrs_ fields marked as `init=False` will be included. .. versionadded:: 23.2.0 *_cattrs_use_alias* .. versionadded:: 23.2.0 *_cattrs_include_init_false* .. versionchanged:: 25.2.0 The `_cattrs_use_alias` parameter takes its value from the given converter by default. .. versionchanged:: 26.1.0 `typing.Annotated[T, override()]` is now recognized and can be used to customize unstructuring. rDrUFN)rLrNrOrQ) rrr}rr)r' working_setAttributeErrorsetraddr1remove) rGrIrLrNrOrQrRoriginrEmappingrr@r@rAr0sN          r0_cattrs_forbid_extra_keys _cattrs_prefer_attrib_converters_cattrs_detailed_validation)SimpleStructureHook[Mapping[str, Any], T]c , KsV |j} d| } t|ddD]=} z|| j}Wnty*| j}td|d| dwt|ddp4t|}tdd |}td d |}| d |7} q d |i}i}g}g}g}g}t}|d krft|dd}|d krpt|dd}|d krw|j}|d kr~|j }|r||d<t |d<|r| d| d| dt |d<t |d<|D]}|j}|| vr| |}nt|jt}|tkr|| |<|jrq|jdur|js| sq|j}t|tr||j|}nt|rt|st|st|||}|jdur|j}nt||||}d|}|dur|||<|j}|jdur/|s|n|j}||kr.t||d| |<n|j}| |d} |js|j!t"urS| | d|d| d} | | d| d} d|}!|||!<|dur||j#kr|||<| | d|d |d!|d"n,d|}"|||"<| | d|d |d!|d#|"d$ n| | d|d%|d&| dd'} | | d(| d} | | d)|j$d*|d+|d,|d- | | d.q|j!t"ur| | d|d| d} | | d| d} d|}!|||!<|rG||j#kr2|||<| | d/|d0|d!|d"n#| | d/|d0|d!|d#|!d$ n| | d/|d1|d&| dd'} | | d(| d} | | d)|j$d*|d+|d,|d- | | d.q|r|gd27}| d3| d4|sd5gd6gd7d8|Dd9gd:| d;g}#nd5gdng}$|D]9}|j}|| vr| |}nt|jt}|tkr|| |<|jrq|jdur |js | s q|j!t"ur|$ |q|j}t|tr(||j|}nt|r=t|s=t|s=t|||}|jdurG|j}nt||||}|jdurj|sY|n|j}||krit||d| |<n|j}| ||js|durd|}|||<||j#kr|||<d?|d |d!|d"}%n"d|}"|||"<d?|d |d!|d#|"d$ }%n d?|d%|d&}%| |%q|rd|}|||<||j#kr|||<|d!|d@}&nd|}"|||"<|d!|d#|"dA}&ndB|dC}&|j%r |jdD|&}&| |&q|$r;| d| d|$D]}|j}| |t}|j}t|tr=||j|}nt|rRt|sRt|sRt|||}|jdur\|j}nt||||}d|}|||<|jdur|sw|n|j}||krt||d| |<n|j}| ||js| dE|d|r||j#kr|||<| dF|d |d!|d"q d|}"|||"<| dF|d |d!|d#|"d$ q | dF|d%|d&q | dE|d|r,||j#kr|||<| dG|jd0|d!|d"q d|}"|||"<| dG|jd0|d!|d#|"d$ q | dG|jd1|d&q |sLdHgdId8|DdJg}#ndKgdLd8|DdJg}#| d>|rg|gdM7}dN&dOd8|D}'|'|dP| dQ|'dRg|||#|}(dS&|(})t(|dT|r|(ngdU}*t)t*|)|*dV||| }+| |+_+|+S)Wa Generate a specialized dict structuring function for a list of attributes. Usually used as a building block by more specialized hook factories. Any provided overrides are attached to the generated function under the `overrides` attribute. :param _cattrs_forbid_extra_keys: Whether the structuring function should raise a `ForbiddenExtraKeysError` if unknown keys are encountered. :param _cattrs_use_linecache: Whether to store the source code in the Python linecache. :param _cattrs_prefer_attrib_converters: If an _attrs_ converter is present on a field, use it instead of processing the field normally. :param _cattrs_detailed_validation: Whether to use a slower mode that produces more detailed errors. :param _cattrs_use_alias: If true, the attribute alias will be used as the dictionary key by default. :param _cattrs_include_init_false: If true, _attrs_ fields marked as `init=False` will be included. .. versionadded:: 24.1.0 .. versionchanged:: 25.2.0 The `_cattrs_use_alias` parameter takes its value from the given converter by default. .. versionchanged:: 26.1.0 `typing.Annotated[T, override()]` is now recognized and can be used to customize unstructuring. structure___parameters__r@z"Missing type for generic argument z, specify it when structuring.Nr|z [\[\.\] ,<>]_z\|u__clrDforbid_extra_keysFrU__c_a__c_fekez res = {}z errors = []z**res,__c_cve__c_avn__c_structure_rVz zif 'z' in o:ztry: __c_type_r[z = z(o['z'])z'], rZz = o['z']zexcept Exception as e:zHe.__notes__ = getattr(e, '__notes__', []) + [__c_avn("Structuring class z @ attribute z", "z ", __c_type_z)]zerrors.append(e)zres['rbz'] = o[')( unknown_fields = set(o.keys()) - __c_a if unknown_fields:z5 errors.append(__c_feke('', __cl, unknown_fields))z2 if errors: raise __c_cve('While structuring ' + z, errors, __cl)z try:z return __cl(cSrqz r@rsr@r@rArlruz5make_dict_structure_fn_from_attrs.. )z@ except Exception as exc: raise __c_cve('While structuring ' + z, [exc], __cl)z instance = __cl(cSrqrr@rsr@r@rArl'ruz return instancez instance.z']),z),zo['z'],rhz if 'z instance.raz return __cl(cSrqrrr@rsr@r@rArlruz )z instance = __cl(cSrqrrr@rsr@r@rArlru)rrz, raise __c_feke('', __cl, unknown_fields)recSrfrgr@rir@r@rArlrmrnz (o, _=__cl, rorw structureryr{),r|r}KeyErrorr"strresubrdetailed_validation_prefer_attrib_convertersrrrrr~r+rr(r:rrr getrrrrr;r,rr8rrrr _structure_call __qualname__kw_onlyrupdater*rrr),rErGrIrJrrNrrrOrQrRcl_namerp name_basepnr~rrrz post_linespi_linesrallowed_fieldsranrBrrstruct_handler_nameianrrk type_nametninstantiation_lines non_requiredpi_lineinvocation_linerrrrrr@r@rAr/HsZ-                            "        "                                                  r/c Ksi} t|rt|} t|| } | dur| }t|ddD]} t| r/t| ds/t| | } nqt|} ztj} Wnt yHt } | t_Ynw|| vrPt | |zt | ||| f||||||d|W| || srt`SS| || s|t`w)av Generate a specialized dict structuring function for an attrs class or dataclass. Any provided overrides are attached to the generated function under the `overrides` attribute. :param _cattrs_forbid_extra_keys: Whether the structuring function should raise a `ForbiddenExtraKeysError` if unknown keys are encountered. :param _cattrs_use_linecache: Whether to store the source code in the Python linecache. :param _cattrs_prefer_attrib_converters: If an _attrs_ converter is present on a field, use it instead of processing the field normally. :param _cattrs_detailed_validation: Whether to use a slower mode that produces more detailed errors. :param _cattrs_use_alias: If true, the attribute alias will be used as the dictionary key by default. :param _cattrs_include_init_false: If true, _attrs_ fields marked as `init=False` will be included. .. versionadded:: 23.2.0 *_cattrs_use_alias* .. versionadded:: 23.2.0 *_cattrs_include_init_false* .. versionchanged:: 23.2.0 The `_cattrs_forbid_extra_keys` and `_cattrs_detailed_validation` parameters take their values from the given converter by default. .. versionchanged:: 24.1.0 The `_cattrs_prefer_attrib_converters` parameter takes its value from the given converter by default. .. versionchanged:: 25.2.0 The `_cattrs_use_alias` parameter takes its value from the given converter by default. .. versionchanged:: 26.1.0 `typing.Annotated[T, override()]` is now recognized and can be used to customize unstructuring. N__orig_bases__r@ztyping.Generic)rrNrrrOrQ)rrr)r}r startswithrr'rrrrrr/r) rGrIrrNrrrOrQrRrbaserErr@r@rAr.sX1         r..rHeteroTupleUnstructureFnrunstructure_to type_args tuple | Nonec sd}|dur t|n|}fdd|D}ddt|D}|tur(|p%||d<g}|d|d |tur=|d n|d tt|D]}||tkrZ|d |d qH|d|d|dqH|turq|dn|dg|d} ttd | dd|||S)zGenerate a specialized unstructure function for a heterogenous tuple. :param type_args: If provided, override the type arguments. unstructure_tupleNcsg|]}|qSr@)r)rjtype_argrIr@rArlhruz4make_hetero_tuple_unstructure_fn..cSsi|] \}}d||qS) __cattr_u_r@)rjrkhr@r@rA jsz4make_hetero_tuple_unstructure_fn..__cattr_seq_clrnz(tup):z res = __cattr_seq_cl((z res = (z tup[z],z __cattr_u_z(tup[z]),z ))r return resrwr{) r enumeratetuplerrangelenr#rrr) rGrIrrrhandlersrrzrkrr@rrAr2Ys*        r2 key_handler'Callable[[Any, Any | None], Any] | NoneMappingUnstructureFncCs^|p|j}|j}d}|}t|dddurHt|}t|dkr#|\} } n|t} } |p0|j| dd}|tkr7d}|j| dd}|tkrDd}t|}||d} |durSdnd } |dur[d nd } d |d g}|tusp|dur|tur|durz|durztS| d| d| dn|p|| d<| d| d| dg|d}t t d |dd| | |S)zGenerate a specialized unstructure function for a mapping. :param unstructure_to: The class to unstructure to; defaults to the same class as the mapping being unstructured. unstructure_mapping__args__NrFrW) __cattr_k_u __cattr_v_uz__cattr_k_u(k)rz__cattr_v_u(v)rrnz (mapping):z return {:  for k, v in mapping.items()}__cattr_mapping_clz res = __cattr_mapping_cl((rez) for k, v in mapping.items())rrwrr{) rxr}rrrrr#rdictrrrr)rGrIrrkh val_handlerrrargskey_argval_argrk_uv_urzr@r@rAmapping_unstructure_factorys>       rrr5 structure_torr)SimpleStructureHook[Mapping[Any, Any], T]cCsd}|dkr |j}d|i}g}i} t|st|} t| dkr0| \} } |tur)| }|tur/| }n|tur<|tur<| \}n|turH|turH| \}n| \}t}|tvoT|tv} | s|j|dd}||jkre|}|j|dd}||jkrs|}||d<||d<||d <||d <||krd nd }||krd nd}nd} | r| dn|rt | d<t | d<|tur|nt| d<|tur|nt| d<t |d<| d| d| d| d|| d| d| d| d| d| d|| d| d| d | d| d!| d"t |d#n | d$|d%|d&|tur4| d'd(d)d*| D}|rFd(|}| D] \}}|||<qJ||d+<d,|d-|d.}|g|d/}d0|}tt|d1d2|||S)3z8Generate a specialized structure function for a mapping.structure_mappingrDrrFrW __cattr_k_t __cattr_v_t __cattr_k_s __cattr_v_sz__cattr_k_s(k, __cattr_k_t)z__cattr_k_s(k)z__cattr_v_s(v, __cattr_v_t)z__cattr_v_s(v)Tz res = dict(mapping)r r!val_typekey_typerz res = {}; errors = []z for k, v in mapping.items():z try:z value = z except Exception as e:z e.__notes__ = getattr(e, '__notes__', []) + [IterableValidationNote(f'Structuring mapping value @ key {k!r}', k, val_type)]z errors.append(e)z continuez key = z res[key] = valuez e.__notes__ = getattr(e, '__notes__', []) + [IterableValidationNote(f'Structuring mapping key @ key {k!r}', k, key_type)]z if errors:z9 raise IterableValidationError('While structuring ' + z, errors, __cattr_mapping_cl)rprrz res = __cattr_mapping_cl(res)recSrfrgr@rir@r@rArl8rmz-mapping_structure_factory..rGrnz(mapping, cl=clrorvrwrr{)rrrrr rrget_structure_hookrrr r!rreprrrrrr)rGrIrrrrrrrzrr key_arg_cand val_arg_cand is_bare_dictrrk_sv_srrrdef_linerrr@r@rAmapping_structure_factorys                     rr4rcCsv|j}t|dddvr0|jd}t|tr!t|dt}|tur!t}|j|dd}|tkr0|p/|S|p3||fdd }|S) zA hook factory for unstructuring iterables. :param unstructure_to: Force unstructuring to this type, if provided. .. versionchanged:: 24.2.0 `typing.NoDefault` is now correctly handled as `Any`. rN)Nr@r __default__FrWcs|fdd|DS)Nc3s|]}|VqdSNr@ri_hookr@rA gszMiterable_unstructure_factory..unstructure_iterable..r@)iterable_seq_clrr@rrAunstructure_iterablefsz:iterable_unstructure_factory..unstructure_iterable) rxr}rrr rrrr#)rGrIrrrr!r@r@rAiterable_unstructure_factoryLs    r"r3)NNNNN) r6r7r8r9r:r7r;r<r=r>r?r&)rErFrGrHrIr-rJrKrLrMrNrMrOrPrQrMrRr&r?rS)FTrDF)rGrHrIr-rLrMrNrMrOrPrQrMrRr&r?rS)rErFrGrHrIr-rJrKrrPrNrMrrPrrPrOrPrQrMrRr&r?r)rDTrDrDrDF)rGrHrIr-rrPrNrMrrPrrPrOrPrQrMrRr&r?r)NN) rGrrIr-rrrrr?r) rGrrIr-rrrrr?r) rGrHrIr-rrrrPr?r r)rGrrIr-rrr?r)N __future__rrcollections.abcrrrtypingrrrr r rEr r r rrtyping_extensionsr_compatrrrrrrrrr _genericsrdispatchrerrorsrrrr r!r"fnsr#typesr$_constsr&r'r(r)_lcr*_sharedr+r, convertersr-__all__rBrCr1r0r/r.IterableUnstructureFnrr__annotations__r2rrr5rrr4r"r3r@r@r@rAs ,          ; O 0 ` - > |