
    -2i(>                       U d Z ddlmZ ddlZddlZddlZddlZddlZddl	m
Z
mZmZ ddlmZmZmZ ddlmZ ddlmZ ddlmZ dd	lmZ dd
lmZ ddlmZmZmZmZm Z m!Z! ddl"m#Z#m$Z$m%Z%m&Z&m'Z' ddl(m)Z) ddl*m+Z+m,Z,m-Z- ddl.m/Z/ ddl0m1Z1m2Z2 ddl3m4Z4 e#r6ee5e$f         ee6e$f         z  Z7de8d<   ee5         ee6         z  Z9de8d<   ddl:m;Z; e5e<e=e6e>e?e@e2jA        eee ejB        ee!eCjD        eEjD        hZFde8d<   eGeHeIeJeKe
eehZLde8d<   d[dZMd\d"ZNd]d&ZOd^d(ZPd_d*ZQd`d-ZR e&d.          ZSdad2ZTdbd6ZU e&d7          ZVe6d8dcd>ZW G d? d@e1jX                  ZYe#rdddDZZn G dE dF          ZZ e&dG          Z[dedIZ\ e]            Z^dfdMZ_dgdPZ` eja        dQR           G dS dT                      Zb e&dUdVW          Zc e&dX          Zd G dY dZe%ecedf                   ZedS )hzBucket of reusable internal utilities.

This should be reduced as much as possible with functions only used in one place, moved to that place.
    )annotationsN)OrderedDictdefaultdictdeque)CallableIterableMapping)Set)deepcopy)cached_property)	Parameter)zip_longest)BuiltinFunctionTypeCodeTypeFunctionTypeGeneratorType
LambdaType
ModuleType)TYPE_CHECKINGAnyGenericTypeVaroverload)MISSING)	TypeAlias	TypeGuard
deprecated)PydanticDeprecatedSince211   )_repr_typing_extra)import_cached_base_modelr   MappingIntStrAnyAbstractSetIntStr   )	BaseModelzset[type[Any]]IMMUTABLE_NON_COLLECTIONS_TYPESBUILTIN_COLLECTIONSparamr   returnboolc                @    | j         t          j        t          j        fv S )aZ  Return whether the parameter accepts a positional argument.

    ```python {test="skip" lint="skip"}
    def func(a, /, b, *, c):
        pass

    params = inspect.signature(func).parameters
    can_be_positional(params['a'])
    #> True
    can_be_positional(params['b'])
    #> True
    can_be_positional(params['c'])
    #> False
    ```
    )kindr   POSITIONAL_ONLYPOSITIONAL_OR_KEYWORD)r)   s    X/var/www/html/pixcura-vrs/venv/lib/python3.11/site-packages/pydantic/_internal/_utils.pycan_be_positionalr1   J   s      :)3Y5TUUU    vr   c           	     j    t          | t          t          t          t          t
          t          f          S N)
