
    bMh;                    j   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	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%m&Z&m'Z' ddl(m)Z) ddl*m+Z+m,Z, ddl-m.Z. ej/        rdZ0de1d<   dZ2de1d<   ddl3m4Z4 e5e6e7e8e9e:e;e,j<        eeee	j=        eee>j?        e@j?        hZAde1d<   eBeCeDeEeFeeehZGde1d<   dXdZHdYd"ZIdZd&ZJd[d(ZKd\d*ZLd]d-ZM e"d.          ZNd^d2ZOd_d6ZP e"d7          ZQe8d8d`d>ZR G d? d@e+jS                  ZTej/        rdadDZUn G dE dF          ZU e"dG          ZVdbdIZW eX            ZYdcdMZZ ej[        dNO           G dP dQ                      Z\ e"dRdST          Z] e"dU          Z^ G dV dWe!e]e^f                   Z_dS )dzBucket 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)Mapping)deepcopy)cached_property)	Parameter)zip_longest)BuiltinFunctionTypeCodeTypeFunctionTypeGeneratorType
LambdaType
ModuleType)AnyCallableGenericTypeVaroverload)	TypeAlias	TypeGuard
deprecated)PydanticDeprecatedSince211   )_repr_typing_extra)import_cached_base_modelz3typing.Mapping[int, Any] | typing.Mapping[str, Any]r   MappingIntStrAnyz1typing.AbstractSet[int] | typing.AbstractSet[str]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    Y/var/www/html/test/jupyter/venv/lib/python3.11/site-packages/pydantic/_internal/_utils.pycan_be_positionalr-   H   s      :)3Y5TUUU    vr   c           	     j    t          | t          t          t          t          t
          t          f          S N)
isinstancelisttupleset	frozensetr   r   r/   s    r,   sequence_liker8   [   s    a$sI}eLMMMr.   oclass_or_tuple(type[Any] | tuple[type[Any], ...] | Nonec                F    	 t          | |          S # t          $ r Y dS w xY wNF)r2   	TypeError)r9   r:   s     r,   lenient_isinstancer?   _   s9    !^,,,   uus    
  clsc                    	 t          | t                    ot          | |          S # t          $ r t          | t          j                  rY dS  w xY wr=   )r2   type
issubclassr>   r   WithArgsTypes)r@   r:   s     r,   lenient_issubclassrE   f   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   rE   )r@   r"   s     r,   is_model_classrH   o   s)     )**Ic9--F#Y2FFr.   
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)rI   s    r,   is_valid_identifierrO   x   s)    
 ""$$JW->z-J-J)JJr.   KeyTypemappingdict[KeyType, Any]updating_mappingsc                   |                                  }|D ]o}|                                D ]X\  }}||v rJt          ||         t                    r/t          |t                    rt	          ||         |          ||<   S|||<   Yp|S r1   )copyitemsr2   dictdeep_update)rQ   rS   updated_mappingupdating_mappingkr/   s         r,   rX   rX      s    llnnO- ' '$**,, 	' 	'DAqO##
?13Et(L(L#Q[\]_cQdQd#%01CQ%G%G""%&""		'
 r.   dict[Any, Any]updateNonec                h    |                      d |                                D                        d S )Nc                    i | ]
