
    ^=i/                       d dl m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	m
Z
mZmZmZmZmZ d dlmZ d dlmZmZ d dlmZ d dlZddlmZmZmZmZ  e
d	      Z e
d
eedf         Z e
de	eef         Z  e
dee         Z! e
dedef         Z"d9dZ#	 	 	 	 	 	 d:dZ$	 	 	 	 	 	 	 	 	 	 d;dZ%d<dZ&d=dZ'd>dZ(d?dZ)d@dZ*dAdZ+dBdZ,dCdZ-dDdZ.dEdZ/dFdZ0ddd dGd!Z1dHd"Z2dId#Z3 e
d$      Z4 e
d%      Z5edJd&       Z6edKd'       Z6edLd(       Z6dMd)Z6dNd*Z7dOd+Z8dPd,Z9dQd-Z:dRd.Z;dSd/Z<dTd0Z=dUd1Z>dVd2Z?dWd3Z@dXd4ZAd5d6dYd7ZBdZd8ZCy)[    )annotationsN)	AnyTupleMappingTypeVarCallableIterableSequencecastoverload)Path)datedatetime)	TypeGuard   )OmitNotGiven	FileTypesHeadersLike_T_TupleT.)bound	_MappingT
_SequenceT	CallableTc                @    | D cg c]  }|D ]  }|  c}}S c c}}w N )tsublistitems      O/home/rose/Desktop/poly/venv/lib/python3.12/site-packages/groq/_utils/_utils.pyflattenr#   !   s"     !6WgdDgD666s   c          	     T    g }|D ]   }|j                  t        | |dd             " |S )zRecursively extract files from the given dictionary based on specified paths.

    A path may look like this ['foo', 'files', '<array>', 'data'].

    Note: this mutates the given dictionary.
    r   Nindexflattened_key)extend_extract_items)querypathsfilespaths       r"   extract_filesr.   %   s/     *,E^E4qMN L    c                  	 ||   }|dz  }t        |       rC	 t        |      |k(  r| j                  |      }n| |   }||}n	|d| dz  }t        ||||	      S t	        |       r4|d