isinstancelisttupleset	frozensetr   r   r3   s    r0   sequence_liker<   ]   s    a$sI}eLMMMr2   oclass_or_tuple(type[Any] | tuple[type[Any], ...] | Nonec                F    	 t          | |          S # t          $ r Y dS w xY wNF)r6   	TypeError)r=   r>   s     r0   lenient_isinstancerC   a   s9    !^,,,   uus    
  clsc                    	 t          | t                    ot          | |          S # t          $ r t          | t          j                  rY dS  w xY wrA   )r6   type
issubclassrB   r!   WithArgsTypes)rD   r>   s     r0   lenient_issubclassrI   h   s`    #t$$HC)H)HH   c=677 	55s   $' $AATypeGuard[type[BaseModel]]c                F    t                      }t          | |          o| |uS )zReturns true if cls is a _proper_ subclass of BaseModel, and provides proper type-checking,
    unlike raw calls to lenient_issubclass.
    )r"   rI   )rD   r&   s     r0   is_model_classrL   q   s)     )**Ic9--F#Y2FFr2   
identifierstrc                T    |                                  ot          j        |            S )zChecks that a string is a valid identifier and not a Python keyword.
    :param identifier: The identifier to test.
    :return: True if the identifier is valid.
    )isidentifierkeyword	iskeyword)rM   s    r0   is_valid_identifierrS   z   s)    
 ""$$JW->z-J-J)JJr2   KeyTypemappingdict[KeyType, Any]updating_mappingsc                   |                                  }|D ]o}|                                D ]X\  }}||v rJt          ||         t                    r/t          |t                    rt	          ||         |          ||<   S|||<   Yp|S r5   )copyitemsr6   dictdeep_update)rU   rW   updated_mappingupdating_mappingkr3   s         r0   r\   r\      s    llnnO- ' '$**,, 	' 	'DAqO##
?13Et(L(L#Q[\]_cQdQd#%01CQ%G%G""%&""		'
 r2   dict[Any, Any]updateNonec                h    |                      d |                                D                        d S )Nc                    i | ]
\  }}|||S r5    ).0r_   r3   s      r0   
<dictcomp>z#update_not_none.<locals>.<dictcomp>   s    EEETQq}Aq}}}r2   )ra   rZ   )rU   ra   s     r0   update_not_nonerh      s1    NNEEV\\^^EEEFFFFFr2   T)name_factory
input_listlist[T] | tuple[T, ...]rj   Callable[[T], str]list[T]c                   g }g }| D ]T} ||          }||vr+|                     |           |                     |           <|||                    |          <   U|S )zMake a list unique while maintaining order.
    We update the list if another one with the same name is set
    (e.g. model validator overridden in subclass).
    )appendindex)rk   rj   resultresult_namesr3   v_names         r0   unique_listru      s~     F L 3 3a%%'''MM!12F<%%f--..Mr2   c                      e Zd ZdZdZd#d	Zd$dZd$dZd%dZd&dZ	e
d'd(d            Zed)d            Ze
d*d            Zed+d            Zd,d!Zd"S )-
ValueItemszOClass for more convenient calculation of excluded or included fields on values.)_items_typevaluer   rZ   $AbstractSetIntStr | MappingIntStrAnyr*   rb   c                    |                      |          }t          |t          t          f          r#|                     |t          |                    }|| _        d S r5   )_coerce_itemsr6   r7   r8   _normalize_indexeslenrx   )selfrz   rZ   s      r0   __init__zValueItems.__init__   sQ    ""5))edE]++ 	?++E3u::>>E(-r2   itemr+   c                \    |                      | j                            |                    S )zWCheck if item is fully excluded.

        :param item: key or index of a value
        )is_truerx   getr   r   s     r0   is_excludedzValueItems.is_excluded   s$    
 ||DKOOD11222r2   c                    || j         v S )z`Check if value is contained in self._items.

        :param item: key or index of value
        rx   r   s     r0   is_includedzValueItems.is_included   s    
 t{""r2   e	int | str+AbstractSetIntStr | MappingIntStrAny | Nonec                h    | j                             |          }|                     |          s|ndS )z:param e: key or index of element on value
        :return: raw values for element if self._items is dict and contain needed element
        N)rx   r   r   )r   r   r   s      r0   for_elementzValueItems.for_element   s2     {q!!<<--7tt47r2   r#   v_lengthintdict[int | str, Any]c                   i }d}|                                 D ]\  }}t          |t                    sDt          |t                    s/|                     |          st          d| d|j                   |dk    r|                     |          }zt          |t                    st          d          |dk     r||z   n|}| 	                    ||
                    |                    ||<   |s|S |                     |          r*t          |          D ]}|                    |d           |S t          |          D ]F}|                    |i           }|                     |          s| 	                    ||          ||<   G|S )a]  :param items: dict or set of indexes which will be normalized
        :param v_length: length of sequence indexes of which will be

        >>> self._normalize_indexes({0: True, -2: True, -1: True}, 4)
        {0: True, 2: True, 3: True}
        >>> self._normalize_indexes({'__all__': True}, 4)
        {0: True, 1: True, 2: True, 3: True}
        Nz,Unexpected type of exclude value for index "z" __all__zExcluding fields from a sequence of sub-models or dicts must be performed index-wise: expected integer keys or keyword "__all__"r   .)rZ   r6   r	   AbstractSetr   rB   	__class___coerce_valuer   merger   range
