gojddlmZddlZddlZddlZddlZddlZddlZddlZddl Z ddl Z ddl Z ddl Z ddl mZddlmZmZmZddlmZmZmZmZmZmZddlmZmZmZmZejZ dZ!d Z"d Z#e j$iZ%eZ&ej'ej(ej)Z*Gd d ej+Z,e,j-Z- Gd de.Z/e-ddddddddddddddfdZ0dldZ1dmdZ2dZ3e3dgdZ4dZ5dZ6dZ7dZ8dZ9dZ:dZ;dZd#Z?d$Z@ dnd%ZA dod&ZBeBZC d'ZDd(ZEd)ZFd*ZGd+ZHd,ZId-ZJdmd.ZKd/ZLdpd0ZMd1ZNd2ZOd3Z)d4ZPd5ZQdqd<ZRdrd?ZSdsdAZTdrdBZUdtdGZVdudUZWdvdWZXGdXdYZYdZeYjZDZ[eGeKeMeYe[[d\e[D[d]e[D[ZYGd^d_Z\eKeMe\Z\Gd`daZ]dbe]jZDZ^eGeKeMe]e^[e^[e^[Z]Gdcd>Z_dddeDZ^eGeKeMe_e^[e^[e^[Z_efdfdfZ`eBddgGdhdiZadjZbdkZ'dS)w) annotationsN) itemgetter)_compat_configsetters) PY_3_10_PLUS PY_3_11_PLUS PY_3_13_PLUS_AnnotationExtractor_get_annotationsget_generic_base)DefaultAlreadySetErrorFrozenInstanceErrorNotAnAttrsClassErrorUnannotatedAttributeErrorz__attr_factory_%s)ztyping.ClassVarz t.ClassVarClassVarztyping_extensions.ClassVar_attrs_cached_hashc<eZdZdZejZdZdZdS)_NothingaF Sentinel to indicate the lack of a value when `None` is ambiguous. If extending attrs, you can use ``typing.Literal[NOTHING]`` to show that a value may be ``NOTHING``. .. versionchanged:: 21.1.0 ``bool(NOTHING)`` is now False. .. versionchanged:: 22.2.0 ``NOTHING`` is now an ``enum.Enum`` variant. cdS)NNOTHINGselfs V/var/www/html/nodeJS/PythonScripts/venv3.11/lib/python3.11/site-packages/attr/_make.py__repr__z_Nothing.__repr__IsycdS)NFrrs r__bool__z_Nothing.__bool__LsurN) __name__ __module__ __qualname____doc__enumautorrr rrrrr<sKdikkGrrc0eZdZdZeddfdZdS)_CacheHashWrappera An integer subclass that pickles / copies as None This is used for non-slots classes with ``cache_hash=True``, to avoid serializing a potentially (even likely) invalid hash value. Since `None` is the default value for uncalculated hashes, whenever this is copied, the copy's value for the hash should automatically reset. See GH #613 for more details. Nrc ||fSNr)r_none_constructor_argss r __reduce__z_CacheHashWrapper.__reduce__ds  %''r)r!r"r#r$typer-rrrr(r(XsA  ,04::R((((((rr(TFcht|| | d\} }} }||dur|durd}t|| I|turd}t|t | sd}t|t | }|i}t | ttfrtj | } |r%t |ttfr t|}|r%t |ttfr t|}tdid|d|d |d dd |d |d |d|d|d| d| d|d| d|d| d|S)a Create a new field / attribute on a class. Identical to `attrs.field`, except it's not keyword-only. Consider using `attrs.field` in new code (``attr.ib`` will *never* go away, though). .. warning:: Does **nothing** unless the class is also decorated with `attr.s` (or similar)! .. versionadded:: 15.2.0 *convert* .. versionadded:: 16.3.0 *metadata* .. versionchanged:: 17.1.0 *validator* can be a ``list`` now. .. versionchanged:: 17.1.0 *hash* is `None` and therefore mirrors *eq* by default. .. versionadded:: 17.3.0 *type* .. deprecated:: 17.4.0 *convert* .. versionadded:: 17.4.0 *converter* as a replacement for the deprecated *convert* to achieve consistency with other noun-based arguments. .. versionadded:: 18.1.0 ``factory=f`` is syntactic sugar for ``default=attr.Factory(f)``. .. versionadded:: 18.2.0 *kw_only* .. versionchanged:: 19.2.0 *convert* keyword argument removed. .. versionchanged:: 19.2.0 *repr* also accepts a custom callable. .. deprecated:: 19.2.0 *cmp* Removal on or after 2021-06-01. .. versionadded:: 19.2.0 *eq* and *order* .. versionadded:: 20.1.0 *on_setattr* .. versionchanged:: 20.3.0 *kw_only* backported to Python 2 .. versionchanged:: 21.1.0 *eq*, *order*, and *cmp* also accept a custom callable .. versionchanged:: 21.1.0 *cmp* undeprecated .. versionadded:: 22.2.0 *alias* TNF6Invalid value for hash. Must be True, False, or None.z=The `default` and `factory` arguments are mutually exclusive.z*The `factory` argument must be a callable.default validatorreprcmphashinit convertermetadatar.kw_onlyeqeq_keyorder order_key on_setattraliasr) _determine_attrib_eq_order TypeErrorr ValueErrorcallableFactory isinstancelisttuplerpipeand_ _CountingAttr)r1r2r3r4r5r6r8r.r7factoryr9r:r<r>r?r;r=msgs rattribrMhsn$> R$$ By D,,U1B1BFnn ' ! !O S// !   ">CS// !'""*tUm,,/\:. %Z D%=99%)$ %Z D%=99%)$     ) T  D   T   T  )  T   2 v e ) :  e! rcJt||d}t|||dS)z[ Evaluate the script with the given global (globs) and local (locs) variables. execN)compileeval)scriptglobslocsfilenamebytecodes r_compile_and_evalrXs- vx00H5$rc|in|}d}|} t|d|d|f}tj||} | |krn|ddd|d}|dz }ct ||||||S)zO Create the method with the script given and return the method object. NrT->)len splitlines linecachecache setdefaultrX) namerSrVrTlocalsrUcount base_filenamelinecache_tupleold_vals r _make_methodrhs22VD EM  KK    d # #    /,,XGG o % % #CRC(335333   feT8444 :rc"|d}d|ddg}|r2t|D]!\}}|d|d|d"n|dttd }t d ||||S) z Create a tuple subclass to hold `Attribute`s for an `attrs` class. The subclass is a bare tuple with properties for names. class MyClassAttributes(tuple): __slots__ = () x = property(itemgetter(0)) Attributeszclass z(tuple):z __slots__ = () z% = _attrs_property(_attrs_itemgetter())z pass)_attrs_itemgetter_attrs_property ) enumerateappendrpropertyrXjoin)cls_name attr_namesattr_class_nameattr_class_templatei attr_namerTs r_make_attr_tuple_classrzs"---O****/%j11  LAy  & &LyLLqLLL      "":...", J JEdii 344e<<<  !!r _Attributes)attrs base_attrsbase_attrs_mapct|}|dr|dr |dd}|tS)z Check whether *annot* is a typing.ClassVar. The string comparison hack is used to avoid evaluating all string annotations which would put attrs-based classes at a performance disadvantage compared to plain old classes. )'"rrZ)str startswithendswith_CLASSVAR_PREFIXES)annots r _is_class_varr#s\ JJE  ##z(B(Bad    . / //rc||jvS)zR Check whether *cls* defines *attrib_name* (and doesn't just inherit it). )__dict__)cls attrib_names r_has_own_attributer4s #, &&rcg}i}t|jddD]\}t|dgD]H}|js |j|vr|d}|||||j<I]g}t}t|D]<}|j|vr |d|| |j=||fS)zQ Collect attr.ibs from base classes of *cls*, except *taken_attr_names*. rrZ__attrs_attrs__T inheritedr) reversed__mro__getattrrrbevolverqsetinsertadd)rtaken_attr_namesr} base_attr_mapbase_clsafilteredseens r_collect_base_attrsr;sJMS[2.//--#4b99 - -A{ af(8884((A   a $,M!& ! !  -H 55D j ! ! 6T>> 1  ] ""rcg}i}|jddD]o}t|dgD][}|j|vr |d}||j|||||j<\p||fS)a- Collect attr.ibs from base classes of *cls*, except *taken_attr_names*. N.B. *taken_attr_names* will be mutated. Adhere to the old incorrect behavior. Notably it collects from the front and considers inherited attributes which leads to the buggy behavior reported in #428. rrZrTr)rrrbrrrq)rrr}rrrs r_collect_base_attrs_brokenrZsJMK"%--#4b99 - -Av)))4((A   ( ( (   a $,M!& ! ! - } $$rc T|jt||#t|}na|dur.dD}g}t }D]\} } t | r|| | t} t| ts'| turtnt| } | | | f||z } t| dkr:tddt!| fd zd zn.t!d Dd }fd |D} |rt#|d| D\}}nt%|d| D\}}|rd| D} d|D}|| z}d}d|DD]<} |dur"| jturd| }t)||dur| jturd}=| |||}d|D}d|D}t+|j|}t/||||fS)a3 Transform all `_CountingAttr`s on a class into `Attribute`s. If *these* is passed, use that and don't look for them on the class. If *collect_by_mro* is True, collect them in the correct MRO order, otherwise use the old -- incorrect -- order. See #428. Return an `_Attributes`. NTcBh|]\}}t|t|SrrErJ.0rbattrs r z#_transform_attrs..s<   d$ ..    rr1rz1The following `attr.ib`s lack a type annotation: , c8|jSr*)getcounter)ncds rz"_transform_attrs..sbffQii6Gr)key.c3NK|] \}}t|t||fV!dSr*rrs r z#_transform_attrs..sN  D$dM22 t       rc|djSNr)r)es rrz"_transform_attrs..s !A$,rc vg|]5\}}t|||6S))rbcar.) Attributefrom_counting_attrr)rryrannss r z$_transform_attrs..sW Ir $$r(;(; %  rch|] }|j Srrbrrs rrz#_transform_attrs..,,,Q!&,,,rch|] }|j Srrrs rrz#_transform_attrs..rrc:g|]}|dST)r9rrs rrz$_transform_attrs..s&???QXXdX++???rc:g|]}|dSrrrs rrz$_transform_attrs..s&AAAahhth,,AAArFc3>K|]}|jdu |jdu|VdS)FN)r6r9rs rrz#_transform_attrs..s: M MA!&"5"5!)u:L:La:L:L:L:L M MrzlNo mandatory attributes allowed after an attribute with a default value or factory. Attribute in question: cpg|]3}|js(|t|jn|4S))r?)r?r_default_init_alias_forrbrs rrz$_transform_attrs..sO    @AwM.qv66777A   rcg|] }|j Srrrs rrz$_transform_attrs..s(((Q!&(((r)rr rFitemsrrrrrrErJrMrqr]rrssortedrrr1rBrzr!r{)rthese auto_attribsr9collect_by_mrofield_transformerca_listca_names annot_namesryr.r unannotated own_attrsr}rr| had_defaultrLru AttrsClassrrs @@r_transform_attrsrvs B C D u{{}}%%      hhjj    ee #zz|| + +OItT""  OOI & & &y'**Aa// D !W FHHH&2C2C2C NNIq> * * * *, {  a  +C));,G,G,G,GHHH     "$((**    '&    % I $7 ,,),,,% % ! MM%? ,,),,,% % ! MB??Y??? AAjAAA  "E K M M M M M $  19#7#7GBCGGCS// ! %  AIW$<$<K$!!#u--      E)(%(((J' jAAJ  5)):}E F FFrc(gd}||dn|gd|ddgt|d}|tj|d}t dd |||d |i S) N) zdef wrapper(_cls):z __class__ = _clsz def __getattr__(self, item, cached_properties=cached_properties, original_getattr=original_getattr, _cached_setattr_get=_cached_setattr_get):z+ func = cached_properties.get(item)z if func is not None:z! result = func(self)z1 _setter = _cached_setattr_get(self)z# _setter(item, result)z return resultz, return original_getattr(self, item))z try:z2 return super().__getattribute__(item)z except AttributeError:z4 if not hasattr(super(), '__getattr__'):z raisez- return super().__getattr__(item)zY original_error = f"'{self.__class__.__name__}' object has no attribute '{item}'"z- raise AttributeError(original_error)z return __getattr__z__getattr__ = wrapper(_cls)r)cached_properties_cached_setattr_getoriginal_getattr __getattr__ro_cls)rc)rqextend_generate_unique_filename _OBJ_SETATTR__get__rhrs)rrrlinesunique_filenameglobs r_make_cached_property_getattrrs   E# :           LL $ ) 0Y??O/+3,  D  % C    rc~t|tr"|dvrt|||dSt)z4 Attached to frozen classes as __setattr__. ) __cause__ __context__ __traceback____suppress_context__ __notes__N)rE BaseException __setattr__rrrbvalues r_frozen_setattrsrsL$ &&44,, !!$e444 rc|t|tr!|dvrt||dSt)z4 Attached to frozen classes as __delattr__. )rN)rEr __delattr__r)rrbs r_frozen_delattrsr.sA$ &&4>+A+A!!$--- rc |\}n1#t$r$dt|d}t|dwxYw|j}t |}|D]/}|js |j}|j}||vrt||||<0|di|S)a Create a new instance, based on the first positional argument with *changes* applied. .. tip:: On Python 3.13 and later, you can also use `copy.replace` instead. Args: inst: Instance of a class with *attrs* attributes. *inst* must be passed as a positional argument. changes: Keyword changes in the new copy. Returns: A copy of inst with *changes* incorporated. Raises: TypeError: If *attr_name* couldn't be found in the class ``__init__``. attrs.exceptions.NotAnAttrsClassError: If *cls* is not an *attrs* class. .. versionadded:: 17.1.0 .. deprecated:: 23.1.0 It is now deprecated to pass the instance using the keyword argument *inst*. It will raise a warning until at least April 2024, after which it will become an error. Always pass the instance as a positional argument. .. versionchanged:: 24.1.0 *inst* can't be passed as a keyword argument anymore. z*evolve() takes 1 positional argument, but z were givenNr) rBr]rA __class__fieldsr6rbr?r) argschangesinstrLrr|rry init_names rrr9sJ' ''' OT O O O nn$& ' .C 3KKE ::v  F G G # #!(y!9!9GI  3>>>>s.5ceZdZdZdZdZdZdZdZdZ dZ d Z d Z d Z d Zd ZdZdZdZdZdZdZdZdS) _ClassBuilderz( Iteratively build *one* class. ) _attr_names_attrs_base_attr_map _base_names _cache_hashr _cls_dict_delete_attribs_frozen_has_custom_setattr_has_post_init _has_pre_init_is_exc _on_setattr_pre_init_has_args_slots _weakref_slot_wrote_own_setattrcdt||||| |\}}}||_|rt|jni|_||_d|D|_||_td|D|_ ||_ ||_ ||_ | |_ tt|dd|_d|_|jr8|j}t'j|}t+|jdk|_tt|dd|_t| |_| |_| |_| |_d|_|j|jd<|r&t:|jd<t<|jd <d |_n{| t>t@j!t@j"fvr[dx}}|D]}|j#d }|j$d }|r|rn| t>kr|s|r$| t@j!kr|r| t@j"kr |sd|_|r)|%\|jd <|jd <dSdS) Nch|] }|j Srrrs rrz)_ClassBuilder.__init__..s777qAF777rc3$K|] }|jV dSr*rrs rrz)_ClassBuilder.__init__..s$ 7 7A 7 7 7 7 7 7r__attrs_pre_init__Fr__attrs_post_init__rrrT __getstate__ __setstate__)&rrdictrrrrrrGrr rr rboolrrr rinspect signaturer] parametersrrrr rr rr_DEFAULT_ON_SETATTRrvalidateconvertr2r7_make_getstate_setstate)rrrslotsfrozen weakref_slotgetstate_setstaterr9 cache_hashis_excrr>has_custom_setattrrr|r}base_map pre_init_funcpre_init_signature has_validator has_converterrs r__init__z_ClassBuilder.__init__s"'7       ' ' #z8 /4<cl+++" 77J777& 7 7 7 7 777  )%!'#/CU"K"KLL"'   M 2M!(!2=!A!A &)*<*G&H&H1&LD #"730Eu#M#MNN#';; %#5 "',0K()  (,)rr!rs rrz_ClassBuilder.__repr__s;TY%7;;;;rc|jdur|}n/|}trt j|}t |ddrd|jvr||S)z Finalize class based on the accumulated configuration. Builder cannot be used after calling this method. T__attrs_init_subclass__N) r _create_slots_class_patch_original_classr abcupdate_abstractmethodsrrr-)rrs r build_classz_ClassBuilder.build_classs ;$  **,,CC,,..C 6055 C2D 9 9 *)==  ' ' ) ) ) rc|j}|j}|jrl|jD]d}||vr^t ||t t urAt jt5t||dddn #1swxYwYe|j D]\}}t||||j s+t |ddrd|_|js t |_|S)zA Apply accumulated methods and return the class. N__attrs_own_setattr__F)rrrrr _SENTINEL contextlibsuppressAttributeErrordelattrrrsetattrr r4rrr)rr base_namesrbrs rr/z#_ClassBuilder._patch_original_classsLi%    +( + + **T955YFF $,^<<++T***+++++++++++++++ >//11 & &KD% Cu % % % %& /7 (%, ,  /).C %+ /". sA66A: =A: c 8fdjD}jsBd|d<js6jjD])jddr t|d<n*i}d}jj ddD]Ojddd }| fd td gDPtj j}jr#dtjd d vr d|vr|s|d z }d|D}g}|rt!j}|D]T\}} ||fz }||=|| t%j| j} | t$jjur| ||<U|d} | || t/|| j|d<fd|Dfd|DfdD| jrt2t5|d <jj|d<t9jjjjj|} t=j| j |D]} tC| tDtFfrt| j$dd}n=tC| tJrt| j&dd}nt| dd}|su|D]*} |j'ju}|r| |_'#tP$rY'wxYw| S)zL Build and return a new class with a `__slots__` attribute. cVi|]%\}}|gtjddRv"||&S)r __weakref__)rGr)rkvrs r z5_ClassBuilder._create_slots_class..+sR   1M% 011M:M}MMMM qMMMrFr4rrrZr>NTc2i|]}|t|Srr)rrbrs rrAz5_ClassBuilder._create_slots_class..Js5'(D11r __slots__r)r>cXi|]'\}}t|tj||j(Sr)rE functoolscached_propertyfunc)rrbrGs rrAz5_ClassBuilder._create_slots_class..[sD   %o/9+DEE /&   rrcg|]}|v| Srr)rrbr;s rrz5_ClassBuilder._create_slots_class..zs#GGGtJ0F0Fd0F0F0Frc$i|] \}}|v || Srr)rslotslot_descriptor slot_namess rrAz5_ClassBuilder._create_slots_class..s4   %oz!! /!!!rcg|]}|v| Srr)rrb reused_slotss rrz5_ClassBuilder._create_slots_class..s#NNNtT5M5Md5M5M5Mrr# __closure__))rrr rr __bases__rrrrupdaterrrrr r rqrrreturn_annotation Parameteremptyrr_HASH_CACHE_FIELDrGr#r.r! itertoolschainvaluesrE classmethod staticmethod__func__rrfget cell_contentsrB)rrexisting_slotsweakref_inheritednamesr&additional_closure_functions_to_updateclass_annotationsrbrH annotationrritem closure_cellscellmatchrr;rOrMs` @@@@rr.z!_ClassBuilder._create_slots_class's    ,,..   & */B& '+  $ 3H(,,-DeLL,8=) ! )!B$/  H $$]D99E$(!  ! ! '+r B B    )**     &WTY R%H%HHHU**%+ % %E  )+   24.   0 ; ; /5577 9 9 d$ tH6==dCCC$.t44F W%6%<<<.8%d+!vvm44 +6==>NOOO =!#3TY!!B}  HGGGuGGG     )7)=)=)?)?   ONNNzNNN  ,   1   / 0 0 0 ++;!Y3>d49oodi0$)2ErJJO L   ! !#I   1 1D$l ;<< C!( }d K K D(++ C!( =$ G G 'mT B B   % 1 11 .$);E 1-0* "D 1 s1N  NNcr|t|j||j|jd<|S)Nr)_add_method_dunders _make_reprrrr)rnss radd_reprz_ClassBuilder.add_reprs8%)%=%= t{B 2 2& & z" rc|jd}|d}t|d}|||jd<|S)Nrz3__str__ can only be generated if a __repr__ exists.c*|Sr*rrs r__str__z&_ClassBuilder.add_str..__str__s==?? "rrq)rrrBrj)rr3rLrqs radd_strz_ClassBuilder.add_strs]~!!*-- <GCS// ! # # #%)$<$Nr)rans rrz8_ClassBuilder._make_getstate_setstate..s5! ! R=-@-@B-@-@-@-@! ! rc"fdDS)9 Automatically created by attrs. c2i|]}|t|SrrCrrbrs rrAzQ_ClassBuilder._make_getstate_setstate..slots_getstate..s%KKK$D'$--KKKrr)rstate_attr_namess`rslots_getstatez=_ClassBuilder._make_getstate_setstate..slots_getstates"LKKK:JKKK Krc t|}t|tr#t |D]\}}|||nD]}||vr||||r|t ddSdS)rwN)rrrErGziprV)rstate_ClassBuilder__bound_setattrrbrhash_caching_enabledrzs rslots_setstatez=_ClassBuilder._make_getstate_setstate..slots_setstates+22488O%'' ;$''7#?#?11KD%#OD%00001-;;Du}}'eDk::: $ 9 1488888 9 9r)rGrr)rr{rrrzs @@rrz%_ClassBuilder._make_getstate_setstates !! ! )! ! !    L L L L L $/ 9 9 9 9 9 9,~--rcd|jd<|S)N__hash__)rrs rmake_unhashablez_ClassBuilder.make_unhashables%)z" rc|t|j|j|j|j|jd<|S)Nrr"r)rj _make_hashrrrrrrs radd_hashz_ClassBuilder.add_hashsL%)%=%=   |+    & & z" rc|t|j|j|j|j|j|j|j|j |j |j |j d |j d<|S)NF attrs_initr*rj _make_initrrrr rrr rrrr rrs radd_initz_ClassBuilder.add_initsw%)%=%=   "'#   #      & & z"" rcB|d|jd<|S)Nct|fi|Sr*r)rrs rrz+_ClassBuilder.add_replace..sF4$;$;7$;$;r __replace__)rjrrs r add_replacez_ClassBuilder.add_replaces+(,(@(@ ; ;) ) }% rcRtd|jD|jd<dS)Nc3@K|]}|j |j|jVdSr*)r6r9rb)rfields rrz/_ClassBuilder.add_match_args..sL1 1 z1 #(-1 J1 1 1 1 1 1 r__match_args__)rGrrrs radd_match_argsz_ClassBuilder.add_match_argss=+01 1 1 1 1 , , '(((rc|t|j|j|j|j|j|j|j|j |j |j |j d |j d<|S)NTr__attrs_init__rrs radd_attrs_initz_ClassBuilder.add_attrs_initsx+/+C+C   "'#   #     , , '(" rc|j}|t|j|j|d<|t |d<|S)N__eq____ne__)rrj_make_eqrr_make_nerrs radd_eqz_ClassBuilder.add_eq2sU ^// TY , ,  8 // ;;8  rcj}fdtjjD\|d<|d<|d<|d<S)Nc3BK|]}|VdSr*)rj)rmethrs rrz*_ClassBuilder.add_order..?sMB B   $ $T * *B B B B B B r__lt____le____gt____ge__)r _make_orderrrrs` r add_orderz_ClassBuilder.add_order<sg ^B B B B #DIt{;;B B B >8 blBxL"X,  rc$|jr|Si|jD],}|jp|j}|r|tjur ||f|j<-s|S|jrd}t|fd}d|j d<| ||j d<d|_ |S)Nz7Can't combine custom __setattr__ with on_setattr hooks.c |\}}||||}n#t$r|}YnwxYwt|||dSr*)KeyErrorr)rrbvalrhooknvalsa_attrss rrz._ClassBuilder.add_setattr..__setattr__Ysl *"4.4tD!S))     tT * * * * *s  ++Tr4r) rrr>r rNO_OPrbrrBrrjr )rrr>rLrrs @r add_setattrz_ClassBuilder.add_setattrFs < K 1 1A9)9J 1j ==#$j=  K  # "KCS// ! + + + + +37./(,(@(@(M(M}%"& rctjt5|jj|_dddn #1swxYwYtjt5|jjd|j|_dddn #1swxYwYtjt5d|jjd|_dddn #1swxYwY|S)zL Add __module__ and __qualname__ to a *method* if possible. Nrz$Method generated by attrs for class )r6r7r8rr"r#r!r$)rmethods rrjz!_ClassBuilder._add_method_dundersis  0 0 5 5 $ 4F  5 5 5 5 5 5 5 5 5 5 5 5 5 5 5  0 0 P P%)Y%;"O"Ofo"O"OF  P P P P P P P P P P P P P P P  0 0  -9)--- N                 s08<<BB B(C  CCN)r!r"r#r$rDr*rr2r/r.rmrrrrrrrrrrrrrjrrrrrss>I*Z/Z/Z/x<<<."""HIIIV   '.'.'.R   (    (!!!Frrc|&t|du|dufrd}t||||fS||}||}|dur|durd}t|||fS) Validate the combination of *cmp*, *eq*, and *order*. Derive the effective values of eq and order. If *eq* is None, set it to *default_eq*. N&Don't mix `cmp` with `eq' and `order`.FT-`order` can only be True if `eq` is True too.anyrB)r4r:r< default_eqrLs r_determine_attrs_eq_orderr|s  3$T0ABCC6oo Cx z  } U{{u}}=oo u9rc|&t|du|dufrd}t|d}|||\}}||||fS||d}}n||\}}|||}}n||\}}|dur|durd}t|||||fS)rNrc6t|rd|}}nd}||fS)z8 Decide whether a key function is used. TN)rC)rrs rdecide_callable_or_booleanz>_determine_attrib_eq_order..decide_callable_or_booleans, E?? u3EECczrFTrr) r4r:r<rrLrcmp_keyr;r=s rr@r@s  3$T0ABCC6oo 11#66 WGS')) zF//33 F }vy55e<<y U{{u}}=oo vui ''rcZ|dus|dur|S||dur|S|D]}t||rdS|S)ap Check whether we should implement a set of methods for *cls*. *flag* is the argument passed into @attr.s like 'init', *auto_detect* the same as passed into @attr.s and *dunders* is a tuple of attribute names whose presence signal that the user has implemented it themselves. Return *default* if no reason for either for or against is found. TF)r)rflag auto_detectdundersr1dunders r_determine_whether_to_implementrsd t||tu}}  | u,, c6 * * 55  NrcV (ddl}|tddt|||d\||t t t frtj     fd}||S||S)a A class decorator that adds :term:`dunder methods` according to the specified attributes using `attr.ib` or the *these* argument. Consider using `attrs.define` / `attrs.frozen` in new code (``attr.s`` will *never* go away, though). Args: repr_ns (str): When using nested classes, there was no way in Python 2 to automatically detect that. This argument allows to set a custom name for a more meaningful ``repr`` output. This argument is pointless in Python 3 and is therefore deprecated. .. caution:: Refer to `attrs.define` for the rest of the parameters, but note that they can have different defaults. Notably, leaving *on_setattr* as `None` will **not** add any hooks. .. versionadded:: 16.0.0 *slots* .. versionadded:: 16.1.0 *frozen* .. versionadded:: 16.3.0 *str* .. versionadded:: 16.3.0 Support for ``__attrs_post_init__``. .. versionchanged:: 17.1.0 *hash* supports `None` as value which is also the default now. .. versionadded:: 17.3.0 *auto_attribs* .. versionchanged:: 18.1.0 If *these* is passed, no attributes are deleted from the class body. .. versionchanged:: 18.1.0 If *these* is ordered, the order is retained. .. versionadded:: 18.2.0 *weakref_slot* .. deprecated:: 18.2.0 ``__lt__``, ``__le__``, ``__gt__``, and ``__ge__`` now raise a `DeprecationWarning` if the classes compared are subclasses of each other. ``__eq`` and ``__ne__`` never tried to compared subclasses to each other. .. versionchanged:: 19.2.0 ``__lt__``, ``__le__``, ``__gt__``, and ``__ge__`` now do not consider subclasses comparable anymore. .. versionadded:: 18.2.0 *kw_only* .. versionadded:: 18.2.0 *cache_hash* .. versionadded:: 19.1.0 *auto_exc* .. deprecated:: 19.2.0 *cmp* Removal on or after 2021-06-01. .. versionadded:: 19.2.0 *eq* and *order* .. versionadded:: 20.1.0 *auto_detect* .. versionadded:: 20.1.0 *collect_by_mro* .. versionadded:: 20.1.0 *getstate_setstate* .. versionadded:: 20.1.0 *on_setattr* .. versionadded:: 20.3.0 *field_transformer* .. versionchanged:: 21.1.0 ``init=False`` injects ``__attrs_init__`` .. versionchanged:: 21.1.0 Support for ``__attrs_pre_init__`` .. versionchanged:: 21.1.0 *cmp* undeprecated .. versionadded:: 21.3.0 *match_args* .. versionadded:: 22.2.0 *unsafe_hash* as an alias for *hash* (for :pep:`681` compliance). .. deprecated:: 24.1.0 *repr_ns* .. versionchanged:: 24.1.0 Instances are not compared as tuples of attributes anymore, but using a big ``and`` condition. This is faster and has more correct behavior for uncomparable values like `math.nan`. .. versionadded:: 24.1.0 If a class has an *inherited* classmethod called ``__attrs_init_subclass__``, it is executed after the class is created. .. deprecated:: 24.1.0 *hash* is deprecated in favor of *unsafe_hash*. NrzQThe `repr_ns` argument is deprecated and will be removed in or after August 2025.) stacklevelcpt|} duot|t}ot|d}|r|rd}t |t ||t |d | | }t |dr|dur|t | d}|s|dur| |s&t |dr| | durt|d rd durd urd }t|d us|d us|r rd }t|nJdus |dur|dur| n' rd }t||t |d r|n'| rd}t|t"r$t|ds|t&r&r$t|ds||S)NTrz/Can't freeze a class with a custom __setattr__.)rrrrp)rr)rrrrrFr0zlInvalid value for cache_hash. To use hash caching, hashing must be either explicitly or implicitly enabled.r*zFInvalid value for cache_hash. To use hash caching, init must be True.rr)_has_frozen_base_class issubclassrrrBrrrmrrrrrrArrrrr rr rr2)r is_frozenr#has_own_setattrrLbuilderr:rrauto_excr"req_rrr!r5r6r9 match_argsr>order_r3repr_nsrrrr s rwrapzattrs..wrapLsh94S99 T!Djm&D&D% *< + +   "y "CCS// !      +!0            )  , + {M   &   W % % % $;; OO    , k#7   "** NN    9 &N          Lt##"3 33$D t  E 1 1d6FJCC.. 5==T\bEkkfk %Enn$ %T\\ LR4ZZI,=,=        %Enn$  # # % % % * {M   %         " " $ $ $ %^nn$  " 23 F F "    ! ! !  % %'s,<== %  " " $ $ $""$$$r) warningswarnDeprecationWarningrrErFrGrrH) maybe_clsrrr3r4r5r6rrr rrr9r"rr:r<rrr!r>rr unsafe_hashrrrrs ``` `````````` `````` @@rr|r|sSx c      ,CUDAAKC*tUm,,/\:. g%g%g%g%g%g%g%g%g%g%g%g%g%g%g%g%g%g%g%g%g%g%g%g%g%V 4 ??rc|jtuS)zV Check whether *cls* has a frozen ancestor by looking at its __setattr__. )rr)rs rrrs ?. ..rc Ld|d|jdt|d|jdS)zF Create a "filename" suitable for a function being generated. z.sAAFdNNqv~!$$,,,,,,r r5zdef __hash__(selfzhash((rlz):z, *zC, _cache_wrapper=__import__('attr._make')._make._CacheHashWrapper):z_cache_wrapper()c T||zz|d dzgD]d}|jr:d|jd}|j|<|d|d|jdzC|d|jdze|dzzd S) z Generate the code for actually computing the hash code. Below this will either be returned directly or used to compute a value which is then cached, depending on the value of cache_hash r,__key(self.z), self.rkN)rr;rbrq) prefixindentrcmp_namer|closing_bracesrT hash_func method_lines type_hashs rappend_hash_computation_linesz1_make_hash..append_hash_computation_liness )+0I0000     H HAx H+qv+++"#(h##BBBBBBB##F-FQV-F-F-F$FGGGGFVOn<=====rzif self.z is None:zobject.__setattr__(self, '', rself. = z return self.zreturn ror)rGrr5rqrVrsrh)rr|rr"tabrhash_defrrSrrTrrrs ` @@@@@rrrs   E C/V<>>>>>>>>>4 6C"I->"I"I"IIJJJ   ) )C->CCCS1W      a# . . . . ) ).)...a    C"D1B"D"DDEEEE%%i555 YY| $ $F  FOU C CCrc6t||dd|_|S)z% Add a hash method to *cls*. Fr)rrrr|s r _add_hashrs!c55IIICL Jrc d}|S)z Create __ne__ method. cR||}|turtS| S)zj Check equality and either forward a NotImplemented or return the result negated. )rNotImplemented)rotherresults rrz_make_ne..__ne__*s. U## ^ # #! !zrr)rs rrr%s    Mrc .d|D}t|d}gd}i}|r|d|D]}|jrBd|jd}|j||<|d|d|jd |d |jd n%|d |jd |j||dur|dd|d<|dn|dd|}t d|||S)z6 Create __eq__ method for *cls* with *attrs*. c g|] }|j | Sr)r:rs rrz_make_eq..<s & & &1 &Q & & &rr:)zdef __eq__(self, other):z- if other.__class__ is not self.__class__:z return NotImplementedz return (rrrrz) == z(other.rrz == other.rZz andz )z return Trueror)rrqr;rbrsrh)rr|rrrTrrrSs rrr8sr ' & & & &E/T::O   E E ( _%%% / /Ax I+qv+++#$(h VxVVqvVVHVVQVVVV GQVGGqvGGHHHb !!$Ry...b  W &''' YYu  F &/5 A AArc\dDfdfd}fd}fd}fd}||||fS)z9 Create ordering methods for *cls* with *attrs*. c g|] }|j | Sr)r<rs rrz_make_order..bs ) ) )1 )Q ) ) )rcPtdfdDDS)z& Save us some typing. c3:K|]\}}|r ||n|VdSr*r)rrrs rrz6_make_order..attrs_to_tuple..hsK  s (CCJJJ5      rc3PK|] }t|j|jfV!dSr*)rrbr=)rrobjs rrz6_make_order..attrs_to_tuple..jsG89af%%q{3r)rG)rr|s`rattrs_to_tuplez#_make_order..attrs_to_tupledsW  =B      rc^|j|jur||kStSz1 Automatically created by attrs. rrrrrs rrz_make_order..__lt__o9 ?dn , ,!>$''..*?*?? ?rc^|j|jur||kStSr r r s rrz_make_order..__le__x9 ?dn , ,!>$''>>%+@+@@ @rc^|j|jur||kStSr r r s rrz_make_order..__gt__r rc^|j|jur||kStSr r r s rrz_make_order..__ge__rrr)rr|rrrrrs ` @rrr^s * ) ) ) )E       666 ))rch||j}t|||_t|_|S)z5 Add equality methods to *cls* with *attrs*. )rrrrrrs r_add_eqrs2 }##u%%CJCJ Jrct|d}td|D}d|D}t|d<t|d<t|d<g}|D]H\}}} | rd|znd|zd z} |t kr|d | d n |d |d | d } || Id|} |d} n|dz} ddddddddddddd| d| ddd g}td!d"|||#S)$Nr3c3pK|]1}|jdu |j|jdurtn|j|jfV2dS)FTN)r3rbr6rs rrz_make_repr..sV"" 6   !&D..$$afqv>    ""rc8i|]\}}}|tk|dz|S)_repr)r3)rrbrrs rrAz_make_repr..s0   (dAqQ$YYwYYYrrr8rrzgetattr(self, "z ", NOTHING)z={z!r}z_repr(z)}rz1{self.__class__.__qualname__.rsplit(">.", 1)[-1]}z.{self.__class__.__name__}zdef __repr__(self):z try:z: already_repring = _compat.repr_context.already_repringz except AttributeError:z! already_repring = {id(self),}z: _compat.repr_context.already_repring = already_repringz else:z# if id(self) in already_repring:z return '...'z else:z# already_repring.add(id(self))z return f'(z)'z finally:z$ already_repring.remove(id(self))rro)rT) rrGrr8rr3rqrsrh)r|rlrrattr_names_with_reprsrTattribute_fragmentsrbrrxaccessorfragment repr_fragmentcls_name_fragmentrs rrkrks/V<./s % % %!AFA % % %r)rEr.rArr)rrLr|s r fields_dictr(sn& c4 .nn C*D 1 1E }999"3''' % %u % % %%rc tjdurdSt|jD]+}|j}| |||t ||j,dS)z Validate all attributes on *inst* that have a validator. Leaves all exceptions through. Args: inst: Instance of a class with *attrs* attributes. FN)r_run_validatorsrrr2rrb)rrr@s rrr2sg%'' DN # #.. K = AdAwtQV,, - - -..rcB||}|od|jvS)z> Check if the attribute name comes from a slot class. rD)rr)a_namerrs r _is_slot_attrr-Ds)   F # #C  .;#,..rc | duo | tju} |r| rd} t| |p|}g}i}|D]m}|js|jt ur|||||j<|j|durd} t| d}V| r|jtjurd}nt|d}t||||||||| || | rdnd \}}}|j tj vr/|tj |j j|t |d|rt j|d<t%| rdnd|||}||_|S)Nz$Frozen classes can't use on_setattr.Tr6rr*)r attr_dictr)rrrBr6r1rrqrbr>r_attrs_to_init_scriptr"sysmodulesrRrrrrh__annotations__)rr|pre_initpre_init_has_args post_initrrr"rr#cls_on_setattrrhas_cls_on_setattrrLneeds_cached_setattrfiltered_attrsr/rrrSrTrr6s rrrLs d"J~W]'J$4oo%/NI ((v !)w.. a    !& < #~~< oo%#'  (AL $E$E#' /V<>><(4';#$ &6J   D 'D Krryr value_varhas_on_setattrrreturncd|d|dS)zJ Use the cached object.setattr to set *attr_name* to *value_var*. _setattr('rrr)ryr;r<s r_setattrr@s 3 2 2i 2 2 22rr7 Converterc<d|d|||dS)zk Use the cached object.setattr to set *attr_name* to *value_var*, but run its converter first. r?rr)_fmt_converter_callryr;r<r7s r_setattr_with_converterrEs. ] \ \i&C&CIy&Y&Y \ \ \\rrc8|rt||dSd|d|S)zo Unless *attr_name* has an on_setattr hook, use normal assignment. Otherwise relegate to _setattr. Trr)r@)ryrr<s r_assignrGs4 0 5$/// (9 ( ( ( ((rcb|rt||d|Sd|d|||S)z Unless *attr_name* has an on_setattr hook, use normal assignment after conversion. Otherwise relegate to _setattr_with_converter. Trr)rErCrDs r_assign_with_converterrIsGN&y)T9MMM V9 V V!>!>y)!T!T V VVrrrrdict[str, type]cr|dur$|durdttfSdfd }dfd }d ||fSdttfS)zg Determine the correct setter functions based on whether a class is frozen and/or slotted. Trryrr;r<rr=cVt|rt|||Sd|d|SN _inst_dict['z'] = )r-r@)ryr;r<rs r fmt_setterz&_determine_setters..fmt_setters@Y 66 F 9nEEE=)==)== =rr7rAc|st|rt||||Sd|d|||SrM)r-rErC)ryr;r<r7rs rfmt_setter_with_converterz5_determine_setters..fmt_setter_with_convertersd  y-!H!H .y.)h)gg)2O2OPY[d2e2egg gr)z_inst_dict = self.__dict__ryrr;rr<rr=r ryrr;rr<rr7rAr=r)r@rErGrI)rrrrOrQs ` r_determine_settersrTs~~ D==x!88 8 > > > > > > h h h h h h ,  %   w. ..rr|list[Attribute]r is_slotted call_pre_initr5call_post_initdoes_cache_hashr#r9r8 method_nametuple[str, dict, dict]c > |rdgng} | r| dt|||\} }}| | g}g}g}i}ddi}|D]}|jr|||j}|jdup|jt juo| }|j}t|j t}|r|j j rdnd}|j /t|j tst|j }n|j }|jdur|rt |jfz}|K| |||d|d z|||j |||j<n'| |||d|d z||j j||<n|I| ||d |d |||j |||j<n| ||d |d |n|j t&ur|s|d |d }|jr||n|||E| ||||||j |||j<n| ||||n|r_|d }|jr||n||| d|dt |jfz}|| d|||||z| d| d|||dz|zd z||z|j |||j<nd| d||||z| d| d|||dz|zd z|z|j j||<n|jr||n|||D| ||||||j |||j<n | |||||jdur(|j| |j||<||jr |j||<|rkt.|d<| d|D]I}d|jz}d|jz}| d|d|d|jd |j||<|||<J|r| d|r<|r|r dt0d}ndt0d}n dt0d}| ||r8d d!|D} | d"| d d#|}|}!|rX||rd#ndd$d#|z }d#d%d&|DD}"|!|!rd#ndz }!|!|"z }!|r |r d'|!d | d(<d)}#d*| d|d+| r|#| nd,d-||fS).z Return a script of an initializer for *attrs*, a dict of globals, and annotations for the initializer. The globals are required by the generated script. zself.__attrs_pre_init__()z$_setattr = _cached_setattr_get(self)r=NrrNFrrz attr_dict['z '].defaultz =attr_dict['z=NOTHINGzif z is not NOTHING:rkzelse:Trz#if _config._run_validators is True:__attr_validator___attr_z(self, z, self.zself.__attrs_post_init__()r?z', None)rNz '] = Nonerz = Nonerc38K|]}|j d|jVdS)rN)r6rbrs rrz(_attrs_to_init_script..s4BBQ16B(((BBBBBBrzBaseException.__init__(self, rz*, cg|] }|d| S)=r)r kw_arg_names rrz)_attrs_to_init_script..s8    ....   rc3LK|]}|ddV dS)rarN)split)rkwas rrz(_attrs_to_init_script..s1#N#N#CIIcNN1$5#N#N#N#N#N#Nrzself.__attrs_pre_init__(rz zdef z): passro)rqrTrr2rbr>rrr?rEr1rD takes_selfr7rAr6_INIT_FACTORY_PAT_get_global_namerKrr9r._first_param_typerrVrs)$r|rrVrWr5rXrYrr#r9r8rZr extra_linesrOrQr kw_only_argsattrs_to_validatenames_for_globalsrrryr<arg_name has_factory maybe_selfr7init_factory_nameargval_nameinit_hash_cachevals pre_init_argspre_init_kw_only_argsNLs$ rr0r0s (.; B ( ) )E   3    :L:}::6K6 LL DLT"K UDUD ; (  $ $Q ' ' 'F T1 L - D2D  7 G44 *Kqy/CKVV ; ":ak9+M+M "!!+..II I 6U??* $5 $A!(LL11%-0AJ0A0A0AA*% "+&i&@&@&H&HIILL" %-0AJ0A0A0AA*89y7H!"344& --!;i;;;&! '")"<">v!i&7() H%%&9+F&(1(C H%-'.)$ :;;;" - -A*QV3H!AF*I LLLLLLL16LLL M M M*++ h '+, i ( (3 1222&  A N"J/@"J"J"J"M1B"M"M"M@&7@@@O _%%%>xxBB%BBBBB m>>>a B   T  (RWWU^^^&      rrbc,|dS)z The default __init__ parameter name for a field. This performs private-name adjustment via leading-unscore stripping, and is the default value of Attribute.alias if not provided. r)lstriprs rrrs ;;s  rcheZdZdZdZ d dZdZed dZdZ d Z d Z d Z dS)ra *Read-only* representation of an attribute. .. warning:: You should never instantiate this class yourself. The class has *all* arguments of `attr.ib` (except for ``factory`` which is only syntactic sugar for ``default=Factory(...)`` plus the following: - ``name`` (`str`): The name of the attribute. - ``alias`` (`str`): The __init__ parameter name of the attribute, after any explicit overrides and default private-attribute-name handling. - ``inherited`` (`bool`): Whether or not that attribute has been inherited from a base class. - ``eq_key`` and ``order_key`` (`typing.Callable` or `None`): The callables that are used for comparing and ordering objects by this attribute, respectively. These are set by passing a callable to `attr.ib`'s ``eq``, ``order``, or ``cmp`` arguments. See also :ref:`comparison customization `. Instances of this class are frequently used for introspection purposes like: - `fields` returns a tuple of them. - Validators get them passed as the first argument. - The :ref:`field transformer ` hook receives a list of them. - The ``alias`` property exposes the __init__ parameter name of the field, with any overrides and default private-attribute handling applied. .. versionadded:: 20.1.0 *inherited* .. versionadded:: 20.1.0 *on_setattr* .. versionchanged:: 20.2.0 *inherited* is not taken into account for equality checks and hashing anymore. .. versionadded:: 21.1.0 *eq_key* and *order_key* .. versionadded:: 22.2.0 *alias* For the full version history of the fields, see `attr.ib`. )rbr1r2r3r:r;r<r=r5r6r8r.r7r9rr>r?NFcXt||p| |p|d\} }}}t|}|d||d||d||d||d| |d||d||d ||d ||d ||d | |d | r!tjt | nt |d| |d| |d||d||d|dS)NTrbr1r2r3r:r;r<r=r5r6r7r8r.r9rr>r?)r@rrtypesMappingProxyTyper_EMPTY_METADATA_SINGLETON)rrbr1r2r3r4r5r6rr8r.r7r9r:r;r<r=r>r? bound_setattrs rr*zAttribute.__init__C s*(B 2y1E4( ( $FE9 %,,T22   fd### i))) k9--- fd### dB h''' gu%%% k9--- fd### fd### k9--- /&tH~~666.      fd### i))) k9--- lJ/// gu%%%%%rctr*)rrs rrzAttribute.__setattr__z s!!rc |j}njd}t|fdtjD}|d|jj|ddd|S)Nz8Type annotation and type argument cannot both be presentc:i|]}|dv|t|S))rbr2r1r.rrC)rr?rs rrAz0Attribute.from_counting_attr.. sE     wr1~~rF)rbr2r1r.r4rr)r.rBrrD _validator_default)rrbrr.rL inst_dicts ` rrzAttribute.from_counting_attr} s <7DD W LCS// !     (    s mK      rc |tj|}|||S)a  Copy *self* and apply *changes*. This works similarly to `attrs.evolve` but that function does not work with :class:`attrs.Attribute`. It is mainly meant to be used for `transform-fields`. .. versionadded:: 20.3.0 )copy _setattrsr)rrnews rrzAttribute.evolve s0ioo gmmoo&&& rcDtfdjDS)( Play nice with pickle. c3lK|].}|dkrt|ntjV/dS)r8N)rrr8rys rrz)Attribute.__getstate__.. sZ  $(:#5#5GD$   4 ;N;N      rrGrDrs`rrzAttribute.__getstate__ s?          rcV|t|j|dSrN)rr}rDrr~s rrzAttribute.__setstate__ s( s4>51122222rc t|}|D]L\}}|dkr ||||||r!tjt |nt MdS)Nr8)rrr~rrr)rname_values_pairsrrbrs rrzAttribute._setattrs s$,,T22 ,  KD%z!! dE**** !7.tE{{;;;6   r) NNNFNNNNNNr*) r!r"r#r$rDr*rrZrrrrrrrrrr s((XI<  '5&5&5&5&n"""   [ <$   333     rrcng|]2}t|tddddd|dkddt| 3S)NTFr8) rbr1r2r3r4r:r<r5r6rr?)rrrrrbs rrr sg     j %d++   r)r|c(g|]}|jdk |Srrrs rrr s$666Q+ 5 5q 5 5 5rc6g|]}|j |jdk|Sr)r5rbrs rrr s+ = = =AF =qv'<'<1'<'<'r<r=r3r.c#vK|]4}t|t|tddddddddddddV5dS)NTFrbr?r1r2r3r4r5r6r9r:r;r<r=rr>)rrrrs rrz_CountingAttr. s|  $# -d33         r) rrr3r:r<r5r6r>r?r8NTFrrc$txjdz c_tj|_||_||_||_||_| |_| |_| |_ ||_ ||_ ||_ ||_ | |_| |_||_||_dSr)rJ cls_counterrrrr7r3r:r;r<r=r5r6r8r.r9r>r?)rr1r2r3r4r5r6r7r8r.r9r:r;r<r=r>r?s rr*z_CountingAttr.__init__5 s& !!Q&!!$0  #"   "      $ rcX|j||_nt|j||_|S)z Decorator that adds *meth* to the list of validators. Returns *meth* unchanged. .. versionadded:: 17.1.0 )rrIrrs rr2z_CountingAttr.validatorZ s- ? ""DOO"4?D99DO rc\|jturtt|d|_|S)z Decorator that allows to set the default for an attribute. Returns *meth* unchanged. Raises: DefaultAlreadySetError: If default has been set before. .. versionadded:: 17.1.0 T)rg)rrrrDrs rr1z_CountingAttr.defaulth s0 = ' '( (666  r) r!r"r#r$rDrGrrrr*r2r1rrrrJrJ sI$0   $ %     0>     ?00ObK###J   rrJc*eZdZdZdZddZdZdZdS) rDa Stores a factory callable. If passed as the default value to `attrs.field`, the factory is used to generate a new value. Args: factory (typing.Callable): A callable that takes either none or exactly one mandatory positional argument depending on *takes_self*. takes_self (bool): Pass the partially initialized instance that is being initialized as a positional argument. .. versionadded:: 17.1.0 *takes_self* rKrgFc"||_||_dSr*r)rrKrgs rr*zFactory.__init__ s $rcDtfdjDS)rc38K|]}t|VdSr*rCrys rrz'Factory.__getstate__.. s-DDTWT4((DDDDDDrrrs`rrzFactory.__getstate__ s*DDDDT^DDDDDDrc^t|j|D]\}}t|||dSr)r}rDr:)rr~rbrs rrzFactory.__setstate__ sBt~u55 ' 'KD% D$ & & & & ' 'rN)F)r!r"r#r$rDr*rrrrrrDrD~ sZ$*I%%%%EEE '''''rrDcJg|] }t|tdddddddd !SNTF) rbr1r2r3r4r:r<r5r6rrrrs rrr W          rcPeZdZdZdZddddZedd Zdd Zd Z d Z dS)rAae Stores a converter callable. Allows for the wrapped converter to take additional arguments. The arguments are passed in the order they are documented. Args: converter (Callable): A callable that converts the passed value. takes_self (bool): Pass the partially initialized instance that is being initialized as a positional argument. (default: `False`) takes_field (bool): Pass the field definition (an :class:`Attribute`) into the converter as a positional argument. (default: `False`) .. versionadded:: 24.1.0 )__call__rj _global_namer7 takes_fieldrgFrgrcz|_|_|_t|}|_jsjs fd_n<jrjs fd_n#jsjr fd_n fd_|}||jjd<dSdS)Nc.|Sr*r7)rr__rs rrz$Converter.__init__.. s1F1Frc0||Sr*r)rinstancerrs rrz$Converter.__init__.. sx99rc0||Sr*r)rrrrs rrz$Converter.__init__.. sT^^u66rc2|||Sr*r)rrrrs rrz$Converter.__init__.. s4>>x<<rr=) r7rgrr get_first_param_typerjrget_return_typer3)rr7rgrexrts` rr*zConverter.__init__ s "$& !) , ,!#!8!8!:!: 4#3 FFFFDMM _ T%5 DMM T%5 DMMDM   ! ! >68DM )( 3 3 3 >rryrr=c d|S)zh Return the name that a converter for an attribute name *attr_name* would have. __attr_converter_r)rys rrizConverter._get_global_name s /9...rr;c,|js"|js||d|dS|jr%|jr||d|d|dS|jr||d|dS||d|d|dS)z Return a string that calls the converter for an attribute name *attr_name* and the value in variable named *value_var* according to `self.takes_self` and `self.takes_field`. rrz, self, attr_dict['z'])z, self)z , attr_dict[')rgrri)rryr;s rrCzConverter._fmt_converter_call s  F4#3 F++I66EEEEE E ? ft/ f++I66eeeeW`eee e ? L++I66KKKKK K'' 22[[Y[[Y[[[[rc,|j|j|jdS)zx Return a dict containing only converter and takes_self -- the rest gets computed when loading. r7rgrrrs rrzConverter.__getstate__ s# /+   rc |jdi|dS)z+ Load instance from state. Nrrrs rrzConverter.__setstate__ s"  rN)ryrr=r)ryrr;rr=r) r!r"r#r$rDr*r[rirCrrrrrrArA s(I165999996///\/\\\\"    rcJg|] }t|tdddddddd !Srrrs rrr rrrc  t|tr|}n:t|ttfr d|D}nd}t ||dd}|dd}|dd} i | ||| d<|| d<| | d<tj||i fd} tj tt5tjdjd d | _dddn #1swxYwY|d d} t%| |d |d d\|d <|d <t'dd|i|| } d|D| _| S)a A quick way to create a new class called *name* with *attrs*. .. note:: ``make_class()`` is a thin wrapper around `attr.s`, not `attrs.define` which means that it doesn't come with some of the improved defaults. For example, if you want the same ``on_setattr`` behavior as in `attrs.define`, you have to pass the hooks yourself: ``make_class(..., on_setattr=setters.pipe(setters.convert, setters.validate)`` Args: name (str): The name for the new class. attrs (list | dict): A list of names or a dictionary of mappings of names to `attr.ib`\ s / `attrs.field`\ s. The order is deduced from the order of the names or attributes inside *attrs*. Otherwise the order of the definition of the attributes is used. bases (tuple[type, ...]): Classes that the new class will subclass. class_body (dict): An optional dictionary of class attributes for the new class. attributes_arguments: Passed unmodified to `attr.s`. Returns: type: A new class with *attrs*. .. versionadded:: 17.1.0 *bases* .. versionchanged:: 18.1.0 If *attrs* is ordered, the order is retained. .. versionchanged:: 23.2.0 *class_body* c,i|]}|tSr)rMrs rrAzmake_class..\ s///AAvxx///rz(attrs argument must be a dict or a list.rNrr*c.|Sr*)rR)rlbodys rrzmake_class..o s $rrr!__main__r4r:r<Trc2i|]\}}|j ||jSr*)r.)rr?r@s rrAzmake_class.. s.a!&2D162D2D2Drr)rErrFrGrApoprRr~ new_classr6r7r8rBr1 _getframe f_globalsrr"rrrr3)rbr|bases class_bodyattributes_argumentscls_dictrLr4r6 user_inittype_r4rrs @r make_classr1 sRP% ED%= ) )/////8nn||0$77H 2D99I Z..I D J%- !"&/ "#$Z OD%-G-G-G-G H HE  ^Z 8 8  =++599                    " "5$ / /C "   &&  ))   T"W% 9& 8 8x 8#7 8 8 ? ?C&nn..C Js=3D<<EE)rrc,eZdZdZeZdZdS) _AndValidatorz2 Compose many validators to a single one. c4|jD]}||||dSr*) _validators)rrrrr@s rrz_AndValidator.__call__ s5! ! !A AdD%  ! !rN)r!r"r#r$rMrrrrrrr s:&((K!!!!!rrcg}|D]4}|t|tr|jn|g5tt |S)a A validator that composes multiple validators into one. When called on a value, it runs all wrapped validators. Args: validators (~collections.abc.Iterable[typing.Callable]): Arbitrary number of validators. .. versionadded:: 17.1.0 )rrErrrG) validatorsrvr2s rrIrI sh D   )]33 I ! !    t % %%rctdD}|rfd}nfd}s2tjd}|j||dnt d}|r ||jd<d}tst|tr|j }t | }|r ||jd <|rt|d d S|S) a A converter that composes multiple converters into one. When called on a value, it runs all wrapped converters, returning the *last* value. Type annotations will be inferred from the wrapped converters', if they have any. converters (~collections.abc.Iterable[typing.Callable]): Arbitrary number of converters. .. versionadded:: 20.1.0 c3@K|]}t|tVdSr*rErA)rcs rrzpipe.. s,GGq*Q 22GGGGGGrclD]/}t|tr ||||n ||}0|Sr*r)rrrr converterss rpipe_converterzpipe..pipe_converter sM  +5a+C+COAAc4'''3Jrc(D] }||}|Sr*r)rrrs rrzpipe..pipe_converter s&  affJrA)rr=rrrZr=Tr) rtypingTypeVarr3rRr rr rErArr)rreturn_instancerrtlastrs` rrHrH sL GGJGGGGGO            : N3  &--a1.E.EFFFF !A / / D D F F  645N *5 1"~ ! 4 ; ; !=D"$ ' ' 7 7 9 9  :79N *8 4LDdKKKK r)NrNr*)T)NNNNNNNFFTFFFFFNNFFNNNTN)NNrRrS)ryrrrr<rr=r)rrrrrrJ)r|rUrrrVrrWrr5rrXrrYrrrJr#rr9rr8rrZrr=r[)rbrr=r)c __future__rr0r6rr%rFrrWr_r1r~roperatorrrNrrrr r r r r r exceptionsrrrrobjectrrrhrrVrrr5rHrrrEnumrrintr(rMrXrhrzr{rrrrrrrrrrrr@rr|rrrrrrrrrrkr!rr(r-rr@rErGrIrTr0rrrD_arJrD_frArrrIrrrrsD#"""""   ('''''''''! ')2E2266 FHH "gl7?G4DEEty(   ( ( ( ( ( ( ( ("        hhhhV    :""":%$   000"'''###>%%%8jGjGjGZ777t"777tFFFFFFFFR8((((((X.26         1]]]]@  ///DDDDDDN&#B#B#BL5*5*5*p    666r+++\&&&:...$///LLL^3333]]]])))) W W W W,/,/,/,/^AAAAHHHHHHHHHV#" I G )2&&&66"666 > =b = = =     QQQQQQQQh -0011 $'$'$'$'$'$'$'$'N! )GGIIgR888CCC2 N N NaaaaaaaaH; I GIIir * * *"555R    yTZZZZBTt$$$ ! ! ! ! ! ! !%$ !&&&.99999r