o yAf;@sdZddlmZddlmZddlmZddlmZ ddl m Z m Z m Z mZmZddlmZ dd d d d d d d d d d d d d d d d d d d d d d dZeZeed d dZe d d d d d d d d d d d d d dddZd d d dddZd d dddZd S)z] These are keyword-only APIs that call `attr.s` and `attr.ib` with different default values. )partial)setters)asdict)astuple)NOTHING_frozen_setattrs_ng_default_on_setattrattribattrs)UnannotatedAttributeErrorNTF)theserepr unsafe_hashhashinitslotsfrozen weakref_slotstr auto_attribskw_only cache_hashauto_exceqorder auto_detectgetstate_setstate on_setattrfield_transformer match_argscsV fdd fdd}|dur'|S||S)a Define an *attrs* class. Differences to the classic `attr.s` that it uses underneath: - Automatically detect whether or not *auto_attribs* should be `True` (c.f. *auto_attribs* parameter). - Converters and validators run when attributes are set by default -- if *frozen* is `False`. - *slots=True* .. caution:: Usually this has only upsides and few visible effects in everyday programming. But it *can* lead to some surprising behaviors, so please make sure to read :term:`slotted classes`. - *auto_exc=True* - *auto_detect=True* - *order=False* - Some options that were only relevant on Python 2 or were kept around for backwards-compatibility have been removed. Please note that these are all defaults and you can change them as you wish. :param Optional[bool] auto_attribs: If set to `True` or `False`, it behaves exactly like `attr.s`. If left `None`, `attr.s` will try to guess: 1. If any attributes are annotated and no unannotated `attrs.fields`\ s are found, it assumes *auto_attribs=True*. 2. Otherwise it assumes *auto_attribs=False* and tries to collect `attrs.fields`\ s. For now, please refer to `attr.s` for the rest of the parameters. .. versionadded:: 20.1.0 .. versionchanged:: 21.3.0 Converters are also run ``on_setattr``. .. versionadded:: 22.2.0 *unsafe_hash* as an alias for *hash* (for :pep:`681` compliance). cstdid|dd dddddd d d |d d ddd ddddd dd S)N maybe_clsr rrrrrrrrrrrrrrrZcollect_by_mroTrrrr )r )clsr)rrrrrrrrrrr rrrrrr rrr"3/usr/lib/python3.10/site-packages/attr/_next_gen.pydo_itYsZ     zdefine..do_itcsdtjfv}durdurt|jD]}|jtur(|r#d}t|tjnqdur2|Sz|dWStyF|dYSw)z Making this a wrapper ensures this code runs during class creation. We also ensure that frozen-ness of classes is inherited. NFz@Frozen classes can't use on_setattr (frozen-ness was inherited).T)rZNO_OPr __bases__ __setattr__r ValueErrorr )r#Zhad_on_setattrZbase_clsmsg)rr%rrr"r$wrapss$     zdefine..wrapNr")r!r rrrrrrrrrrrrrrrrrrr r*r")rrrrr%rrrrrrrr rrrrrr rrr$defines 0A#r+)rrdefault validatorrrrmetadatatype converterfactoryrrrraliascCs$t|||||||||| | | | | dS)a Identical to `attr.ib`, except keyword-only and with some arguments removed. .. versionadded:: 23.1.0 The *type* parameter has been re-added; mostly for `attrs.make_class`. Please note that type checkers ignore this metadata. .. versionadded:: 20.1.0 r,)r r,r"r"r$fields r4)recursefiltervalue_serializercCst||||ddS)z Same as `attr.asdict`, except that collections types are always retained and dict is always used as *dict_factory*. .. versionadded:: 21.3.0 T)instr5r6r7retain_collection_types)_asdict)r8r5r6r7r"r"r$rsr)r5r6cCst|||ddS)z Same as `attr.astuple`, except that collections types are always retained and `tuple` is always used as the *tuple_factory*. .. versionadded:: 21.3.0 T)r8r5r6r9)_astuple)r8r5r6r"r"r$rsr)N)__doc__ functoolsrrZ_funcsrr:rr;_makerrr r r exceptionsr r+Zmutablerr4r"r"r"r$sd       ,