
    g.                       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 dd	l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%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Z0dEdZ1dFdZ2dGdZ3dd d!dHd"Z4dId#Z5dJd$Z6 e
d%      Z7 e
d&      Z8edKd'       Z9edLd(       Z9edMd)       Z9dNd*Z9dOd+Z:dPd,Z;dQd-Z<dRd.Z=dSd/Z>dTd0Z?dUd1Z@dVd2ZAdWd3ZBdXd4ZCdYd5ZDd6d7dZd8ZEd[d9ZFy)\    )annotationsN)	AnyTupleMappingTypeVarCallableIterableSequencecastoverload)Path)datedatetime)	TypeGuard   )NotGiven	FileTypes
NotGivenOrHeadersLike)
parse_dateparse_datetime_T_TupleT.)bound	_MappingT
_SequenceT	CallableTc                @    | D cg c]  }|D ]  }|  c}}S c c}}w N )tsublistitems      G/var/www/openai/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_filesr0   &   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        | t              rg cY S ddlm}  || |       |J |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_content)key   []r'   z<array>z[])
IndexError
isinstancer   _filesr3   r   r   is_dictlenpopKeyErrorr+   is_listr%   )objr/   r(   r)   r4   r3   r#   s          r$   r+   r+   9   sX   75k 
QJEs|
	D	e#wws|3x  MqQZ'M'	
 	
 
)I    D :G:S-$"6Y]	  

 
	
 Ik  7c8$I 	4 	s6(((Y 45667*  	 I		(s.   B %C% 5C6C"8'C"!C"%C32C3c                $    t        | t               S r   )r9   r   r@   s    r$   is_givenrC   z   s    #x(((r1   c                "    t        | t              S r   r9   tuplerB   s    r$   is_tuplerG          c5!!r1   c                "    t        | t              S r   rE   rB   s    r$   
is_tuple_trJ      rH   r1   c                "    t        | t              S r   r9   r
   rB   s    r$   is_sequencerM          c8$$r1   c                "    t        | t              S r   rL   rB   s    r$   is_sequence_trP      rN   r1   c                "    t        | t              S r   r9   r   rB   s    r$   
is_mappingrS          c7##r1   c                "    t        | t              S r   rR   rB   s    r$   is_mapping_trV      rT   r1   c                "    t        | t              S r   )r9   dictrB   s    r$   r;   r;          c4  r1   c                "    t        | t              S r   )r9   listrB   s    r$   r?   r?      rY   r1   c                "    t        | t              S r   )r9   r	   rB   s    r$   is_iterabler]      rN   r1   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.
    )rS   r   r   itemsdeepcopy_minimalr?   )r#   kventrys       r$   r`   r`      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    r5   r    )r<   join)seqre   rf   sizes       r$   
human_joinrn      sv    s8Dqyqy1vqya&5'3q6(++::c#2hAeWAc"gY"777r1   c                    d|  dS )zOAdd single quotation marks around the given string. Does *not* do any escaping.'r    )strings    r$   quoterr      s    vha=r1   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   r5   (and)rf   )z,Missing required arguments; Expected either z arguments to be givenr   zMissing required arguments: zMissing required argument: )set	enumerateaddr8   	TypeError__name__r<   keysallrn   rr   r[   )argskwargsi_r4   variantmatchesarg
variationsmsgmissingry   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namerx   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 Lr1   _K_Vc                     y r   r    rB   s    r$   strip_not_givenr     s    (+r1   c                     y r   r    rB   s    r$   r   r   "  s    FIr1   c                     y r   r    rB   s    r$   r   r   &  s    ,/r1   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)rS   r_   r9   r   )r@   r4   values      r$   r   r   *  sE    
{c?
),X:3Juh<WCJXXXs
   AAc                    t        | d      S )N
   )base)intvals    r$   coerce_integerr   5  s    sr1   c                    t        |       S r   )floatr   s    r$   coerce_floatr   9  s    :r1   c                (    | dk(  xs | dk(  xs | dk(  S )Ntrue1onr    r   s    r$   coerce_booleanr   =  s    &=5C3J5#+5r1   c                    | y t        |       S r   )r   r   s    r$   maybe_coerce_integerr   A      
{#r1   c                    | y t        |       S r   )r   r   s    r$   maybe_coerce_floatr   G  s    
{r1   c                    | y t        |       S r   )r   r   s    r$   maybe_coerce_booleanr   M  r   r1   c                D    | j                  |      r| t        |      d S | S )zXRemove a prefix from a string.

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

    Backport of `str.removesuffix` for Python < 3.9
    N)endswithr<   )rq   suffixs     r$   removesuffixr   ]  s(    
 vnV%%Mr1   c                z    t        |       j                         }t        j                  j	                  |       }||fS r   )r   
read_bytesosr/   basename)r/   contents	file_names      r$   file_from_pathr   g  s3    Dz$$&H  &Ix  r1   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 )Nr5   r   )groupupper)pats    r$   <lambda>z%get_required_header.<locals>.<lambda>v  s#    #))A,STI[I[I]:]r1   zCould not find z header)lowerrV   r_   r9   strresub
capitalizer   get
ValueError)headersheaderlower_headerra   rb   intercaps_headernormalized_headerr   s           r$   get_required_headerr   m  s    <<>LGMMODAqwwyL(Z3-? $
 vvn.]_e_p_p_rs$lFLLNDTU-.L V
 vhg6
77r1   c                 J    	 t        j                         S # t        $ r Y yw xY w)Nfalse)sniffiocurrent_async_library	Exceptionr    r1   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r1   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")`.
    )rS   r_   	json_safer]   r9   r   bytes	bytearrayr   r   	isoformat)datar4   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NotGivenOr[_T]r   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   )rl   r   re   r   rf   r   r   r   )rq   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)rq   r   r   r   r   r   )rq   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   )G
__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   _compatr   r   r   r   r   r   r   r   r   r%   r0   r+   rC   rG   rJ   rM   rP   rS   rV   r;   r?   r]   r`   rn   rr   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r    r1   r$   <module>r      s   " 	 	  
 
 
  # '  A A PT]
)5#5
6KwsF{';<	\&)9:
KxS'9:	7  
 # !&>	>
> 	>
 > !>B)""%%$$!!%  48d 8
HV T]T] 
 + 
 + 
 I 
 I 
 / 
 /Y6!8& (+ r1   