\  }}|||S r1    ).0r[   r/   s      r,   
<dictcomp>z#update_not_none.<locals>.<dictcomp>   s    EEETQq}Aq}}}r.   )r]   rV   )rQ   r]   s     r,   update_not_nonerd      s1    NNEEV\\^^EEEFFFFFr.   T)name_factory
input_listlist[T] | tuple[T, ...]rf   typing.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)rg   rf   resultresult_namesr/   v_names         r,   unique_listrq      s~     F L 3 3a%%'''MM!12F<%%f--..Mr.   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   rV   $AbstractSetIntStr | MappingIntStrAnyr&   r^   c                    |                      |          }t          |t          t          f          r#|                     |t          |                    }|| _        d S r1   )_coerce_itemsr2   r3   r4   _normalize_indexeslenrt   )selfrv   rV   s      r,   __init__zValueItems.__init__   sQ    ""5))edE]++ 	?++E3u::>>E(-r.   itemr'   c                \    |                      | j                            |                    S )zWCheck if item is fully excluded.

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

        :param item: key or index of value
        rt   r   s     r,   is_includedzValueItems.is_included   s    
 t{""r.   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)rt   r   r   )r|   r   r~   s      r,   for_elementzValueItems.for_element   s2     {q!!<<--7tt47r.   r   v_lengthintdict[int | str, Any]c                ,   i }d}|                                 D ]\  }}t          |t          j                  sIt          |t          j                  s/|                     |          st          d| d|j                   |dk    r|                     |          }t          |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   .)rV   r2   typingr   AbstractSetr   r>   	__class___coerce_valuer   merger   range
setdefault)	r|   rV   r   normalized_items	all_itemsir/   normalized_inormalized_items	            r,   rz   zValueItems._normalize_indexes   s    24	KKMM 	_ 	_DAqq&.11 cZ6CU5V5V cZ^ZfZfghZiZi 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 #r.   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 ra   ra   )rb   r[   r   s     r,   
<listcomp>z$ValueItems.merge.<locals>.<listcomp>  s    ;;;Q(]]!]]]r.   c                    g | ]}|v |	S ra   ra   rb   r[   r   s     r,   r   z$ValueItems.merge.<locals>.<listcomp>  s%    >`>`>`QVW[_V_V_qV_V_V_r.   c                    g | ]}|v|	S ra   ra   r   s     r,   r   z$ValueItems.merge.<locals>.<listcomp>  s    &L&L&LQatmmqmmmr.   )r   )r   r   r3   r   r   )r@   r   r   r   
merge_keysmergedr[   merged_items    ``     r,   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	r.   c                    t          | t          j                  rnYt          | t          j                  rt                              | d          } n#t          | dd          }t          d|           | S )N.r   z???z!Unexpected type of exclude value )r2   r   r   r   rW   fromkeysgetattrr>   )rV   
class_names     r,   ry   zValueItems._coerce_items  sr    eV^,, 	Nv122 	NMM%--EE U;;JL
LLMMMr.   c                ^    ||                      |          r|S |                     |          S r1   )r   ry   )r@   rv   s     r,   r   zValueItems._coerce_value#  s0    =CKK..=L  '''r.   r/   c                    | du p| du S )NT.ra   r7   s    r,   r   zValueItems.is_true)  s    Dy$AH$r.   _repr.ReprArgsc                    d | j         fgS r1   r   r|   s    r,   __repr_args__zValueItems.__repr_args__-  s    t{#$$r.   N)rv   r   rV   rw   r&   r^   )r~   r   r&   r'   )r   r   r&   r   )rV   r   r   r   r&   r   )F)r   r   r   r   r   r'   r&   r   )rV   rw   r&   r   )rv   r   r&   r   r/   r   r&   r'   )r&   r   )__name__
__module____qualname____doc__	__slots__r}   r   r   r   rz   classmethodr   staticmethodry   r   r   r   ra   r.   r,   rs   rs      s       YY#I. . . .3 3 3 3# # # #8 8 8 8#  #  #  # J # # # # [#J    \ ( ( ( [(
 % % % \%% % % % % %r.   rs   name	get_valueCallable[[], T]c                    d S r1   ra   r   r   s     r,   LazyClassAttributer   3  s      r.   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   rJ   r   Callable[[], Any]r&   r^   c                "    || _         || _        d S r1   r   )r|   r   r   s      r,   r}   zLazyClassAttribute.__init__=  s    DI&DNNNr.   r   c                *    |                                  S r1   )r   r   s    r,   rv   zLazyClassAttribute.valueA  s    >>###r.   instanceowner	type[Any]c                R    || j         S t          | j        d|j        d          )Nz attribute of z is class-only)rv   AttributeErrorr   r   )r|   r   r   s      r,   __get__zLazyClassAttribute.__get__E  s3    z! DI!_!_u~!_!_!_```r.   N)r   rJ   r   r   r&   r^   )r&   r   )r   r   r   r   r&   r^   )r   r   r   r   r}   r	   rv   r   ra   r.   r,   r   r   7  sl        	 	
	' 	' 	' 	' 
	$ 	$ 	$ 
	$	a 	a 	a 	a 	a 	ar.   r   Objobjc                    | 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$   r4   rU   r>   