setdefault)	r   rZ   r   normalized_items	all_itemsir3   normalized_inormalized_items	            r0   r~   zValueItems._normalize_indexes   s    24	KKMM 	_ 	_DAqq'** cjK.H.H cDLLYZOO c aq a aTUT_ a abbbI~~ ..q11	a%% A   ,-q558a<<aL-1ZZ;K;O;OP\;];]-^-^\** 	$##<<	"" 	$8__ 4 4 ++As3333##x 	M 	MA.99!R@@O<<00 M&*jjO&L&L #r2   Fbaseoverride	intersectc                   |                                |                                S |                               sS |                               r|rnS |rfdD             fdD             z   }nt                    fdD             z   }i }|D ]G}|                                         |                              |          |          }||||<   H|S )aH  Merge a `base` item with an `override` item.

        Both `base` and `override` are converted to dictionaries if possible.
        Sets are converted to dictionaries with the sets entries as keys and
        Ellipsis as values.

        Each key-value pair existing in `base` is merged with `override`,
        while the rest of the key-value pairs are updated recursively with this function.

        Merging takes place based on the "union" of keys if `intersect` is
        set to `False` (default) and on the intersection of keys if
        `intersect` is set to `True`.
        Nc                    g | ]}|v |	S re   re   )rf   r_   r   s     r0   
<listcomp>z$ValueItems.merge.<locals>.<listcomp>  s    ;;;Q(]]!]]]r2   c                    g | ]}|v |	S re   re   rf   r_   r   s     r0   r   z$ValueItems.merge.<locals>.<listcomp>  s%    >`>`>`QVW[_V_V_qV_V_V_r2   c                    g | ]}|v|	S re   re   r   s     r0   r   z$ValueItems.merge.<locals>.<listcomp>  s    &L&L&LQatmmqmmmr2   )r   )r   r   r7   r   r   )rD   r   r   r   
merge_keysmergedr_   merged_items    ``     r0   r   zValueItems.merge   s0    $$X..  &&K;;t 	O;;x   	3$244(2  	M;;;;T;;;>`>`>`>`(>`>`>``JJd&L&L&L&L(&L&L&LLJ') 	( 	(A))DHHQKKaI)VVK&'q	r2   c                    t          | t                    rnTt          | t                    rt                              | d          } n#t          | dd          }t          d|           | S )N.r   z???z!Unexpected type of exclude value )r6   r	   r   r[   fromkeysgetattrrB   )rZ   
class_names     r0   r}   zValueItems._coerce_items  sm    eW%% 	N{++ 	NMM%--EE U;;JL
LLMMMr2   c                ^    ||                      |          r|S |                     |          S r5   )r   r}   )rD   rz   s     r0   r   zValueItems._coerce_value%  s0    =CKK..=L  '''r2   r3   c                    | du p| du S )NT.re   r;   s    r0   r   zValueItems.is_true+  s    Dy$AH$r2   _repr.ReprArgsc                    d | j         fgS r5   r   r   s    r0   __repr_args__zValueItems.__repr_args__/  s    t{#$$r2   N)rz   r   rZ   r{   r*   rb   )r   r   r*   r+   )r   r   r*   r   )rZ   r#   r   r   r*   r   )F)r   r   r   r   r   r+   r*   r   )rZ   r{   r*   r#   )rz   r   r*   r   r3   r   r*   r+   )r*   r   )__name__
__module____qualname____doc__	__slots__r   r   r   r   r~   classmethodr   staticmethodr}   r   r   r   re   r2   r0   rw   rw      s       YY#I. . . .3 3 3 3# # # #8 8 8 8#  #  #  # J # # # # [#J    \ ( ( ( [(
 % % % \%% % % % % %r2   rw   name	get_valueCallable[[], T]c                    d S r5   re   r   r   s     r0   LazyClassAttributer   5  s      r2   c                  :    e Zd ZdZddZedd
            ZddZdS )r   zA descriptor exposing an attribute only accessible on a class (hidden from instances).

        The attribute is lazily computed and cached during the first access.
        r   rN   r   Callable[[], Any]r*   rb   c                "    || _         || _        d S r5   r   )r   r   r   s      r0   r   zLazyClassAttribute.__init__?  s    DI&DNNNr2   r   c                *    |                                  S r5   )r   r   s    r0   rz   zLazyClassAttribute.valueC  s    >>###r2   instanceowner	type[Any]c                R    || j         S t          | j        d|j        d          )Nz attribute of z is class-only)rz   AttributeErrorr   r   )r   r   r   s      r0   __get__zLazyClassAttribute.__get__G  s3    z! DI!_!_u~!_!_!_```r2   N)r   rN   r   r   r*   rb   )r*   r   )r   r   r   r   r*   rb   )r   r   r   r   r   r   rz   r   re   r2   r0   r   r   9  sl        	 	
	' 	' 	' 	' 
	$ 	$ 	$ 
	$	a 	a 	a 	a 	a 	ar2   r   Objobjc                    | t           u r| S | j        }|t          v r| S 	 | s(|t          v r|t          u r| n|                                 S n# t          t          t          f$ r Y nw xY wt          |           S )zReturn type as is for immutable built-in types
    Use obj.copy() for built-in empty collections
    Use copy.deepcopy() for non-empty collections and unknown objects.
    )
