hyLSSKJr SSKrSSKrSSKrSSKrSSKrSSKrSSKrSSK r SSK r SSK r SSK J r Jr SSKJr SSKJrJrJr SSKJrJrJr SSKJrJrJrJrJrJr SS KJ r J!r!J"r"J#r# \$RJr&S r'S r(S r)\ RT"05r+\$"5r,\RZ"\R\\R^5r0"S S\Rb5r2\2Rfr3"SS\45r5\3SSSSSSSSSSSSSS4Sjr6SRSSSjjr7STSUSjjr8SVSjr9"SS\5r:Sr;Sr<SWSjr=Sr>SXSjr?Sr@SrAS rBS!rC"S"S#5rDS$rES%rFSYS&jrGSZS'jrH\HrIS(rJS[S)jrKS\S*jrLS]S+jrMS,rNS^S-jrOS.rPSTS/jrQS_S0jrRS`S1jrSS2rTS3rUS4r/S5rVSaS6jrWSbS7jrXScS9jrYSdS:jrZScS;jr[SeS<jr\SfS=jr]SgS>jr^"S?S@5r_\_RVs/sHn\_"U\3SSSSSUSA:gSS\^"U5SB9 PM snra\M"\Q"\S"\_\aSC9\aVs/sHoRSD:wdMUPM snSC9\aVs/sH)oR(dMURSD:wdM'UPM+ snSC9r_"SESF5rd\Q"\S"\d55rd"SGSH5re\eRVs/sHn\_"U\3SSSSSSSSSI9 PM snrf\M"\Q"\S"\e\fSC9\fSC9\fSC9re"SJS85rgSKVs/sHn\_"U\3SSSSSSSSSI9 PM snrf\M"\Q"\S"\g\fSC9\fSC9\fSC9rg\$4S4SLjrh\H"SSSM9"SNSO55riSPrjSQr-gs snfs snfs snfs snfs snf)h) annotationsN)CallableMapping)cached_property)Any NamedTupleTypeVar)_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_hashcF\rSrSrSr\R "5rSrSr Sr g)_Nothing=a. 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. cg)NNOTHINGselfs U[La Sn[U5e[ U 5(d Sn[U5e[ U 5nUc0n[ U [[45(a[R"U 6n U(a#[ U[[45(a[U6nU(a#[ U[[45(a[U6n[S0SU_SU_S U_S S_S U_S U_S U_SU_SU_SU _SU _SU_SU _SU_SU _SU_6$)aC 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 isinstancelisttupler pipeand_ _CountingAttr)r=r>r?r@rArBrDr:rCfactoryrErFrHrJrKrGrImsgs r"attribrYisn$> $ By D,U1BFn ' !O S/ !  >CS/ !'"*tUm,,\\:. Z D%=99)$ Z D%=99)$                         ! r%c4[XS5n[XAU5 g)zO Evaluate the script with the given global (globs) and local (locs) variables. execN)compileeval)scriptglobslocsfilenamebytecodes r"_compile_and_evalrcsv0H$r%cUc0OUnSnUn[U5SURS5U4n[RR X5nX:XaOUSSSUS3nUS- nMU[ XXA5 U$)zH Cache the script with _linecache_, compile it and return the _locals_. Nr T->)len splitlines linecachecache setdefaultrc) r^rar_localsr`count base_filenamelinecache_tupleold_vals r"_linecache_and_compilerrs2VD EM  K    d #    //,,XG  % #CR()5'3   fT4 Kr%cUS3n0n[U5HupEU4Sjn[U5X5'M [U[4U5$)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)) Attributesc X$r5r)r!is r"getter&_make_attr_tuple_class..getters 7Nr%) enumeratepropertyr:rS)cls_name attr_namesattr_class_namebodyrv attr_namerws r"_make_attr_tuple_classrsO" *-O D!*-  #6* . %4 00r%c4\rSrSr%S\S'S\S'S\S'Srg ) _Attributesir:attrslist[Attribute] base_attrsdict[str, type]base_attrs_maprN)r)r*r+r,__annotations__r0rr%r"rrs K##r%rc[U5nURS5(aURS5(aUSSnUR[5$)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. )'"r re)str startswithendswith_CLASSVAR_PREFIXES)annots r" _is_class_varr"sK JE  ##z(B(Ba    . //r%cXR;$)zJ Check whether *cls* defines *attrib_name* (and doesn't just inherit it). )__dict__)cls attrib_names r"_has_own_attributer3s ,, &&r%c/n0n[URSS5Hhn[US/5HTnUR(dURU;aM&UR SS9nUR U5 XCUR'MV Mj /n[5n[U5HBnURU;aMURSU5 URUR5 MD Xc4$)zI Collect attr.ibs from base classes of *cls*, except *taken_attr_names*. r re__attrs_attrs__T inheritedr) reversed__mro__getattrrnameevolveappendsetinsertadd)rtaken_attr_namesr base_attr_mapbase_clsafilteredseens r"_collect_base_attrsr:s JMS[[2./#4b9A{{aff(884(A   a $,!&& ! :0H 5D j ! 66T> 1  "  ""r%c/n0nURSSHrn[US/5H^nURU;aMURSS9nUR UR5 UR U5 XCUR'M` Mt X#4$)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. r rerTr)rrrrrr)rrrrrrs r"_collect_base_attrs_brokenr[sJMKK"%#4b9Avv))4(A   (   a $,!&& !:&  $$r%c ^URm[U5nUb[UR55nGO$USLaTR5VV s1sHupU R[ LdMUiM n nn /n[ 5n UR5Hnup[U 5(aMU RU 5 TRU [5nUR[ La [U5nURX45 Mp X- nU(a,[SSR[UU4SjS95-S-5eO [STR55SS9n[ R"nUV Vs/sHun nU"U UURU 55PM! nn nU(a*[%UUVs1sHoR&iM sn5unnO)[)UUVs1sHoR&iM sn5unnU(a<UVs/sHoR+SS 9PM nnUVs/sHoR+SS 9PM nnUU-nUb[-U"UU55nS nS U5HJnUSLa$UR.[LaS U<3n[1U5eUS LdM3UR.[LdMHSnML UHEnUR2(aM[4R7U5"S [9UR&55 MG UVs/sHoR&PM nn[;UR<U5n[?U"U5UU5$s sn nfs snn fs snfs snfs snfs snfs snf)a 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`. Tz1The following `attr.ib`s lack a type annotation: , c:>TRU5R$r5)getcounter)ncds r""_transform_attrs..sbffQi6G6Gr%)key.c3V# UHupUR[LdMX4v M! g7fr5) __class__rV).0rattrs r" #_transform_attrs..s) ",JD>>]2 ",s) )c USR$Nr )r)es r"rrs !A$,,r%)rEFc3h# UH(oRSLdMURSLdM$Uv M* g7f)FN)rBrErrs r"rrs( MA&&"5a!))u:Laas 2 2 2zlNo mandatory attributes allowed after an attribute with a default value or factory. Attribute in question: rK) rrrRitemsrrVrrrrrrYrrjoinsorted Attributefrom_counting_attrrrrrrSr=rNrK _OBJ_SETATTR__get___default_init_alias_forrr)r)rthese auto_attribsrEcollect_by_mrofield_transformerannsca_listrrca_names annot_namesrr:r unannotatedfcaca own_attrsrrr had_defaultrXr| AttrsClassrs @r"_transform_attrsrws2 B C D u{{}%  !hhj ( ~~. (  e #zz|OIT"" OOI &y'*A{{-/1I NNI> * ,, +C));,GH    "$((*  '    & &CELELMIrIr488I./W$7 ),)Q&&),% ! M%? ),)Q&&),% ! M5>?YXXdX+Y ?6@Ajhhth,j A  "E$'U34K M M $ 199#7ABCAFGCS/ ! % AIIW$<K Nwww   #G-DQVV-L M#((%Q&&%J(' jAJ z%(*m DDm J --@A>)s0L8,L80&L>*M M >MM8Mc/SQnUbURS5 OUR/SQ5 URSS/5 [US5nU[RUS.n[ SR U5XES U0S 9S $) 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 _cls)rm __getattr__)rextend_generate_unique_filenamerrrrr)rrrlinesunique_filenameglobs r"_make_cached_property_getattrrs E# :      LL $ ) 0Y?O/+33, D " %/   r%cr[U[5(aUS;a[RXU5 g[e)z, Attached to frozen classes as __setattr__. ) __cause__ __context__ __traceback____suppress_context__ __notes__N)rQ BaseException __setattr__rr!rvalues r"_frozen_setattrsrs8$ &&44, !!$e4 r%cp[U[5(aUS;a[RX5 g[e)z, Attached to frozen classes as __delattr__. )rN)rQr __delattr__r)r!rs r"_frozen_delattrsr(s/$ &&4>+A!!$- r%c,UunURn[ U5nUHBnUR (dMUR nURnX;dM5[X'5X'MD U"S0UD6$![a S[U5S3n[U5Sef=f)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) rNrhrMrfieldsrBrrKr) argschangesinstrXrrrr init_names r"rr3sJ' ..C 3KE vv FF GG  #!(!9G   >>! '8T ; O n$& 's A--&Bc\rSrSrSrSrSSjrSrSSjrSr Sr S r S r S r S rS rSrSrSrSrSrSrSrSrSSjrSSjrSrg) _ClassBuilderimz Iteratively build *one* class. )_add_method_dunders _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 _repr_added_script_snippets_slots _weakref_slot_wrote_own_setattrc[UUUUU U5unnnXlU(a[UR5O0UlXlUVs1sHnUR iM snUlUUl[SU55Ul X0l X@l XPl Xl[[!USS55UlSUlUR"(a?UR&n[(R*"U5n[-UR.5S:Ul[[!USS55Ul[U5(+UlXlXlXlSUlUR URS'U(a.[<URS'[>URS'S UlOU [@[BRD[BRF4;aS=nnUH3nURHbS nURJbS nU(dM*U(dM3 O U [@:XaU(dU(a6U [BRD:XaU(aU [BRF:XaU(dSUlU(a-URM5uURS 'URS '/Ul'SUl([SURS 5(aURS 5(dURTUl+gURXUl+gs snf)Nc38# UHoRv M g7fr5rrs r"r)_ClassBuilder.__init__..s 7As__attrs_pre_init__Fr __attrs_post_init__rrrT __getstate__ __setstate__r*r+)-rrdictrrrrrrrSrrrrrboolrrr rinspect signaturerh parametersrrr r rrrr_DEFAULT_ON_SETATTRr validateconvertr>rC_make_getstate_setstater r hasattr_add_method_dunders_safer_add_method_dunders_unsafe)r!rrslotsfrozen weakref_slotgetstate_setstaterrE cache_hashis_excrrJhas_custom_setattrrrrbase_mapr pre_init_funcpre_init_signature has_validator has_converters r"__init___ClassBuilder.__init__s"'7       ' #z8 /4cll+" ,67JqAFFJ7& 7 77  )%!'#/CU"KL"'    22M!(!2!2=!A &)*<*G*G&H1&LD #"730Eu#MN#'; %#5 "',0KK() ,)rr)r s r"r#_ClassBuilder.__repr__s$TYY%7%7$8;;r%cPSRURVs/sHoSPM sn5n0nURHupEnURU5 M [U[ UR S5U5nURHu pGU"UR U5 M gs snf)z- Evaluate any registered snippets in one go. rrmethodsN)rr updaterrrrr)r!snippetr^r__ snippet_globsr`hooks r"_eval_snippets_ClassBuilder._eval_snippetssd6K6KL6K7AJ6KLM#'#8#8 Aa LL '$9&  %dii ;   //JAq  &0MsB#c,UR5 URSLaUR5nO1UR5n[(a[ R "U5n[USS5(a SUR;aUR5 U$)zk Finalize class based on the accumulated configuration. Builder cannot be used after calling this method. T__attrs_init_subclass__N) r<r_create_slots_class_patch_original_classrabcupdate_abstractmethodsrrr?)r!rs r" build_class_ClassBuilder.build_class s|  ;;$ **,C,,.C|005 C2D 9 9)=  ' ' ) r%c(URnURnUR(aaURHQnX2;dM [ X[ 5[ LdM#[ R"[5 [X5 SSS5 MS URR5Hup4[XU5 M UR(d5[ USS5(a#SUlUR(d [ UlU$!,(df  M=f)z1 Apply accumulated methods and return the class. N__attrs_own_setattr__F)rrrrr _SENTINEL contextlibsuppressAttributeErrordelattrrrsetattrrrGrrr)r!r base_namesrrs r"rA#_ClassBuilder._patch_original_class"sii%%    ((*95YF $,,^<*=<) >>//1KD Cu %2 &&7 (%, , ).C %++". #=NO =!#3TYY!B}  (-GutJ0Fdu G*8)=)=)? )?%oz! "D/ !)?  (2Nzt5Mdz N ,      / 0 +;!YY33>499odii00$))2E2ErJOO LL   !#I D$l ;<<!( }d K D(++!( =$ G 'mT B  %1 ..$));E -0*&! 2 K >" >H  OJ"sS&RRR -R R4 R$R$ R)-R); R/R/!R44 SSc^[TRU5up#U4SjnTRRX#U45 STlT$)Nc4>TRUS5US'g)Nr#rcls_dictr_r!s r" _attach_repr,_ClassBuilder.add_repr.._attach_reprs#'#;#;E*.__str__s==? "r%r)r rNrr)r!rXrs r"add_str_ClassBuilder.add_strs?GCS/ ! #%)$<$.s! )2=-@BB)s  cF>TVs0sHo[X5_M sn$s snf! Automatically created by attrs. r)r!rstate_attr_namess r"slots_getstate=_ClassBuilder._make_getstate_setstate..slots_getstates(;KK:J$'$--:JK KKsc>[RU5n[U[5(a[ TU5H up4U"X45 M OTHnX1;dM U"X1U5 M T(aU"[ S5 gg)rN)rrrQrSziprY)r!state_ClassBuilder__bound_setattrrrhash_caching_enabledrs r"slots_setstate=_ClassBuilder._make_getstate_setstate..slots_setstatess+2248O%''$''7#?KD#D0$@-D}'Dk:-$ 148$r%)rSrr)r!rrrrs @@r"r!%_ClassBuilder._make_getstate_setstatesG !! ))!   L $// 9,--r%c$SURS'U$N__hash__)rr s r"make_unhashable_ClassBuilder.make_unhashables%)z" r%c^[TRTRTRTRS9upSU4SjjnTR R XU45 T$)Nr&r)c4>TRUS5US'grrv)rxr`r!s r" attach_hash+_ClassBuilder.add_hash..attach_hashs#'#;#;DUSnTUlTRU5US'g)Nr1rrrxr_rBrr!s r" _attach_init,_ClassBuilder.add_init.._attach_init2s*$D#.D #'#;#;D#AHZ r%_make_init_scriptrrrr rrrrrr r r r)r!r^r_rrs` @r"add_init_ClassBuilder.add_init"s%6 II KK     # #    LL KK       LL    & "{ B $$f\%BC r%cDURS5URS'U$)Nc[U40UD6$r5)r)r!rs r"r+_ClassBuilder.add_replace..=sF4$;7$;r% __replace__)rrr s r" add_replace_ClassBuilder.add_replace;s%(,(@(@ ;) }% r%cV[SUR55URS'g)Nc3# UH7nUR(dMUR(aM)URv M9 g7fr5)rBrEr)rfields r"r/_ClassBuilder.add_match_args..Bs01 $zz "'-- EJJ$sAAA__match_args__)rSrrr s r"add_match_args_ClassBuilder.add_match_argsAs'+01 1 , '(r%c\^^[TRTRTRTRTR TR TRTRTRTRTRSS9 upmUU4SjnTRRXU45 T$)NTrcF>USnTUlTRU5US'g)N__attrs_init__rrs r"_attach_attrs_init8_ClassBuilder.add_attrs_init.._attach_attrs_initXs,)*D#.D )-)A)A$)GH% &r%r)r!r^r_rrs` @r"add_attrs_init_ClassBuilder.add_attrs_initHs%6 II KK     # #    LL KK       LL    & "{ H $$f5G%HI r%c^TRn[TR5up#U4SjnTRR X#U45 [ US'T$)Nc4>TRUS5US'g)N__eq__rvrws r" _attach_eq(_ClassBuilder.add_eq.._attach_eqfs!%!9!9%/!JHX r%__ne__)r_make_eq_scriptrr rr)r!rr^r_rs` r"add_eq_ClassBuilder.add_eqasK ^^' 4  K $$fZ%@A8  r%c^TRnU4Sj[TRTR55uUS'US'US'US'T$)Nc3F># UHnTRU5v M g7fr5rv)rmethr!s r"r*_ClassBuilder.add_order..rs'B ;  $ $T * *;s!__lt____le____gt____ge__)r _make_orderrr)r!rs` r" add_order_ClassBuilder.add_orderosL ^^B #DIIt{{;B >8 blBxL"X,  r%c^0mURHPnUR=(d URnU(dM+U[RLdM@X4TUR 'MR T(dU$UR (a Sn[U5eU4SjnSURS'URU5URS'SUl U$)Nz7Can't combine custom __setattr__ with on_setattr hooks.cd>TUup4U"XU5n[XU5 g![a UnNf=fr5)KeyErrorr)r!rvalrr;nvalsa_attrss r"r._ClassBuilder.add_setattr..__setattr__sA *"4.DS) T *   s  //TrGr) rrJr r NO_OPrrrNrrr)r!rrJrXrrs @r" add_setattr_ClassBuilder.add_setattrysA9)9)9Jzj =#$=  K  # #KCS/ ! +37./(,(@(@(M}%"& r%cURRUlURRSUR3UlSURRS3UlU$)z0 Add __module__ and __qualname__ to a *method*. r$Method generated by attrs for class )rr*r+r)r-r!methods r"r$(_ClassBuilder._add_method_dunders_unsafes`!II00!%!7!7 8&//9JK34993I3I2J! L  r%c[R"[5 URRUlSSS5 [R"[5 URR SUR 3UlSSS5 [R"[5 SURR S3UlSSS5 U$!,(df  N=f!,(df  Nc=f!,(df  U$=f)z< Add __module__ and __qualname__ to a *method* if possible. Nrr)rIrJrKrr*r+r)r-rs r"r#&_ClassBuilder._add_method_dunders_safes  0 $ 4 4F 1  0%)YY%;%;$_determine_attrib_eq_order..decide_callable_or_booleans- E??u3zCzr%FTrr) r@rFrHrrXrcmp_keyrGrIs r"rLrLs  3$T0ABCC6o 1#6 S)) zF/3  }y5e< U{u}=o u ''r%chUSLdUSLaU$UcUSLaU$UHn[X5(dM g U$)aX 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_detectdundersr=dunders r"_determine_whether_to_implementrsH t|tu}  | u, c * * Nr%c@^^^^^^^^ ^ ^ ^ ^ ^^^^^^^^^TbSSKnUR[S5SS9 [XOUS5ummUbUm[ T[ [ 45(a[R"T6mU UUU UUUUUUUU UUUUUUU UU 4SjnUcU$U"U5$)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.) stacklevelc>T=(d [U5nT SL=(a [U[5nT=(a [US5nU(aU(a Sn[ U5e[ UTTUT[ UTTSTS9TTT UT TUT 5n[ UTTS5(aURT5 TSLaUR5 [ UT TS5nU(dUSLaUR5 U(d#[ UTTS5(aUR5 T(dUR5 TcTSLa[US 5(aS mTSLaTS LaTb S n[U5eTS LdTcUS LdU(aT (a S n[U5eOGTSLd TcUSLaUSLaUR5 O$T (a S n[U5eUR5 [ UTTS 5(aUR5 O$UR!5 T (a Sn[U5e["(a![US5(dUR%5 [&(a(T(a![US5(dUR)5 UR+5$)NTrz/Can't freeze a class with a custom __setattr__.)rr)r=r)rr)rrrrrFr<zlInvalid value for cache_hash. To use hash caching, hashing must be either explicitly or implicitly enabled.r1zFInvalid value for cache_hash. To use hash caching, init must be True.rr)_has_frozen_base_class issubclassrrrNrrr}rrrrrMrrrrrrrrrD)r is_frozenr*has_own_setattrrXbuilderrFrrauto_excr)req_rr&r(rArBrE match_argsrJorder_r?repr_nsr%rrr's r"wrapattrs..wraps94S9 T!Djm&D% *< +  yCCS/ !      +!0          ) . + {M     W % $; OO  , k#7 "* NN 9 &N          ! Lt#"3 33D t E 1d6FJCC. 5=T\bEkfEn$T\ LR4ZI,=    En$  # # % * {M        " " $^n$ < 23 F F    ! L&s,<==  " " $""$$r%) warningswarnDeprecationWarningrrQrRrSr rT) maybe_clsrrr?r@rArBr%r&r'rrrEr)r rFrHrrr(rJrr  unsafe_hashrrr r s ``` `````````` `````` @@r"rrsx c   ,CUDAKC*tUm,,\\:. j%j%j%j%\  ?r%c&UR[L$)zJ Check whether *cls* has a frozen ancestor by looking at its __setattr__. )rr)rs r"rrs ??. ..r%c XSUSURS[USUR5S3$)z> Create a "filename" suitable for a function being generated. z.s/aFFdNqvv!$$$,5s ? ? ? rAzdef __hash__(selfzhash((z))z):z, *zC, _cache_wrapper=__import__('attr._make')._make._CacheHashWrapper):z_cache_wrapper()c v>TRX-T-UST S3-/5 TH|nUR(aFSURS3nURTU'TRUSUSURS3-5 MZTRUSURS3-5 M~ TRUS-T-5 g ) 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,r9_key(self.z), self. N)rrGrr) prefixindentrcmp_namerclosing_bracesr_ hash_func method_lines type_hashs r"append_hash_computation_lines8_make_hash_script..append_hash_computation_lines/s )+8I;a00  Axxqvvhd+"#((h##xzxrBB##F}QVVHA-F$FG FVOn<=r%zif self.z is None:zobject.__setattr__(self, '', rself. = z return self.zreturn r)rSrArrrYr) rrr&r)tabhash_defr,r^r(r_r)r*r+s ` @@@@@r"rrsF  E C.sF;>4CH->,?y"IIJ  ),->,?sCS1W    a# . ))*#.a  CL1B0C"DDE%i5 YY| $F 5=r%c\[XSSS9up#[X#[US5S9 USUlU$)z Add a hash method to *cls*. Frrra)rrcrrrrr^r_s r" _add_hashr6\sA& 5UMF 9#z J$CL Jr%cPURU5nU[La[$U(+$)zR Check equality and either forward a NotImplemented or return the result negated. )rNotImplemented)r!otherresults r"rrjs( [[ F :r%c RUVs/sHoR(dMUPM nn/SQn0nU(aURS5 UHnUR(aQSURS3nURX4'URSUSURSUSURS 3 5 O+URS URS UR35 XS LdMUS S 3US 'M URS5 OURS5 SR U5nXS4$s snf)z. Create __eq__ method for *cls* with *attrs*. )zdef __eq__(self, other):z- if other.__class__ is not self.__class__:z return NotImplementedz return (r9r!rr"z) == z(other.rr#z == other.rez andz )z return Truer)rFrrGrr)rrrr_r'r^s r"rrvs &1QE & E E  _%Axxqvvhd+#$(( xjqvvheH:WQVVHTUV }QVVHJqvvhGHb !$Ryk.b   W &' YYu F == 's D$D$c^^TVs/sHo"R(dMUPM snmU4SjmU4SjnU4SjnU4SjnU4SjnX4XV4$s snf)z1 Create ordering methods for *cls* with *attrs*. c>>^[SU4SjT555$)z Save us some typing. c3H# UHupU(aU"U5OUv M g7fr5r)rrrs r"r6_make_order..attrs_to_tuple..s(  CJ5 ( "c3h># UH'n[TUR5UR4v M) g7fr5)rrrI)rrobjs r"rr?s(=Baff%q{{3Us/2)rS)rBrs`r"attrs_to_tuple#_make_order..attrs_to_tuples) =B   r%cd>URURLaT"U5T"U5:$[$rrr8r!r9rCs r"r_make_order..__lt__0 ??dnn ,!$'.*?? ?r%cd>URURLaT"U5T"U5:*$[$rrFrGs r"r_make_order..__le__0 ??dnn ,!$'>%+@@ @r%cd>URURLaT"U5T"U5:$[$rrFrGs r"r_make_order..__gt__rIr%cd>URURLaT"U5T"U5:$[$rrFrGs r"r_make_order..__ge__rLr%)rH)rrrrrrrrCs ` @r"rrsI )1Q )E   6 ))c *s A A cUc URn[U5up#[X#[US5S9 USUl[ UlU$)z- Add equality methods to *cls* with *attrs*. rr4)rrrcrrrr5s r"_add_eqrRsN }###E*MF 9#x HxCJCJ Jr%c[SU55nUVVVs0sHup4oT[:wdMUS-U_M nnnn[US'[US'[US'/nUHMup4nU(aSU-OSU-S-n U[:Xa U<S U <S 3O U<S U<S U <S 3n UR U 5 MO S R U5n UcSn OUS-n SSSSSSSSSSSSSU SU S3SS/n S R U 5U4$s snnnf)!z; Create the source and globs for a __repr__ and return it. c3# UHNnURSLdMURURSLa[O URUR4v MP g7f)FTN)r?rrBrs r"r$_make_repr_script..sD"A 66  ?!&&D.$affqvv>s A?A_reprr rKrr/zgetattr(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))r)rSr?r rKrrr)rr|attr_names_with_reprsrrr9r_attribute_fragmentsrvaccessorfragment repr_fragmentcls_name_fragmentrs r"r{r{s]""" -B ,Ajdq$Yw,A  E),E E)+ GdN%6%= %M  Dy  *'+T8<  ""8,,II12M zO!== D"+D-- )*!M?"=. E$ 99U U ""U s C2 C2czUc URn[X!5up4[X4[US5S9 USUlU$)z Add a repr method to *cls*. r#r4)rr{rcrr#)rr|rr^r_s r" _add_reprr`sH }##%e0MF 9#z J$CL Jr%c[U5nUc"[U[5(d Sn[U5e[ USS5nUc,Ub[ USS5nUbX0lU$U<S3n[ U5eU$)a  Return the tuple of *attrs* attributes for a class. The tuple also allows accessing the fields by their names (see below for examples). Args: cls (type): Class to introspect. Raises: TypeError: If *cls* is not a class. attrs.exceptions.NotAnAttrsClassError: If *cls* is not an *attrs* class. Returns: tuple (with name accessors) of `attrs.Attribute` .. versionchanged:: 16.2.0 Returned tuple allows accessing the fields by name. .. versionchanged:: 23.1.0 Add support for generic classes. NPassed object must be a class.r! is not an attrs-decorated class.)rrQr:rMrrr)r generic_baserXrs r"rr,s.$C(LJsD$9$9.n C*D 1E }  #L*;TBE ',# 89"3'' Lr%c[U[5(d Sn[U5e[USS5nUcU<S3n[ U5eUVs0sHo3R U_M sn$s snf)a Return an ordered dictionary of *attrs* attributes for a class, whose keys are the attribute names. Args: cls (type): Class to introspect. Raises: TypeError: If *cls* is not a class. attrs.exceptions.NotAnAttrsClassError: If *cls* is not an *attrs* class. Returns: dict[str, attrs.Attribute]: Dict of attribute name to definition .. versionadded:: 18.1.0 rbrNrc)rQr:rMrrr)rrXrrs r" fields_dictrfZsj& c4 .n C*D 1E }89"3''$ %u!FFAIu %% %sA!c [RSLag[UR5H0nURnUcMU"X[ XR 55 M2 g)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_validatorsrrr>rr)rrrcs r"rrwsI%' DNN # KK = dwtVV, -$r%cTURU5nU=(a SUR;$)z6 Check if the attribute name comes from a slot class. rR)rr)a_namerrs r" _is_slot_attrrks(   F #C  .;#,,..r%c $U SL=(a U [RLn U(aU (a Sn [U 5eU=(d Un/n0nUHnUR(dUR[ LaM)UR U5 UUUR'URbUSLa Sn [U 5eSnMlU (dMuUR[RLdMSnM [UUUUUUUUU UU U (aSOS5 unnnUR[R;a6UR[RURR5 UR[ US.5 U(a[R US'UUU4$)Nz$Frozen classes can't use on_setattr.Trr1)r attr_dictr)r rrNrBr=rrrrJ_attrs_to_init_scriptr*sysmodulesr7rrr)rrpre_initpre_init_has_args post_initr&r%r)rr*cls_on_setattrrhas_cls_on_setattrrXneeds_cached_setattrfiltered_attrsrmrr^r_rs r"rrsh d"J~W]]'J$4o%/NI vv!))w. a  !&& << #~< o%#'  ALL $E#'  "7 &J "FE; ~~$ S[[099: LLW9=>(4';';#$ 5+ %%r%cSUSUS3$)zB Use the cached object.setattr to set *attr_name* to *value_var*. _setattr('r.rr)r value_varhas_on_setattrs r"_setattrr|s {#i[ 22r% Converterc2SUSURX5S3$)z_ Use the cached object.setattr to set *attr_name* to *value_var*, but run its converter first. ryr.r)_fmt_converter_callrrzr{rCs r"_setattr_with_converterrs& {#i&C&CI&Y%ZZ[ \\r%c8U(a [XS5$SUSU3$)zc Unless *attr_name* has an on_setattr hook, use normal assignment. Otherwise relegate to _setattr. Tr/r0)r|)rrr{s r"_assignrs'  $// 9+S ((r%cXU(a [XSU5$SUSURX53$)z Unless *attr_name* has an on_setattr hook, use normal assignment after conversion. Otherwise relegate to _setattr_with_converter. Tr/r0)rrrs r"_assign_with_converterrs5&yT9MM 9+S!>!>y!T U VVr%c^USLa9USLa S[[4$SU4SjjnSU4SjjnSUU4$S[[4$)z[ Determine the correct setter functions based on whether a class is frozen and/or slotted. TrcN>[UT5(a [XU5$SUSU3$N _inst_dict['z'] = )rkr|)rrzr{rs r" fmt_setter&_determine_setters..fmt_setters2Y 66 nEE!)E)= =r%cz>U(d[UT5(a [XX#5$SUSURX53$r)rkrr)rrzr{rCrs r"fmt_setter_with_converter5_determine_setters..fmt_setter_with_convertersH y-!H!H..")E)2O2OPY2e1fg gr%)z_inst_dict = self.__dict__rrrzrr{rrr rrrzrr{rrCr}rr)r|rrr)r&r%rrrs ` r"_determine_settersrs~ D=x!88 8 > >'* ><@ >  > h h h! h! h  h ,  %   w. ..r%c U(aS/O/n U (aU RS5 [XU5upnU RU 5 /n/n/n0nSS0nUGH!nUR(aURU5 URnUR SL=(d% UR [ RL=(a U nURn[UR[5nU(aURR(aSOSnURb5[UR[5(d[UR5nO URnURSLGa U(a[ UR4-nUbJU RU"UUSUS 3-UU55 URUUR#UR5'O U RU"UUSUS 3-U55 URR$UU'GO UbHU RU"US US 3UU55 URUUR#UR5'GOU RU"US US 3U55 GOUR[&LaU(dUS US 3nUR((aURU5 OURU5 UbDU RU"UUUU55 URUUR#UR5'GOU RU"UUU55 GOU(GaNUS 3nUR((aURU5 OURU5 U RSUS35 [ UR4-nUb}U RSU"UUUU5-5 U RS5 U RSU"UUS-U-S -UU5-5 URUUR#UR5'ORU RSU"UUU5-5 U RS5 U RSU"UUS-U-S -U5-5 URR$UU'OUR((aURU5 OURU5 UbCU RU"UUUU55 URUUR#UR5'OU RU"UUU55 URSLdGMUR*bUcUR*UU'GMUcGMUR,(dGMUR,UU'GM$ U(az[.US'U RS5 UHZnSUR-nSUR-nU RSUSUSURS 35 URUU'UUU'M\ U(aU RS5 U(a?U(aU(a S[0S3nOS[0S3nO S[0S3nU RU5 U(a-S R3S!U55n U RS"U S 35 S#R3U5nUn!U(acUU(aS#OSS$S#R3U53- nS#R3S%U5V"s/sH n"U"S&U"3PM sn"5n#U!U!(aS#OS- n!U!U#- n!U(aU(a S'U!S 3U S('S)n$S*U SUS+U (aU$R3U 5OS,S-3UU4$s sn"f).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)rNr!FrWrz attr_dict['z '].defaultz =attr_dict['z=NOTHINGzif z is not NOTHING:r$zelse:Tr z#if _config._run_validators is True:__attr_validator___attr_z(self, z, self.zself.__attrs_post_init__()ryz', None)rz '] = Noner/z = Noner c3d# UH&oR(dMSUR3v M( g7f)r/N)rBrrs r"r(_attrs_to_init_script.. s"B%Q66(%x(%s00zBaseException.__init__(self, rz*, c3H# UHoRS5Sv M g7f)=rN)split)rkwas r"rr s#N#IIcN1$5r@rzself.__attrs_pre_init__(rz zdef z): passr)rrrr>rrJr rrKrQr=rP takes_selfrCr}rB_INIT_FACTORY_PAT_get_global_namerWrrEr:_first_param_typer rYr)%rr is_slotted call_pre_initrrcall_post_initdoes_cache_hashrr*rvru method_namer extra_linesrrr kw_only_argsattrs_to_validatenames_for_globalsrrrr{arg_name has_factory maybe_selfrCinit_factory_nameargval_nameinit_hash_cachevals pre_init_args kw_arg_namepre_init_kw_only_argsNLs% r"rnrn.s*(.; ( )E  3  :L}:6K6 LL DLT"K  ;;  $ $Q 'FF T1 LL - D2D  77 G4 *qyy/C/CV ;; ":akk9+M+M!!++.I I 66U?$5 $A!(LL1%-!Jvv!i&7() H%&9+F+F+F(1(C(C H%kn'.)$ :;"A*QVV3H!AFF*I LL4z 7166(!L M*+++ h '+, i ( # 12 $./@.A"J$01B0C9"M %&7%8@O _%xxB%BB 4TF!<= 99T?DM 44R(DIIl,C+DEE $ $O#N $OK-q .#N !  B6 .. *-m_A>a B  WTF+RWWU^&)*     s] c$URS5$)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. r9)lstriprs r"rr2 s ;;s r%cp\rSrSrSrSrS SjrSr\SSSjj5r Sr S r S r S r S rg)ri= a6 *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`. )rr=r>r?rFrGrHrIrArBrDr:rCrErrJrKNc[X^=(d U U=(d US5upnn[RU5nU"SU5 U"SU5 U"SU5 U"SU5 U"SU 5 U"SU5 U"SU5 U"S U5 U"S U5 U"S U5 U"S U 5 U"S U (a[R"[ U 55O[ 5 U"SU 5 U"SU 5 U"SU5 U"SU5 U"SU5 g)NTrr=r>r?rFrGrHrIrArBrCrDr:rErrJrK)rLrrtypesMappingProxyTyper_EMPTY_METADATA_SINGLETON)r!rr=r>r?r@rArBrrDr:rCrErFrGrHrIrJrK bound_setattrs r"r1Attribute.__init__~ s*(B 2y1E4( $E9 %,,T2  fd#i)k9-fd#dBh'gu%k9-fd#fd#k9- &&tH~6.   fd#i)k9-lJ/gu%r%c[er5)rrs r"rAttribute.__setattr__ s!!r%cUc URnOURbSUS3n[U5eU"UURURURSUR UR SURUURURURURURURURUR5$)Nz>Type annotation and type argument cannot both be present for 'z'.F)r:rN_default _validatorr?rArBrDrCrErFrGrHrIrJrK)rrrr:rXs r"rAttribute.from_counting_attr s <77D WW RSWRXXZ[CS/ !  KK MM GG  GG GG  KK  LL JJ EE II HH LL MM HH%  r%c p[R"U5nURUR55 U$)z 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)r!rnews r"rAttribute.evolve s(iio gmmo& r%cB^[U4SjTR55$) Play nice with pickle. c3r># UH,nUS:wa [TU5O[TR5v M. g7f)rDN)rrrDrrr!s r"r)Attribute.__getstate__.. s4 &$(:#5GD$ 4 ;N N&s47rSrRr s`r"rAttribute.__getstate__ s#    r%cNUR[URU55 grN)rrrRr!rs r"rAttribute.__setstate__ s s4>>512r%c [RU5nUHHup4US:wa U"X45 MU"UU(a[R"[ U55O[ 5 MJ g)NrD)rrrrrr)r!name_values_pairsrrrs r"rAttribute._setattrs sU$,,T2 ,KDz!d*!..tE{;6  -r%r) NNNFNNNNNNr5)rrrrV)r)r*r+r,r-rRr1rr]rrrrrr0rr%r"rr= sb(XI<  '5&n"  :$ 3 r%rrD) rr=r>r?r@rFrHrArBrrK)rrc~\rSrSrSrSr/\"SS55Q\"SSSSSSS SS SSS SS SS 9P7rS r S r S r Sr Sr g)rVi! a Intermediate representation of attributes that uses a counter to preserve the order in which the attributes have been defined. *Internal* data structure of the attrs library. Running into is most likely the result of a bug like a forgotten `@attr.s` decorator. )rrrKrCrrFrGrArBrErDrJrHrIr?r:c#j# UH)n[U[U5[SSSSSSSSSSSSS9v M+ g7f)NTFrrKr=r>r?r@rArBrErFrGrHrIrrJ)rrr)rrs r"r_CountingAttr.= sR $ # -d3 " s13) rrr?rFrHrArBrJrKrDNTFrrc[=RS- sl[RUlXlX lXplX0lXlXlXl Xl XPl X`l Xl XlXlXlUUlgr)rV cls_counterrrrrCr?rFrGrHrIrArBrDr:rErJrK)r!r=r>r?r@rArBrCrDr:rErFrGrHrIrJrKs r"r1_CountingAttr.__init__o so& !!Q&!$00  #"   "     $ r%cfURcXlU$[URU5UlU$)zl Decorator that adds *meth* to the list of validators. Returns *meth* unchanged. .. versionadded:: 17.1.0 )rrUr!rs r"r>_CountingAttr.validator s3 ?? ""O #4??D9DO r%cVUR[La[e[USS9UlU$)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)r)rrrrPrs r"r=_CountingAttr.default s) == '( (6  r%)r)r*r+r,r-rRrSrrrr1r>r=r0rr%r"rVrV! sI$0  $ %  0>  ?0ObK#J r%rVc2\rSrSrSrSrSSjrSrSrSr g) rPi a 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* rWrcXlX lgr5r)r!rWrs r"r1Factory.__init__ s  $r%cB^[U4SjTR55$)rc3<># UHn[TU5v M g7fr5rrs r"r'Factory.__getstate__.. sD^TWT4((^srr s`r"rFactory.__getstate__ sDT^^DDDr%cZ[URU5Hup#[XU5 M gr)rrRrM)r!rrrs r"rFactory.__setstate__ s%t~~u5KD D &6r%N)F) r)r*r+r,r-rRr1rrr0rr%r"rPrP s$*I%E 'r%rP) rr=r>r?r@rFrHrArBrcV\rSrSrSrSrSSS.Sjr\S Sj5rSSjr S r S r S r g )r}i a1 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__r _global_namerC takes_fieldrFrrc^UTlUTlUTl[U5nUR 5TlTR(dTR(d U4SjTlOgTR(aTR(d U4SjTlO9TR(dTR(a U4SjTlO U4SjTlUR5nUbUTR RS'gg)Nc&>TRU5$r5rC)rr9__r!s r"r$Converter.__init__.. s1Fr%c&>TRX5$r5r)rinstancerr!s r"rr s9r%c&>TRX5$r5r)rrrr!s r"rr sT^^6r%c(>TRXU5$r5r)rrrr!s r"rr# s4>><r%r) rCrrrget_first_param_typerrget_return_typer)r!rCrrexrts` r"r1Converter.__init__ s"$& !) ,!#!8!8!:4#3#3FDM __T%5%5DMT%5%5DMDM   ! >68DMM ) )( 3 r%c SU3$)zP Return the name that a converter for an attribute name *attr_name* would have. __attr_converter_r)rs r"rConverter._get_global_name+ s #9+..r%cpUR(d(UR(dURU5SUS3$UR(a+UR(aURU5SUSUS3$UR(aURU5SUS3$URU5SUSUS3$)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`. rWrz, self, attr_dict['z'])z, self)z , attr_dict[')rrr)r!rrzs r"rConverter._fmt_converter_call3 s 4#3#3++I67q 1E E ??t//++I67q CVW`Vaade e ??++I67q 7K K'' 231YK}YKWZ[[r%cJURURURS.$)z` Return a dict containing only converter and takes_self -- the rest gets computed when loading. rCrrrr s r"rConverter.__getstate__D s% //++  r%c(UR"S0UD6 g)z Load instance from state. Nrrrs r"rConverter.__setstate__O s r%)rrrCrrN)rrrr)rrrzrrr) r)r*r+r,r-rRr1r^rrrrr0rr%r"r}r} s>(I16596//\"  r%rc ^[R"SU5n[U[5(aUnOC[U[[ 45(aUVs0sH of[ 5_M nnO Sn[U5eURSS5nURSS5n URSS5n 0mUbTRU5 UbUTS'U bU TS'U bU TS'[R"X0U4Sj5n [R"[[5 [ R""S5R$R'S S 5U lSSS5 URS S5n [+U UR'S 5UR'S 5S5uUS 'US '[-SSU0UD6"U 5n UR/5VVs0sH upUR0cMXR0_M" snnU lU $s snf!,(df  N=fs snnf)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)`` .. warning:: It is *your* duty to ensure that the class name and the attribute names are valid identifiers. ``make_class()`` will *not* validate them for you. 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* .. versionchanged:: 25.2.0 Class names can now be unicode. NFKCz(attrs argument must be a dict or a list.rNrr1c&>URT5$r5)r7)r|r~s r"rmake_class.. s  $r%r r)__main__r@rFrHTrr) unicodedata normalizerQrrRrSrYrMpopr7r new_classrIrJrKrNro _getframe f_globalsrr*rrrr:r)rrbases class_bodyattributes_argumentsrxrrXrqrs user_inittype_r@rrbrcr~s @r" make_classrk s`   .D% ED%= ) ))./AvxK/8n||0$7H 2D9I Z.I D J%- !"&/ "#$Z OOD-G HE   ^Z 8==+5599    9  " "5$ /C "   &  )  T"W%  8x 8#7 8 ?C'nn..da!&& 66 .C J_02 9 8&sG06G5>HH5 H)r%rc,\rSrSrSr\"5rSrSrg) _AndValidatori z* Compose many validators to a single one. c<URH nU"XU5 M gr5) _validators)r!rrrrcs r"r_AndValidator.__call__ s!!A d% "r%rN) r)r*r+r,r-rYrrr0rr%r"rr s(K!r%rc/nUH6nUR[U[5(a UROU/5 M8 [[ U55$)z 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 )rrQrrrS) validatorsrr>s r"rUrU sM D  )]33  ! !   t %%r%c^[ST55nU(aU4SjnOU4SjnT(d)[S5nURRX3S.5 O[ TS5R 5nU(aXBRS'TSn[ (d![U[5(a URn[ U5R5nU(aXbRS 'U(a [US S S 9$U$) aa 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 c3B# UHn[U[5v M g7fr5rQr})rcs r"rpipe.. sGJq*Q 22Jscf>TH)n[U[5(a U"XU5OU"U5nM+ U$r5r%)rrrr& converterss r"pipe_converterpipe..pipe_converter s5+5a+C+CAc'3 Jr%c*>TH nU"U5nM U$r5r)rr&r)s r"r*r+ sf Jr%A)rrrrrerTr) rr rr7rrrrQr}rr)r)return_instancer*r-tlastrs` r"rTrT s GJGGO    CL&&--a.EF !A / D D F 45 * *5 1"~| 4 ; ;==D"$ ' 7 7 9 79 * *8 4DdKK r%)Nr) r^rr_dict[str, Any] | Noner`Mapping[str, object] | Nonerarrrr5) r^rrarr_r1rmr2rzdict[str, Any])r{rr|z list[str]rr:)rz'tuple[list[Attribute], dict[str, type]])rr)T)NNNNNNNFFTFFFFFNNFFNNNTN)rr:rrrr) rr:rrr&rr)rrtuple[str, dict])rr:rr)rrRrr3)rr3)NN)rtuple[str, dict, dict]rr)rrrrr{rrr)r&rr%rrr)rrrrrrrrrrrrrrrrrr*rrvrrurrrrr4)rrrr)k __future__rrBrIrr.rrZrjrorrcollections.abcrr functoolsrtypingrrr rr r r rrrrrr exceptionsrrrrobjectrrrrrYrrrHrTr rrEnumrrintr2rYrcrrrrrrrrrrrrrrrrLrrrrrrr6rrrrRr{r`rrfrkrr|rrrrrnrrrR_arrArVrP_fr}rrrU)rrs00r"r?s #   -%++('!! ')!2226 H ll7??G4D4DEtyy(    ( ("        h\)-       &      $+/     !  (   F1.$*$ 0"'#,#B%8iEiEX1h"7tG G T8((X.26         1`F  /E E%E/3EAEEEP  "J5*p"6#r +\&:.$/B&B&J3]]"]48]EN]]) W W" W48 WEN W W,/ ,/,/.=,/^A AAA A  A  AA#A AAAAAHGGp##$    j %d+ $"  )2&6"Q+ 5q"6 =bFF1qvv'<1b =   QQh -01 $'$'h!!"       " GIgR8C2 Naab;;       ;  Iir *"5R  yTdVTt$ ! !% !&.9g(7 =Dns0#N 8NNN 5N N N=N!