Ë
|
·^iÍ ã óæ d dl mZ d dlZd dlZd dlZd dlZd dlZd dlZd dlZd dl Z d dl
|
Z
|
d dl Z d dl Z d dl mZmZ d dlmZ d dlmZmZmZ ddlmZmZmZ ddlmZmZm Z m Z m Z m Z dd l m!Z!m"Z"m#Z#m$Z$ e%jL Z'd
|
Z(d Z)d Z* e
|
jV i « Z, e%« Z- ej\ ej^ ej` « Z1 G d dejd « Z3e3jh Z4 G d de5« Z6e4ddddddddddddddfdZ7 dT dUdZ8 dV dWdZ9dXdZ: G d de« Z;d Z<d Z= dYdZ>d Z? dZd Z@d ZAd ZBd ZCd ZD G d! d"« ZEd# ZFd$ ZG d[d%ZH d\d'ZIeIZJ d( ZKd]d)ZL d^d*ZMd_d+ZNd, ZOd`d-ZPd. ZQdVd/ZRdad0ZSdbd1ZTd2 ZUd3 ZVd4 Z0d5 ZW dcd6ZXddd7ZY ded9ZZdfd:Z[ ded;Z\ dgd<Z] dhd=Z^did>Z_ G d? d@« Z`e`j D cg c] } e`| e4ddddd&| dAk7 dd& e_| « ¬B« c} Zb eN eR eTe`eb¬C« ebD cg c] }|jÆ dDk7 s| c}¬C« ebD cg c]! }|jÈ s|jÆ dDk7 s |# c}¬C« Z` G dE dF« Ze eR eTee« « Ze G dG dH« Zfefj D cg c] } e`| e4ddddd&ddd& e_| « ¬B« c} Zg eR eTefeg¬C« eg¬C« Zf G dI dJ« Zhehj D cg c] } e`| e4ddddd&ddd&¬K«
|
c} Zi eN eR eTehei¬C« ei¬C« ei¬C« Zh G dL d8« ZjdMD cg c] } e`| e4ddddd&ddd&¬K«
|
c} Zi eN eR eTejei¬C« ei¬C« ei¬C« Zje%fdfdNZk eIdd¬O« G dP dQ« « ZldR ZmdS Z.yc c} w c c}w c c}w c c} w c c} w c c} w )jé )Ú annotationsN)ÚCallableÚMapping)Úcached_property)ÚAnyÚ
|
NamedTupleÚTypeVaré )Ú_compatÚ_configÚsetters)Ú PY_3_10_PLUSÚ PY_3_11_PLUSÚ PY_3_13_PLUSÚ_AnnotationExtractorÚ_get_annotationsÚget_generic_base)ÚDefaultAlreadySetErrorÚFrozenInstanceErrorÚNotAnAttrsClassErrorÚUnannotatedAttributeErrorz__attr_factory_%s)ztyping.ClassVarz
|
t.ClassVarÚClassVarztyping_extensions.ClassVarÚ_attrs_cached_hashc ó> e Zd ZdZ ej
|
« Zd Zd Zy)Ú_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.
|
c ó y)NÚNOTHING© ©Úselfs õ] H:\项ç®\archive\æµè¯ç»\èæ¬\Change_password\venv_build\Lib\site-packages\attr/_make.pyÚ__repr__z_Nothing.__repr__K s Øó c ó y)NFr r s r! Ú__bool__z_Nothing.__bool__N s Ør# N) Ú__name__Ú
|
__module__Ú __qualname__Ú__doc__ÚenumÚautor r" r% r r# r! r r > s ñð diikGòór# r c ó( e Zd ZdZ ed« dfdZy)Ú_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.
|
Nr c ó
|
||fS ©Nr )r Ú_none_constructorÚ_argss r! Ú
|
__reduce__z _CacheHashWrapper.__reduce__f s Ø %Ð'Ð'r# )r& r' r( r) Útyper2 r r# r! r- r- Z s ñ ñ ,0°«:¸Rô (r# r- Tc ó t || | d« \ } }} }||dur|dur d}t |« | 8| t ur d}t |« t | « s d}t |« t | « } |i }t | t t f« rt j | } |r t |t t f« rt | }|r t |t t f« rt | }t di d| 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*
|
.. versionchanged:: 25.4.0
|
*kw_only* can now be None, and its default is also changed from False to
|
None.
|
TNFú6Invalid 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Ú validatorÚreprÚcmpÚhashÚinitÚ converterÚmetadatar3 Úkw_onlyÚeqÚeq_keyÚorderÚ order_keyÚ
|
on_setattrÚaliasr ) Ú_determine_attrib_eq_orderÚ TypeErrorr Ú
|
ValueErrorÚcallableÚFactoryÚ
|
isinstanceÚlistÚtupler ÚpipeÚand_Ú _CountingAttr)r6 r7 r8 r9 r: r; r= r3 r< Úfactoryr> r? rA rC rD r@ rB Úmsgs r! ÚattribrR j s ôt $>Ø Ró$Ñ Byð ÐD¨Ñ ,°¸UÑ1BØFÜnÐ àÐØ 'Ñ !àOð ô S/Ð !ÜÔ Ø>CÜ S/Ð !Ü'Ó"àÐØô *t¤UmÔ,Ü \\ :Ð.
|
áZ ¬D´%¨=Ô9Ü)Ð$ áZ ¬D´%¨=Ô9Ü)Ð$ ä ò Ùð áð ñ ð ñ ð ñ
|
ð ñ ð ñ ð ñ ð ñ ð ñ ð ñ ð ñ ð ñ ð ñ ð ñ ð ñ ð! ð r# c ó8 t | |d« }t |||« y)z[
|
Evaluate the script with the given global (globs) and local (locs)
|
variables.
|
ÚexecN)ÚcompileÚeval)ÚscriptÚglobsÚlocsÚfilenameÚbytecodes r! Ú_compile_and_evalr\ Ø s ô vx¨Ó0HÜ5$Õ r# c óâ |i n|}d}|} t | « d| j d« |f}t j j ||« }||k( rn|dd d| d}|dz }Ut | |||« |S )zP
|
Cache the script with _linecache_, compile it and return the _locals_.
|
Nr
|
Téÿÿÿÿú-ú>)ÚlenÚ
|
splitlinesÚ linecacheÚcacheÚ
|
setdefaultr\ ) rW rZ rX ÚlocalsrY ÚcountÚ base_filenameÚlinecache_tupleÚold_vals r! Ú_linecache_and_compilerk æ s ð 2 VDð EØ MØ
|
ä KØ Ø × Ñ dÓ #Ø ð
|
ô //×,Ñ,¨X°ÓGØ oÒ %Ø à# C RÐ(Ð)¨¨5¨'°Ð3Ø
|
ð ô fe T¨8Ô4à Kr# c ó | d}i }t |« D ] \ }}|fd}t |« ||< t |t f|« 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 ó | | S r/ r )r Úis r! Úgetterz&_make_attr_tuple_class.<locals>.getter s Ø7Nr# )Ú enumerateÚpropertyr3 rL )Úcls_nameÚ
|
attr_namesÚattr_class_nameÚbodyro Ú attr_namerp s r! Ú_make_attr_tuple_classrx sX ð "
|
*Ð-OØ DÜ! *Ó-ò + 9à ó ô # 6Ó*Yð +ô ¤% ¨4Ó 0Ð0r# c ó, e Zd ZU ded< ded< ded< y)Ú _Attributesr3 Úattrsúlist[Attribute]Ú
|
base_attrsúdict[str, type]Úbase_attrs_mapN)r& r' r( Ú__annotations__r r# r! rz rz s
Ø KØ Ó Ø#Ô#r# rz c ó t | « } | j d« r| j d« r| dd } | j t « S )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Ú
|
startswithÚendswithÚ_CLASSVAR_PREFIXES)Úannots r! Ú _is_class_varr & sE ô JEð ×Ñ
|
Ô#¨¯©°zÔ(BØa à × Ñ Ô .Ó /Ð/r# c ó || j v S )zR
|
Check whether *cls* defines *attrib_name* (and doesn't just inherit it).
|
)Ú__dict__)ÚclsÚ attrib_names r! Ú_has_own_attributer 7 s ð #,,Ð &Ð&r# c óº g }i }t | j dd « D ]a }t |dg « D ]O }|j s|j |v r |j d¬« }|j |« |||j < Q c g }t « }t |« D ]> }|j |v r|j d|« |j |j « @ ||fS )zQ
|
Collect attr.ibs from base classes of *cls*, except *taken_attr_names*.
|
r
|
r^ Ú__attrs_attrs__T©Ú inheritedr )
|
ÚreversedÚ__mro__Úgetattrr ÚnameÚevolveÚappendÚsetÚinsertÚadd)r Útaken_attr_namesr} Ú base_attr_mapÚbase_clsÚaÚfilteredÚseens r! Ú_collect_base_attrsr¢ > så ð JØMô S[[¨¨2Ð .Ó/ò -ÜÐ#4°bÓ9ò -AØ{{affÐ(8Ñ 8Øà 4Ó(AØ × Ñ aÔ Ø$,M!&&Ò !ñ -ð-ð HÜ 5DÜ jÓ !ò Ø 66T>Ø Ø1Ô Ø Õð ð ]Ð "Ð"r# c ó g }i }| j dd D ]p }t |dg « D ]^ }|j |v r|j d¬« }|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^ r Tr )r r r r r r )r r r} r r r s r! Ú_collect_base_attrs_brokenr¤ _ s ð JØMð KK "Ð%ò -ÜÐ#4°bÓ9ò -AØvvÐ)Ñ)Øà 4Ó(AØ × Ñ §¡Ô (Ø × Ñ aÔ Ø$,M!&&Ò !ñ -ð-ð }Ð $Ð$r# c óÄ | j t | « }|t |j « « }n|du rðj « D ch c] \ }} | j t
|
u r| }
|
}} g }t « } |j « D ]h \ } } t | « r| j | « j | t « }|j t
|
ur t |« }|j | |f« j |
|
| z
|
}|rQt ddj t |fd¬« « z dz « t d j « D « d ¬« }t j" }t$ j& j( }|D cg c]! \ } } || |||u|j | « « # }} }|r(t+ | |D ch c] }|j, c}« \ }}n't/ | |D ch c] }|j, c}« \ }}|t$ j& j0 u r>|D cg c] }|j3 d¬ « }}|D cg c] }|j3 d¬ « }}||z }|t5 || |« « }d
|
}d |D « D ]B }|du r"|j6 t u rd |}t9 |« |d
|
u s.|j6 t usAd}D |D ]= }|j: rt= j? |« d tA |j, « « ? |D cg c] }|j, }}tC | jD |« }tG ||« ||« S c c} }w c c}} w c c}w c c}w c c}w c c}w c c}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 | « j S r/ )ÚgetÚcounter)ÚnÚcds r! ú<lambda>z"_transform_attrs.<locals>.<lambda>© s ø °b·f±f¸Q³i×6GÑ6G r# )Úkeyú.c 3 óN K | ] \ }}|j t u r||f y wr/ )Ú __class__rO )Ú.0r Úattrs r! ú <genexpr>z#_transform_attrs.<locals>.<genexpr>¯ s, è ø ò á D$Ø>>¤]Ñ2ð t ñ ùs #%c ó | d j S ©Nr
|
)r© )Úes r! r¬ z"_transform_attrs.<locals>.<lambda>´ s !A$,, r# )r> Fc 3 ó\ K | ]$ }|j d us|j d u s!| & yw)FN)r; r> ©r± r s r! r³ z#_transform_attrs.<locals>.<genexpr>Û s& è ø Ò MA !§&¡&°Ò"5¸!¿)¹)ÀuÒ:LaÑ Mùs ,,¥,zlNo mandatory attributes allowed after an attribute with a default value or factory. Attribute in question: rD )$r r rK Úitemsr° rO r r r r¨ r rR r r ÚjoinÚsortedÚ AttributeÚfrom_counting_attrÚ
|
ClassPropsÚ KeywordOnlyÚNOr¢ r r¤ ÚFORCEr rL r6 rG rD Ú _OBJ_SETATTRÚ__get__Ú_default_init_alias_forrx r& rz ) r ÚtheseÚ auto_attribsr> Úcollect_by_mroÚfield_transformerÚannsÚca_listr r² Úca_namesÚ annot_namesrw r3 r Ú unannotatedÚfcaÚnoÚcaÚ own_attrsr} r r{ Ú had_defaultrQ rt Ú
|
AttrsClassr« s @r! Ú_transform_attrsrÔ { sp ø ð$
|
BÜ CÓ Dà ÐÜu{{}Ó%Ø Ñ ð !hhj÷
|
ádØ~~¤ Ñ.ò ð
|
ñ
|
ð
|
Üe Ø #zz|ò +OItÜ TÔ"ØØ OOIÔ &Øy¤'Ó*Aà{{¤-Ñ/Ü1IØ NNI q>Õ *ð +ð Ñ, Ù Ü+ØCØ))Ü;Ó,GÔHóñð ñ óð ô ñ à"$§(¡(£*ô ñ
|
'ô
|
ô ×
|
&Ñ
|
&CÜ × Ñ × "Ñ "Bð %÷ñ Irñ Ø Ø Ø 2Ð Ø HHYÓ õ
|
ðIñ ñ Ü$7Ø )Ö,Q!&&Ò,ó%
|
Ñ!
|
Mô %?Ø )Ö,Q!&&Ò,ó%
|
Ñ!
|
Mð *×(Ñ(×.Ñ.Ñ.Ø5>Ö?°QXX dXÕ+Ð? Ð?Ø6@ÖA°ahh thÕ,ÐA
|
ÐAà Ñ "EàÐ$ÜÑ'¨¨UÓ3Ó4ð KÙ MÔ Mò Ø $Ñ 1§9¡9´Ñ#7ð Að BCð AFð GCÜ S/Ð !à %Ò A§I¡I´WÒ$<Ø Kð ð ò NØwwä × Ñ Ó # GÔ-DÀQÇVÁVÓ-LÕ MðNð #(Ö(Q!&&Ð(JÐ(Ü'¨¯ © °jÓAJä z %Ó(¨*°mÓ DÐDùó{
|
ùóLùò -ùò -ùò @ùÚAùò> )s* Á L=Å<&MÆ1M
|
ÇM
|
ÈMÈ5MË?M c ó g d¢}||j d« n|j g d¢« |j ddg« t |d« }| t j |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_getÚoriginal_getattrú
|
Ú_cls)rf Ú __getattr__)r ÚextendÚ_generate_unique_filenamer rà rk rº )rÖ rØ r ÚlinesÚunique_filenameÚglobs r! Ú _make_cached_property_getattrrá ó s ò Eð Ð#Ø Ø :õ
|
ð ò ô
|
ð
|
LLà $Ø )ð
|
ôô 0°°YÓ?Oð /Ü +× 3Ñ 3Ø ,ñ Dô "Ø %Ó/¨4¸À¸ ô àñ ð r# c óf t | t « r |dv rt j | ||« yt )z4
|
Attached to frozen classes as __setattr__.
|
)Ú __cause__Ú __context__Ú __traceback__Ú__suppress_context__Ú __notes__N)rJ Ú BaseExceptionÚ __setattr__r ©r r Úvalues r! Ú_frozen_setattrsrì ' s7 ô $ Ô&¨4ð 4ñ ,ô ×!Ñ! $¨¨eÔ4Øä
|
Ð r# c ód t | t « r|dv rt j | |« yt )z4
|
Attached to frozen classes as __delattr__.
|
)rç N)rJ rè Ú __delattr__r )r r s r! Ú_frozen_delattrsrï 8 s. ô $ Ô&¨4°>Ñ+AÜ×!Ñ! $¨Ô-Øä
|
Ð r# c ó | \ }|j }t |« }|D ]; }|j
|
s|j }|j }||vs-t ||« ||< = |di |¤S # t $ r dt | « d}t |« dw xY w)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 ) rG ra rF r° Úfieldsr; r rD r ) ÚargsÚchangesÚinstrQ r r{ r rw Ú init_names r! r r C s© ðJ'Øð ..CÜ 3KEØ ò :ØvvØ ØFF ØGG Ø GÒ #Ü!(¨¨yÓ!9GIÒ ð :ñ >>Ðøô! ò 'à8¼¸T»¸ À;Ð Oð ô n $Ð&ð 'ús A% Á%%B
|
c ó¤ e Zd ZdZdZ ddZd ZddZd Zd Z d Z
|
d Z d
|
Z d Z d Zd Zd Zd Zd Zd Zd Zd Zd ZddZddZy)Ú _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_setattrc ó
|
t ||||j |j |j « \ }}}|| _ |j
|
rt |j « ni | _ || _ |D ch c] } | j c} | _ || _ t d |D « « | _ |j
|
| _ |j | _ |j$ | _ |j( t* j, j. u | _ t3 t5 |dd« « | _ d| _ | j6 r>|j: }
|
t= j> |
|
« } tA | jB « dkD | _ t3 t5 |dd« « | _" t3 |« | _# |jH | _% |jL | _' || _( d| _) | j | j d< || j d< |j r.tT | j d< tV | j d < d
|
| _) n»| jN tX tZ j\ tZ j^ fv rdx} } |D ]% } | j` d
|
} | jb d
|
} | s"| s% n | jN tX k( r| s| r>| jN tZ j\ k( r| r | jN tZ j^ k( r | sd | _' |jd r-| jg « \ | j d < | j d < g | _4 d| _5 tm | j d « rtm | j d« s| jn | _8 y | jr | _8 y c c} w )Nc 3 ó4 K | ] }|j y wr/ ©r r¸ s r! r³ z)_ClassBuilder.__init__.<locals>.<genexpr>° s è ø Ò 7¨A §¥Ñ 7ùs Ú__attrs_pre_init__Fr
|
Ú__attrs_post_init__r Ú__attrs_props__ré rî TÚ __getstate__Ú __setstate__r' r( ):rÔ r> Úcollected_fields_by_mrorÈ rÚ Ú
|
is_slottedÚdictr rþ rú r rü rû rL rù r Ú is_frozenr Úhas_weakref_slotr
|
Ú hashabilityr¾ Ú HashabilityÚHASHABLE_CACHEDrý Úboolr r r r ÚinspectÚ signaturera Ú
|
parametersr rÿ Ú is_exceptionr Úon_setattr_hookr r r rì rï Ú_DEFAULT_ON_SETATTRr ÚvalidateÚconvertr7 r< Úadded_picklingÚ_make_getstate_setstater r ÚhasattrÚ_add_method_dunders_saferø Ú_add_method_dunders_unsafe)r r rÅ rÆ ÚpropsÚhas_custom_setattrr{ r} Úbase_mapr Ú pre_init_funcÚpre_init_signatureÚ has_validatorÚ has_converters r! Ú__init__z_ClassBuilder.__init__ s ô '7Ø Ø Ø Ø MMØ × )Ñ )Ø × #Ñ #ó '
|
Ñ#z8ð Ø/4×/?Ò/?cllÔ+ÀRØ Ø,6Ö7 qAFFÒ7ÔØ &ÔÜ Ñ 7°Ô 7Ó7ÔØ×&Ñ& Ø Ø "× 3Ñ 3Ôà × Ñ ¤×!7Ñ!7×!GÑ!GÐ Gð Ôô "¤'¨#Ð/CÀUÓ"KÓ LÔØ"'Ô Ø × Ò ð × 2Ñ 2MÜ!(×!2Ñ!2°=Ó!AÐ Ü&)Ð*<×*GÑ*GÓ&HÈ1Ñ&LDÔ #Ü "¤7¨3Ð0EÀuÓ#MÓ NÔÜ#'¨£;Ô Ø ×)Ñ) Ø ×0Ñ0Ôà#5Ô Ø"'Ô à,0¯K©KÐ(Ñ)Ø,1Ð(Ñ)à ??Ü,<DNN=Ñ )Ü,<DNN=Ñ )à&*DÕ #Ø × Ñ Ü Ü × Ñ Ü OOð"
|
ñ
|
ð
|
-2Ð 1MMØò Ø;;Ð*Ø$(MØ;;Ð*Ø$(Mâ ¢]Ùð ð ×$Ñ$Ô(;Ò;Ù *©mà×$Ñ$¬×(8Ñ(8Ò8Á Ø×$Ñ$¬¯©Ò7Á ð
|
$(Ô à × Ò ð ×,Ñ,Ó.ñ Ø~Ñ.Ø~Ñ.ð ð Ô ð !Ôô tyy ,Ô/´wØ II~ô8
|
ð (,×'DÑ'DDÕ $à'+×'FÑ'FDÕ $ùò_ 8s Á-N c ó6 d| j j dS )Nz<_ClassBuilder(cls=z)>)rÚ r& r s r! r" z_ClassBuilder.__repr__ÿ s Ø$ T§Y¡Y×%7Ñ%7Ð$8¸Ð;Ð;r# c óH dj | j D cg c] }|d c}« }i }| j D ] \ }}}|j |« t |t | j
|
d« |« }| j D ] \ }}} || j |« yc c}w )z=
|
Evaluate any registered snippets in one go.
|
rÙ r ÚmethodsN)rº r Úupdaterk rÝ rÚ rþ )r ÚsnippetrW rX Ú_Ú snippet_globsrY Úhooks r! Ú_eval_snippetsz _ClassBuilder._eval_snippets s¥ ð °d×6KÑ6KÖL¨7G AJÒLÓMØØ#'×#8Ñ#8ò (Ñ A}aØ LL Õ 'ð (ô &Ø Ü % d§i¡i°Ó ;Ø ó
|
ð ×/Ñ/ò 'JAq$Ù Õ &ñ 'ùò Ms B c óX | j « | j du r5| j « }t j |« | j
|
_ n+| j « }t rt j |« }t |dd« r d|j vr|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ÚweakrefÚrefrÚ Ú__attrs_base_of_slotted__Ú_patch_original_classr ÚabcÚupdate_abstractmethodsr r r< )r r s r! Ú build_classz_ClassBuilder.build_class s ð ×ÑÔ Ø ;;$Ñ Ø×*Ñ*Ó,CÜ29·+±+¸cÓ2BDIIÕ /à×,Ñ,Ó.CÝÜ×0Ñ0°Ó5ô
|
CÐ2°DÔ 9Ø)°· ± Ñ=à × 'Ñ 'Ô )à
|
r# c óê | j }| j }| j r\| j D ]M }||vst ||t
|
« t
|
us t j t « 5 t ||« ddd« O | j j « D ] \ }}t |||« | j s+t |dd« r d|_ | j s t |_ |S # 1 sw Y ÁxY w)zA
|
Apply accumulated methods and return the class.
|
NÚ__attrs_own_setattr__F)rÚ rü rÿ rù r Ú _SENTINELÚ
|
contextlibÚsuppressÚAttributeErrorÚdelattrrþ r¹ Úsetattrr rF r r ré )r r Ú
|
base_namesr rë s r! rA z#_ClassBuilder._patch_original_class- sì ð iiØ×%Ñ%
|
ð × Ò Ø ×(Ñ(ò +à
|
Ò*Ü T¬9Ó5¼YÒFô
|
$×,Ñ,¬^Ó<ñ +Ü TÔ*÷+ð +ð +ð >>×/Ñ/Ó1ò &KD%Ü CuÕ %ð &ð
|
×&Ò&¬7Ø Ð(¨%ô,
|
ð ).CÔ %à×+Ò+Ü".à
|
÷#+ð +ús Á* C)Ã)C2 c ó | j j « D ci c]& \ }}|g t | j « ¢ddvr||( }}}t t
|
d« r t j | j « | j sSd|d< | j sB| j j D ]) }|j j dd« s t |d< n i }d}| j j dd D ]U }|j j dd « d
|
}|j t! |d g « D ci c] }|t! ||« c}« W t# | j$ « }| j } | j& r$dt! | j d d « vr d| vr|s| d z } |j « D
|
ci c]" \ }}
|
t) |
|
t* « r ||
|
j, $ } }}
|
g } | rÆt/ | j « } | j « D ]` \ }}| |fz } ||= | j1 |« t3 j4 |« j6 }|t2 j8 j: us\|| |< b |j d« }|| j1 |« t= | || j « |d< | D cg c] }||vs| }}|j « D ci c] \ }}||v r|| }}}|D cg c] }||vs| }}|j |« | j> r|j1 t@ « t |« |d < | j jB |d< tE | j « | j jF | j j |« }tI jJ |j jM « | « D ] }t) |tN tP f« rt! |jR dd « }n5t) |tT « rt! |jV dd « }n t! |dd « }|si|D ]% } |jX | j u }|s ||_, ' |S c c}}w c c}w c c}
|
}w c c}w c c}}w c c}w # tZ $ r Y Xw xY w)zL
|
Build and return a new class with a `__slots__` attribute.
|
r Ú __weakref__Ú_clear_type_descriptorsFrF ré r
|
r^ NTÚ __slots__r )rO rÛ r( Ú __closure__).rþ r¹ rL rù r' ÚsysrP rÚ r r Ú __bases__r r¨ r r r5 r r rü r
|
rJ r Úfuncr r r r Úreturn_annotationÚ ParameterÚemptyrá rý Ú_HASH_CACHE_FIELDr( r3 r& Ú itertoolsÚchainÚvaluesÚ classmethodÚ staticmethodÚ__func__rr ÚfgetÚ cell_contentsrG )r ÚkÚvr« r Úexisting_slotsÚweakref_inheritedr rM ÚnamesÚ cached_proprÖ Ú&additional_closure_functions_to_updateÚclass_annotationsrU Ú
|
annotationrØ Ú
|
slot_namesÚslotÚslot_descriptorÚ reused_slotsr ÚitemÚ closure_cellsÚcellÚmatchs r! r= z!_ClassBuilder._create_slots_classQ s ð ×,Ñ,Ó.÷
|
á1ØÐM% × 0Ñ 0Ó1ÐM°:ÐM¸}ÑMÑMð qDð
|
ñ
|
ô 3Ð1Ô 2Ü × 'Ñ '¨¯ © Ô 2ð ×&Ò&Ø*/BÐ&Ñ 'à×+Ò+Ø $§ ¡ × 3Ñ 3ò HØ ×(Ñ(×,Ñ,Ð-DÀeÕLÜ,8=Ñ)Ù ð ð Ø !ÐØ ×)Ñ)¨!¨BÐ/ò HØ× Ñ ×$Ñ$ ]°DÓ9ÐEØ$(Ð!Ø × !Ñ !ô !(¨°+¸rÓ Böà ð ' (¨DÓ1Ñ1òõ ð ô ×)Ñ)Ó*
|
à× Ñ à × Ò Ø ¤W¨T¯Y©Y¸ ÀRÓ%HÑHØ UÑ*Ù%à Ð%Ñ %Eð &(§X¡X£Z÷
|
á!kÜ+¤Ô7ð +×"Ñ"Ñ "ð
|
Ðñ
|
ð 24Ð.Ù Ü 0°·±Ó ;Ð Ø /× 5Ñ 5Ó 7ò 9
|
dà$Ñ àtHØ6×=Ñ=¸dÔCÜ $× .Ñ .¨tÓ 4× FÑ F
|
Ø ¤W×%6Ñ%6×%<Ñ%<Ò<Ø.8Ð% dÒ+ð 9ð "vv mÓ 4Ð Ø Ð+Ø6×=Ñ=Ð>NÔOä =Ø!Ð#3°T·Y±Yó!B}Ñ ð (-ÖGt°¸JÒ0FdÐG
|
ÐGð *8×)=Ñ)=Ó)?÷
|
á%oØzÑ!ð /Ñ !ð
|
ñ
|
ð
|
(2ÖNt°TÀ Ò5MdÐN
|
ÐNØ
|
,Ô Ø × Ò Ø × Ñ Ô /Ô 0ä
|
Ó+;à !YY× 3Ñ 3>Ñð d499odii× 0Ñ 0°$·)±)×2EÑ2EÀrÓJô OOØ LL× Ñ Ó !Ð#Ió
|
ò 1Dô $¤¬lÐ ;Ô<ô !(¨¯ © °}ÀdÓ K ÜD¤(Ô+ô !(¨¯ © °=À$Ó G ä '¨¨m¸TÓ B á ØØ%ò 1ð1Ø × .Ñ .°$·)±)Ð ;Eò
|
Ø-0Õ*ñ 1ð! 1ð2
|
ùóS
|
ùòFùó"
|
ùò> Hùó
|
ùò
|
OøôJ "ò áðúsA +QÄ2Q
|
Æ3'Q$Ê+ Q*Ê5Q*ËQ/Ë& Q5Ë0Q5Ð1Q:Ñ: RÒRc ó t j |« \ }} fd} j j |||f« d _ S )Nc ó4 j |d « | d< y )Nr" ©rø ©Úcls_dictrX r s r! Ú _attach_reprz,_ClassBuilder.add_repr.<locals>._attach_reprã s ø Ø#'×#;Ñ#;¸EÀ*Ñ<MÓ#NHZÒ r# T)Ú_make_repr_scriptrú r r r )r ÚnsrW rX rx s ` r! Úadd_reprz_ClassBuilder.add_reprà sG ø Ü)¨$¯+©+°rÓ: ô Oð × Ñ ×$Ñ$ f¨e°\Ð%BÔCØ ÔØ r# c óz | j s d}t |« d }| j |« | j d< | S )Nz3__str__ can only be generated if a __repr__ exists.c ó" | j « S r/ ©r" r s r! Ú__str__z&_ClassBuilder.add_str.<locals>.__str__ï s Ø==?Ð "r# r )r rG rø rþ )r rQ r s r! Úadd_strz_ClassBuilder.add_strê s? Ø× Ò ØGCÜ S/Ð !ò #ð %)×$<Ñ$<¸WÓ$EyÑ!Ø r# c ót t d | j D « « fd}| j fd}||fS )zF
|
Create custom __setstate__ and __getstate__ methods.
|
c 3 ó, K | ] }|d k7 s | yw)rO Nr )r± Úans r! r³ z8_ClassBuilder._make_getstate_setstate.<locals>.<genexpr>ú s è ø ò !
|
بR°=Ó-@Bñ!
|
ùs
|
c óD D ci c] }|t | |« c}S c c}w )ú9
|
Automatically created by attrs.
|
©r )r r Ústate_attr_namess r! Úslots_getstatez=_ClassBuilder._make_getstate_setstate.<locals>.slots_getstateþ s& ø ð ;KÖK°$D' $¨Ó-Ñ-ÒKÐ KùÒKs c óÜ t j | « }t |t « r t |« D ] \ }} |||« nD ] }||v s |||| « r |t
|
d« yy)r
N)r rà rJ rL ÚziprY )r ÚstateÚ _ClassBuilder__bound_setattrr rë Úhash_caching_enabledr s r! Úslots_setstatez=_ClassBuilder._make_getstate_setstate.<locals>.slots_setstate s ø ô +× 2Ñ 2°4Ó 8OÜ%¤Ô'ô $'Ð'7¸Ó#?ò 1KD%Ù# D¨%Õ0ñ1ð -ò ;DØu}Ù'¨¨e°D©kÕ:ð;ñ $Ù Ô 1°4Õ8ð $r# )rL rù rý )r r r r r s @@r! r& z%_ClassBuilder._make_getstate_setstateõ sI ù ô
|
!ñ !
|
Ø ×)Ñ)ô!
|
ó
|
Ðô Lð $× /Ñ /Ð õ 9ð, ~Ð-Ð-r# c ó$ d | j d< | S ©NÚ__hash__)rþ r s r! Úmake_unhashablez _ClassBuilder.make_unhashable s Ø%)zÑ"Ø r# c óÄ t j j j j ¬« \ }}d fd } j
|
j |||f« S )N©ÚfrozenÚ
|
cache_hashc ó4 j |d « | d< y r ru )rw rY r s r! Ú attach_hashz+_ClassBuilder.add_hash.<locals>.attach_hash* s ø Ø#'×#;Ñ#;¸DÀÑ<LÓ#MHZÒ r# )rw r rY r ÚreturnÚNone)Ú_make_hash_scriptrÚ rú r rý r r )r rW rX r s ` r! Úadd_hashz_ClassBuilder.add_hash" sW ø Ü)Ø IIØ KKØ<<Ø×'Ñ'ô
|
õ Nð × Ñ ×$Ñ$ f¨e°[Ð%AÔBà r# c ód t j j j j j
|
j j j j j j d¬« \ }} fd} j j |||f« S )NF©Ú
|
attrs_initc óF |d }|_ j |« | d< y )Nr1 ©r rø ©rw rX r; r r s r! Ú _attach_initz,_ClassBuilder.add_init.<locals>._attach_initA s* ø ØÑ$DØ#.DÔ Ø#'×#;Ñ#;¸DÓ#AHZÒ r# ©Ú_make_init_scriptrÚ rú r r r r r rý rû r r r r )r rW rX r£ r s ` @r! Úadd_initz_ClassBuilder.add_init1 s ù Ü%6Ø IIØ KKØ × Ñ Ø × #Ñ #Ø × Ñ Ø LLØ KKØ × Ñ Ø × Ñ Ø LLØ × Ñ Ø ô &
|
Ñ"{õ Bð
|
× Ñ ×$Ñ$ f¨e°\Ð%BÔCà r# c óD | j d « | j d< | S )Nc ó t | fi |¤S r/ )r )r ró s r! r¬ z+_ClassBuilder.add_replace.<locals>.<lambda>L s ¤F¨4Ñ$;°7Ñ$; r# Ú __replace__)rø rþ r s r! Ú add_replacez_ClassBuilder.add_replaceJ s% Ø(,×(@Ñ(@Ù ;ó)
|
}Ñ%ð r# c óV t d | j D « « | j d< y )Nc 3 ód K | ]( }|j r|j s|j * y wr/ )r; r> r )r± Úfields r! r³ z/_ClassBuilder.add_match_args.<locals>.<genexpr>Q s) è ø ò 1
|
àØzz %§-¢-ð JJñ1
|
ùs .0Ú__match_args__)rL rú rþ r s r! Úadd_match_argsz _ClassBuilder.add_match_argsP s' Ü+0ñ 1
|
à ô1
|
ó ,
|
Ð'Ò(r# c ód t j j j j j
|
j j j j j j d¬« \ }} fd} j j |||f« S )NTr c óF |d }|_ j |« | d< y )NÚ__attrs_init__r¡ r¢ s r! Ú_attach_attrs_initz8_ClassBuilder.add_attrs_init.<locals>._attach_attrs_initg s, ø ØÐ)Ñ*DØ#.DÔ Ø)-×)AÑ)AÀ$Ó)GHÐ%Ò &r# r¤ )r rW rX r³ r s ` @r! Úadd_attrs_initz _ClassBuilder.add_attrs_initW s ù Ü%6Ø IIØ KKØ × Ñ Ø × #Ñ #Ø × Ñ Ø LLØ KKØ × Ñ Ø × Ñ Ø LLØ × Ñ Øô &
|
Ñ"{õ Hð
|
× Ñ ×$Ñ$ f¨eÐ5GÐ%HÔIà r# c ó¨ j }t j « \ }} fd} j j |||f« t
|
|d< S )Nc ó4 j |d « | d< y )NÚ__eq__ru rv s r! Ú
|
_attach_eqz(_ClassBuilder.add_eq.<locals>._attach_equ s ø Ø!%×!9Ñ!9¸%À¹/Ó!JHXÒ r# Ú__ne__)rþ Ú_make_eq_scriptrú r r r¹ )r r« rW rX r¸ s ` r! Úadd_eqz_ClassBuilder.add_eqp sO ø Ø ^^ä'¨¯ © Ó4 ô Kð × Ñ ×$Ñ$ f¨e°ZÐ%@ÔAä 8 à r# c ó j } fdt j j « D « \ |d< |d< |d< |d< S )Nc 3 ó@ K | ] }j |« y wr/ ru )r± Úmethr s r! r³ z*_ClassBuilder.add_order.<locals>.<genexpr> s& øè ø ò B
|
àð × $Ñ $ T× *ñB
|
ùs Ú__lt__Ú__le__Ú__gt__Ú__ge__)rþ Ú _make_orderrÚ rú )r r« s ` r! Ú add_orderz_ClassBuilder.add_order~ sL ø Ø ^^óB
|
ä# D§I¡I¨t¯{©{Ó;ôB
|
Ñ>8 bl B x¡L°"°X±,ð
|
r# c ó\ i | j D ]C }|j xs | j }|s |t j us3||f|j
|
< E s| S | j r d}t |« fd}d| j d< | j |« | j d< d| _
|
| S )Nz7Can't combine custom __setattr__ with on_setattr hooks.c óh | \ }} || ||« }t | ||« y # t $ r |}Y w xY wr/ )ÚKeyErrorr )r r Úvalr r9 ÚnvalÚsa_attrss r! ré z._ClassBuilder.add_setattr.<locals>.__setattr__ sG ø ð *Ø" 4.4ñ D ! SÓ)ä t TÕ *øô ò Øð ús # £ 1°1TrF ré ) rú rC r r ÚNO_OPr r rG rþ rø r )r r rC rQ ré rÊ s @r! Ú add_setattrz_ClassBuilder.add_setattr s ø ØØò 1AØ Ò9¨×)9Ñ)9JÚj´· ± Ò =Ø#$ j =Ò ð 1ñ
|
ØKà × #Ò #àKCÜ S/Ð !ô +ð 37Ð.Ñ/Ø(,×(@Ñ(@ÀÓ(M}Ñ%Ø"&Ô à r# c óÎ | j j |_ | j j d|j |_ d| j j d|_ |S )z@
|
Add __module__ and __qualname__ to a *method*.
|
r® ú$Method generated by attrs for class )rÚ r' r( r& r) ©r Úmethods r! r) z(_ClassBuilder._add_method_dunders_unsafe¨ s` ð !II× 0Ñ 0Ôà!%§¡×!7Ñ!7Ð 8¸¸&¿/¹/Ð9JÐ KÔð 3°4·9±9×3IÑ3IÐ2JÈ!Ð Lð ð r# c óä t j t « 5 | j j |_ ddd« t j t « 5 | j j
|
d|j |_ ddd« t j t « 5 d| j j
|
d|_ ddd« |S # 1 sw Y xY w# 1 sw Y XxY w# 1 sw Y |S xY w)zL
|
Add __module__ and __qualname__ to a *method* if possible.
|
Nr® rÎ )rH rI rJ rÚ r' r( r& r) rÏ s r! r( z&_ClassBuilder._add_method_dunders_safe¶ sÒ ô × Ñ ¤ Ó 0ñ 5Ø $§ ¡ × 4Ñ 4FÔ ÷ 5ô × Ñ ¤ Ó 0ñ PØ%)§Y¡Y×%;Ñ%;Ð$<¸A¸f¿o¹oÐ=NÐ"OFÔ ÷ Pô × Ñ ¤ Ó 0ñ ^Ø CÀDÇIÁI×DZÑDZÐC[Ð[\Ð ]FN÷ ^ð ÷ 5ð 5ú÷ Pð Pú÷ ^ð ús# C Á+CÂ# C%Ã CÃC"Ã%C/N)r r3 rÆ r r* r¾ r+ r )r r )rÐ r r r )r& r' r( r) rQ r1 r" r: rD rA r= r{ r r& r r r¦ rª r¯ r´ r» rÄ rÌ r) r( r r# r! r÷ r÷ } s¨ ñðIð0cGà ðcGð ð cGð
|
ð cGð !ó cGòJ<ó'ò$ò2"òHMò^ò ò'.òRò ò ò2ò
|
òò2 ò ò ó@ ô r# r÷ c ó | t |du|duf« r d}t |« | | | fS ||}||}|du r|du r d}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.©ÚanyrG )r9 r? rA Ú
|
default_eqrQ s r! Ú_determine_attrs_eq_orderrÙ Æ sy ð
|
3 ¨$ °¸TÐ0AÐ BÔCØ6ÜoÐ ð ØCxð
|
zØ à }Øà U{u }Ø=ÜoÐ à u9Ðr# c óì | t |du|duf« r d}t |« d }| || « \ } }| || |fS ||d}}n ||« \ }}|||}}n ||« \ }}|du r|du r d}t |« ||||fS )rÓ NrÔ c ó4 t | « rd| }} | |fS d}| |fS )z8
|
Decide whether a key function is used.
|
TN)rH )rë r s r! Údecide_callable_or_booleanz>_determine_attrib_eq_order.<locals>.decide_callable_or_booleanë s1 ô E?Ø u3Eð czÐð CØczÐr# FTrÕ rÖ ) r9 r? rA rØ rQ rÜ Úcmp_keyr@ rB s r! rE rE â s¼ ð
|
3 ¨$ °¸TÐ0AÐ BÔCØ6ÜoÐ òð Ù1°#Ó6 WØGS 'Ð)Ð)ð
|
zØ Fá/°Ó3
|
Fà }Ø vyá5°eÓ<Ñyà U{u }Ø=ÜoÐ à vuiÐ 'Ð'r# c óT |du s|du r|S ||du r|S |D ] }t | |« s y |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 )r ÚflagÚ auto_detectÚdundersr6 Údunders r! Ú _determine_whether_to_implementrã sL ð t|tu}Ø à | uÑ,Øð ò Ü c 6Õ *Ùðð Nr# Fc ó8
|
ddl }|j t d« d¬« t |||d« \ ||t t
|
t f« rt j
|
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*.
|
.. versionchanged:: 25.4.0
|
*kw_only* now only applies to attributes defined in the current class,
|
and respects attribute-level ``kw_only=False`` settings.
|
.. versionadded:: 25.4.0 *force_kw_only*
|
Nr zQThe `repr_ns` argument is deprecated and will be removed in or after August 2025.é )Ú
|
stacklevelc ó xs t | « }du xr t | t « } xr t | d« }|r|r d}t |« | xr t | d« }t j }|r |j }ndu rr |j n |j }n~du r |j }nm^ du rt | d« r |j }nN|du r |du rr |j n |j }n+|du r |j }n|j }n d}t |« t j }rr |j n |j } n |j } t d"i d|d |d
|
d d t | d « dt | d« d|d| xr t | d« d|dd| d!d dt | d ¬« dd }
|
|
|
j" sr d }t |« t% | |
|
|¬ « } |
|
j& r| j) « |
|
j* r| j- « |
|
j. r| j1 « |
|
j2 r| j5 « s| j7 « |
|
j" r| j9 « n(|
|
j: |j u r| j= « |
|
j> r| jA « n | jC « r d }t |« tD r t | d « s| jG « tH r r t | d!« s| jK « | jM « S )#NTré z/Can't freeze a class with a custom __setattr__.)r· r¹ Fr r5 r r r r Ú
|
added_init©r1 Ú
|
added_reprr~ Úadded_eqÚadded_ordering)r¿ rÀ rÁ r r Úadded_match_argsr> r Ú added_strr% )r r )r6 r! rÈ zlInvalid value for cache_hash. To use hash caching, hashing must be either explicitly or implicitly enabled.)rÆ r* r+ zFInvalid value for cache_hash. To use hash caching, init must be True.r© r® r )'Ú_has_frozen_base_classÚ
|
issubclassrè r rG rã r¾ r Ú LEAVE_ALONEr ÚHASHABLEÚ
|
UNHASHABLErF r¿ rÁ ÚYESrÀ Ú is_hashabler÷ rê r{ rî r rë r» rì rÄ rÌ r r r rè r¦ r´ r rª r r¯ rD )"r r Úis_excÚhas_own_setattrrQ r? r r r¿ Úkwor* ÚbuilderrÆ rà Úauto_excr rÇ Úeq_rÈ Ú force_kw_onlyr Úgetstate_setstater: r; r> Ú
|
match_argsrC Úorder_r8 Úrepr_nsÚslotsr rÅ Ú weakref_slots" r! Úwrapzattrs.<locals>.wrap s© ø àÒ9Ô 4°SÓ 9 ØTÐ!ÒD¤j°´mÓ&DØ%ò
|
Ô*<Ø ó+
|
ñ yØCCÜ S/Ð !àZò
|
Ô ;Ø kÐ#7ó
|
ô !×,Ñ, á Ø%×1Ñ1KØ T\ñ ð ×+Ò+à ×)Ñ)ñ ð
|
U]Ø%×1Ñ1KØ \ØdÑ"Ô'9¸#¸zÔ'JØ )× 5Ñ 5 Øt ¨TÑ 1ñ "ð ×/Ò/à$×-Ñ-ñ ð
|
uØ )× 5Ñ 5 à )× 4Ñ 4 àJCÜC.Ð ä ×,Ñ, Ù Ù'4+×#Ò#¸+¿/¹/Cà ..Cäò !
|
Ù ð!
|
á ð!
|
ñ ð!
|
ñ %3ð !
|
ô
|
7ØT;¨ ôð !
|
ô 7ØT;¨ ôð!
|
ñ ð!
|
ð &:ò Ü/ØØØØ8ó øð!
|
ñ& $ð'!
|
ñ( (ð)!
|
ñ* ð+!
|
ñ, *ð-!
|
ñ. ð/!
|
ô0 ;ØØ!ØØ0Ø õ ð1!
|
ñ> 'ð?!
|
ñ@ 0ðA!
|
ðF × Ò ¡Zð ACÜC.Ð ä Ø Ø Ø%ØØ .ô
|
ð × Ò Ø × Ñ WÔ %à ??Ø OOÔ à >>Ø NNÔ Ø × Ò Ø × Ñ Ô áØ × Ñ Ô !à × Ò Ø × Ñ Õ Ø × Ñ +×"8Ñ"8Ñ 8Ø × #Ñ #Ô %à × Ò Ø × Ñ Õ à × "Ñ "Ô $ÙØ^Ü nÐ$å Ô 2°3¸ Ô FØ × Ñ Ô !õ ÙÜ& sÐ,<Ô=à × "Ñ "Ô $à×"Ñ"Ó$Ð$r# ) ÚwarningsÚwarnÚDeprecationWarningrÙ rJ rK rL r rM ) Ú maybe_clsrÅ r r8 r9 r: r; r r r r rÆ r> r rú r? rA rà rÇ rý rC rÈ rþ Ú unsafe_hashrü r r rû rÿ s ``` `````````` `````` ` @@r! r{ r{ ' s¡ ÿÿý ðB ÐÛà Ü Øcó ð ð ô
|
ô ,¨C°°U¸DÓAKCð Ð Øä*t¤UmÔ,Ü \\ :Ð.
|
÷G%÷ G%÷ G%ñ G%ðV ÐØ á ?Ðr# c ó& | j t u S )zV
|
Check whether *cls* has a frozen ancestor by looking at its
|
__setattr__.
|
)ré rì )r s r! rï rï 3 s ð
|
??Ô .Ð .Ð.r# c
|
óX d| d| j dt | d| j « dS )zF
|
Create a "filename" suitable for a function being generated.
|
z<attrs generated ú r® r( r` )r' r r& )r Ú func_names r! rÝ rÝ ; s7 ð
|
I; a¨¯©Ð'7°qÜ 3¨¯ © Ó 5Ð
|
6°að 9ðr# c óö
|
t d D « « d}t t | d« « i d}d
|
d|s|dz }n|dz }|d z }d
|
|
z
|
d z |g
|
fd }|rz j |d t dz « |r, |dt d|dz « j |dz d z « n |dt d|dz « j |dt z « n |d|« dj « }| fS )Nc 3 ót K | ]0 }|j d u s |j |j d u s-| 2 yw)TN)r: r? r¸ s r! r³ z$_make_hash_script.<locals>.<genexpr>H s1 è ø ò ØAFF dN¨q¯v©v©~À!Ç$Á$È$Â,ñùs 8¢8±8ú r: zdef __hash__(selfzhash((z))z):z, *zC, _cache_wrapper=__import__('attr._make')._make._CacheHashWrapper):z_cache_wrapper(ú)c óh j || z z |d dz g« D ]u }|j rEd|j d}|j |< j |d| d|j dz « Tj |d|j dz « w j |dz z « y )
|
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 ú,r7 Ú_keyú(self.z),ú self.ú N)rÜ r@ r r )
|
ÚprefixÚindentr Úcmp_namer{ Úclosing_bracesrX Ú hash_funcÚ method_linesÚ type_hashs
|
r! Ú append_hash_computation_linesz8_make_hash_script.<locals>.append_hash_computation_lines` sÒ ø ð ×Ñà )Ñ+Ø8 I ;¨aÐ0Ñ0ð ô
|
ð ò HAØxxØ qvvh dÐ+Ø"#§(¡(hØ ×#Ñ#Øx¨ z°¸¿¹°x¸rÐ BÑBõð ×#Ñ# F¨}¸Q¿V¹V¸HÀAÐ-FÑ$FÕGð Hð ×ÑF VO¨nÑ <Õ=r# zif self.z is None:zobject.__setattr__(self, 'ú', rå úself.ú = z return self.zreturn rÙ )rL r: rÝ r rY rº ) r r{ r r ÚtabÚhash_defr rW r rX r r r s ` @@@@@r! r r E sF ý ô ñ Øôó Eð CäÔ.¨s°FÓ;Ó<Ià Eà"HØIØNÙ ØDÑàEÑàÐYÑYØ%¨ Ñ1 Ø#Ñ à :L÷>ñ >ñ4 Ø×ÑC HÔ->Ð,?¸yÐ"IÑ IÔJÙ Ù )Ø,Ô->Ð,?¸sÐCÀSÈ1ÁWô ð × Ñ a¡¨#¡ Õ .á )ØÔ)Ð*¨#Ð.°°a±ô ð ×ÑC LÔ1BÐ0CÐ"DÑ DÕEá% i°Ô5à YY|Ó $FØ 5=Ðr# c ón t | |dd¬« \ }}t ||t | d« ¬« |d | _ | S )z%
|
Add a hash method to *cls*.
|
Fr r ©rZ )r r\ rÝ r ©r r{ rW rX s r! Ú _add_hashr' sG ô &Ø U5¨UôMFEô ØÔ 9¸#¸zÓ Jõð Ñ$CLØ Jr# c óF | j |« }|t u rt S | S )z^
|
Check equality and either forward a NotImplemented or
|
return the result negated.
|
)r· ÚNotImplemented)r ÚotherÚresults r! r¹ r¹ s( ð
|
[[Ó FØ Ñ Ü Ð à:Ðr# c ó, | D cg c] }|j s| } }g d¢}i }| rÆ|j d« | D ] }|j rRd|j d}|j ||< |j d| d|j d| d|j d « n+|j d
|
|j d |j « || d us|d d |d < |j d« n|j d« dj |« }||fS c c}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 (r7 r r r z) == z(other.r r z
|
== other.r^ z andz )z return TruerÙ )r? r r@ r rº )r{ r rÞ rX r rW s r! rº rº § s ð Ö &1 §£QÐ &EÐ &ò Eð EÙ Ø _Ô%Øò /AØxxØ qvvh dÐ+ð #$§(¡(hØ Ø xj¨¨q¯v©v¨h°e¸H¸:ÀWÈQÏVÉVÈHÐTUÐVõð }¨Q¯V©V¨H°J¸q¿v¹v¸hÐ GÔHØb Ò!Ø $ Ryk¨Ð .b ð /ð WÕ à Ð&Ô'à YYuÓ Fà 5=Ðùò= 's
|
DDc ó D cg c] }|j s| c}fdfd}fd}fd}fd}||||fS c c}w )z9
|
Create ordering methods for *cls* with *attrs*.
|
c ó< t d fdD « D « « S )z&
|
Save us some typing.
|
c 3 ó: K | ] \ }}|r ||« n| y wr/ r )r± rë r s r! r³ z6_make_order.<locals>.attrs_to_tuple.<locals>.<genexpr>Ö s' è ø ò
|
ásñ CJ 5Ó (ñ
|
ùs c 3 ób K | ]& }t |j « |j f ( y wr/ )r r rB )r± r Úobjs r! r³ z6_make_order.<locals>.attrs_to_tuple.<locals>.<genexpr>Ø s* øè ø ò Ø89affÓ% q§{¡{Ô3ñ ùs ,/)rL )r1 r{ s `r! Úattrs_to_tuplez#_make_order.<locals>.attrs_to_tupleÒ s) ù ô ñ
|
ó Ø=Bô ô
|
ó
|
ð
|
r# c ób |j | j u r | « |« k S t S ©z1
|
Automatically created by attrs.
|
©r° r) ©r r* r2 s r! r¿ z_make_order.<locals>.__lt__Ý ó0 ø ð ??dnnÑ ,Ù! $Ó'©.¸Ó*?Ñ?Ð ?ä Ð r# c ób |j | j u r | « |« k S t S r4 r5 r6 s r! rÀ z_make_order.<locals>.__le__æ ó0 ø ð ??dnnÑ ,Ù! $Ó'©>¸%Ó+@Ñ@Ð @ä Ð r# c ób |j | j u r | « |« kD S t S r4 r5 r6 s r! rÁ z_make_order.<locals>.__gt__ï r7 r# c ób |j | j u r | « |« k\ S t S r4 r5 r6 s r! r z_make_order.<locals>.__ge__ø r9 r# )rA )r r{ r r¿ rÀ rÁ r r2 s ` @r! rà rÃ Ì sK ù ð Ö )1 §£QÒ )Eô
|
ô ô ô ô ð 66 6Ð )Ð)ùòc *s ??c ó | | j }t |« \ }}t ||t | d« ¬« |d | _ t
|
| _ | S )z5
|
Add equality methods to *cls* with *attrs*.
|
r· r% )r rº r\ rÝ r· r¹ r& s r! Ú_add_eqr= sR ð }Ø×#Ñ#ä# EÓ*MFEÜØÔ 9¸#¸xÓ Hõð x CJÜCJà Jr# c óÒ t d | D « « }|D ci c] \ }}}|t k7 s|dz | }}}}t |d< t |d< t |d< g }|D ]B \ }}}|rd|z nd|z dz } |t k( r|d | d
|
n
|
|d |d | d }
|
|j |
|
« D d j |« } |d} n|dz } ddddddddddddd| d | d d d g} d j | « |fS c c}}}w )!zC
|
Create the source and globs for a __repr__ and return it.
|
c 3 ó¦ K | ]I }|j d ur9|j |j du rt n |j |j f K yw)FTN)r8 r r; r¸ s r! r³ z$_make_repr_script.<locals>.<genexpr> sC è ø ò "à Ø 66Ñ ð
|
!&& D.$¨a¯f©f°q·v±vÔ>ñ"ùs AAÚ_reprr rJ r r zgetattr(self, "z ", NOTHING)z={z!r}z_repr(z)}r¦ z1{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Ù )rL r8 r rJ r r rº )r{ rz Úattr_names_with_reprsr Úrr7 rX Úattribute_fragmentsro ÚaccessorÚfragmentÚ repr_fragmentÚcls_name_fragmentrÞ s r! ry ry sg ô "ñ "àô"ó Ðð -B÷ ð Ù (d A qÀQÌ$ÃYwÑð Eò ô E)ÑÜ ,EÐ
|
ÑÜ E)ÑØ ÐØ+ò -
|
aá GdNÐ%6¸Ñ%=À Ñ%Mð ð
|
Dyò ¢Ñ *â'+ªT²8Ð<ð ð
|
×"Ñ" 8Õ,ð -ð IIÐ 1Ó2Mà zØ OÑà Ð!=Ñ =Ðð ØØ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% )r ry r\ rÝ r" )r rz r{ rW rX s r! Ú _add_reprrJ N sN ð }Ø×#Ñ#ä% e¨RÓ0MFEÜØÔ 9¸#¸zÓ Jõð Ñ$CLØ Jr# c óÌ t | « }| t | t « s 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.
|
Nú Passed object must be a class.r ú! is not an attrs-decorated class.)r rJ r3 rF r r r )r Ú generic_baserQ r{ s r! rñ rñ ] s ô. $ CÓ(LàФJ¨s´DÔ$9Ø.ÜnÐ ä CÐ*¨DÓ 1Eà }Ø Ð #ÜLÐ*;¸TÓBEØÐ ð ',Ô#Ø ØÐ8Ð9Ü" 3Ó'Ð'à Lr# c óº t | t « s d}t |« t | dd« }|| d}t |« |D ci c] }|j
|
| c}S c c}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
|
rL r NrM )rJ r3 rF r r r )r rQ r{ r s r! Ú fields_dictrP se ô& c4Ô Ø.ÜnÐ Ü CÐ*¨DÓ 1EØ }ØÐ8Ð9Ü" 3Ó'Ð'Ø $Ö %!AFFAIÒ %Ð%ùÒ %s ÁAc ó¸ t j du ryt | j « D ]/ }|j }| || |t | |j « « 1 y)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_validatorsrñ r° r7 r r )rô r rc s r! r# r# ¨ sR ô × Ñ %Ñ'Øä DNNÓ #ò .Ø KKØ =Ù dAwt Q§V¡VÓ,Õ -ñ.r# c óH |j | « }|xr d|j v S )z>
|
Check if the attribute name comes from a slot class.
|
rQ )r¨ r )Úa_namer r s r! Ú _is_slot_attrrU º s( ð ×
|
Ñ
|
FÓ
|
#CØ Ò .; #§,¡,Ð.Ð.r# c ó¼ |
|
d uxr |
|
t j u} |r| r d} t | « |xs |}g }i }|D ] }|j s|j t
|
u r"|j |« |||j < |j |du r d} t | « d}b| se|j t j usd}
t ||||||||| || | rdnd« \ }}}| j t j v r6|j t j | j j « |j t
|
|d« |rt j |d< |||fS )Nz$Frozen classes can't use on_setattr.Tr² r1 )r Ú attr_dictr× )r rË rG r; r6 r r r rC Ú_attrs_to_init_scriptr' rS Úmodulesr5 r r rà )r r{ Úpre_initÚpre_init_has_argsÚ post_initr r r r rö Úcls_on_setattrr Úhas_cls_on_setattrrQ Úneeds_cached_setattrÚfiltered_attrsrW r rW rX r s r! r¥ r¥  sj ð dÐ"ÒJ ~¼W¿]¹]Ð'Jð ñ Ñ$Ø4ÜoÐ à%Ò/¨ÐØNØIØ ò (Øvv!))¤wÑ.Ø à× Ñ aÔ Ø !&&Ñà <<Ð #Ø~Ø<Ü oÐ%à#'Ñ Ú A§L¡L¼¿ ¹ Ò$EØ#'Ñ ð (ô "7ØØØ ØØØØØØØ ØÙ &ѨJó "Ñ FE;ð ~~Ñ$à S[[ § ¡ Ñ0×9Ñ9Ô:à LLW°9Ñ=Ô>áô (4×';Ñ';Ð#Ñ$à 5+Ð %Ð%r# c ó d| d| dS )zJ
|
Use the cached object.setattr to set *attr_name* to *value_var*.
|
ú
|
_setattr('r r r )rw Ú value_varÚhas_on_setattrs r! Ú_setattrre s ð { # i [°Ð 2Ð2r# Ú Converterc ó4 d| d|j | |« dS )zk
|
Use the cached object.setattr to set *attr_name* to *value_var*, but run
|
its converter first.
|
rb r r )Ú_fmt_converter_call©rw rc rd r< s r! Ú_setattr_with_converterrj s( ð { # i×&CÑ&CÀIÈyÓ&YÐ%ZÐZ[Ð \Ð\r# c ó0 |r t | |d« S d| d| S )zo
|
Unless *attr_name* has an on_setattr hook, use normal assignment. Otherwise
|
relegate to _setattr.
|
Tr r! )re )rw rë rd s r! Ú_assignrl s) ñ
|
Ü 5¨$Ó/Ð/à 9+S Ð (Ð(r# c óR |rt | |d|« S d| d|j | |« S )z
|
Unless *attr_name* has an on_setattr hook, use normal assignment after
|
conversion. Otherwise relegate to _setattr_with_converter.
|
Tr r! )rj rh ri s r! Ú_assign_with_converterrn # s9 ñ Ü& y°)¸TÀ9ÓMÐMà 9+S ×!>Ñ!>¸yÈ)Ó!TÐ UÐ VÐVr# c ó | du r4|du r dt t fS dfd } dfd }d||fS dt t fS )zg
|
Determine the correct setter functions based on whether a class is frozen
|
and/or slotted.
|
Tr c óF t | « r t | ||« S d| d| S ©Nú _inst_dict['z'] = )rU re )rw rc rd r s r! Ú
|
fmt_setterz&_determine_setters.<locals>.fmt_setter@ s1 ø ô Y¨ Ô6Ü ¨9°nÓEÐEà! ) ¨E°)°Ð=Ð =r# c ól |s t | « rt | |||« S d| d|j | |« S rq )rU rj rh )rw rc rd r< r s r! Úfmt_setter_with_converterz5_determine_setters.<locals>.fmt_setter_with_converterH sL ø ñ ¤ ¨y¸-Ô!HÜ.Ø y¨.¸)óð ð " ) ¨E°)×2OÑ2OÐPYÐ[dÓ2eÐ1fÐgÐ gr# )z_inst_dict = self.__dict__©rw r rc r rd r r r ©
|
rw r rc r rd r r< rf r r )re rj rl rn )r r r rs ru s ` r! Ú_determine_settersrx 0 s¤ ø ð ~Ø D=ØxÔ!8Ð8Ð 8ð >Øð >Ø'*ð >Ø<@ð >à õ >ð hØð hàð hð !ð hð !ð hð
|
õ hð ,Ø Ø %ð
|
ð
|
ð wÔ.Ð .Ð.r# c
|
óì |rdgng } | r| j d« t |||« \ } }}| j | « g }g }g }g }i }ddi}| D ] }|j r|j |« |j }|j
|
duxs |j
|
t j uxr |
|
}|j }t |j t « }|r|j j rdnd}|j 0t |j t « st |j « } n |j } |j du r|rt |j fz } | J| j ||| d| d z || « « | j || j# |j « < n | j ||| d| d z |« « |j j$ || < n | H| j ||d
|
| d || « « | j || j# |j « < nÖ| j ||d
|
| d |« « n·|j t& ur«|s©| d | d } |j( r|j | « n"|j | « |j |« | D| j ||||| « « | j || j# |j « < n| j ||||« « nú|rY| d } |j( r|j | « n"|j | « |j |« | j d| d« t |j fz } | }| j d ||||| « z « | j d« | j d ||| dz |z d z || « z « | j || j# |j « < nR| j d ||||« z « | j d« | j d ||| dz |z d z |« z « |j j$ || < n|j( r|j |« n"|j |« |j |« | C| j ||||| « « | j || j# |j « < n| j ||||« « |j du sÃ|j* | |j* ||< â| æ| j, sô| j, ||< |rxt. |d< | j d« |D ]Y }d|j z } d|j z }| j d| d| d|j d « |j || < |||< [ |r| j d« |r5|r|r dt0 d} nd t0 d } n
|
d t0 d } | j | « |r-d j3 d! | D « « }!| j d"|! d « d#j3 |« }d#j3 |« }|rV||rd#nd d$d#j3 |« z }d#j3 d% |D « D "cg c] }"|" d&|" c}"« }#||rd#ndz }||#z }|r |r d'| d | d(< d)}$d*| d| d+| r|$j3 | « nd, d-||fS c c}"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)r Nr Ú FrA r z 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__()rb z', None)rr z '] = Noner z = Noner c 3 óT K | ] }|j sd |j " yw)r N)r; r r¸ s r! r³ z(_attrs_to_init_script.<locals>.<genexpr>E s! è ø ÒB¨Q¸1¿6»6% §¡xÔ(ÑBùs ((z BaseException.__init__(self, r¦ z*, c 3 óD K | ] }|j d « d yw)ú=r N)Úsplit)r± Úkwas r! r³ z(_attrs_to_init_script.<locals>.<genexpr>R s è ø Ò#N¸# C§I¡I¨c£N°1Õ$5Ñ#Nùs r zself.__attrs_pre_init__(r z
|
zdef z):
|
ÚpassrÙ )r rx rÜ r7 r rC r rË rD rJ r6 rI Ú
|
takes_selfr< rf r; Ú_INIT_FACTORY_PATÚ_get_global_namerP r r> r3 Ú_first_param_typer rY rº )%r{ r r Ú call_pre_initr[ Úcall_post_initÚdoes_cache_hashr rö r_ r^ Ú method_namerÞ Ú extra_linesrs ru rò Ú pre_init_argsÚ kw_only_argsÚattrs_to_validateÚnames_for_globalsr r rw rd Úarg_nameÚ has_factoryÚ
|
maybe_selfr< Úinit_factory_nameÚargÚval_nameÚinit_hash_cacheÚvalsÚ kw_arg_nameÚpre_init_kw_only_argsÚNLs% r! rX rX _ sh ñ( .;Ð (Ñ )ÀEáØ ð 3ô
|
ô :LØ:}ó:Ñ6KÐ 6ð
|
LLÔ à DØMØLØÐð ÐØTÐ"Kà ó XDØ ;;Ø × $Ñ $ QÔ 'àFF Ø ¨TÐ1ò
|
Ø LL¤§ ¡ Ð -Ò DÐ2Dð ð
|
77ä §¡¬GÓ4 Ù *¨q¯y©y×/CÒ/CVÈ
|
à ;;Ð "¬:°a·k±kÄ9Ô+MÜ! !§+¡+Ó.Ià Ià 66U?ÙÜ$5¸¿¹¸ Ñ$AÐ!Ø Ð(ØLLÙ1Ø %Ø -°!°J°<¸qÐ0AÑ AØ *Ø %ó ôð "×+Ñ+ð & i×&@Ñ&@ÀÇÁÓ&HÒIð LLÙ"Ø %Ø -°!°J°<¸qÐ0AÑ AØ *óôð 89·y±y×7HÑ7HÐ!Ð"3Ó4ØÐ&Ø Ù-Ø!Ø% i [°
|
Ð;Ø&Ø!ó ôð ×'Ñ'ð " )×"<Ñ"<¸Q¿V¹VÓ"DÓEð Ù Ø!Ø% i [°
|
Ð;Ø&óöð YYgÑ %©kØ Jl¨9¨+°ZÐ@CØyyØ ×#Ñ# CÕ(à CÔ Ø ×$Ñ$ XÔ.àÐ$Ø Ù-Ø! 8¨^¸Yóôð ×'Ñ'ð " )×"<Ñ"<¸Q¿V¹VÓ"DÓEð Z¨ °8¸^Ó LÖMâ Ø JhÐ'CØyyØ ×#Ñ# CÕ(à CÔ Ø ×$Ñ$ XÔ.Ø LL3xjÐ(8Ð9Ô :ä 1°Q·V±V°IÑ =Ð ØÐ$Ø ØÙ/Ø! 8¨^¸Yóñôð WÔ%Ø ØÙ/Ø!Ø)¨CÑ/°*Ñ<¸sÑBØ&Ø!ó ñôð ×'Ñ'ð " )×"<Ñ"<¸Q¿V¹VÓ"DÒEð ØZ¨ °8¸^Ó LÑLôð WÔ%Ø ØÙ Ø!Ø)¨CÑ/°*Ñ<¸sÑBØ&óñôð 45·9±9×3DÑ3DÐ Ð /Ò 0àyyØ ×#Ñ# HÕ-à HÔ%Ø ×$Ñ$ XÔ.àÐ$Ø Ù-Ø! 8¨^¸Yóôð ×'Ñ'ð " )×"<Ñ"<¸Q¿V¹VÓ"DÒEð Z¨ °8¸^Ó LÔMà 66T>ØvvÐ! iÐ&7Ø()¯© HÓ%ØÒ&¨9×+FÔ+Fà(1×(CÑ(C HÓ%ðqXDñt Ü'.Ð)Ñ$Ø Ð:Ô;Ø"ò -AØ*¨Q¯V©VÑ3HØ! A§F¡FÑ*IØ LL4 z¨°° ¸7À1Ç6Á6À(È!ÐLÔ MØ*+¯+©+Ð hÑ 'Ø+,Ð iÒ (ð -ñ Ø Ð1Ô2ñ Ù ÙØ$.Ô/@Ð.AÀÐ"Jà$0Ô1BÐ0CÀ9Ð"Mà %Ô&7Ð%8¸Ð @OØ _Ô%ñ ØxxÑB°%ÔBÓBà Ð4°T°F¸!Ð<Ô=à 99T?DØIImÓ,MÙà 44 RÐ(¨¨D¯I©I°lÓ,CÐ+DÐEÑEØ $§ ¡ ñ $OÀ Ô#Nö ð ð -q Ò.ò ó!
|
Ð ð ¡ °BÑ6 ØÐ.Ñ. áÑ*à-¨m¨_¸AÐ>að
|
Bà W T Fð +Ù RWWU^ &Ð)ð *ð ð Øð ð ùò s Ú [1c ó$ | j d« S )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.
|
r7 )Úlstripr s r! rÄ rÄ g s ð ;;sÓ Ðr# c ón e Zd ZdZdZ d dZd Ze d d d« Zd Z d Z
|
d Z d
|
Z y)r¼ a²
|
*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 <custom-comparison>`.
|
|
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 <transform-fields>` 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`.
|
)r r6 r7 r8 r? r@ rA rB r: r; r= r3 r< r> r rC rD Nc óÞ t ||xs | |xs |d« \ } }}}t j | « } |d|« |d|« |d|« |d|« |d| « |d|« |d|« |d |« |d
|
|« |d |« |d | « |d | r t j t | « « nt « |d|
|
« |d| « |d|« |d|« |d|« y )NTr r6 r7 r8 r? r@ rA rB r: r; r< r= r3 r> r rC rD )rE r rà ÚtypesÚMappingProxyTyper Ú_EMPTY_METADATA_SINGLETON)r r r6 r7 r8 r9 r: r; r r= r3 r< r> r? r@ rA rB rC rD Ú bound_setattrs r! r1 zAttribute.__init__³ s ô* (BØ 2yÒ 1¨E°4ó(
|
Ñ$FE9ô
|
%×,Ñ,¨TÓ2 ñ fdÔ#Ùi Ô)Ùk 9Ô-ÙfdÔ#ÙdBÔ Ùh Ô'ÙguÔ%Ùk 9Ô-ÙfdÔ#ÙfdÔ#Ùk 9Ô-ÙØ ñ ô ×&Ñ&¤t¨H£~Ô6ä.ô
|
ñ fdÔ#Ùi Ô)Ùk 9Ô-Ùl JÔ/ÙguÕ%r# c ó t r/ )r rê s r! ré zAttribute.__setattr__ê s Ü!Ð!r# c óÀ | |j }n |j d| d}t |« | ||j |j |j d |j
|
|j d|j ||j |j |n |j |j |j |j |j |j |j « S )Nz>Type annotation and type argument cannot both be present for 'z'.F)r3 rG Ú_defaultÚ
|
_validatorr8 r: r; r= r< r> r? r@ rA rB rC rD )r r rÐ r> r3 rQ s r! r½ z Attribute.from_counting_attrí s½ ð <Ø77DØ WWÐ ØRÐSWÐRXÐXZÐ[CÜ S/Ð !ÙØ Ø KKØ MMØ GGØ Ø GGØ GGØ Ø KKØ Ø LLØzzÐ)G¨r¯z©zØ EEØ IIØ HHØ LLØ MMØ HHó%
|
ð
|
r# c ón t j | « }|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 ró Únews r! r zAttribute.evolve
|
s( ô iioà gmmoÔ&à
|
r# c ó@ t fd j D « « S )ú(
|
Play nice with pickle.
|
c 3 ój K | ]* }|d k7 r t |« nt j « , yw)r= N)r r r= ©r± r r s r! r³ z)Attribute.__getstate__.<locals>.<genexpr>%
|
s5 øè ø ò
|
àð $(¨:Ò#5GD$Ô ¼4ÀÇ Á Ó;NÓ Nñ
|
ùs 03©rL rQ r s `r! r zAttribute.__getstate__!
|
s# ø ô ó
|
à ô
|
ó
|
ð
|
r# c óN | j t | j |« « y©r¬ N)r© r rQ ©r r s r! r zAttribute.__setstate__*
|
s ð s4>>¨5Ó1Õ2r# c óº t j | « }|D ]A \ }}|dk7 r
|
|||« |||r t j t |« « nt
|
« C y )Nr= )r rà r r r r¡ )r Úname_values_pairsr¢ r rë s r! r© zAttribute._setattrs0
|
s^ Ü$×,Ñ,¨TÓ2 Ø,ò KD%ØzÒ!Ù d EÕ*á Øñ !ô ×.Ñ.¬t°E«{Ô;ä 6õ ñ r# )
|
NNNFNNNNNNr/ )r r rÐ rO r> r ) r& r' r( r) rQ r1 ré r] r½ r r r r© r r# r! r¼ r¼ r s~ ñ(ðXIð< Ø ØØØ ØØØØØó'5&òn"ð à?Cð
|
Øð
|
Ø )ð
|
Ø48ò
|
ó ð
|
òBò$
|
ò3ó r# r¼ r= ) r r6 r7 r8 r9 r? rA r: r; r rD )r{ r c ó| e Zd ZdZdZg ed dD « « ¢ eddddddddddddddd¬ « Zd
|
Zd Z d Z
|
d Z y)rO 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.
|
)r¥ r¦ rD r< r© r? r@ r: r; r> r= rC rA rB r8 r3 c # ój K | ]+ }t |t |« t d dd ddddd dd dd ¬« - y w)NTF©r rD r6 r7 r8 r9 r: r; r> r? r@ rA rB r rC )r¼ rÄ r )r± r s r! r³ z_CountingAttr.<genexpr>v
|
sV è ø ò
|
ð$ ô# ØÜ-¨dÓ3Ü Ø ØØØØØ ØØØØ Ø Ø ÷ ð ñ
|
ùs 13) r© r¥ r8 r? rA r: r; rC rD r= NTFr· r c ó2 t xj dz c_ t j | _ || _ || _ || _ || _ | | _ | | _ | | _ || _
|
|| _ || _ || _ | | _ |
|
| _ || _ || _ y rµ )rO Ú cls_counterr© r¥ r¦ r< r8 r? r@ rA rB r: r; r= r3 r> rC rD )r r6 r7 r8 r9 r: r; r< r= r3 r> r? r@ rA rB rC rD s r! r1 z_CountingAttr.__init__¨
|
s ô& ×!Ò! QÑ&Õ!Ü$×0Ñ0 Ø Ø#Ø"Ø ØØ Ø
|
Ø"Ø Ø Ø Ø Ø Ø$Ø
|
r# c óf | j || _ |S t | j |« | _ |S )z
|
Decorator that adds *meth* to the list of validators.
|
|
Returns *meth* unchanged.
|
|
.. versionadded:: 17.1.0
|
)r¦ rN ©r r¾ s r! r7 z_CountingAttr.validatorÍ
|
s5 ð ??Ð "Ø "DOð ô # 4§?¡?°DÓ 9DOØ r# c óZ | j t urt t |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)r )r¥ r r rI r» s r! r6 z_CountingAttr.defaultÛ
|
s) ð ==¤Ñ 'Ü(Ð (ä °Ô6 à r# ) r& r' r( r) rQ rL r¼ r r¹ r1 r7 r6 r r# r! rO rO Z
|
s
ñðIð$0Ù ñ
|
ð$
|
ô%
|
ó
|
|
ð0ñ> ØØ ØØØØØØØØØØØØØô
|
ñ?0Oðb Kò#òJ ó r# rO c ó~ e Zd ZdZ G d dej
|
« Z G d dej
|
« ZdZd Z e
|
d « Z y )
|
r¾ a¥
|
Effective class properties as derived from parameters to `attr.s()` or
|
`define()` decorators.
|
|
This is the same data structure that *attrs* uses internally to decide how
|
to construct the final class.
|
|
Warning:
|
|
This feature is currently **experimental** and is not covered by our
|
strict backwards-compatibility guarantees.
|
|
|
Attributes:
|
is_exception (bool):
|
Whether the class is treated as an exception class.
|
|
is_slotted (bool):
|
Whether the class is `slotted <slotted classes>`.
|
|
has_weakref_slot (bool):
|
Whether the class has a slot for weak references.
|
|
is_frozen (bool):
|
Whether the class is frozen.
|
|
kw_only (KeywordOnly):
|
Whether / how the class enforces keyword-only arguments on the
|
``__init__`` method.
|
|
collected_fields_by_mro (bool):
|
Whether the class fields were collected by method resolution order.
|
That is, correctly but unlike `dataclasses`.
|
|
added_init (bool):
|
Whether the class has an *attrs*-generated ``__init__`` method.
|
|
added_repr (bool):
|
Whether the class has an *attrs*-generated ``__repr__`` method.
|
|
added_eq (bool):
|
Whether the class has *attrs*-generated equality methods.
|
|
added_ordering (bool):
|
Whether the class has *attrs*-generated ordering methods.
|
|
hashability (Hashability): How `hashable <hashing>` the class is.
|
|
added_match_args (bool):
|
Whether the class supports positional `match <match>` over its
|
fields.
|
|
added_str (bool):
|
Whether the class has an *attrs*-generated ``__str__`` method.
|
|
added_pickling (bool):
|
Whether the class has *attrs*-generated ``__getstate__`` and
|
``__setstate__`` methods for `pickle`.
|
|
on_setattr_hook (Callable[[Any, Attribute[Any], Any], Any] | None):
|
The class's ``__setattr__`` hook.
|
|
field_transformer (Callable[[Attribute[Any]], Attribute[Any]] | None):
|
The class's `field transformers <transform-fields>`.
|
|
.. versionadded:: 25.4.0
|
c ó& e Zd ZdZdZ dZ dZ dZy)úClassProps.HashabilityzO
|
The hashability of a class.
|
|
.. versionadded:: 25.4.0
|
ÚhashableÚhashable_cacheÚ
|
unhashableÚ leave_aloneN)r& r' r( r) rò r ró rñ r r# r! r r¿ 6 s) ñ ð Ø#Ø*Ø6Ø!
|
Ø+Ø# Ø'r# r c ó e Zd ZdZdZ dZ dZy)úClassProps.KeywordOnlyzw
|
How attributes should be treated regarding keyword-only parameters.
|
|
.. versionadded:: 25.4.0
|
rÏ ÚyesÚforceN)r& r' r( r) rÀ rô rÁ r r# r! r¿ rÅ F s! ñ ð Ø.ØØQØØ.r# r¿ ©r r r r r> r rè rê rë rì r rí rî r% r! rÈ c óä || _ || _ || _ || _ || _ || _ || _ || _ | | _ |
|
| _ | | _
|
| | _ | | _ || _ || _ || _ y r/ rÈ )r r r r r r> r rè rê rë rì r rí rî r% r! rÈ s r! r1 zClassProps.__init__g s} ð& )ÔØ$Ø 0Ô Ø"Ø Ø'>Ô$Ø$Ø$Ø Ø ,ÔØ&ÔØ 0Ô Ø"Ø ,ÔØ .Ô Ø!2Õ r# c ó | j t j j u xs& | j t j j u S r/ )r r¾ r rò r r s r! rõ zClassProps.is_hashable sC ð × Ñ ¤
|
× 6Ñ 6× ?Ñ ?Ð ?ò JØ× Ñ ¤:×#9Ñ#9×#IÑ#IÐIð
|
r# N) r& r' r( r) r* ÚEnumr r¿ rQ r1 rr rõ r r# r! r¾ r¾ ñ
|
sJ ñBôH(diiô (ô /diiô /ð Iò&"3ðH ñ
|
ó ñ
|
r# r¾ c ó( e Zd ZdZdZddZd Zd Zy)rI 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*
|
©rP r c ó || _ || _ y r/ rÍ )r rP r s r! r1 zFactory.__init__¼ s Ø Ø$r# c ó@ t fd j D « « S )r¬ c 3 ó6 K | ] }t |« y wr/ r r® s r! r³ z'Factory.__getstate__.<locals>.<genexpr>Ä s øè ø ÒD¨TWT 4×(ÑDùs r¯ r s `r! r zFactory.__getstate__À s ø ô ÓD°T·^±^ÔDÓDÐDr# c óZ t | j |« D ] \ }}t | ||« yr± )r rQ rL )r r r rë s r! r zFactory.__setstate__Æ s. ô t~~¨uÓ5ò 'KD%Ü D$ Õ &ñ 'r# N)F)r& r' r( r) rQ r1 r r r r# r! rI rI § s ñð$ *Ió%òEó 'r# rI )
|
r r6 r7 r8 r9 r? rA r: r; r c óH e Zd ZdZdZddddZed d« Zd dZd Z d Z
|
y
|
) rf ae
|
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_namer< Ú takes_fieldr F©r rÕ c ó® | _ | _ | _ t |« }|j « _ j s j s fd _ nP j r j s fd _ n- j s j r fd _ n
|
fd _ |j « }|| j j d< y y )Nc ó& j | « S r/ ©r< )rë r7 Ú__r s r! r¬ z$Converter.__init__.<locals>.<lambda> s ø °· ± ÀÓ1F r# c ó( j | |« S r/ rÙ )rë ÚinstancerÚ r s r! r¬ z$Converter.__init__.<locals>.<lambda>
|
s ø ¸¿¹Øxó9 r# c ó( j | |« S r/ rÙ )rë rÚ r r s r! r¬ z$Converter.__init__.<locals>.<lambda> s ø °T·^±^Øuó6 r# c ó* j | ||« S r/ rÙ )rë rÜ r r s r! r¬ z$Converter.__init__.<locals>.<lambda> s ø ¸4¿>¹>Øx ó< r# r ) r< r rÕ r Úget_first_param_typer rÓ Úget_return_typer )r r< r rÕ ÚexÚrts ` r! r1 zConverter.__init__ÿ s³ ø Ø"Ø$Ø&Ôä ! )Ó ,Ø!#×!8Ñ!8Ó!:Ô à 4×#3Ò#3Û FDMØ __ T×%5Ò%5ó DMð T×%5Ò%5ó DMó DMð × Ñ Ó !Ø >Ø68DMM× )Ñ )¨(Ò 3ð r# c ó d| S )zh
|
Return the name that a converter for an attribute name *attr_name*
|
would have.
|
Ú__attr_converter_r )rw s r! r
zConverter._get_global_name s ð # 9 +Ð.Ð.r# c ó> | j s#| j s| j |« d| dS | j r&| j r| j |« d| d| dS | j r| 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`.
|
rA r z, self, attr_dict['z'])z, self)z , attr_dict[')r rÕ r
)r rw rc s r! rh z Converter._fmt_converter_call" s¶ ð 4×#3Ò#3Ø×+Ñ+¨IÓ6Ð7°q¸¸ À1ÐEÐ Eà ??t× /Ò /Ø×+Ñ+¨IÓ6Ð7°q¸¸ ÐCVÐW`ÐVaÐadÐeÐ eà ??Ø×+Ñ+¨IÓ6Ð7°q¸¸ À7ÐKÐ Kà×'Ñ'¨ Ó2Ð3°1°Y°K¸}ÈYÈKÐWZÐ[Ð[r# c óJ | j | j | j dS )zx
|
Return a dict containing only converter and takes_self -- the rest gets
|
computed when loading.
|
©r< r rÕ rç r s r! r zConverter.__getstate__3 s% ð Ø //Ø ×+Ñ+ñ
|
ð
|
r# c ó( | j di |¤ y)z+
|
Load instance from state.
|
Nr ré r² s r! r zConverter.__setstate__> s ð Ñ Ó r# N)rw r r r )rw r rc r r r ) r& r' r( r) rQ r1 r^ r
rh r r r r# r! rf rf á s> ñð(Ið 16À5ô 9ð6 ò/ó ð/ó\ò"
|
ó r# rç c óà t j d| « } t |t « r|}n<t |t t
|
f« r|D ci c] }|t « }}n d}t |« |j dd« }|j dd« } |j dd« }
|
i |j |« ||d< | | d< |
|
|
|
d< t j | |i fd« } t j t t « 5 t! j" d« j$ j' d d
|
« | _ ddd« |j d d« } t+ | |j' d « |j' d « d« \ |d < |d < t- dd|i|¤| « } |j/ « D ci c] \ }}|j0 ||j0 ! c}}| _ | S c c}w # 1 sw Y ªxY wc c}}w )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.r Nr r1 c ó& | j « S r/ )r5 )rz rv s r! r¬ z make_class.<locals>.<lambda>¢ s ø ¸¿ ¹ À$» r# r
|
r& Ú__main__r9 r? rA TrÅ r )Ú unicodedataÚ normalizerJ r rK rL rR rF Úpopr5 r Ú new_classrH rI rJ rG rS Ú _getframeÚ f_globalsr¨ r' rÙ rú r¹ r3 r )r r{ ÚbasesÚ
|
class_bodyÚattributes_argumentsrw r rQ rZ r\ Ú user_initÚtype_r9 r rb rc rv s @r! Ú
|
make_classrø Z só ø ô` × Ñ ¨Ó .Dä%Ô ØÜ ED¤%=Ô )Ø).Ö/ AAvxKÐ/Ñ/à8ÜnÐ à||Ð 0°$Ó7HØ Ð 2°DÓ9IØ Z¨Ó.Ià DØÐ Ø JÔ ØÐØ%-Ð !Ñ"ØÐ Ø&/Ð "Ñ#ØÐ Ø$ZÑä OOD %¨Ó-GÓ HEô
|
× Ñ ^¬ZÓ 8ñ
|
Ü ==¨Ó+×5Ñ5×9Ñ9Ø
|
ó
|
Ô÷
|
ð ×
|
"Ñ
|
" 5¨$Ó
|
/Cô "Ø Ø × Ñ Ó&Ø × Ñ Ó)Ø ó ñØ TÑ"Ø WÑ%ð 9&Ñ
|
8xÐ
|
8Ð#7Ñ
|
8¸Ó
|
?Cð 'nnÓ .÷Ùa°!·&±&Ñ2D166 óCÔð Jùò_ 0÷2
|
ð
|
üó&s ÁGÄ 5G Æ*G*Æ?G*Ç G')r r c ó$ e Zd ZdZ e« Zd Zy)Ú _AndValidatorz2
|
Compose many validators to a single one.
|
c ó: | j D ] } ||||« y r/ )Ú _validators)r rô r² rë rc s r! rÓ z_AndValidator.__call__Í s# Ø×!Ñ!ò !AÙ dD%Õ ñ !r# N)r& r' r( r) rR rü rÓ r r# r! rú rú Å s ññ (Kó!r# rú c ó g }| D ]0 }|j t |t « r |j n|g« 2 t t |« « 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
|
)rÜ rJ rú rü rL )Ú
|
validatorsr r7 s r! rN rN Ò sO ð DØ ò
|
Ø ä)¤]Ô3ð × !Ò !àõ
|
ð
|
ô tÓ %Ð%r# c óº t d D « « }|r fd}n fd} s*t d« }|j j ||d« n~t d « j « }|r||j d< d }t s t |t « r |j }t |« j « }|r||j d < |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
|
c 3 ó< K | ] }t |t « y wr/ ©rJ rf )r± Úcs r! r³ zpipe.<locals>.<genexpr>ù s è ø ÒG°q* Q¬ ×2ÑGùs c óZ D ]$ }t |t « r
|
|| ||« n || « } & | S r/ r )rÈ rô r r Ú
|
converterss r! Úpipe_converterz pipe.<locals>.pipe_converterý s9 ø Ø ò ä+5°a¼Ô+CAc4 Ô'ÉÈ3Ëñ ð ð
|
Jr# c ó& D ]
|
} || « } | S r/ r )rÈ r r s r! r z pipe.<locals>.pipe_converter s" ø Ø ò Ùfð ð Jr# ÚA)rÈ r r rÈ r^ r TrÖ ) r× r r r5 r rß r rJ rf rÓ rà )r Úreturn_instancer r ÚtÚlastrâ s ` r! rM rM é sÓ ø ô ÑG¸JÔGÓGOáõ ô ñ ä CLØ×&Ñ&×-Ñ-°aÀ1Ñ.EÕFô ! ¨A¡ Ó /× DÑ DÓ FÙ Ø45N× *Ñ *¨5Ñ 1à"~ݤ
|
¨4´Ô ;Ø==Dô " $Ó '× 7Ñ 7Ó 9Ù Ø79N× *Ñ *¨8Ñ 4áÜ °DÀdÔKÐKØ Ðr# )Nrz )
|
rW r rX údict[str, Any] | NonerY úMapping[str, object] | NonerZ r r r r/ )
|
rW r rZ r rX r rf r r zdict[str, Any])rs r rt z list[str]r r3 )r z'tuple[list[Attribute], dict[str, type]])r rz )T)NNNNNNNFFTFFFFFNNFFNNNTNT)r r3 r r r r )
|
r r3 r{ r| r r r r r útuple[str, dict])r r3 r{ r| )r{ rK r r )r r )NN)r útuple[str, dict, dict]rv rw )rw r rë r rd r r r )r r r r r r~ )r{ r| r r r r r r r[ r r r r r r r~ rö r r_ r r^ r r r r r )r r r r )nÚ
|
__future__r rB rH r¨ r* r rZ rc rS r rí r> Úcollections.abcr r Ú functoolsr Útypingr r r rz r r r r r r r r r Ú
|
exceptionsr r r r Úobjectré r r r rY r r¡ rG rM r$ r# r" rË r r Úintr- rR r\ rk rx rz r r r¢ r¤ rÔ rá rì rï r r÷ rÙ rE rã r{ rú rï rÝ r r' r¹ rº rà r= ry rJ rñ rP rU r¥ re rj rl rn rx rX rÄ r¼ rQ Ú_ar r: rO r¾ Ú_casrI Ú_frf rø rú rN )r r s 00r! ú<module>r s ðõ #ã
|
Û Û Û Û Û Û Û
|
Û Û Û ç -Ý %ß +Ñ +÷ (Ñ '÷÷ ÷ó ð ×!Ñ! Ø'Ð ðÐ ð )Ð à 2E× 2Ñ 2°2Ó 6Ð ñ H à"gll 7§?¡?°G×4DÑ4DÓEÐ ôtyyô ð( ×
|
Ñ
|
ðô (ô (ð" ØØ Ø Ø Ø Ø Ø ØØ Ø Ø Ø
|
ØØ
|
ó kðb )-Øð Ø ð à ð ð &ð ð ð ð
|
|
ó ð$ +/ð Ø ð àð ð !ð ð (ð ð
|
ó óF1ô.$*ô $ò 0ò"'ð #à,ó #òB%ð8uEð óuEòp1òh ò" ò7÷tF ñ F òRò8((ðX .2óð6 Ø
|
Ø Ø Ø Ø Ø Ø
|
Ø ØØ ØØ ØØ Ø Ø
|
ØØØØØØØØó3BðJ
|
ðò /óðEØ ðEØ%ðEØ/3ðEØAEðEàóEóP ò ó"òJ5*ópó"6#ór ò +ò\&ò:.ò$/ðB&ð óB&óJ3ð]Øð]Ø "ð]Ø48ð]ØENð]àó]ó)ð
|
WØð
|
WØ "ð
|
WØ48ð
|
WØENð
|
Wàó
|
Wð,/Ø ð,/Ø ð,/Ø.=ó,/ð^EØ ðEàðEð ðEð ð Eð
|
ð Eð ð Eð ðEð #ðEð ðEð ðEð ðEð ðEð óEóP ÷Kñ Kðx ×#Ñ#ö ð ñ Ø ØØØ Ø Ø ØØjÑ Ø ØÙ% dÓ+ö òñ" Ù Ù) 2Ô&Ø Ö6Q §¡¨+Ó 5qÒ6ôð Ö
|
=AFF q§v¡v°Ó'<1Ò
|
=ô ÷Qñ Qñh -Ó0Ó1 ÷_
|
ñ _
|
ð` ×$Ñ$ö ð ñ Ø ØØØ Ø Ø ØØ Ø ØÙ% dÓ+ö òñ" Yz°Ô6¸dÔ C
|
÷$'ñ $'ðh ×!Ñ!öð ñ Ø ØØØ Ø Ø ØØ Ø Øö òñ GI g°RÔ 8ÀÔCÈ2Ô
|
N÷a ñ a ðb ;öð ñ Ø ØØØ Ø Ø ØØ Ø Øö òñ Ù Ii rÔ *°"Ô5¸Rô ð y¨TódñV TtÔ$÷ !ð !ó %ð !ò&ó.9ùòSùò( 7ùâ
|
=ùòz ùòvùòns6 È0#OÉ'OÉ<OÊ O
|
Ê O
|
Ê-O
|
Ë) O$Ì6O)Í:O.
|
