
    o i=                       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)m*Z*m+Z+ ddl,m-Z- ddl.m/Z/m0Z0 ddl1m2Z2 e#r6ee3e$f         ee4e$f         z  Z5de6d<   ee3         ee4         z  Z7de6d<   ddl8m9Z9 e3e:e;e4e<e=e>e0j?        eee ej@        ee!eAjB        eCjB        hZDde6d<   eEeFeGeHeIe
eehZJde6d<   dZdZKd[d!ZLd\d%ZMd]d'ZNd^d)ZOd_d,ZP e&d-          ZQd`d1ZRdad5ZS e&d6          ZTe4d7dbd=ZU G d> d?e/jV                  ZWe#rdcdCZXn G dD dE          ZX e&dF          ZYdddHZZ e[            Z\dedLZ]dfdOZ^ ej_        dPQ           G dR dS                      Z` e&dTdUV          Za e&dW          Zb G dX dYe%eaebf                   ZcdS )gzBucket 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)	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    P/var/www/findabus/venv/lib/python3.11/site-packages/pydantic/_internal/_utils.pycan_be_positionalr0   I   s      :)3Y5TUUU    vr   c           	     j    t          | t          t          t          t          t
          t          f          S N)
isinstancelisttupleset	frozensetr   r   r2   s    r/   sequence_liker;   \   s    a$sI}eLMMMr1   oclass_or_tuple(type[Any] | tuple[type[Any], ...] | Nonec                F    	 t          | |          S # t          $ r Y dS w xY wNF)r5   	TypeError)r<   r=   s     r/   lenient_isinstancerB   `   s9    !^,,,   uus    
  clsc                    	 t          | t                    ot          | |          S # t          $ r t          | t          j                  rY dS  w xY wr@   )r5   type
issubclassrA   r    WithArgsTypes)rC   r=   s     r/   lenient_issubclassrH   g   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!   rH   )rC   r%   s     r/   is_model_classrK   p   s)     )**Ic9--F#Y2FFr1   
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)rL   s    r/   is_valid_identifierrR   y   s)    
 ""$$JW->z-J-J)JJr1   KeyTypemappingdict[KeyType, Any]updating_mappingsc                   |                                  }|D ]o}|                                D ]X\  }}||v rJt          ||         t                    r/t          |t                    rt	          ||         |          ||<   S|||<   Yp|S r4   )copyitemsr5   dictdeep_update)rT   rV   updated_mappingupdating_mappingkr2   s         r/   r[   r[      s    llnnO- ' '$**,, 	' 	'DAqO##
?13Et(L(L#Q[\]_cQdQd#%01CQ%G%G""%&""		'
 r1   dict[Any, Any]updateNonec                h    |                      d |                                D                        d S )Nc                    i | ]
\  }}|||S r4    ).0r^   r2   s      r/   
<dictcomp>z#update_not_none.<locals>.<dictcomp>   s    EEETQq}Aq}}}r1   )r`   rY   )rT   r`   s     r/   update_not_nonerg      s1    NNEEV\\^^EEEFFFFFr1   T)name_factory
input_listlist[T] | tuple[T, ...]ri   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)rj   ri   resultresult_namesr2   v_names         r/   unique_listrt      s~     F L 3 3a%%'''MM!12F<%%f--..Mr1   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   rY   $AbstractSetIntStr | MappingIntStrAnyr)   ra   c                    |                      |          }t          |t          t          f          r#|                     |t          |                    }|| _        d S r4   )_coerce_itemsr5   r6   r7   _normalize_indexeslenrw   )selfry   rY   s      r/   __init__zValueItems.__init__   sQ    ""5))edE]++ 	?++E3u::>>E(-r1   itemr*   c                \    |                      | j                            |                    S )zWCheck if item is fully excluded.

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

        :param item: key or index of value
        rw   r   s     r/   is_includedzValueItems.is_included   s    
 t{""r1   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)rw   r   r   )r   r   r   s      r/   for_elementzValueItems.for_element   s2     {q!!<<--7tt47r1   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   .)rY   r5   r	   AbstractSetr   rA   	__class___coerce_valuer   merger   range
setdefault)	r   rY   r   normalized_items	all_itemsir2   normalized_inormalized_items	            r/   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 #r1   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 rd   rd   )re   r^   r   s     r/   
<listcomp>z$ValueItems.merge.<locals>.<listcomp>  s    ;;;Q(]]!]]]r1   c                    g | ]}|v |	S rd   rd   re   r^   r   s     r/   r   z$ValueItems.merge.<locals>.<listcomp>  s%    >`>`>`QVW[_V_V_qV_V_V_r1   c                    g | ]}|v|	S rd   rd   r   s     r/   r   z$ValueItems.merge.<locals>.<listcomp>  s    &L&L&LQatmmqmmmr1   )r   )r   r   r6   r   r   )rC   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	r1   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 )r5   r	   r   rZ   fromkeysgetattrrA   )rY   
class_names     r/   r|   zValueItems._coerce_items  sm    eW%% 	N{++ 	NMM%--EE U;;JL
LLMMMr1   c                ^    ||                      |          r|S |                     |          S r4   )r   r|   )rC   ry   s     r/   r   zValueItems._coerce_value$  s0    =CKK..=L  '''r1   r2   c                    | du p| du S )NT.rd   r:   s    r/   r   zValueItems.is_true*  s    Dy$AH$r1   _repr.ReprArgsc                    d | j         fgS r4   r   r   s    r/   __repr_args__zValueItems.__repr_args__.  s    t{#$$r1   N)ry   r   rY   rz   r)   ra   )r   r   r)   r*   )r   r   r)   r   )rY   r"   r   r   r)   r   )F)r   r   r   r   r   r*   r)   r   )rY   rz   r)   r"   )ry   r   r)   r   r2   r   r)   r*   )r)   r   )__name__
__module____qualname____doc__	__slots__r   r   r   r   r}   classmethodr   staticmethodr|   r   r   r   rd   r1   r/   rv   rv      s       YY#I. . . .3 3 3 3# # # #8 8 8 8#  #  #  # J # # # # [#J    \ ( ( ( [(
 % % % \%% % % % % %r1   rv   name	get_valueCallable[[], T]c                    d S r4   rd   r   r   s     r/   LazyClassAttributer   4  s      r1   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   rM   r   Callable[[], Any]r)   ra   c                "    || _         || _        d S r4   r   )r   r   r   s      r/   r   zLazyClassAttribute.__init__>  s    DI&DNNNr1   r   c                *    |                                  S r4   )r   r   s    r/   ry   zLazyClassAttribute.valueB  s    >>###r1   instanceowner	type[Any]c                R    || j         S t          | j        d|j        d          )Nz attribute of z is class-only)ry   AttributeErrorr   r   )r   r   r   s      r/   __get__zLazyClassAttribute.__get__F  s3    z! DI!_!_u~!_!_!_```r1   N)r   rM   r   r   r)   ra   )r)   r   )r   r   r   r   r)   ra   )r   r   r   r   r   r   ry   r   rd   r1   r/   r   r   8  sl        	 	
	' 	' 	' 	' 
	$ 	$ 	$ 
	$	a 	a 	a 	a 	a 	ar1   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'   r7   rX   rA   
