,hy8ddlmZddlZddlZddlZddlZddlZddlZddlZddl Z ddl Z ddl Z ddl m Z mZddlmZddlmZmZmZddlmZmZmZddlmZmZmZmZmZmZdd lm Z m!Z!m"Z"m#Z#e$jJZ&d Z'd Z(d Z)e jTiZ+e$Z,ejZej\ej^Z0Gd dejbZ2e2jfZ3 Gdde4Z5e3ddddddddddddddfdZ6 dR dSdZ7 dT dUdZ8dVdZ9GddeZ:dZ;dZ< dWdZ=dZ> dXdZ?dZ@dZAd ZBd!ZCGd"d#ZDd$ZEd%ZF dYd&ZG dZd'ZHeHZI d(ZJd[d)ZK d\d*ZLd]d+ZMd,ZNd^d-ZOd.ZPdTd/ZQd_d0ZRd`d1ZSd2ZTd3ZUd4Z/d5ZV dad6ZWdbd7ZX dcd9ZYddd:ZZ dcd;Z[ ded<Z\ dfd=Z]dgd>Z^Gd?d@Z_e_jDcgc]}e_|e3ddddd|dAk7dde^|B  c}ZaeMeQeSe_eaCeaDcgc]}|jdDk7s|c}CeaDcgc]!}|js|jdDk7s |#c}CZ_GdEdFZdeQeSedZdGdGdHZeeejDcgc]}e_|e3ddddddddI c}ZfeMeQeSeeefCefCefCZeGdJd8ZgdKDcgc]}e_|e3ddddddddI c}ZfeMeQeSegefCefCefCZge$fdfdLZheHddMGdNdOZidPZjdQZ-ycc}wcc}wcc}wcc}wcc}w)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_hashc>eZdZdZej ZdZdZy)_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. cy)NNOTHINGselfs L/var/www/html/Resume-Scraper/venv/lib/python3.12/site-packages/attr/_make.py__repr__z_Nothing.__repr__Jscy)NFrrs r!__bool__z_Nothing.__bool__Msr#N) __name__ __module__ __qualname____doc__enumautorr"r%rr#r!rr=s diikGr#rc(eZdZdZeddfdZy)_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__es  %''r#)r&r'r(r)typer2rr#r!r-r-Ys ,0:R(r#r-TFct|| | d\} }} }||dur|dur d}t|| 8|tur d}t|t | s d}t|t | }|i}t | ttfrtj| } |rt |ttfrt|}|rt |ttfrt|}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 convertermetadatar3kw_onlyeqeq_keyorder order_key on_setattraliasr) _determine_attrib_eq_order TypeErrorr ValueErrorcallableFactory isinstancelisttupler pipeand_ _CountingAttr)r6r7r8r9r:r;r=r3r<factoryr>r?rArCrDr@rBmsgs r!attribrRisn$> R$ By D,U1BFn ' !O S/ ! >CS/ !'"*tUm,\\:. Z D%=9)$ Z D%=9)$                         ! r#c8t||d}t|||y)z[ Evaluate the script with the given global (globs) and local (locs) variables. execN)compileeval)scriptglobslocsfilenamebytecodes r!_compile_and_evalr\svx0H5$r#c|in|}d}|} t|d|jd|f}tjj ||}||k(rn|ddd|d}|dz }Ut |||||S)zP Cache the script with _linecache_, compile it and return the _locals_. Nr T->)len splitlines linecachecache setdefaultr\) rWrZrXlocalsrYcount base_filenamelinecache_tupleold_vals r!_linecache_and_compilerks2VD EM  K    d #    //,,XG o % #CR()5'3   feT84 Kr#c|d}i}t|D]\}}|fd}t|||<t|tf|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)) Attributesc ||Sr/r)r is r!getterz&_make_attr_tuple_class..getters 7Nr#) enumeratepropertyr3rL)cls_name attr_namesattr_class_namebodyro attr_namerps r!_make_attr_tuple_classrxsX" *-O D!*-+ 9 #6*Y + %4 00r#c,eZdZUded<ded<ded<y) _Attributesr3attrslist[Attribute] base_attrsdict[str, type]base_attrs_mapN)r&r'r(__annotations__rr#r!rzrzs K##r#rzct|}|jdr|jdr|dd}|jtS)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 r^)str startswithendswith_CLASSVAR_PREFIXES)annots r! _is_class_varr"sE JE  #z(Ba    . //r#c||jvS)zR Check whether *cls* defines *attrib_name* (and doesn't just inherit it). )__dict__)cls attrib_names r!_has_own_attributer3s #,, &&r#cg}i}t|jddD]a}t|dgD]O}|js|j|vr|j d}|j ||||j<Qcg}t}t|D]>}|j|vr|jd||j|j@||fS)zQ Collect attr.ibs from base classes of *cls*, except *taken_attr_names*. r r^__attrs_attrs__T inheritedr) reversed__mro__getattrrnameevolveappendsetinsertadd)rtaken_attr_namesr} base_attr_mapbase_clsafilteredseens r!_collect_base_attrsr:s JMS[[2./-#4b9 -A{{aff(884(A   a $,M!&& !  --H 5D j ! 66T> 1   ] ""r#cg}i}|jddD]p}t|dgD]^}|j|vr|jd}|j |j|j ||||j<`r||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. r r^rTr)rrrrrr)rrr}rrrs r!_collect_base_attrs_brokenr[sJMKK"%-#4b9 -Avv))4(A   (   a $,M!&& ! -- } $$r#c V|jt|}|t|j}n|durjD chc]\}} | jt ur|} }} g}t } |jD]h\} } t| r| j| j| t}|jt ur t|}|j| |fj| | z }|rQtddjt|fdzdztdjDd}t j"}|D cgc]\} }|| ||j|  }} }|r(t%||Dchc]}|j&c}\}}n't)||Dchc]}|j&c}\}}|r>|Dcgc]}|j+d }}|Dcgc]}|j+d }}||z}|t-|||}d }d |DD]B}|dur"|j.turd |}t1||d us.|j.tusAd}D|D]=}|j2rt5j7|d t9|j&?|Dcgc]}|j&}}t;|j<|}t?||||Scc} }wcc}} wcc}wcc}wcc}wcc}wcc}w)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`. Tz1The following `attr.ib`s lack a type annotation: , c:j|jSr/)getcounter)ncds r!z"_transform_attrs..sbffQi6G6Gr#)key.c3NK|]\}}|jtur||fywr/) __class__rO).0rattrs r! z#_transform_attrs..s, D$>>]2t  s#%c |djSNr )r)es r!rz"_transform_attrs..s!A$,,r#)r>Fc3\K|]$}|jdus|jdus!|&yw)FN)r;r>rrs r!rz#_transform_attrs..s& MA!&&"5!))u:La Ms ,,,zlNo mandatory attributes allowed after an attribute with a default value or factory. Attribute in question: rD) rrrKitemsrrOrrrrrrRrrjoinsorted Attributefrom_counting_attrrrrrrLr6rGrD _OBJ_SETATTR__get___default_init_alias_forrxr&rz)rthese auto_attribsr>collect_by_mrofield_transformerannsca_listrrca_names annot_namesrwr3r unannotatedfcaca own_attrsr}rr{ had_defaultrQrt AttrsClassrs @r!_transform_attrsrws: B C D u{{}%  !hhj d~~.   e #zz| +OItT" OOI &y'*A{{-/1I NNIq> * +, +C));,GH   "$((*  '    & &CEL4AIrIr488I./I$7 ),Q!&&,% ! M%? ),Q!&&,% ! M5>?QXXdX+? ?6@Aahhth,A A  "E$'U34K M M $ 199#7ABCAFGCS/ ! % AIIW$<K Nww   #G-DQVV-L MN#((Q!&&(J(' jAJ z%(*m DDm J --@A>)s* L"#L L <L L>L!L&cgd}||jdn|jgd|jddgt|d}|tj|d}t dj |||d |i d 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 _cls)rf __getattr__)rextend_generate_unique_filenamerrrkr)rrrlinesunique_filenameglobs r!_make_cached_property_getattrrs E# :      LL $ ) 0Y?O/+33, D " %/4   r#cft|tr|dvrtj|||yt)z4 Attached to frozen classes as __setattr__. ) __cause__ __context__ __traceback____suppress_context__ __notes__N)rJ BaseException __setattr__rr rvalues r!_frozen_setattrsrs7$ &44, !!$e4 r#cdt|tr|dvrtj||yt)z4 Attached to frozen classes as __delattr__. )rN)rJr __delattr__r)r rs r!_frozen_delattrsr(s.$ &4>+A!!$- r#c |\}|j}t |}|D];}|j s|j }|j}||vs-t||||<=|di|S#t$rdt|d}t|dwxYw)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) rGrarFrfieldsr;rrDr) argschangesinstrQrr{rrw init_names r!rr3sJ' ..C 3KE :vv FF GG G #!(y!9GI  : >>! '8T ; O n$& 's A%%%B ceZdZdZdZ ddZdZddZdZdZ dZ d Z d Z d Z d Zd ZdZdZdZdZdZdZdZddZddZy) _ClassBuilderz( 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_setattrcxt||||| |\}}}||_|rt|jni|_||_|Dchc]}|j c}|_||_td|D|_ ||_ ||_ ||_ | |_tt!|dd|_d|_|j"r>|j&}t)j*|}t-|j.dkD|_tt!|dd|_t| |_| |_| |_| |_d|_|j |jd<|r.t<|jd<t>|jd<d |_n| t@tBjDtBjFfvrldx}}|D]%}|jHd }|jJd }|s"|s%n| t@k(r|s|r*| tBjDk(r|r| tBjFk(r |sd|_|r-|jM\|jd <|jd <g|_'d|_(tS|jd rtS|jd s|jT|_+y|jX|_+ycc}w)Nc34K|]}|jywr/rrs r!rz)_ClassBuilder.__init__..s 7A 7s__attrs_pre_init__Fr __attrs_post_init__rrrT __getstate__ __setstate__r'r()-rrdictrrrrrrrLrrrrrboolrrrr inspect signaturera parametersrrrrrrrr_DEFAULT_ON_SETATTRr validateconvertr7r<_make_getstate_setstaterrhasattr_add_method_dunders_safer_add_method_dunders_unsafe)r rrslotsfrozen weakref_slotgetstate_setstaterr> cache_hashis_excrrChas_custom_setattrrr{r}base_mapr pre_init_funcpre_init_signature has_validator has_converters r!__init__z_ClassBuilder.__init__s"'7       ' #z8 /4cll+" ,67qAFF7& 7 77  )%!'#/CU"KL"'    22M!(!2!2=!A &)*<*G*G&H1&LD #"730Eu#MN#'; %#5 "',0KK() ,)rr&rs r!r"z_ClassBuilder.__repr__s$TYY%7%7$8;;r#cHdj|jDcgc]}|d c}}i}|jD]\}}}|j|t|t |j d|}|jD]\}}}||j |ycc}w)z= Evaluate any registered snippets in one go. rrmethodsN)rrupdaterkrrr)r snippetrWrX_ snippet_globsrYhooks r!_eval_snippetsz_ClassBuilder._eval_snippetssd6K6KL7GAJLM#'#8#8 ( A}a LL ' (&  %dii ;   // 'JAq$  & 'Ms Bc|j|jdur|j}n+|j}trt j |}t|ddrd|jvr|j|S)z 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_abstractmethodsrrr1)r rs r! build_classz_ClassBuilder.build_class sw  ;;$ **,C,,.C005 C2D 9)=  ' ' ) r#c|j}|j}|jr\|jD]M}||vst ||t t us t jt5t||dddO|jjD]\}}t||||js+t |ddrd|_|js t |_|S#1swYxYw)zA Apply accumulated methods and return the class. N__attrs_own_setattr__F)rrrrr _SENTINEL contextlibsuppressAttributeErrordelattrrrsetattrrr8rrr)r r base_namesrrs r!r3z#_ClassBuilder._patch_original_class"sii%%    (( + *T95YF $,,^<+T*++ + >>//1 &KD% Cu % & &&7 (%, ).C %++". #++s * C))C2 c |jjDcic]&\}}|gt|jddvr||(}}}|jsSd|d<|j sB|j jD])}|jjdds t|d<ni}d}|j jddD]U}|jjddd }|jt|d gDcic]}|t||c}Wt|j}|j} |j r$dt|j d d vr d| vr|s| d z } |jD cic]"\}} t#| t$r || j&$} }} g} | rt)|j } | jD]`\}}| |fz } ||=| j+|t-j.|j0}|t,j2j4us\|| |<b|jd }|| j+|t7| ||j |d <| Dcgc] }||vs| }}|jDcic] \}}||vr||}}}|Dcgc] }||vs| }}|j||j8r|j+t:t||d <|j j<|d<t?|j |j j@|j j|}tCjD|jjG| D]}t#|tHtJfrt|jLdd}n5t#|tNrt|jPdd}n t|dd}|si|D]%} |jR|j u}|s||_)'|Scc}}wcc}wcc} }wcc}wcc}}wcc}w#tT$rYXwxYw)zL Build and return a new class with a `__slots__` attribute. r __weakref__Fr8rr r^NT __slots__r)rArr( __closure__)+rrrLrrrr __bases__rrrrr*rrrrrJrfuncrrrrreturn_annotation Parameteremptyrr_HASH_CACHE_FIELDr(r3r& itertoolschainvalues classmethod staticmethod__func__rrfget cell_contentsrG)r kvrrexisting_slotsweakref_inheritedrr?names cached_propr&additional_closure_functions_to_updateclass_annotationsrE annotationr slot_namesslotslot_descriptor reused_slotsritem closure_cellscellmatchs r!r2z!_ClassBuilder._create_slots_classFst ,,. 1M% 0 01M:M}MM qD  &&*/B& '++ $ 3 3H((,,-DeL,8=)! ))!B/ H  $$]D9E$(!  ! !!(+r B'(D11  ))*      WTYY R%HHU*% % %E&(XXZ !k+7 +"" "  24.  0 ; /557 9 d$ tH6==dC$..t4FF W%6%6%<%<<.8%d+ 9 "vvm4 +6==>NO =!#3TYY!B}  (-GtJ0FdG G*8)=)=)? %oz! / !  (2NtT5MdN N ,      / 0 +;!YY33>d499odii00$))2E2ErJOO LL   !#I  1D$l ;<!( }d K D(+!( =$ G 'mT B  % 11 ..$));E -0* 1! 12 K >" >H  OJ"sA+P*P0 'P5< P;P;Q7 QQQ  QQctj|\}}fd}jj|||fd_S)Nc4j|d|d<y)Nr"rcls_dictrXr s r! _attach_reprz,_ClassBuilder.add_repr.._attach_reprs#'#;#;E*.__str__s==? "r#ro)rrGrr)r rQros r!add_strz_ClassBuilder.add_strs?GCS/ ! #%)$<$.s! R=-@B! s cDDcic]}|t||c}Scc}w)9 Automatically created by attrs. r)r rstate_attr_namess r!slots_getstatez=_ClassBuilder._make_getstate_setstate..slots_getstates&;KK$D'$--K KKsctj|}t|trt |D]\}}|||nD]}||vs||||r|t dyy)ruN)rrrJrLziprI)r state_ClassBuilder__bound_setattrrrhash_caching_enabledrws r!slots_setstatez=_ClassBuilder._make_getstate_setstate..slots_setstates+2248O%'$''7#?1KD%#D%01-;Du}'eDk:;$ 148$r#)rLrr)r rxr~r}rws @@r!rz%_ClassBuilder._make_getstate_setstatesI !! ))!   L $// 9,~--r#c$d|jd<|SN__hash__)rrs r!make_unhashablez_ClassBuilder.make_unhashables%)z" r#ctjjjj\}}dfd }j j |||fS)Nrrc4j|d|d<yrre)rgrYr s r! attach_hashz+_ClassBuilder.add_hash..attach_hashs#'#;#;D._attach_init2s*$D#.D #'#;#;D#AHZ r#_make_init_scriptrrrrrrrrrrrrr)r rWrXrrs` @r!add_initz_ClassBuilder.add_init"s%6 II KK     # #    LL KK       LL    & "{ B $$fe\%BC r#cD|jd|jd<|S)Nct|fi|Sr/)r)r rs r!rz+_ClassBuilder.add_replace..=sF4$;7$;r# __replace__)rrrs r! add_replacez_ClassBuilder.add_replace;s%(,(@(@ ;) }% r#cVtd|jD|jd<y)Nc3dK|](}|jr|js|j*ywr/)r;r>r)rfields r!rz/_ClassBuilder.add_match_args..Bs)1 zz%-- JJ1 s.0__match_args__)rLrrrs r!add_match_argsz_ClassBuilder.add_match_argsAs'+01 1 , '(r#cdtjjjjj j jjjjjd \}}fd}jj|||fS)NTrcF|d}|_j||d<y)N__attrs_init__rrs r!_attach_attrs_initz8_ClassBuilder.add_attrs_init.._attach_attrs_initXs,)*D#.D )-)A)A$)GH% &r#r)r rWrXrrs` @r!add_attrs_initz_ClassBuilder.add_attrs_initHs%6 II KK     # #    LL KK       LL    & "{ H $$fe5G%HI r#cj}tj\}}fd}jj |||ft |d<S)Nc4j|d|d<y)N__eq__rerfs r! _attach_eqz(_ClassBuilder.add_eq.._attach_eqfs!%!9!9%/!JHX r#__ne__)r_make_eq_scriptrrrr)r rrWrXrs` r!add_eqz_ClassBuilder.add_eqasO ^^' 4  K $$feZ%@A8  r#cj}fdtjjD\|d<|d<|d<|d<S)Nc3@K|]}j|ywr/re)rmethr s r!rz*_ClassBuilder.add_order..rs&B   $ $T *B s__lt____le____gt____ge__)r _make_orderrr)r rs` r! add_orderz_ClassBuilder.add_orderosL ^^B #DIIt{{;B >8 blBxL"X,  r#c\i|jD]C}|jxs |j}|s |tjus3||f|j <Es|S|j r d}t|fd}d|jd<|j||jd<d|_ |S)Nz7Can't combine custom __setattr__ with on_setattr hooks.ch |\}}||||}t|||y#t$r|}YwxYwr/)KeyErrorr)r rvalrr.nvalsa_attrss r!rz._ClassBuilder.add_setattr..__setattr__sG *"4.4D!S) tT *   s # 11Tr8r) rrCrr NO_OPrrrGrrr)r rrCrQrrs @r! add_setattrz_ClassBuilder.add_setattrys 1A9)9)9Jj =#$j=  1 K  # #KCS/ ! +37./(,(@(@(M}%"& r#c|jj|_|jjd|j|_d|jjd|_|S)z@ Add __module__ and __qualname__ to a *method*. r$Method generated by attrs for class )rr'r(r&r)r methods r!rz(_ClassBuilder._add_method_dunders_unsafes`!II00!%!7!7 8&//9JK34993I3I2J! L  r#ctjt5|jj|_dddtjt5|jj d|j |_dddtjt5d|jj d|_ddd|S#1swYxYw#1swYXxYw#1swY|SxYw)zL Add __module__ and __qualname__ to a *method* if possible. Nrr)r:r;r<rr'r(r&r)rs r!rz&_ClassBuilder._add_method_dunders_safes  0 5 $ 4 4F  5  0 P%)YY%;%;$_determine_attrib_eq_order..decide_callable_or_booleans1 E?u3EczCczr#FTrr) r9r?rArrQrcmp_keyr@rBs r!rErEs  3$T0ABC6o 1#6 WGS')) zF/3 F }vy5e<y U{u}=o vui ''r#cT|dus|dur|S||dur|S|D]}t||sy|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_detectdundersr6dunders r!_determine_whether_to_implementrsL t|tu}  | u, c6 * Nr#c4  ddl}|jtddt|||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.) stacklevelcxs t|} duxrt|t}xr t|d}|r|r d}t |t ||t |d | | }t |dr|jdur|jt | d}|s|dur|j|st |dr|js|jdurt|d rd durd ur d }t|d us|d us|r rKd }t|dus |dur|dur|jn r d }t||jt |d r|jn|j! r d}t|t"rt|ds|j%t&rrt|ds|j)|j+S)NTrz/Can't freeze a class with a custom __setattr__.)r r )r6rn)rr)rrrrrFr5zlInvalid 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 issubclassrrrGrrrkrprrrrFrrrrrrrrr6)r is_frozenrhas_own_setattrrQbuilderr?rrauto_excrreq_rrrr:r;r> match_argsrCorder_r8repr_nsrrrrs r!wrapzattrs..wrapsh94S9 T!Djm&D% *< +  yCCS/ !      +!0          ) . + {M    W % $; OO  , k#7 "* NN 9 &N         ! Lt#"3 3D t E 1d6FJCC. 5=T\bEkfEn$ T\ LR4ZI,=    En$  # # % * {M       " " $^n$  23 F    ! &s,<=  " " $""$$r#) warningswarnDeprecationWarningrrJrKrLr rM) maybe_clsrrr8r9r:r;rrrrrr>rrr?rArrrrCrr unsafe_hashrrrrs ``` `````````` `````` @@r!r{r{sx c   ,CUDAKC*tUm,\\:. j%j%j%j%\  ?r#c&|jtuS)zV Check whether *cls* has a frozen ancestor by looking at its __setattr__. )rr)rs r!rrs ??. ..r#c Xd|d|jdt|d|jdS)zF Create a "filename" suitable for a function being generated. z.s1AFFdNqvv~!$$$,s 888 r:zdef __hash__(selfzhash((z))z):z, *zC, _cache_wrapper=__import__('attr._make')._make._CacheHashWrapper):z_cache_wrapper()c hj||zz|d dzgD]u}|jrEd|jd}|j|<j|d|d|jdzTj|d|jdzwj|dzzy ) 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,r,_key(self.z), self. N)rr@rr) prefixindentrcmp_namer{closing_bracesrX hash_func method_lines type_hashs r!append_hash_computation_linesz8_make_hash_script..append_hash_computation_lines/s )+8I;a00   HAxxqvvhd+"#((h##xzxrBB##F}QVVHA-F$FG H FVOn<=r#zif self.z is None:zobject.__setattr__(self, '', rself. = z return self.zreturn r)rLr:rrrIr) rr{rrtabhash_defrrWrrXrrrs ` @@@@@r!rrsF  E C.sF;>4CH->,?y"IIJ  ),->,?sCS1W    a# . ))*#.a  CL1B0C"DDE%i5 YY| $F 5=r#cnt||dd\}}t||t|d|d|_|S)z% Add a hash method to *cls*. FrrrZ)rr\rrrr{rWrXs r! _add_hashr\sG& U5UMFE 9#z J$CL Jr#cF|j|}|turtS| S)z^ Check equality and either forward a NotImplemented or return the result negated. )rNotImplemented)r otherresults r!rrjs( [[ F :r#c ,|Dcgc]}|js|}}gd}i}|r|jd|D]}|jrRd|jd}|j||<|jd|d|jd|d|jd n+|jd |jd |j||d us|d d |d <|jdn|jddj |}||fScc}w)z6 Create __eq__ method for *cls* with *attrs*. )zdef __eq__(self, other):z- if other.__class__ is not self.__class__:z return NotImplementedz return (r,rrrz) == z(other.rrz == other.r^z andz )z return Truer)r?rr@rr)r{rrrXrrWs r!rrvs &1Q &E & E E  _% /Axxqvvhd+#$((h xjqvvheH:WQVVHTUV }QVVHJqvvhGHb !$Ryk.b  /  W &' YYu F 5== 's DDcDcgc]}|js|c}fdfd}fd}fd}fd}||||fScc}w)z9 Create ordering methods for *cls* with *attrs*. c<tdfdDDS)z& Save us some typing. c3:K|]\}}|r||n|ywr/r)rrrs r!rz6_make_order..attrs_to_tuple..s' sCJ5 ( sc3bK|]&}t|j|jf(ywr/)rrrB)rrobjs r!rz6_make_order..attrs_to_tuple..s*89aff%q{{3s,/)rL)rr{s`r!attrs_to_tuplez#_make_order..attrs_to_tuples) =B   r#cb|j|jur||kStSz1 Automatically created by attrs. rrr rrs r!rz_make_order..__lt__0 ??dnn ,!$'.*?? ?r#cb|j|jur||kStSrrrs r!rz_make_order..__le__0 ??dnn ,!$'>%+@@ @r#cb|j|jur||kDStSrrrs r!rz_make_order..__gt__rr#cb|j|jur||k\StSrrrs r!rz_make_order..__ge__rr#)rA)rr{rrrrrrs ` @r!rrsK )1Q )E   666 ))c *s??c| |j}t|\}}t||t|d|d|_t |_|S)z5 Add equality methods to *cls* with *attrs*. rr)rrr\rrrrs r!_add_eqrsR }###E*MFE 9#x HxCJCJ Jr#ctd|D}|Dcic]\}}}|tk7s|dz|}}}}t|d<t|d<t|d<g}|D]B\}}}|rd|znd|zdz} |tk(r|d | d n |d |d | d } |j | Dd j |} |d} n|dz} ddddddddddddd| d| dddg} d j | |fScc}}}w)!zC Create the source and globs for a __repr__ and return it. c3K|]I}|jdur9|j|jdurtn |j|jfKyw)FTN)r8rr;rs r!rz$_make_repr_script..sC" 66  !&&D.$affqvv>"sAA_reprr r<rrzgetattr(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)rLr8r r<rrr)r{rjattr_names_with_reprsrrr,rXattribute_fragmentsroaccessorfragment repr_fragmentcls_name_fragmentrs r!ririsg""" -B  (dAqQ$Yw E E),E E)+ - aGdN%6%= %M  Dy  *'+T8<  ""8, -II12M zO!== D"+D-- )*!M?"=. E$ 99U U ""U s C"C"c| |j}t||\}}t||t|d|d|_|S)z% Add a repr method to *cls*. r"r)rrir\rr")rrjr{rWrXs r! _add_reprr(sN }##%eR0MFE 9#z J$CL Jr#ct|}|t|ts d}t|t |dd}|*|t |dd}| ||_|S|d}t ||S)aG 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.)rrJr3rFrrr)r generic_baserQr{s r!rr,s.$C(LJsD$9.n C*D 1E }  #L*;TBE ',# 89"3'' Lr#ct|ts d}t|t|dd}||d}t ||Dcic]}|j |c}Scc}w)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 r*rNr+)rJr3rFrrr)rrQr{rs r! fields_dictr.Zse& c4 .n C*D 1E }89"3''$ %!AFFAI %% %sAc tjduryt|jD]/}|j}||||t ||j 1y)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_validatorsrrr7rr)rrrSs r!rrwsR%' DNN #. KK = dAwtQVV, -.r#cH|j|}|xrd|jvS)z> Check if the attribute name comes from a slot class. rB)rr)a_namerrs r! _is_slot_attrr3s(   F #C  .;#,,..r#c | duxr| tju} |r| r d} t| |xs|}g}i}|D]}|js|jt ur"|j ||||j<|j|dur d} t| d}b| se|jtjusd}t||||||||| || | rdnd \}}}|jtjvr6|jtj|jj|jt |d|rtj |d<|||fS)Nz$Frozen classes can't use on_setattr.Trr&)r attr_dictr)r rrGr;r6rrrrC_attrs_to_init_scriptr'sysmodulesr*rrr)rr{pre_initpre_init_has_args post_initrrrrrcls_on_setattrrhas_cls_on_setattrrQneeds_cached_setattrfiltered_attrsr5rrWrXrs r!rrsj d"J~W]]'J$4o%/NI (vv!))w. a  !&& << #~< o%#' ALL $E#' ( "7 &J "FE; ~~$ S[[099: LLW9=>(4';';#$ 5+ %%r#cd|d|dS)zJ Use the cached object.setattr to set *attr_name* to *value_var*. _setattr('rrr)rw value_varhas_on_setattrs r!_setattrrDs {#i[ 22r# Converterc4d|d|j||dS)zk Use the cached object.setattr to set *attr_name* to *value_var*, but run its converter first. rArr)_fmt_converter_callrwrBrCr<s r!_setattr_with_converterrIs( {#i&C&CIy&Y%ZZ[ \\r#c0|r t||dSd|d|S)zo Unless *attr_name* has an on_setattr hook, use normal assignment. Otherwise relegate to _setattr. Trr)rD)rwrrCs r!_assignrKs)  5$// 9+S ((r#cR|rt||d|Sd|d|j||S)z Unless *attr_name* has an on_setattr hook, use normal assignment after conversion. Otherwise relegate to _setattr_with_converter. Trr)rIrGrHs r!_assign_with_converterrMs9&y)T9MM 9+S!>!>y)!T U VVr#c|dur4|dur dttfS dfd } dfd }d||fSdttfS)zg Determine the correct setter functions based on whether a class is frozen and/or slotted. TrcFt|r t|||Sd|d|SN _inst_dict['z'] = )r3rD)rwrBrCrs r! fmt_setterz&_determine_setters..fmt_setters1Y 6 9nEE!)E)= =r#cl|s t|rt||||Sd|d|j||SrP)r3rIrG)rwrBrCr<rs r!fmt_setter_with_converterz5_determine_setters..fmt_setter_with_convertersL y-!H.y.)")E)2O2OPY[d2e1fg gr#)z_inst_dict = self.__dict__rwrrBrrCrrr rwrrBrrCrr<rErr)rDrIrKrM)rrrrRrTs ` r!_determine_settersrWs~ D=x!88 8 > >'* ><@ >  > h h h! h! h  h ,  %   w. ..r#c d |rdgng} | r| jdt|||\} }}| j| g}g}g}i}ddi}|D]}|jr|j||j}|j duxs |j t juxr| }|j}t|jt}|r|jjrdnd}|j0t|jtst|j}n |j}|jdur|rt |jfz}|J| j|||d|d z|||j||j#|j<n | j|||d|d z||jj$||<n|H| j||d |d |||j||j#|j<n| j||d |d |n|jt&ur|s|d |d }|j(r|j|n|j||D| j||||||j||j#|j<n| j||||n|rH|d }|j(r|j|n|j|| jd|dt |jfz}|}| jd|||||z| jd| jd|||dz|zd z||z|j||j#|j<nR| jd||||z| jd| jd|||dz|zd z|z|jj$||<n|j(r|j|n|j||C| j||||||j||j#|j<n| j|||||jdus|j*||j*||<||j,s|j,||<|rxt.|d<| jd|D]Y}d|jz}d|jz}| jd|d|d|jd |j||<|||<[|r| jd|r5|r|r dt0d}ndt0d}n dt0d}| j||r-d j3d!|D} | jd"| d d#j3|}|}!|rV||rd#ndd$d#j3|z }d#j3d%|DD"cgc] }"|"d&|" c}"}#|!|!rd#ndz }!|!|#z }!|r |r d'|!d | d(<d)}$d*| d|d+| r|$j3| nd,d-||fScc}"w).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 Frrz attr_dict['z '].defaultz =attr_dict['z=NOTHINGzif z is not NOTHING:rzelse:Tr z#if _config._run_validators is True:__attr_validator___attr_z(self, z, self.zself.__attrs_post_init__()rAz', None)rQz '] = Nonerz = Nonerc3TK|] }|jsd|j"yw)rN)r;rrs r!rz(_attrs_to_init_script.. s!BQ166%x(Bs((zBaseException.__init__(self, rz*, c3DK|]}|jddyw)=rN)split)rkwas r!rz(_attrs_to_init_script.. s#N#CIIcN1$5#Ns r^zself.__attrs_pre_init__(rz zdef z): passr)rrWrr7rrCr rrDrJr6rI takes_selfr<rEr;_INIT_FACTORY_PAT_get_global_namerPrr>r3_first_param_typer rIr)%r{r is_slotted call_pre_initr:call_post_initdoes_cache_hashrrr>r= method_namer extra_linesrRrTr kw_only_argsattrs_to_validatenames_for_globalsrrrwrCarg_name has_factory maybe_selfr<init_factory_nameargval_nameinit_hash_cachevals pre_init_args kw_arg_namepre_init_kw_only_argsNLs% r!r6r6.s0(.; ( )E  3  :L:}:6K6 LL DLT"K UD ;;  $ $Q 'FF T1 LL - D2D  77 G4 *qyy/C/CV ;; ":akk9+M!!++.I I 66U?$5 $A!(LL1%-!Jvv!i&7() H%&9+F+F(1(C(C H%kUDn'.)$ :;" -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  -q . !  B6 .. *-m_A>a B  WTF+RWWU^&)*     sZ-c$|jdS)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,)lstripr s r!rr2 s ;;s r#cbeZdZdZdZ d dZdZed d dZdZ dZ d Z d Z y)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`. )rr6r7r8r?r@rArBr:r;r=r3r<r>rrCrDNct||xs| |xs|d\} }}}tj|}|d||d||d||d||d| |d||d||d ||d ||d ||d | |d | rtjt | nt |d| |d| |d||d||d|y)NTrr6r7r8r?r@rArBr:r;r<r=r3r>rrCrD)rErrtypesMappingProxyTyper_EMPTY_METADATA_SINGLETON)r rr6r7r8r9r:r;rr=r3r<r>r?r@rArBrCrD bound_setattrs r!r&zAttribute.__init__~ s*(B 2y1E4( $FE9 %,,T2  fd#i)k9-fd#dBh'gu%k9-fd#fd#k9- &&tH~6.   fd#i)k9-lJ/gu%r#ctr/)rrs r!rzAttribute.__setattr__ s!!r#c| |j}n|jd|d}t||||j|j|jd|j |j d|j||j|j|j|j|j|j|j|jS)Nz>Type annotation and type argument cannot both be present for 'z'.F)r3rG_default _validatorr8r:r;r=r<r>r?r@rArBrCrD)rrrr3rQs r!rzAttribute.from_counting_attr s <77D WW RSWRXXZ[CS/ !  KK MM GG  GG GG  KK  LL JJ EE II HH LL MM HH%  r#c ntj|}|j|j|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)r rnews r!rzAttribute.evolve s(iio gmmo& r#c@tfdjDS)( Play nice with pickle. c3jK|]*}|dk7r t|ntj,yw)r=N)rrr=rrr s r!rz)Attribute.__getstate__.. s5 $(:#5GD$ 4 ;N N s03rLrBrs`r!r zAttribute.__getstate__ s#    r#cN|jt|j|yrN)rrzrBr r{s r!r zAttribute.__setstate__ s s4>>512r#c tj|}|D]A\}}|dk7r ||||||rtjt |nt Cy)Nr=)rrrrrr)r name_values_pairsrrrs r!rzAttribute._setattrs s^$,,T2 , KD%z!dE*!..tE{;6  r#) NNNFNNNNNNr/)rrrrO) r&r'r(r)rBr&rrMrrr r rrr#r!rr= sb(XI<  '5&n"  :$ 3 r#rr=) rr6r7r8r9r?rAr:r;rrD)r{rc|eZdZdZdZgeddDeddddddddddddddd Zd Zd Z d Z d Z y)rOa 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. )rrrDr<rr?r@r:r;r>r=rCrArBr8r3c#jK|]+}t|t|tdddddddddddd-yw)NTFrrDr6r7r8r9r:r;r>r?r@rArBrrC)rrr)rrs r!rz_CountingAttr.= sV $# -d3   s13) rrr8r?rAr:r;rCrDr=NTFrrc2txjdz c_tj|_||_||_||_||_| |_| |_| |_ ||_ ||_ ||_ ||_ | |_| |_||_||_yr)rO cls_counterrrrr<r8r?r@rArBr:r;r=r3r>rCrD)r r6r7r8r9r:r;r<r=r3r>r?r@rArBrCrDs r!r&z_CountingAttr.__init__o s& !!Q&!$00  #"   "      $ r#cf|j ||_|St|j||_|S)z Decorator that adds *meth* to the list of validators. Returns *meth* unchanged. .. versionadded:: 17.1.0 )rrNr rs r!r7z_CountingAttr.validator s5 ?? ""DO #4??D9DO r#cZ|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)rb)rrrrIrs r!r6z_CountingAttr.default s) == '( (6  r#) r&r'r(r)rBrLrrrr&r7r6rr#r!rOrO! sI$0  $ %  0>  ?0ObK#J r#rOc(eZdZdZdZddZdZdZy)rIa 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* rPrbc ||_||_yr/r)r rPrbs r!r&zFactory.__init__ s $r#c@tfdjDS)rc36K|]}t|ywr/rvrs r!rz'Factory.__getstate__.. sDTWT4(Dsrrs`r!r zFactory.__getstate__ sDT^^DDDr#cZt|j|D]\}}t|||yr)rzrBr>)r r{rrs r!r zFactory.__setstate__ s.t~~u5 'KD% D$ & 'r#N)F)r&r'r(r)rBr&r r rr#r!rIrI s$*I%E 'r#rI) rr6r7r8r9r?rAr:r;rcHeZdZdZdZddddZed dZd dZdZ d Z y ) rEae 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__re _global_namer< takes_fieldrbFrbrc|_|_|_t|}|j _jsjs fd_nPjrjs fd_n-jsjr fd_n fd_|j}||j jd<yy)Nc&j|Sr/r<)rr,__r s r!rz$Converter.__init__.. s1Fr#c(j||Sr/r)rinstancerr s r!rz$Converter.__init__.. sx9r#c(j||Sr/r)rrrr s r!rz$Converter.__init__.. sT^^u6r#c*j|||Sr/r)rrrr s r!rz$Converter.__init__..# s4>>x<r#r) r<rbrrget_first_param_typererget_return_typer)r r<rbrexrts` r!r&zConverter.__init__ s"$& !) ,!#!8!8!:4#3#3FDM __T%5%5DMT%5%5DMDM   ! >68DMM ) )( 3 r#c d|S)zh Return the name that a converter for an attribute name *attr_name* would have. __attr_converter_r)rws r!rdzConverter._get_global_name+ s #9+..r#c>|js#|js|j|d|dS|jr&|jr|j|d|d|dS|jr|j|d|dS|j|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[')rbrrd)r rwrBs r!rGzConverter._fmt_converter_call3 s 4#3#3++I67q 1E E ??t//++I67q CVW`Vaade e ??++I67q 7K K'' 231YK}YKWZ[[r#cJ|j|j|jdS)zx Return a dict containing only converter and takes_self -- the rest gets computed when loading. r<rbrrrs r!r zConverter.__getstate__D s% //++  r#c(|jdi|y)z+ Load instance from state. Nrrrs r!r zConverter.__setstate__O s  r#N)rwrrr)rwrrBrrr) r&r'r(r)rBr&rNrdrGr r rr#r!rErE s>(I16596//\"  r#rc tjd|}t|tr|}n. s $r#r r&__main__r9r?rATrr) unicodedata normalizerJrrKrLrRrFpopr*r new_classr:r;r<rGr7 _getframe f_globalsrr'rrrr3r)rr{bases class_bodyattributes_argumentsrgrrQr9r; user_inittype_r9rrRrSrvs @r! make_classrk s`   .D% ED%= ))./AAvxK//8n||0$7H 2D9I Z.I D J%- !"&/ "#$Z OOD%-G HE   ^Z 8 ==+5599     " "5$ /C "   &  )  T"W% 9& 8x 8#7 8 ?C'nn.a!&&2D166 C J_02  &sG5G*G*?G*G')rrc$eZdZdZeZdZy) _AndValidatorz2 Compose many validators to a single one. c:|jD] }||||yr/) _validators)r rrrrSs r!rz_AndValidator.__call__ s#!! !A dD%  !r#N)r&r'r(r)rRrrrr#r!rr s(K!r#rcg}|D]0}|jt|tr |jn|g2tt |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 )rrJrrrL) validatorsrvr7s r!rNrN sO D  )]3  ! !   t %%r#ctdD}|rfd}nfd}s*td}|jj||dn~t dj }|r||jd<d}t st|tr |j}t |j}|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|tywr/rJrE)rcs r!rzpipe.. sGq*Q 2GscZD]$}t|tr ||||n||}&|Sr/r)rrrr converterss r!pipe_converterzpipe..pipe_converter s9 +5a+CAc4'3  Jr#c&D] }||} |Sr/r)rrrs r!rzpipe..pipe_converter s" f Jr#A)rrrrr^rTr) rr rr*rrrrJrErr)rreturn_instancerrtlastrs` r!rMrM s GJGGO    CL&&--a1.EF !A / D D F 45N * *5 1"~ 4 ;==D"$ ' 7 7 9 79N * *8 4DdKK r#)NrY) rWrrXdict[str, Any] | NonerYMapping[str, object] | NonerZrrrr/) rWrrZrrXrrfrrzdict[str, Any])rsrrtz list[str]rr3)rz'tuple[list[Attribute], dict[str, type]])rrz)T)NNNNNNNFFTFFFFFNNFFNNNTN)rr3rrrr) rr3r{r|rrrrrtuple[str, dict])rr3r{r|)r{rKrr)rr)NN)rtuple[str, dict, dict]rUrV)rwrrrrCrrr)rrrrrr~)r{r|rrrfrrgrr:rrhrrirrr~rrr>rr=rrjrrr)rrrr)k __future__rr4r:rr*rrJrcr7rrcollections.abcrr functoolsrtypingrrr rYr r r rrrrrr exceptionsrrrrobjectrrrcrrIrrr9rMrrrEnumrrintr-rRr\rkrxrzrrrrrrrrrrrrErr{rrrrrrrrrrir(rr.r3rrDrIrKrMrWr6rrrB_arr:rOrI_frErrrN)rrs00r!rs #   -%++('!! ')2E2226 H "gll7??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&6Q+ 5q6 =AFFqvv'<1 =   QQh -01 $'$'h!!         GIgR8C2 Naab;          Iir *"5R  yTdVTt$ ! !% !&.9g(7 =Dns0+#N"N7NN N (N $N(N