k7  rg S t        | D cg c]  }t        |||||dz   nd	       c}      S g S # t         $ r t        |       sg cY S ddlm} |J t	        |       rBg }| D ]7  } |||r|dz   nd       |j                  |dz   t        t        |      f       9 |cY S  || |       |t        t        |       fgcY S w xY w# t        $ r g cY S w xY wc c}w )Nr   )assert_is_file_contentz[] )key   []r%   z<array>)
IndexErroris_given_filesr1   is_listappendr   r   is_dictlenpopKeyErrorr)   r#   )	objr-   r&   r'   r3   r1   r,   entryr!   s	            r"   r)   r)   8   s   75k, 
QJEs|
	D	e#wws|3x  MqQZ'M'	
 	
 
)I    D :G:S-$"6Y]	  

 
	
 I{  7}I 	4 (((3<13E&u--$2F]_`md2DE4JKL  Ls6Y 4566'7:  	 I		(s5   B %D- 5D>D*3AD*
D*)D*-D;:D;c                J    t        | t               xr t        | t               S r   )
isinstancer   r   r@   s    r"   r8   r8      s!    #x((FC1F-FFr/   c                "    t        | t              S r   rC   tuplerD   s    r"   is_tuplerH          c5!!r/   c                "    t        | t              S r   rF   rD   s    r"   
is_tuple_trK      rI   r/   c                "    t        | t              S r   rC   r
   rD   s    r"   is_sequencerN          c8$$r/   c                "    t        | t              S r   rM   rD   s    r"   is_sequence_trQ      rO   r/   c                "    t        | t              S r   rC   r   rD   s    r"   
is_mappingrT          c7##r/   c                "    t        | t              S r   rS   rD   s    r"   is_mapping_trW      rU   r/   c                "    t        | t              S r   )rC   dictrD   s    r"   r<   r<          c4  r/   c                "    t        | t              S r   )rC   listrD   s    r"   r:   r:      rZ   r/   c                "    t        | t              S r   )rC   r	   rD   s    r"   is_iterabler^      rO   r/   c                   t        |       r;t        t        | j                         D ci c]  \  }}|t	        |       c}}      S t        |       r't        t        | D cg c]  }t	        |       c}      S | S c c}}w c c}w )zMinimal reimplementation of copy.deepcopy() that will only copy certain object types:

    - mappings, e.g. `dict`
    - list

    This is done for performance reasons.
    )rT   r   r   itemsdeepcopy_minimalr:   )r!   kvrA   s       r"   ra   ra      st     $BDJJLILDAq,Q//LIJJt}BdCdU)%0dCDDK JCs   A; B
z, or)delimfinalc                   t        |       }|dk(  ry|dk(  r| d   S |dk(  r| d    d| d| d    S |j                  | d d       d| d| d    z   S )Nr   r2   r4   r    )r=   join)seqre   rf   sizes       r"   
human_joinrm      sv    s8Dqyqy1vqya&5'3q6(++::c#2hAeWAc"gY"777r/   c                    d|  dS )zOAdd single quotation marks around the given string. Does *not* do any escaping.'r   )strings    r"   quoterq      s    vha=r/   c                      d fd}|S )a4  Decorator to enforce a given set of arguments or variants of arguments are passed to the decorated function.

    Useful for enforcing runtime validation of overloaded functions.

    Example usage:
    ```py
    @overload
    def foo(*, a: str) -> str: ...


    @overload
    def foo(*, b: bool) -> str: ...


    # This enforces the same constraints that a static type checker would
    # i.e. that either a or b must be passed to the function
    @required_args(["a"], ["b"])
    def foo(*, a: str | None = None, b: bool | None = None) -> str: ...
    ```
    c                $    t        j                         j                  }|j                         D cg c]+  \  }}|j                  |j
                  |j                  hv r|- c}}t        j                         d fd       }|S c c}}w )Nc                 l   t               t        |       D ]  \  }}	 j                  |           |j                         D ]  }j                  |        D ]  }t        fd|D              }|s n t              dkD  rTt        D cg c],  }dt        |D cg c]  }t        |       c}d      z   d	z   . c}}      }d
| d}	t	        |	      t              dkD  sJ t        t        d         z
        }
t        |
      dkD  r0dt        |
D cg c]  }t        |       c}       }	t	        |	      dt        |
d          }	t	        |	       | i |S # t        $ r2 t	        j
                   dt               dt        |        d      d w xY wc c}w c c}}w c c}w )Nz	() takes z argument(s) but z were givenc              3  &   K   | ]  }|v  
 y wr   r   ).0paramgiven_paramss     r"   	<genexpr>z@required_args.<locals>.inner.<locals>.wrapper.<locals>.<genexpr>  s     J'u4's   r4   (and)rf   )z,Missing required arguments; Expected either z arguments to be givenr   zMissing required arguments: zMissing required argument: )set	enumerateaddr7   	TypeError__name__r=   keysallrm   rq   r\   )argskwargsi_r3   variantmatchesarg
variationsmsgmissingrx   func
positionalvariantss              @r"   wrapperz-required_args.<locals>.inner.<locals>.wrapper   s   %(UL!$1  $$Z]3 ( {{}  % % $J'JK $
 x=1$!+muvmubiz*I#5:*IQVWWZ]]muv"J ITjkC  n$ x=1,,, #3x{#3l#BCG7|a' <Z_fHg_fX[s_fHg=h<ij  n$ !<E'!*<M;NOn$(((9 "  #==/3z?2CCTUXY]U^T__jk   +Jv Ihs)   E(F+
!F&3F+
F1
(;F#&F+
)r   objectr   r   returnr   )	inspect	signature
parametersr`   kindPOSITIONAL_ONLYPOSITIONAL_OR_KEYWORD	functoolswraps)r   paramsnamerw   r   r   r   s   `    @r"   innerzrequired_args.<locals>.inner   s    ""4(33  &||~
-ezz%%++ -

 
	!	) 
!	)F ]
s   0B)r   r   r   r   r   )r   r   s   ` r"   required_argsr      s    ,0d Lr/   _K_Vc                     y r   r   rD   s    r"   strip_not_givenr   %  s    (+r/   c                     y r   r   rD   s    r"   r   r   )  s    FIr/   c                     y r   r   rD   s    r"   r   r   -  s    ,/r/   c                    | yt        |       s| S | j                         D ci c]  \  }}t        |t              r|| c}}S c c}}w )zHRemove all top-level keys where their values are instances of `NotGiven`N)rT   r`   rC   r   )r@   r3   values      r"   r   r   1  sE    
{c?
),X:3Juh<WCJXXXs
   AAc                    t        | d      S )N
   )base)intvals    r"   coerce_integerr   <  s    sr/   c                    t        |       S r   )floatr   s    r"   coerce_floatr   @  s    :r/   c                (    | dk(  xs | dk(  xs | dk(  S )Ntrue1onr   r   s    r"   coerce_booleanr   D  s    &=5C3J5#+5r/   c                    | y t        |       S r   )r   r   s    r"   maybe_coerce_integerr   H      
{#r/   c                    | y t        |       S r   )r   r   s    r"   maybe_coerce_floatr   N  s    
{r/   c                    | y t        |       S r   )r   r   s    r"   maybe_coerce_booleanr   T  r   r/   c                D    | j                  |      r| t        |      d S | S )zXRemove a prefix from a string.

    Backport of `str.removeprefix` for Python < 3.9
    N)
startswithr=   )rp   prefixs     r"   removeprefixr   Z  s(    
  c&km$$Mr/   c                F    | j                  |      r| dt        |        S | S )zXRemove a suffix from a string.

    Backport of `str.removesuffix` for Python < 3.9
    N)endswithr=   )rp   suffixs     r"   removesuffixr   d  s(    
 vnV%%Mr/   c                z    t        |       j                         }t        j                  j	                  |       }||fS r   )r   
read_bytesosr-   basename)r-   contents	file_names      r"   file_from_pathr   n  s3    Dz$$&H  &Ix  r/   c                   |j                         }t        |       r@| j                         D ]-  \  }}|j                         |k(  st        |t              s+|c S  t        j                  dd |j                               }|||j                         |fD ]  }| j                  |      }|s|c S  t        d| d      )Nz([^\w])(\w)c                d    | j                  d      | j                  d      j                         z   S )Nr4   r   )groupupper)pats    r"   <lambda>z%get_required_header.<locals>.<lambda>}  s#    #))A,STI[I[I]:]r/   zCould not find z header)lowerrW   r`   rC   strresub
capitalizer   get
ValueError)headersheaderlower_headerrb   rc   intercaps_headernormalized_headerr   s           r"   get_required_headerr   t  s    <<>LGMMODAqwwyL(Z3-? $
 vvn.]_e_p_p_rs$lFLLNDTU-.L V
 vhg6