ValueErrorRuntimeErrorr   )r   obj_types     r,   smart_deepcopyr   N  s    
 }H222
 	<x#666"e++33;z<0    C==s   )? AAlefttyping.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       r,   all_identicalr   d  sC     "-T5I!N!N!N  	:J&&55 '4r.   T)frozenc                  D    e Zd ZU dZdZded<   dd	Zej        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   keyrJ   r&   r   c               B    | j                             |t                    S r1   )r   r   r   r|   r   s     r,   __getitem__zSafeGetItemProxy.__getitem__  s    |Y///r.   r'   c               6    | j                             |          S r1   )r   __contains__r   s     r,   r   zSafeGetItemProxy.__contains__  s    <,,S111r.   N)r   rJ   r&   r   )r   rJ   r&   r'   )
r   r   r   r   r   __annotations__r   r   TYPE_CHECKINGr   ra   r.   r,   r   r   s  sr           I0 0 0 0  2	2 	2 	2 	2 	2 	22 2r.   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&   r^   c                   || _         d S r1   )r   )r|   r   s     r,   r}   z%deprecated_instance_property.__init__  s    			r.   r   objtypetype[_ModelT]r   c                    d S r1   ra   r|   r   r   s      r,   r   z$deprecated_instance_property.__get__  s    FIcr.   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 r1   ra   r   s      r,   r   z$deprecated_instance_property.__get__  s     JMr.   _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       r,   r   z$deprecated_instance_property.__get__  s    .1.>'.I.I	**tyOaOjIMR R R R3	    4ty  733555r.   )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   ra   r.   r,   r   r     s             III XIZ	J  
 MLL  X M	6 	6 	6 	6 	6 	6r.   r   )r%   r
   r&   r'   r   )r9   r   r:   r;   r&   r'   )r@   r   r:   r   r&   r'   )r@   r   r&   rF   )rI   rJ   r&   r'   )rQ   rR   rS   rR   r&   rR   )rQ   r\   r]   r   r&   r^   )rg   rh   rf   ri   r&   rj   )r   rJ   r   r   r&   re   )r   r   r&   r   )r   r   r   r   r&   r'   )`r   
__future__r   _annotationsdataclassesrM   r   r   r   weakrefcollectionsr   r   r   collections.abcr   rU   r   	functoolsr	   inspectr
   	itertoolsr   typesr   r   r   r   r   r   r   r   r   r   r   typing_extensionsr   r   r   pydanticr    r   r   _import_utilsr   r   r   r   r    mainr"   r   floatcomplexrJ   r'   bytesrB   NoneTyperefNotImplementedr   Ellipsisr#   r3   r5   r4   r6   rW   r$   r-   r8   r?   rE   rH   rO   rP   rX   rd   re   rq   Representationrs   r   r   r   objectr   r   	dataclassr   r   r   r   ra   r.   r,   <module>r     s    
 3 2 2 2 2 2      



    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 < < < < < < < < < < < < < < > > > > > > > > > > / / / / / / " " " " " " " " 3 3 3 3 3 3	 !"WWWWW#VVVVV      
 		K '3     0 				'  	 	 	 	V V V V&N N N N      G G G GK K K K ')

   G G G G GCLL /2     ,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 6r.   