U
|
L ±dZA ã @ s d dl Z ddlmZmZ ddlmZmZmZ ddlm Z dde
|
ddfdd Z d
|
d Z dde dfd d Zdd Zdd Zdd ZdddZdS )é Né )Ú PY_3_9_PLUSÚget_generic_base)ÚNOTHINGÚ _obj_setattrÚfields)ÚAttrsAttributeNotFoundErrorTFc s t | j} }|D ]ü}t| |j} dk r8|| s8qdk rL| || } |dkrt| jr|t| dd||j< nt| ttt t
|
frÄdkr| jnt}
|
|
|
fdd| D ||j< n@t| t rú fdd| ¡ D ||j< n
|
| ||j< q| ||j< q|S )a]
|
Return the *attrs* attribute values of *inst* as a dict.
|
|
Optionally recurse into other *attrs*-decorated classes.
|
|
:param inst: Instance of an *attrs*-decorated class.
|
:param bool recurse: Recurse into classes that are also
|
*attrs*-decorated.
|
:param callable filter: A callable whose return code determines whether an
|
attribute or element is included (``True``) or dropped (``False``). Is
|
called with the `attrs.Attribute` as the first argument and the
|
value as the second argument.
|
:param callable dict_factory: A callable to produce dictionaries from. For
|
example, to produce ordered dictionaries instead of normal Python
|
dictionaries, pass in ``collections.OrderedDict``.
|
:param bool retain_collection_types: Do not convert to ``list`` when
|
encountering an attribute whose type is ``tuple`` or ``set``. Only
|
meaningful if ``recurse`` is ``True``.
|
:param Optional[callable] value_serializer: A hook that is called for every
|
attribute or dict key/value. It receives the current instance, field
|
and value and must return the (updated) value. The hook is run *after*
|
the optional *filter* has been applied.
|
|
:rtype: return type of *dict_factory*
|
|
:raise attrs.exceptions.NotAnAttrsClassError: If *cls* is not an *attrs*
|
class.
|
|
.. versionadded:: 16.0.0 *dict_factory*
|
.. versionadded:: 16.1.0 *retain_collection_types*
|
.. versionadded:: 20.3.0 *value_serializer*
|
.. versionadded:: 21.3.0 If a dict has a collection for a key, it is
|
serialized as a tuple.
|
NT©ÚrecurseÚfilterÚ dict_factoryÚretain_collection_typesÚvalue_serializerc
|
s g | ]}t |d dqS ©F©Úis_keyr r r r ©Ú_asdict_anything©Ú.0Úi©r r r r © úBd:\z\workplace\vscode\pyvenv\venv\Lib\site-packages\attr/_funcs.pyÚ
|
<listcomp>L s øúzasdict.<locals>.<listcomp>c
|
3 s: | ]2\}}t |d dt |d dfV qdS ©Tr FNr ©r ÚkkÚvv©Údfr r r r r Ú <genexpr>Z s$ ïúú÷zasdict.<locals>.<genexpr>) r Ú __class__ÚgetattrÚnameÚhasÚasdictÚ
|
isinstanceÚtupleÚlistÚsetÚ frozensetÚdictÚitems) Úinstr
|
r r r r ÚattrsÚrvÚaÚvÚcfr ©r r r r r r r& sB *
|
|
|
ú ÷ÿ
|
í r& c s t | jdddk r(t| dd}nt| ttttfrvdkrJ| j}n|rTt}nt}|fdd| D }nHt| tr¦ fdd| ¡ D }n| }dk r¾dd|}|S ) zK
|
``asdict`` only works on attrs instances, this works on anything.
|
Ú__attrs_attrs__NTr c
|
s g | ]}t |d dqS r r r r r r r s øúz$_asdict_anything.<locals>.<listcomp>c
|
3 s: | ]2\}}t |d dt |d dfV qdS r r r r r r r! ¢ s$ ïúú÷z#_asdict_anything.<locals>.<genexpr>)
|
r# r" r& r' r( r) r* r+ r, r- )Úvalr r r r r r0 r3 r r4 r r v s: ú ÷ÿ
|
í
|
r c
|
s t | j}g }||D ]ì}t| |j} dk r: ||s:q|dkrøt|jrf| t|d d¡ nt|tt t
|
t fr¬dkr|jnt } | | fdd|D ¡ nJt|t rìdkrÄ|jnt }
|
| |
|
fdd| ¡ D ¡ n
|
| |¡ q| |¡ qt kr|S |S )a)
|
Return the *attrs* attribute values of *inst* as a tuple.
|
|
Optionally recurse into other *attrs*-decorated classes.
|
|
:param inst: Instance of an *attrs*-decorated class.
|
:param bool recurse: Recurse into classes that are also
|
*attrs*-decorated.
|
:param callable filter: A callable whose return code determines whether an
|
attribute or element is included (``True``) or dropped (``False``). Is
|
called with the `attrs.Attribute` as the first argument and the
|
value as the second argument.
|
:param callable tuple_factory: A callable to produce tuples from. For
|
example, to produce lists instead of tuples.
|
:param bool retain_collection_types: Do not convert to ``list``
|
or ``dict`` when encountering an attribute which type is
|
``tuple``, ``dict`` or ``set``. Only meaningful if ``recurse`` is
|
``True``.
|
|
:rtype: return type of *tuple_factory*
|
|
:raise attrs.exceptions.NotAnAttrsClassError: If *cls* is not an *attrs*
|
class.
|
|
.. versionadded:: 16.2.0
|
NT©r
|
r Ú tuple_factoryr c s, g | ]$}t |jr$t|d dn|qS )Tr7 ©r% r" Úastuple)r Új©r Úretainr8 r r r ö s
|
þùûzastuple.<locals>.<listcomp>c 3 sJ | ]B\}}t |jr"t| d n|t |jr<t| d n|fV qdS ))r8 r Nr9 r )r= r8 r r r! s öûýûýòzastuple.<locals>.<genexpr>)r r" r# r$ r% Úappendr: r' r( r) r* r+ r, r- ) r. r
|
r r8 r r/ r0 r1 r2 r3 r r r< r r: ¿ sJ !
|
|
ûÿ
|
öÿÿ
|
ïÿ r: c C sN t | dd}|dk rdS t| }|dk rJt |dd}|dk rB|| _|dk S dS )z
|
Check whether *cls* is a class with *attrs* attributes.
|
|
:param type cls: Class to introspect.
|
:raise TypeError: If *cls* is not a class.
|
|
:rtype: bool
|
r5 NTF)r# r r5 )Úclsr/ Z generic_baseZ generic_attrsr r r r% # s r% c K s` t | ¡}t| j}| ¡ D ]>\}}t||t}|tkrNt| d|j dt||| q |S )a³
|
Copy *inst* and apply *changes*.
|
|
This is different from `evolve` that applies the changes to the arguments
|
that create the new instance.
|
|
`evolve`'s behavior is preferable, but there are `edge cases`_ where it
|
doesn't work. Therefore `assoc` is deprecated, but will not be removed.
|
|
.. _`edge cases`: https://github.com/python-attrs/attrs/issues/251
|
|
:param inst: Instance of a class with *attrs* attributes.
|
:param changes: Keyword changes in the new copy.
|
|
:return: A copy of inst with *changes* incorporated.
|
|
:raise attrs.exceptions.AttrsAttributeNotFoundError: If *attr_name*
|
couldn't be found on *cls*.
|
:raise attrs.exceptions.NotAnAttrsClassError: If *cls* is not an *attrs*
|
class.
|
|
.. deprecated:: 17.1.0
|
Use `attrs.evolve` instead if you can.
|
This function will not be removed du to the slightly different approach
|
compared to `attrs.evolve`.
|
z is not an attrs attribute on Ú.)Úcopyr r" r- r# r r r )r. ÚchangesÚnewr/ Úkr2 r1 r r r Úassoc; s
|
|
ÿrE c O sÎ | r<z
|
| \}W q t k
|
r8 tdt| ddY qX nFz| d¡}W n tk
|
rh tddY nX ddl}|jdtdd |j}t |}|D ].}|j
|
s q|j }|j }||krt ||||< q|f |S )
|
aõ
|
Create a new instance, based on the first positional argument with
|
*changes* applied.
|
|
:param inst: Instance of a class with *attrs* attributes.
|
:param changes: Keyword changes in the new copy.
|
|
:return: A copy of inst with *changes* incorporated.
|
|
:raise TypeError: If *attr_name* couldn't be found in the class
|
``__init__``.
|
:raise 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.
|
z*evolve() takes 1 positional argument, but z were givenNr. z7evolve() missing 1 required positional argument: 'inst'r zgPassing the instance per keyword argument is deprecated and will stop working in, or after, April 2024.é )Ú
|
stacklevel)Ú
|
ValueErrorÚ TypeErrorÚlenÚpopÚKeyErrorÚwarningsÚwarnÚDeprecationWarningr" r Úinitr$ Úaliasr# ) ÚargsrB r. rM r? r/ r1 Ú attr_nameZ init_namer r r Úevolveb sB
|
ÿý
|
ÿþürT c C s| t | dd| krxddl}||d}tr.||d< |j| f|}|dkrLt| n|D ] }|j|krPt|d||j qP| | _| S )aA
|
Resolve any strings and forward annotations in type annotations.
|
|
This is only required if you need concrete types in `Attribute`'s *type*
|
field. In other words, you don't need to resolve your types if you only
|
use them for static type checking.
|
|
With no arguments, names will be looked up in the module in which the class
|
was created. If this is not what you want, e.g. if the name only exists
|
inside a method, you may pass *globalns* or *localns* to specify other
|
dictionaries in which to look up these names. See the docs of
|
`typing.get_type_hints` for more details.
|
|
:param type cls: Class to resolve.
|
:param Optional[dict] globalns: Dictionary containing global variables.
|
:param Optional[dict] localns: Dictionary containing local variables.
|
:param Optional[list] attribs: List of attribs for the given class.
|
This is necessary when calling from inside a ``field_transformer``
|
since *cls* is not an *attrs* class yet.
|
:param bool include_extras: Resolve more accurately, if possible.
|
Pass ``include_extras`` to ``typing.get_hints``, if supported by the
|
typing module. On supported Python versions (3.9+), this resolves the
|
types more accurately.
|
|
:raise TypeError: If *cls* is not a class.
|
:raise attrs.exceptions.NotAnAttrsClassError: If *cls* is not an *attrs*
|
class and you didn't pass any attribs.
|
:raise NameError: If types cannot be resolved because of missing variables.
|
|
:returns: *cls* so you can use this function also as a class decorator.
|
Please note that you have to apply it **after** `attrs.define`. That
|
means the decorator has to come in the line **before** `attrs.define`.
|
|
.. versionadded:: 20.1.0
|
.. versionadded:: 21.1.0 *attribs*
|
.. versionadded:: 23.1.0 *include_extras*
|
|
Ú__attrs_types_resolved__Nr )ÚglobalnsÚlocalnsÚinclude_extrasÚtype)r# Útypingr Úget_type_hintsr r$ r rU ) r? rV rW ZattribsrX rZ ÚkwargsÚhintsÚfieldr r r Ú resolve_types s +
|
|
r_ )NNNT)rA Ú_compatr r Ú_maker r r Ú
|
exceptionsr r, r& r r( r: r% rE rT r_ r r r r Ú<module> s. ú
|
kKû
|
d'? ÿ
|