ValueErrorRuntimeErrorr   )r   obj_types     r/   smart_deepcopyr   O  s    
 }H222
 	<x#666"e++33;z<0    C==s   )? 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       r/   all_identicalr   e  sC     "-T5I!N!N!N  	:J&&55 '4r1   abc                    | | n|S )zTReturn the first argument if it is not `None`, otherwise return the second argument.rd   )r   r   s     r/   get_first_not_noner   t  s    111$r1   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   keyrM   r)   r   c               B    | j                             |t                    S r4   )r   r   r   r   r   s     r/   __getitem__zSafeGetItemProxy.__getitem__  s    |Y///r1   r*   c               6    | j                             |          S r4   )r   __contains__r   s     r/   r   zSafeGetItemProxy.__contains__  s    <,,S111r1   N)r   rM   r)   r   )r   rM   r)   r*   )	r   r   r   r   r   __annotations__r   r   r   rd   r1   r/   r   r   y  so           I0 0 0 0  2	2 	2 	2 	2 	2 	22 2r1   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)   ra   c                   || _         d S r4   )r   )r   r   s     r/   r   z%deprecated_instance_property.__init__  s    			r1   r   objtypetype[_ModelT]r   c                    d S r4   rd   r   r   r   s      r/   r   z$deprecated_instance_property.__get__  s    FIcr1   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 r4   rd   r   s      r/   r   z$deprecated_instance_property.__get__  s     JMr1   _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     #w.. 	""Y'0  MR R R R3	    4ty  733555r1   )r   r   r)   ra   )r   ra   r   r   r)   r   )r   r   r   r   r)   r   )r   r   r   r   r)   r   )r   r   r   r   r   r   r   r   rd   r1   r/   r   r     s             III XIZ	J  
 MLL  X M6 6 6 6 6 6r1   r   )r(   r   r)   r*   r   )r<   r   r=   r>   r)   r*   )rC   r   r=   r   r)   r*   )rC   r   r)   rI   )rL   rM   r)   r*   )rT   rU   rV   rU   r)   rU   )rT   r_   r`   r   r)   ra   )rj   rk   ri   rl   r)   rm   )r   rM   r   r   r)   rh   )r   r   r)   r   )r   r   r   r   r)   r*   )r   r   r   r   r)   r   )dr   
__future__r   _annotationsdataclassesrP   r   r  weakrefcollectionsr   r   r   collections.abcr   r   r	   r
   r   rX   r   	functoolsr   inspectr   	itertoolsr   typesr   r   r   r   r   r   typingr   r   r   r   r   typing_extensionsr   r   r   pydanticr    r   r    _import_utilsr!   r   rM   r"   r   r#   mainr%   floatcomplexr*   bytesrE   NoneTyperefNotImplementedr   Ellipsisr&   r6   r8   r7   r9   rZ   r'   r0   r;   rB   rH   rK   rR   rS   r[   rg   rh   rt   Representationrv   r   r   r   objectr   r   r   	dataclassr   r   r   r   rd   r1   r/   <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 $6r1   