77r/   c                 J    	 t        j                         S # t        $ r Y yw xY w)Nfalse)sniffiocurrent_async_library	Exceptionr   r/   r"   get_async_libraryr     s(    ,,.. s    	""   maxsizec                N    t        j                  |       }t        t        |      S )zmA version of functools.lru_cache that retains the type signature
    for the wrapped function arguments.
    r   )r   	lru_cacher   r   )r   r   s     r"   r   r     s&     !!G Wr/   c                h   t        |       r6| j                         D ci c]  \  }}t        |      t        |       c}}S t        |       r4t	        | t
        t        t        f      s| D cg c]  }t        |       c}S t	        | t        t        f      r| j                         S | S c c}}w c c}w )zvTranslates a mapping / sequence recursively in the same fashion
    as `pydantic` v2's `model_dump(mode="json")`.
    )rT   r`   	json_safer^   rC   r   bytes	bytearrayr   r   	isoformat)datar3   r   r!   s       r"   r   r     s     $CG::<P<ZS%	#	% 00<PP4D3y2I!J,01DD	$D11$4()~~K Q 2s   B),B/)r   zIterable[Iterable[_T]]r   zlist[_T])r*   zMapping[str, object]r+   zSequence[Sequence[str]]r   list[tuple[str, FileTypes]])
r@   r   r-   Sequence[str]r&   r   r'   
str | Noner   r   )r@   z_T | NotGiven | Omitr   zTypeGuard[_T])r@   r   r   zTypeGuard[tuple[object, ...]])r@   z_TupleT | objectr   zTypeGuard[_TupleT])r@   r   r   zTypeGuard[Sequence[object]])r@   z_SequenceT | objectr   zTypeGuard[_SequenceT])r@   r   r   zTypeGuard[Mapping[str, object]])r@   z_MappingT | objectr   zTypeGuard[_MappingT])r@   r   r   zTypeGuard[dict[object, object]])r@   r   r   zTypeGuard[list[object]])r@   r   r   zTypeGuard[Iterable[object]])r!   r   r   r   )rk   r   re   r   rf   r   r   r   )rp   r   r   r   )r   r   r    Callable[[CallableT], CallableT])r@   Noner   r   )r@   zMapping[_K, _V | NotGiven]r   zdict[_K, _V])r@   r   r   r   )r@   zobject | Noner   r   )r   r   r   r   )r   r   r   r   )r   r   r   bool)r   r   r   
int | None)r   r   r   zfloat | None)r   r   r   zbool | None)rp   r   r   r   r   r   )rp   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   )D
__future__r   r   r   r   r   typingr   r   r   r   r   r	   r
   r   r   pathlibr   r   r   typing_extensionsr   r   _typesr   r   r   r   r   r   r   r   r   r   r   r#   r.   r)   r8   rH   rK   rN   rQ   rT   rW   r<   r:   r^   ra   rm   rq   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r/   r"   <module>r      s   " 	 	  
 
 
  # '  ; ;T]
)5#5
6KwsF{';<	\&)9:
KxS'9:	7  
 # !&F	F
F 	F
 F !FRG""%%$$!!%  48d 8
HV T]T] 
 + 
 + 
 I 
 I 
 / 
 /Y6!8& (+ r/   