r   r   r'   r(   r8   rY   rB   
ValueErrorRuntimeErrorr   )r   obj_types     r0   smart_deepcopyr   P  s    
 g~~
}H222
 	<x#666"e++33;z<0    C==s   )A
 
A$#A$leftIterable[Any]rightc                N    t          | |t                    D ]\  }}||ur dS dS )a  Check that the items of `left` are the same objects as those in `right`.

    >>> a, b = object(), object()
    >>> all_identical([a, b, a], [a, b, a])
    True
    >>> all_identical([a, b, [a]], [a, b, [a]])  # new list object, while "equal" is not "identical"
    False
    )	fillvalueFT)r   	_SENTINEL)r   r   	left_item
right_items       r0   all_identicalr   h  sC     "-T5I!N!N!N  	:J&&55 '4r2   abc                    | | n|S )zTReturn the first argument if it is not `None`, otherwise return the second argument.re   )r   r   s     r0   get_first_not_noner   w  s    111$r2   T)frozenc                  :    e Zd ZU dZdZded<   dd	ZerddZdS dS )SafeGetItemProxyzWrapper redirecting `__getitem__` to `get` with a sentinel value as default

    This makes is safe to use in `operator.itemgetter` when some keys may be missing
    )wrappedzMapping[str, Any]r   keyrN   r*   r   c               B    | j                             |t                    S r5   )r   r   r   r   r   s     r0   __getitem__zSafeGetItemProxy.__getitem__  s    |Y///r2   r+   c               6    | j                             |          S r5   )r   __contains__r   s     r0   r   zSafeGetItemProxy.__contains__  s    <,,S111r2   N)r   rN   r*   r   )r   rN   r*   r+   )	r   r   r   r   r   __annotations__r   r   r   re   r2   r0   r   r   |  so           I0 0 0 0  2	2 	2 	2 	2 	2 	22 2r2   r   _ModelTr&   )bound_RTc                  x    e Zd ZdZddZedd            Ze edd          dd                        ZddZdS )deprecated_instance_propertya  A decorator exposing the decorated class method as a property, with a warning on instance access.

    This decorator takes a class method defined on the `BaseModel` class and transforms it into
    an attribute. The attribute can be accessed on both the class and instances of the class. If accessed
    via an instance, a deprecation warning is emitted stating that instance access will be removed in V3.
    fgetCallable[[type[_ModelT]], _RT]r*   rb   c                   || _         d S r5   )r   )r   r   s     r0   r   z%deprecated_instance_property.__init__  s    			r2   r   objtypetype[_ModelT]r   c                    d S r5   re   r   r   r   s      r0   r   z$deprecated_instance_property.__get__  s    FIcr2   zAccessing this attribute on the instance is deprecated, and will be removed in Pydantic V3. Instead, you should access this attribute from the model class.N)categoryr   c                    d S r5   re   r   s      r0   r   z$deprecated_instance_property.__get__  s     JMr2   _ModelT | Nonec                    |Mt           j        dk    r| j        j        n| j        j        j        }t          j        d|dt          d            | j                            ||                      S )N)   
   zAccessing the zi attribute on the instance is deprecated. Instead, you should access this attribute from the model class.r%   )r   
