⚝
One Hat Cyber Team
⚝
Your IP:
216.73.216.189
Server IP:
97.74.87.16
Server:
Linux 16.87.74.97.host.secureserver.net 5.14.0-503.38.1.el9_5.x86_64 #1 SMP PREEMPT_DYNAMIC Fri Apr 18 08:52:10 EDT 2025 x86_64
Server Software:
Apache
PHP Version:
8.2.28
Buat File
|
Buat Folder
Eksekusi
Dir :
~
/
var
/
opt
/
nydus
/
ops
/
attr
/
__pycache__
/
View File Name :
_make.cpython-39.pyc
a ���g�y � @ s� d dl mZ d dlZd dlZd dlZd dlZd dlZd dlZd dlZd dl Z d dl Z d dl Z d dl m Z mZ d dlmZ d dlmZmZmZ ddlmZmZmZ ddlmZmZmZm Z m Z m Z dd l m Z m!Z!m"Z"m#Z# e$j%Z&d Z'd Z(d Z)e �*i �Z+e$� Z,e�-ej.ej/�Z0G d d� dej1�Z2e2j3Z3G dd� de4�Z5e3ddddddddddddddfdd�Z6d�dddddd�dd �Z7d�ddddd d �d d �Z8dd!d"d#�d$d%�Z9G d&d'� d'e�Z:d(d)� Z;d*d+� Z<d,d-�d.d/�Z=d0d1� Z>d'd-�d2d3�Z?d4d5� Z@d6d7� ZAd8d9� ZBd:d;� ZCG d<d=� d=�ZDd>d?� ZEd@dA� ZFd�dBdC�ZGd�dDdE�ZHeHZIdFdG� ZJd"dddH�dIdJ�ZKd"dKdLdLdMdN�dOdP�ZLd"dKdQ�dRdS�ZMdTdU� ZNdVdMdW�dXdY�ZOdZd[� ZPd�d\d]�ZQdMd-�d^d_�ZRd�d`da�ZSdbdc� ZTddde� ZUdfdg� Z/dhdi� ZVdjd-�dkdl�ZWdddLddm�dndo�ZXdddLdpddq�drds�ZYdddLddt�dudv�ZZdddLdpddq�dwdx�Z[dLdLdydz�d{d|�Z\dKdLdLdLdLdLdLdydLdLdLddjd}� d~d�Z]ddd��d�d��Z^G d�d�� d��Z_d�d�� e_j`D �ZaeMeQeSe_ead��d�d�� eaD �d��d�d�� eaD �d��Z_G d�d�� d��ZbeQeSeb��ZbG d�d�� d��Zcd�d�� ecj`D �ZdeMeQeSecedd��edd��edd��ZcG d�dp� dp�Zed�d�� d�D �ZdeMeQeSeeedd��edd��edd��Zee$fdfd�d��ZfeHddd��G d�d�� d���Zgd�d�� Zhd�d�� Z-dS )�� )� 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.ClassVarZ_attrs_cached_hashc @ s( e Zd ZdZe�� Zdd� Zdd� ZdS )�_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 C s dS )N�NOTHING� ��selfr r �;/opt/nydus/tmp/pip-target-mke_irhy/lib/python/attr/_make.py�__repr__J s z_Nothing.__repr__c C s dS )NFr r r r r �__bool__M s z_Nothing.__bool__N) �__name__� __module__� __qualname__�__doc__�enum�autor r r r r r r r = s r c @ s" e Zd ZdZed�dfdd�ZdS )�_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 C s ||fS �Nr )r Z_none_constructor�_argsr r r � __reduce__e s z _CacheHashWrapper.__reduce__)r r! r" r# �typer) r r r r r& Y s r& TFc C s� t || | d�\} }} }|dur:|dur:|dur:d}t|��| durr| turVd}t|��t| �sjd}t|��t| �} |du r~i }t| ttf�r�t j | � } |r�t|ttf�r�t |� }|r�t|ttf�r�t |� }t | ||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* 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�metadatar* �kw_only�eq�eq_key�order� order_key� on_setattr�alias) �_determine_attrib_eq_order� TypeErrorr � ValueError�callable�Factory� isinstance�list�tupler �pipe�and_� _CountingAttr)r, r- r. r/ r0 r1 r3 r* r2 �factoryr4 r5 r7 r9 r: r6 r8 �msgr r r �attribi sR 7� � �rH � �strzdict[str, Any] | NonezMapping[str, object] | None�None)�script�globs�locs�filename�returnc C s t | |d�}t|||� dS )z[ Evaluate the script with the given global (globs) and local (locs) variables. �execN)�compile�eval)rL rM rN rO �bytecoder r r �_compile_and_eval� s rU zdict[str, Any])rL rO rM �localsrP c C sz |du r i n|}d}|}t | �d| �d�|f}tj�||�}||krFqh|dd� � d|� d�}|d7 }qt| |||� |S )zP Cache the script with _linecache_, compile it and return the _locals_. Nr T����-�>)�len� splitlines� linecache�cache� setdefaultrU ) rL rO rM rV rN �count� base_filenameZlinecache_tupleZold_valr r r �_linecache_and_compile� s � ra z list[str]r* )�cls_name� attr_namesrP c C sF | � d�}i }t |�D ] \}}|fdd�}t|�||< qt|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)) Z Attributesc S s | | S r' r )r �ir r r �getter s z&_make_attr_tuple_class.<locals>.getter)� enumerate�propertyr* rB )rb rc Zattr_class_name�bodyrd � attr_namere r r r �_make_attr_tuple_class s rj c @ s& e Zd ZU ded< ded< ded< dS )� _Attributesr* �attrs�list[Attribute]� base_attrs�dict[str, type]Zbase_attrs_mapN)r r! r" �__annotations__r r r r rk s rk c C s2 t | �} | �d�r(| �d�r(| dd� } | �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 rW )rJ � startswith�endswith�_CLASSVAR_PREFIXES)Zannotr r r � _is_class_var" s rv c C s || j v S )zR Check whether *cls* defines *attrib_name* (and doesn't just inherit it). )�__dict__)�clsZ attrib_namer r r �_has_own_attribute3 s ry z'tuple[list[Attribute], dict[str, type]]�rP c C s� g }i }t | jdd� �D ]H}t|dg �D ]6}|js*|j|v r@q*|jdd�}|�|� |||j< q*qg }t� }t |�D ](}|j|v r�qv|�d|� |� |j� qv||fS )zQ Collect attr.ibs from base classes of *cls*, except *taken_attr_names*. r rW �__attrs_attrs__T�� inheritedr ) �reversed�__mro__�getattrr} �name�evolve�append�set�insert�add)rx �taken_attr_namesrn � base_attr_map�base_cls�a�filtered�seenr r r �_collect_base_attrs: s" r� c C sn g }i }| j dd� D ]N}t|dg �D ]<}|j|v r6q&|jdd�}|�|j� |�|� |||j< q&q||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 rW r{ Tr| )r r� r� r� r� r� )rx r� rn r� r� r� r r r �_collect_base_attrs_broken[ s r� c s0 | j �t| �� |dur$t|�� �}n�|du r�dd� ��� D �}g }t� }� �� D ]H\} } t| �rbqP|�| � ��| t�} | j t ur�t | �} |� | | f� qP|| } | r�t dd�t| �fdd�d �� d ��n td d � ��� D �d d� d �}tj�� �fdd�|D �} |�r&t| dd� | D ��\}}nt| dd� | D ��\}}|�r`dd� | D �} dd� |D �}|| }|du�r�t|| |��}d}dd � |D �D ]H} |du �r�| jtu �r�d| ��}t|��|du �r�| jtu�r�d}�q�|D ]$} | j�s�t�| �dt| j�� �q�dd� |D �}t | j |�}t ||�||�S )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`. NTc S s h | ]\}}|j tu r|�qS r �� __class__rE ��.0r� �attrr r r � <setcomp>� s �z#_transform_attrs.<locals>.<setcomp>z1The following `attr.ib`s lack a type annotation: �, c s � � | �jS r' )�get�counter)�n)�cdr r �<lambda>� � z"_transform_attrs.<locals>.<lambda>)�key�.c s s$ | ] \}}|j tu r||fV qd S r' r� r� r r r � <genexpr>� s �z#_transform_attrs.<locals>.<genexpr>c S s | d j S �Nr )r� )�er r r r� � r� c s" g | ]\}}�||� � |���qS r )r� )r� ri �ca)�anns�fcar r � <listcomp>� s z$_transform_attrs.<locals>.<listcomp>c S s h | ] }|j �qS r �r� �r� r� r r r r� � r� c S s h | ] }|j �qS r r� r� r r r r� � r� c S s g | ]}|j d d��qS �T)r4 �r� r� r r r r� � r� c S s g | ]}|j d d��qS r� r� r� r r r r� � r� Fc s s& | ] }|j d ur|jd u r|V qdS )FN)r1 r4 r� r r r r� � r� zlNo mandatory attributes allowed after an attribute with a default value or factory. Attribute in question: r: c S s g | ] }|j �qS r r� r� r r r r� � r� ) rw r rA �itemsr� rv r� r� r r� rE rH r� r �join�sorted� Attribute�from_counting_attrr� r� rB r, r= r: � _OBJ_SETATTR�__get__�_default_init_alias_forr� rj r rk )rx �these� auto_attribsr4 �collect_by_mro�field_transformerZca_listZca_namesZ annot_namesri r* r� Z unannotatedZ own_attrsrn r� rl Z had_defaultrG rc Z AttrsClassr )r� r� r� r �_transform_attrsw s� � ������ �� � r� c C sn g d�}|d ur |� d� n|�g d�� |�ddg� t|d�}| tj|d�}td�|�||d |id �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)rV � __getattr__)r� �extend�_generate_unique_filenamer� r� ra r� )r� r� rx �linesZunique_filename�globr r r � _make_cached_property_getattr� s. �� �� ���r� c C s, t | t�r$|dv r$t�| ||� dS t�dS )z4 Attached to frozen classes as __setattr__. )� __cause__� __context__� __traceback__�__suppress_context__� __notes__N)r@ � BaseException� __setattr__r �r r� �valuer r r �_frozen_setattrs s r� c C s* t | t�r"|dv r"t�| |� dS t�dS )z4 Attached to frozen classes as __delattr__. )r� N)r@ r� � __delattr__r )r r� r r r �_frozen_delattrs( s r� c O s� z | \}W n, t y6 dt| �� d�}t|�d�Y n0 |j}t|�}|D ].}|jsVqJ|j}|j}||vrJt||�||< qJ|f i |��S )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 givenN) r= rZ r< r� �fieldsr1 r� r: r� ) �args�changes�instrG rx rl r� ri Z init_namer r r r� 3 s % �r� c @ s� e Zd ZdZdZdd�dd�Zdd� Zd d �d d �Zd d� Zdd� Z dd� Z dd� Z dd� Z dd� Z dd� Zdd � Zd d � Zd d � Zd!d"� Zd#d$� Zd%d&� Zd'd(� Zd)d*� Zd+d+d,�d-d.�Zd+d+d,�d/d0�Zd1S )2� _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_setattrr* �rx c C s t ||||| |�\}}}|| _|r,t|j�ni | _|| _dd� |D �| _|| _tdd� |D ��| _ || _ || _ || _ | | _ tt|dd��| _d| _| jr�|j}t�|�}t|j�dk| _tt|dd��| _t|� | _| | _| | _| | _d| _ | j| jd < |�r t | jd < t | jd < d | _ n�| t t j!t j"fv �r�d }}|D ]8}|j#d u�rPd }|j$d u�r`d }|�r<|�r< �qv�q<| t k�r�|�s�|�r�| t j!k�r�|�r�| t j"k�r�|�s�d | _|�r�| �%� \| jd < | jd< g | _&d| _'t(| jd��r�t(| jd��s| j)| _*n| j+| _*d S )Nc S s h | ] }|j �qS r r� r� r r r r� � r� z)_ClassBuilder.__init__.<locals>.<setcomp>c s s | ] }|j V qd S r' r� r� r r r r� � r� z)_ClassBuilder.__init__.<locals>.<genexpr>�__attrs_pre_init__Fr �__attrs_post_init__r{ r� r� T� __getstate__� __setstate__r! r" ),r� r� �dictrw r� r� r� r� rB r� r� r� r� r� �boolr� r� r� r� �inspect� signaturerZ � parametersr� r� r� r� r� r� r� r� �_DEFAULT_ON_SETATTRr �validate�convertr- r2 �_make_getstate_setstater� r� �hasattr�_add_method_dunders_safer� �_add_method_dunders_unsafe)r rx r� �slots�frozen� weakref_slot�getstate_setstater� r4 � cache_hash�is_excr� r9 Zhas_custom_setattrr� rl rn Zbase_mapZ pre_init_funcZpre_init_signatureZ has_validatorZ has_converterr� r r r �__init__� s� � � ������� ��� z_ClassBuilder.__init__c C s d| j j� d�S )Nz<_ClassBuilder(cls=z)>)r� r r r r r r � s z_ClassBuilder.__repr__rK rz c C sl d� dd� | jD ��}i }| jD ]\}}}|�|� q t|t| jd�|�}| jD ]\}}}|| j|� qPdS )z= Evaluate any registered snippets in one go. r� c S s g | ] }|d �qS )r r )r� Zsnippetr r r r� � r� z0_ClassBuilder._eval_snippets.<locals>.<listcomp>�methodsN)r� r� �updatera r� r� r� )r rL rM �_Z snippet_globsrN �hookr r r �_eval_snippets� s �z _ClassBuilder._eval_snippetsc C sT | � � | jdu r | �� }n| �� }tr2t�|�}t|dd�rPd|jvrP|� � |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_classr �abcZupdate_abstractmethodsr� rw r )r rx r r r � build_class s ��z_ClassBuilder.build_classc C s� | j }| j}| jrj| jD ]P}||vrt||t�turt�t�� t ||� W d � q1 s^0 Y q| j � � D ]\}}t |||� qt| j s�t|dd�r�d|_| js�t|_|S )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� r r� r� r� )r rx � base_namesr� r� r r r r " s& �� *�z#_ClassBuilder._patch_original_classc s� �fdd��j �� D �}�jsTd|d< �jsT�jjD ] � � j�dd�r4t|d< qTq4i }d}�jj dd� D ]:� � j�dd �d ur�d }|� � fd d�t � d g �D �� qlt �j ���j}�jr�dt �jd d �vr�d|vr�|s�|d7 }dd� |�� D �}g }|�r�t�j�}|�� D ]F\}} ||f7 }||= |�| � t�| �j} | tjju�r| ||< �q|�d�} | d u�rx|�| � t|| �j�|d< �fdd�|D ���fdd�|�� D ���fdd��D ��|� �� �j�r��t� t��|d < �jj|d< t �j��jj �jj|�} t � | j� � |�D ]�} t!| t"t#f��rHt | j$dd �}n(t!| t%��rdt | j&dd �}n t | dd �}|�sz�q$|D ]8}z|j'�ju }W n t(�y� Y n0 |�r~| |_'�q~�q$| S )zL Build and return a new class with a `__slots__` attribute. c s2 i | ]*\}}|g t � j��d �d�R vr||�qS )rw � __weakref__)rB r� �r� �k�vr r r � <dictcomp>J s �z5_ClassBuilder._create_slots_class.<locals>.<dictcomp>Fr r� r rW r NTc s i | ]}|t � |��qS r �r� �r� r� )r� r r r i s �� __slots__r )r c S s" i | ]\}}t |t�r||j�qS r )r@ r �func)r� r� Z cached_propr r r r z s �r� c s g | ]}|� vr|�qS r r r )r r r r� � r� z5_ClassBuilder._create_slots_class.<locals>.<listcomp>c s i | ]\}}|� v r||�qS r r )r� ZslotZslot_descriptor)� slot_namesr r r � s �c s g | ]}|� vr|�qS r r r )� reused_slotsr r r� � r� r" � __closure__))r� r� r� r� r� � __bases__rw r� r� r r� r� r� r� r� r� r r� r� r� �return_annotation� Parameter�emptyr� r� �_HASH_CACHE_FIELDrB r" r* r � itertools�chain�valuesr@ � classmethod� staticmethod�__func__rg �fget� cell_contentsr= )r r� Zexisting_slotsZweakref_inherited�namesr� Z&additional_closure_functions_to_updateZclass_annotationsr� r � annotationr� rx �itemZ closure_cells�cell�matchr )r� r r r r r r F s� � �� ����� � � � z!_ClassBuilder._create_slots_classc s8 t � j|�\}}� fdd�}� j�|||f� d� _� S )Nc s � � |d �| d< d S )Nr �r� ��cls_dictrM r r r � _attach_repr� s z,_ClassBuilder.add_repr.<locals>._attach_reprT)�_make_repr_scriptr� r� r� r� )r �nsrL rM r1 r r r �add_repr� s z_ClassBuilder.add_reprc C s. | j sd}t|��dd� }| �|�| jd< | S )Nz3__str__ can only be generated if a __repr__ exists.c S s | � � S r' �r r r r r �__str__� s z&_ClassBuilder.add_str.<locals>.__str__r6 )r� r= r� r� )r rG r6 r r r �add_str� s z_ClassBuilder.add_strc s< t dd� | jD ����fdd�}| j� � �fdd�}||fS )zF Create custom __setstate__ and __getstate__ methods. c s s | ]}|d kr|V qdS )r Nr )r� Zanr r r r� � s z8_ClassBuilder._make_getstate_setstate.<locals>.<genexpr>c s � fdd��D �S )�9 Automatically created by attrs. c s i | ]}|t � |��qS r r r r r r r � r� zQ_ClassBuilder._make_getstate_setstate.<locals>.slots_getstate.<locals>.<dictcomp>r r )�state_attr_namesr r �slots_getstate� s z=_ClassBuilder._make_getstate_setstate.<locals>.slots_getstatec sf t �| �}t|t�r4t�|�D ]\}}|||� q n �D ]}||v r8|||| � q8� rb|td� dS )r8 N)r� r� r@ rB �zipr )r �stateZ _ClassBuilder__bound_setattrr� r� �Zhash_caching_enabledr9 r r �slots_setstate� s z=_ClassBuilder._make_getstate_setstate.<locals>.slots_setstate)rB r� r� )r r: r> r r= r r� � s � z%_ClassBuilder._make_getstate_setstatec C s d | j d< | S �N�__hash__)r� r r r r �make_unhashable s z _ClassBuilder.make_unhashablec sH t � j� j� j� jd�\}}dddd�� fdd� }� j�|||f� � S )N�r� r� r� rK )r0 rN rP c s � � |d �| d< d S r? r. )r0 rN r r r � attach_hash s z+_ClassBuilder.add_hash.<locals>.attach_hash)�_make_hash_scriptr� r� r� r� r� r� )r rL rM rC r r r �add_hash s � z_ClassBuilder.add_hashc s` t �j�j�j�j�j�j�j�j�j �j �j dd� \}}� � �fdd�}�j � |||f� �S )NF�� attrs_initc s |d }� |_ ��|�| d< d S )Nr� �rp r� �r0 rM r1 �r r r r � _attach_init2 s z,_ClassBuilder.add_init.<locals>._attach_init��_make_init_scriptr� r� r� r� r� r� r� r� r� r� r� r� r� )r rL rM rK r rJ r �add_init" s" � z_ClassBuilder.add_initc C s | � dd� �| jd< | S )Nc [ s t | fi |��S r' r� )r r� r r r r� = r� z+_ClassBuilder.add_replace.<locals>.<lambda>� __replace__)r� r� r r r r � add_replace; s � z_ClassBuilder.add_replacec C s t dd� | jD ��| jd< d S )Nc s s | ]}|j r|js|jV qd S r' )r1 r4 r� )r� �fieldr r r r� B s �z/_ClassBuilder.add_match_args.<locals>.<genexpr>�__match_args__)rB r� r� r r r r �add_match_argsA s �z _ClassBuilder.add_match_argsc s` t �j�j�j�j�j�j�j�j�j �j �j dd� \}}� � �fdd�}�j � |||f� �S )NTrF c s |d }� |_ ��|�| d< d S )N�__attrs_init__rH rI rJ r r �_attach_attrs_initX s z8_ClassBuilder.add_attrs_init.<locals>._attach_attrs_initrL )r rL rM rU r rJ r �add_attrs_initH s" � z _ClassBuilder.add_attrs_initc s> � j }t� j�\}}� fdd�}� j�|||f� t|d< � S )Nc s � � |d �| d< d S )N�__eq__r. r/ r r r � _attach_eqf s z(_ClassBuilder.add_eq.<locals>._attach_eq�__ne__)r� �_make_eq_scriptr� r� r� rY )r r� rL rM rX r r r �add_eqa s z_ClassBuilder.add_eqc s> � j }� fdd�t� j� j�D �\|d< |d< |d< |d< � S )Nc 3 s | ]}� � |�V qd S r' r. )r� �methr r r r� r s �z*_ClassBuilder.add_order.<locals>.<genexpr>�__lt__�__le__�__gt__�__ge__)r� � _make_orderr� r� )r r� r r r � add_ordero s � z_ClassBuilder.add_orderc s� i � | j D ],}|jp| j}|r |tjur ||f� |j< q � s@| S | jrRd}t|��� fdd�}d| jd< | � |�| jd< d| _ | S )Nz7Can't combine custom __setattr__ with on_setattr hooks.c sD z� | \}}W n t y& |}Y n0 || ||�}t| ||� d S r' )�KeyErrorr� )r r� �valr� r Znval�Zsa_attrsr r r� � s z._ClassBuilder.add_setattr.<locals>.__setattr__Tr r� ) r� r9 r� r �NO_OPr� r� r= r� r� r� )r r� r9 rG r� r re r � add_setattry s z_ClassBuilder.add_setattrr )�methodrP c C s6 | 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 rh r r r r� � s �z(_ClassBuilder._add_method_dunders_unsafec C s� t �t�� | jj|_W d � n1 s*0 Y t �t��& | jj� d|j� �|_W d � n1 sj0 Y t �t��" d| jj� d�|_W d � n1 s�0 Y |S )zL Add __module__ and __qualname__ to a *method* if possible. Nr� ri )r r r r� r! r" r r# rj r r r r� � s ( 4 0z&_ClassBuilder._add_method_dunders_safeN)r r! r" r# r r� r r r r r r4 r7 r� rA rE rN rP rS rV r[ rb rg r� r� r r r r r� m s. k$ ) r� c C st | dur(t |du|duf�r(d}t|��| dur8| | fS |du rD|}|du rP|}|du rl|du rld}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.��anyr= )r/ r5 r7 � default_eqrG r r r �_determine_attrs_eq_order� s rq c C s� | dur(t |du|duf�r(d}t|��dd� }| durP|| �\} }| || |fS |du rd|d }}n ||�\}}|du r�|| }}n ||�\}}|du r�|du r�d}t|��||||fS )rk Nrl c S s t | �rd| } }nd}| |fS )z8 Decide whether a key function is used. TN)r> )r� r� r r r �decide_callable_or_boolean� s z>_determine_attrib_eq_order.<locals>.decide_callable_or_booleanFTrm rn ) r/ r5 r7 rp rG rr Zcmp_keyr6 r8 r r r r; � s" r; c C sF |du s|du r|S |du r(|du r(|S |D ]}t | |�r, dS q,|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. TFN)ry )rx �flag� auto_detectZdundersr, Zdunderr r r � _determine_whether_to_implement� s ru c s� �dur"ddl }|jtd�dd� t|||d�\��|dur@|� t� ttf�rXtj� � � � ��������� � � � � �������fdd�}| du r�|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*. Nr zQThe `repr_ns` argument is deprecated and will be removed in or after August 2025.� )� stacklevelc s" �p t | �}�du o t| t�}�o*t| d�}|r@|r@d}t|��t| ��|�t| ��d�d�� � �|�� |��}t| ��d�r�|��� �du r�|�� t| ��d�}|s�|du r�|� � |s�t| ��d�r�|� � �s�|� � � d u r��du r�t| d �r�d � � du�r(� d u�r(� d u�r(d }t |��� d u �sL� d u �rF|d u �sL|�r`��r�d }t |��nL� du �s�� d u �r�|du �r�|du �r�|� � n��r�d }t |��|�� t| � �d ��r�|�� n|�� ��r�d}t |��t�r�t| d��s�|�� t�r� �rt| d��s|�� |�� S )NTr� z/Can't freeze a class with a custom __setattr__.)r� r� )r, r5 )rW rY )r] r^ r_ r` r@ Fr+ zlInvalid 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.rO rR )�_has_frozen_base_class� issubclassr� ry r= r� ru r4 r7 r[ rb rg r< rE rA rN rV r rP r rS r )rx � is_frozenr� Zhas_own_setattrrG Zbuilderr5 �r� rt �auto_excr� r� Zeq_r� r� r� r0 r1 r4 � match_argsr9 Zorder_r. �repr_nsr� rJ r� r� r r �wrap� s� ���� � ���� $ ��� � ���zattrs.<locals>.wrap) �warnings�warn�DeprecationWarningrq r@ rA rB r rC )Z maybe_clsr� r r. r/ r0 r1 r� r� r� rJ r� r4 r� r} r5 r7 rt r� r� r9 r� r~ � unsafe_hashr� r� r r| r rl s" \�� 4nrl c C s | j tu S )zV Check whether *cls* has a frozen ancestor by looking at its __setattr__. )r� r� r� r r r ry s ry )rx � func_namerP c C s$ d|� d| j � dt| d| j�� d�S )zF Create a "filename" suitable for a function being generated. z<attrs generated � r� r" rY )r! r� r )rx r� r r r r� s ��r� rm r� ztuple[str, dict])rx rl r� r� rP c s t dd� � D ��� d}tt| d���i �d}d�d�|sB|d7 }n |d 7 }|d 7 }d � ��d 7 �|g�� �����fd d�}|r��|dt� d� � |r�|dt� d�|d � ��|d d � n|dt� d�|d � ��|dt� � � n |d|� d���}|�fS )Nc s s0 | ](}|j d u s$|j du r|jd u r|V qdS )TN)r0 r5 r� r r r r� s z$_make_hash_script.<locals>.<genexpr>� r0 zdef __hash__(selfzhash((z))z):z, *zC, _cache_wrapper=__import__('attr._make')._make._CacheHashWrapper):z_cache_wrapper(�)c s� �� || � |d�� d� g� � D ]Z}|jrhd|j� d�}|j�|< ��|d|� d|j� d� � q&��|d|j� d� � q&��|d � � d S ) 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)r� r6 r� r� )�prefix�indentr� �cmp_name�rl Zclosing_bracesrM Z hash_funcZ method_linesZ type_hashr r � append_hash_computation_lines/ s �� �z8_make_hash_script.<locals>.append_hash_computation_lineszif self.z is None:zobject.__setattr__(self, '�', rv �self.� = z return self.zreturn r� )rB r0 r� r� r r� )rx rl r� r� �tabZhash_defr� rL r r� r rD s> � �� rD )rx rl c C s6 t | |ddd�\}}t||t| d�d� |d | _| S )z% Add a hash method to *cls*. FrB r@ �rO )rD rU r� r@ �rx rl rL rM r r r � _add_hash\ s � � r� c C s | � |�}|tu rtS | S )z^ Check equality and either forward a NotImplemented or return the result negated. )rW �NotImplemented)r �other�resultr r r rY j s rY rA )rl rP c C s� dd� | D �} g d�}i }| r�|� d� | D ]�}|jrxd|j� d�}|j||< |� d|� d|j� d |� d |j� d � � n|� d |j� d |j� �� || d ur,|d � d�|d< q,|� d� n |� d� d�|�}||fS )z6 Create __eq__ method for *cls* with *attrs*. c S s g | ]}|j r|�qS r )r5 r� r r r r� z r� z#_make_eq_script.<locals>.<listcomp>)zdef __eq__(self, other):z- if other.__class__ is not self.__class__:z return NotImplementedz return (r r� r� r� z) == z(other.r� r� z == other.rW z andz )z return Truer� )r� r6 r� r� )rl r� rM r� r� rL r r r rZ v s& � rZ c sV dd� � D �� � fdd���fdd�}�fdd�}�fd d �}�fd d �}||||fS ) z9 Create ordering methods for *cls* with *attrs*. c S s g | ]}|j r|�qS r )r7 r� r r r r� � r� z _make_order.<locals>.<listcomp>c s t dd� � fdd��D �D ��S )z& Save us some typing. c s s" | ]\}}|r||�n|V qd S r' r )r� r� r� r r r r� � s �z6_make_order.<locals>.attrs_to_tuple.<locals>.<genexpr>c 3 s | ]}t � |j�|jfV qd S r' )r� r� r8 r� ��objr r r� � s )rB r� �rl r� r �attrs_to_tuple� s ��z#_make_order.<locals>.attrs_to_tuplec s |j | j u r � | �� |�k S tS �z1 Automatically created by attrs. �r� r� �r r� �r� r r r] � s z_make_order.<locals>.__lt__c s |j | j u r � | �� |�kS tS r� r� r� r� r r r^ � s z_make_order.<locals>.__le__c s |j | j u r � | �� |�kS tS r� r� r� r� r r r_ � s z_make_order.<locals>.__gt__c s |j | j u r � | �� |�kS tS r� r� r� r� r r r` � s z_make_order.<locals>.__ge__r )rx rl r] r^ r_ r` r )rl r� r ra � s ra c C sB |du r| j }t|�\}}t||t| d�d� |d | _t| _| S )z5 Add equality methods to *cls* with *attrs*. NrW r� )r{ rZ rU r� rW rY r� r r r �_add_eq� s � r� c C s� t dd� | D ��}dd� |D �}t|d< t|d< t|d< g }|D ]N\}}}|rVd| n d | d }|tkrvd ||f n d |||f } |�| � q@d �|�} |du r�d} n|d } ddddddddddddd | � d | � d �d d g} d!�| �|fS )"zC Create the source and globs for a __repr__ and return it. c s s6 | ].}|j d ur|j|j du r"t n|j |jfV qdS )FTN)r. r� r1 r� r r r r� � s �z$_make_repr_script.<locals>.<genexpr>c S s$ i | ] \}}}|t kr|d |�qS )�_repr)r. )r� r� �rr r r r r � s z%_make_repr_script.<locals>.<dictcomp>r r r r� zgetattr(self, "z ", NOTHING)z %s={%s!r}z%s={%s_repr(%s)}r� Nz1{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� )rB r r r r. r� r� ) rl r3 Zattr_names_with_reprsrM Zattribute_fragmentsr� r� rd �accessor�fragmentZ repr_fragmentZcls_name_fragmentr� r r r r2 � sN ���� � �r2 c C s> |du r| j }t||�\}}t||t| d�d� |d | _| S )z% Add a repr method to *cls*. Nr r� )r{ r2 rU r� r )rx r3 rl rL rM r r r � _add_repr s � r� c C sv t | �}|du r&t| t�s&d}t|��t| dd�}|du rr|dur`t|dd�}|dur`|| _|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 r@ r* r< r� r{ r )rx Z generic_baserG rl r r r r� , s r� c C sJ t | t�sd}t|��t| dd�}|du r<| �d�}t|��dd� |D �S )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� r{ Nr� c S s i | ] }|j |�qS r r� r� r r r r t r� z fields_dict.<locals>.<dictcomp>)r@ r* r< r� r )rx rG rl r r r � fields_dictZ s r� c C sD t jdu rdS t| j�D ]&}|j}|dur|| |t| |j�� qdS )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 Z_run_validatorsr� r� r- r� r� )r� r� r r r r r� w s r� c C s |� | �}|od|jv S )z> Check if the attribute name comes from a slot class. r )r� rw )Za_namer� rx r r r � _is_slot_attr� s r� ztuple[str, dict, dict]c C s | d uo| t ju} |r&| r&d} t| ��|p,|}g }i }|D ]b}|jsP|jtu rPq:|�|� |||j< |jd ur�|du r�d} t| ��d}q:| r:|jt jur:d}q:t ||||||||| || | r�dnd� \}}}| j t j v r�|� t j | j j� |� t|d�� |�r tj|d< |||fS )Nz$Frozen classes can't use on_setattr.TrT r� )r � attr_dictr� )r rf r= r1 r, r r� r� r9 �_attrs_to_init_scriptr! �sys�modulesr� rw r� r� )rx rl �pre_init�pre_init_has_args� post_initr� r� r� r� r� Zcls_on_setattrrG �has_cls_on_setattrrG �needs_cached_setattrZfiltered_attrsr� r� rL rM r r r r rM � sP � � rM �ri � value_var�has_on_setattrrP c C s d| � d|� d�S )zJ Use the cached object.setattr to set *attr_name* to *value_var*. � _setattr('r� r� r �ri r� r� r r r �_setattr� s r� � Converter�ri r� r� r2 rP c C s d| � d|� | |�� d�S )zk Use the cached object.setattr to set *attr_name* to *value_var*, but run its converter first. r� r� r� )�_fmt_converter_call�ri r� r� r2 r r r �_setattr_with_converter� s r� )ri r� r� rP c C s |rt | |d�S d| � d|� �S )zo Unless *attr_name* has an on_setattr hook, use normal assignment. Otherwise relegate to _setattr. Tr� r� )r� )ri r� r� r r r �_assign� s r� c C s* |rt | |d|�S d| � d|�| |�� �S )z� Unless *attr_name* has an on_setattr hook, use normal assignment after conversion. Otherwise relegate to _setattr_with_converter. Tr� r� )r� r� r� r r r �_assign_with_converter� s r� ro )r� r� r� c s` | du rV|du rdt tfS ddddd�� fdd� }dddddd �� fd d � }d ||fS dttfS ) zg Determine the correct setter functions based on whether a class is frozen and/or slotted. Tr rJ r� r� c s& t | � �rt| ||�S d| � d|� �S �N� _inst_dict['z'] = )r� r� r� �r� r r � fmt_setter s z&_determine_setters.<locals>.fmt_setterr� r� c s4 |st | � �r t| |||�S d| � d|�| |�� �S r� )r� r� r� r� r� r r �fmt_setter_with_converter s �z5_determine_setters.<locals>.fmt_setter_with_converter)z_inst_dict = self.__dict__)r� r� r� r� )r� r� r� r� r� r r� r �_determine_setters� s �r� ) rl r{ � is_slotted� call_pre_initr� �call_post_init�does_cache_hashr� r� r� r� � method_namerP c $ C s� |r dgng } | r | � d� t|||�\} }}| �| � g }g }g }i }ddi}| D �]�}|jrj|� |� |j}|jdup�|jtjuo�| }|j}t |j t �}|r�|j j r�dnd}|j dur�t |j t�s�t|j �}n|j }|jdu �r�|�r`t|jf } |du�r4| � ||| d|� d � ||�� |j ||�|j�< n | � ||| d|� d � |�� |j j|| < nT|du�r�| � ||d |� d �||�� |j ||�|j�< n| � ||d |� d �|�� �n�|j tu�r@|�s@|� d |� d �} |j�r�|� | � n |� | � |du�r*| � |||||�� |j ||�|j�< n| � ||||�� �nb|�r@|� d �} |j�rd|� | � n |� | � | � d|� d�� t|jf } |du�r�| � d|||||� � | � d� | � d||| d | d ||� � |j ||�|j�< nB| � d||||� � | � d� | � d||| d | d |� � |j j|| < nb|j�rT|� |� n |� |� |du�r�| � |||||�� |j ||�|j�< n| � ||||�� |jdu rT|jdu�r�|du �r�|j||< qT|durT|jrT|j||< qT|�rRt|d< | � d� |D ]L}d|j } d|j }| � d| � d|� d|j� d �� |j|| < |||< �q|�rb| � d� |�r�|�r�|�r�dt� d�} n d t� d �} n d t� d �} | � | � |�r�d �d!d"� | D ��} | � d#| � d �� d$�|�}|}!|�r@||�r�d$nd� d%d$�|�� �7 }d$�d&d'� d(d"� |D �D ��}"|!|!�r2d$nd7 }!|!|"7 }!|�r\|�r\d)|!� d �| d*< d+}#d,| � d|� d-| �r~|#�| �nd.� d/�||fS )0z� 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)rP Nr rI Fr� r� z attr_dict['z '].defaultz =attr_dict['z=NOTHINGzif z is not NOTHING:r� zelse:Tr z#if _config._run_validators is True:Z__attr_validator_Z__attr_z(self, z, self.zself.__attrs_post_init__()r� z', None)r� z '] = Noner� z = Noner� c s s | ]}|j rd |j� �V qdS )r� N)r1 r� r� r r r r� r� z(_attrs_to_init_script.<locals>.<genexpr>z BaseException.__init__(self, r� z*, c S s g | ]}|� d |� ��qS )�=r )r� Z kw_arg_namer r r r� s �z)_attrs_to_init_script.<locals>.<listcomp>c s s | ]}|� d �d V qdS )r� r N)�split)r� Zkwar r r r� r� zself.__attrs_pre_init__(r z zdef z): �passr� )r� r� r� r- r� r9 r rf r: r@ r, r? � takes_selfr2 r� r1 �_INIT_FACTORY_PAT�_get_global_namerF r r4 r* �_first_param_typer r r� )$rl r{ r� r� r� r� r� r� r� r� r� r� r� Z extra_linesr� r� r� Z kw_only_argsZattrs_to_validateZnames_for_globalsr r� ri r� Zarg_nameZ has_factoryZ maybe_selfr2 Zinit_factory_name�argZval_nameZinit_hash_cache�valsZ pre_init_argsZpre_init_kw_only_args�NLr r r r� . sj �� � �� ��� �� � �� ��� ��� ��� �� ��� ��� " �� ��r� )r� rP c C s | � 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. r )�lstripr� r r r r� 2 s r� c @ s\ e Zd ZdZdZddd�Zdd� Zedd d d �d d ��Zdd� Z dd� Z dd� Z dd� Z dS )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� r, r- r. r5 r6 r7 r8 r0 r1 r3 r* r2 r4 r} r9 r: NFc C s� t ||p | |p|d�\} }}}t�| �}|d|� |d|� |d|� |d|� |d| � |d|� |d|� |d |� |d |� |d |� |d | � |d | r�t�t| ��nt� |d| � |d| � |d|� |d|� |d|� d S )NTr� r, r- r. r5 r6 r7 r8 r0 r1 r2 r3 r* r4 r} r9 r: )r; r� r� �types�MappingProxyTyper� �_EMPTY_METADATA_SINGLETON)r r� r, r- r. r/ r0 r1 r} r3 r* r2 r4 r5 r6 r7 r8 r9 r: � bound_setattrr r r r� ~ s4 � �� zAttribute.__init__c C s t �d S r' )r r� r r r r� � s zAttribute.__setattr__rJ rE )r� r� c C st |d u r|j }n |j d ur.d|� d�}t|��| ||j|j|jd |j|jd|j||j|j |j |j |j |j |j|j�S )Nz>Type annotation and type argument cannot both be present for 'z'.F)r* r= �_default� _validatorr. r0 r1 r3 r2 r4 r5 r6 r7 r8 r9 r: )rx r� r� r* rG r r r r� � s2 �z Attribute.from_counting_attrc K s t � | �}|�|�� � |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� �newr r r r� � s zAttribute.evolvec s t � fdd�� jD ��S )�( Play nice with pickle. c 3 s* | ]"}|d krt � |�nt� j�V qdS )r3 N)r� r� r3 r r r r r� � s �z)Attribute.__getstate__.<locals>.<genexpr>�rB r r r r r r� � s �zAttribute.__getstate__c C s | � t| j|�� dS �r� N)r� r; r �r r< r r r r� � s zAttribute.__setstate__c C sL t �| �}|D ]8\}}|dkr*|||� q|||r@t�t|��nt� qd S )Nr3 )r� r� r� r� r� r� )r Zname_values_pairsr� r� r� r r r r� � s ��zAttribute._setattrs) NNNFNNNNNN)N) r r! r" r# r r� r� r$ r� r� r� r� r� r r r r r� = s( , � 7 r� c C s2 g | ]*}t |td dd dd|dkddt|�d� �qS )NTFr3 ) r� r, r- r. r/ r5 r7 r0 r1 r} r: )r� r r� r r r r r� s ��r� r� c C s g | ]}|j d kr|�qS r| r� r� r r r r� r� c C s g | ]}|j r|jd kr|�qS r| )r0 r� r� r r r r� r� c @ sn e Zd ZdZdZg edd� dD ���eddddddd dd ddd dd dd ��R Zd Zd d � Z dd� Z dd� Z dS )rE 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� r: r2 r� r5 r6 r0 r1 r4 r3 r9 r7 r8 r. r* c c s8 | ]0}t |t|�td dd ddddd dd dd d�V qd S )NTF�r� r: r, r- r. r/ r0 r1 r4 r5 r6 r7 r8 r} r9 )r� r� r r r r r r� = s$ ��z_CountingAttr.<genexpr>) r� r� r. r5 r7 r0 r1 r9 r: r3 NTFr� r c C st t jd7 _t j| _|| _|| _|| _|| _| | _| | _| | _ || _ || _ || _ || _ | | _| | _|| _|| _d S r� )rE � cls_counterr� r� r� r2 r. r5 r6 r7 r8 r0 r1 r3 r* r4 r9 r: )r r, r- r. r/ r0 r1 r2 r3 r* r4 r5 r6 r7 r8 r9 r: r r r r� o s" z_CountingAttr.__init__c C s$ | j du r|| _ nt| j |�| _ |S )z� Decorator that adds *meth* to the list of validators. Returns *meth* unchanged. .. versionadded:: 17.1.0 N)r� rD �r r\ r r r r- � s z_CountingAttr.validatorc C s | j turt�t|dd�| _ |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 r? r� r r r r, � s z_CountingAttr.default) r r! r" r# r rB r� r{ r� r� r- r, r r r r rE ! s: �� ��1%rE c @ s. e Zd ZdZdZd dd�Zdd� Zdd � Zd S ) r? 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* �rF r� Fc C s || _ || _d S r' r� )r rF r� r r r r� � s zFactory.__init__c s t � fdd�� jD ��S )r� c 3 s | ]}t � |�V qd S r' r r r r r r� � r� z'Factory.__getstate__.<locals>.<genexpr>r� r r r r r� � s zFactory.__getstate__c C s& t | j|�D ]\}}t| ||� q dS r� )r; r r )r r< r� r� r r r r� � s zFactory.__setstate__N)F)r r! r" r# r r� r� r� r r r r r? � s r? c C s( g | ] }t |td dd dddddd� �qS �NTF) r� r, r- r. r/ r5 r7 r0 r1 r} �r� r r r r r r� � s ��c @ sZ e Zd ZdZdZddd�dd�Zeddd�d d ��Zdddd �d d �Zdd� Z dd� Z dS )r� 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� Z _global_namer2 � takes_fieldr� F�r� r� c s� |� _ |� _|� _t|�}|�� � _� js@� js@� fdd�� _nF� jr\� js\� fdd�� _n*� jsx� jrx� fdd�� _n� fdd�� _|�� }|d ur�|� jjd< d S )Nc s � � | �S r' �r2 )r� r �__r r r r� r� z$Converter.__init__.<locals>.<lambda>c s � � | |�S r' r� )r� �instancer� r r r r� s �c s � � | |�S r' r� )r� r� rQ r r r r� s �c s � � | ||�S r' r� )r� r� rQ r r r r� # s �rP ) r2 r� r� r �get_first_param_typer� r� �get_return_typerp )r r2 r� r� �ex�rtr r r r� s zConverter.__init__rJ )ri rP c C s d| � �S )zh Return the name that a converter for an attribute name *attr_name* would have. Z__attr_converter_r )ri r r r r� + s zConverter._get_global_name)ri r� rP c C s� | j s"| js"| �|�� d|� d�S | j rJ| jrJ| �|�� d|� d|� d�S | j rf| �|�� d|� d�S | �|�� d|� d|� d�S )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`. r� r� z, self, attr_dict['z'])z, self)z , attr_dict[')r� r� r� )r ri r� r r r r� 3 s z Converter._fmt_converter_callc C s | j | j| jd�S )zx Return a dict containing only converter and takes_self -- the rest gets computed when loading. �r2 r� r� r� r r r r r� D s �zConverter.__getstate__c C s | j f i |�� dS )z+ Load instance from state. Nrx r� r r r r� O s zConverter.__setstate__N) r r! r" r# r r� r% r� r� r� r� r r r r r� � s c C s( g | ] }t |td dd dddddd� �qS r� r� r r r r r� V s ��r� c sl t �d| �} t|t�r |}n*t|ttf�r:dd� |D �}n d}t|��|�dd�}|�dd�}|�dd�} i � |dur�� �|� |dur�|� d< |dur�|� d< | dur�| � d< t � | |i � fd d ��} t � t t��& t�d �j�d d �| _W d � n1 �s0 Y |�dd�} t| |�d�|�d�d�\|d< |d< tf d|i|��| �} dd� |�� D �| _| S )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. �NFKCc S s i | ] }|t � �qS r )rH r� r r r r � r� z make_class.<locals>.<dictcomp>z(attrs argument must be a dict or a list.r� Nr� r� c s | � � �S r' )r� )r3 �rh r r r� � r� z make_class.<locals>.<lambda>r r �__main__r/ r5 r7 Tr� c S s" i | ]\}}|j d ur||j �qS r' )r* r r r r r � s )� unicodedata� normalizer@ r� rA rB r< �popr� r� � new_classr r r r= r� � _getframe� f_globalsr� r! rq r� r� rp ) r� rl �basesZ class_bodyZattributes_argumentsr0 rG r� r� Z user_init�type_r/ rx r r� r � make_classk sN 0 �& ���r )r� r� c @ s e Zd ZdZe� Zdd� ZdS )� _AndValidatorz2 Compose many validators to a single one. c C s | j D ]}||||� qd S r' )� _validators)r r� r� r� r r r r r� � s z_AndValidator.__call__N)r r! r" r# rH r r� r r r r r � s r c G s6 g }| D ] }|� t|t�r |jn|g� qtt|��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� r@ r r rB )Z validatorsr� r- r r r rD � s ��rD c s� t dd� � D ��}|r$� fdd�}n � fdd�}� sPtd�}|j�||d�� nTt� d ��� }|rn||jd < � d }ts�t|t�r�|j }t|�� � }|r�||jd < |r�t|d 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 s s | ]}t |t�V qd S r' �r@ r� )r� �cr r r r� r� zpipe.<locals>.<genexpr>c s, � D ]"}t |t�r || ||�n|| �} q| S r' r )rd r� rQ r �� convertersr r �pipe_converter s �z pipe.<locals>.pipe_converterc s � D ] }|| �} q| S r' r )rd r r r r r s �A)rd rP r rd rW rP Tr� ) ro r rp r� r r� r r@ r� r� r� )r Zreturn_instancer r �t�lastr� r r r rC � s& rC )NrI )N)T)NNNNNNNFFTFFFFFNNFFNNNTN)N)NN)i� __future__r r r r� r$ r� r! r\ r� r� r� �collections.abcr r � functoolsr �typingr r r rI r r r r r r r r r � exceptionsr r r r �objectr� r� r� ru r r� r� r rC r� r� r� �Enumr r �intr& rH rU ra rj rk rv ry r� r� r� r� r� r� r� r� rq r; ru rl r� ry r� rD r� rY rZ ra r� r2 r� r� r� r� rM r� r� r� r� r� r� r� r� r Z_arE r? Z_fr� r r rD r r r r �<module> s. � n � �#! l4 : N , � � d H %8 9 . E /& K� � � ' � d ��� k