stacklevel)	sysversion_infor   r   __func__warningswarnr   r   )r   r   r   	attr_names       r0   r   z$deprecated_instance_property.__get__  s     #w.. 	""Y'0  MR R R R3	    4ty  733555r2   )r   r   r*   rb   )r   rb   r   r   r*   r   )r   r   r   r   r*   r   )r   r   r   r   r*   r   )r   r   r   r   r   r   r   r   re   r2   r0   r   r     s             III XIZ	J  
 MLL  X M6 6 6 6 6 6r2   r   )r)   r   r*   r+   r   )r=   r   r>   r?   r*   r+   )rD   r   r>   r   r*   r+   )rD   r   r*   rJ   )rM   rN   r*   r+   )rU   rV   rW   rV   r*   rV   )rU   r`   ra   r   r*   rb   )rk   rl   rj   rm   r*   rn   )r   rN   r   r   r*   ri   )r   r   r*   r   )r   r   r   r   r*   r+   )r   r   r   r   r*   r   )fr   
__future__r   _annotationsdataclassesrQ   r   r  weakrefcollectionsr   r   r   collections.abcr   r   r	   r
   r   rY   r   	functoolsr   inspectr   	itertoolsr   typesr   r   r   r   r   r   typingr   r   r   r   r   pydantic_corer   typing_extensionsr   r   r   pydanticr    r    r!   _import_utilsr"   r   rN   r#   r   r$   mainr&   floatcomplexr+   bytesrF   NoneTyperefNotImplementedr   Ellipsisr'   r7   r9   r8   r:   r[   r(   r1   r<   rC   rI   rL   rS   rT   r\   rh   ri   ru   Representationrw   r   r   r   objectr   r   r   	dataclassr   r   r   r   re   r2   r0   <module>r!     s    
 3 2 2 2 2 2      



   7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 . . . . . .       % % % % % %       ! ! ! ! ! ! d d d d d d d d d d d d d d d d A A A A A A A A A A A A A A ! ! ! ! ! ! > > > > > > > > > > / / / / / / " " " " " " " " 3 3 3 3 3 3 !")#s("3gc3h6G"GGGGG#.s#3k#6F#FFFFF      
 		K '3     0 				'  	 	 	 	V V V V&N N N N      G G G GK K K K ')

   G G G G GCLL (+     ,C% C% C% C% C%% C% C% C%L  aKKKKKa a a a a a a a( genn   * FHH	   % % % %
 d###2 2 2 2 2 2 2 $#22 ');
/
/
/genn$6 $6 $6 $6 $677C<#8 $6 $6 $6 $6 $6r2   