
    ̺i/                       S SK Jr  S SKrS SKrS SKrS SKrS SKJrJrJ	r	J
r
JrJrJrJrJr  S SKJr  S SKJrJr  S SKJr  S SKrSSKJrJrJrJr  \
" S	5      r\
" S
\\S4   S9r\
" S\	\\4   S9r \
" S\\   S9r!\
" S\S\4   S9r"S9S jr#      S:S jr$          S;S jr%S<S jr&S=S jr'S>S jr(S?S jr)S@S jr*SAS jr+SBS jr,SCS jr-SDS jr.SES jr/SFS jr0SSS .SGS! jjr1SHS" jr2SIS# jr3\
" S$5      r4\
" S%5      r5\SJS& j5       r6\SKS' j5       r6\SLS( j5       r6SMS) jr6SNS* jr7SOS+ jr8SPS, jr9SQS- jr:SRS. jr;SSS/ jr<STS0 jr=SUS1 jr>SVS2 jr?SWS3 jr@SXS4 jrAS5S6.SYS7 jjrBSZS8 jrCg)[    )annotationsN)	AnyTupleMappingTypeVarCallableIterableSequencecastoverload)Path)datedatetime)	TypeGuard   )OmitNotGiven	FileTypesHeadersLike_T_TupleT.)bound	_MappingT
_SequenceT	CallableTc                H    U  VVs/ s H  o  H  o"PM     M     snn$ s  snnf N )tsublistitems      V/var/www/piano.thomer.com/venv/lib/python3.13/site-packages/anthropic/_utils/_utils.pyflattenr#   !   s"     !6WgdDgD666s   c          
     P    / nU H  nUR                  [        XSSS95        M     U$ )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^EqMN L    c                   X   nUS-  n[        U 5      (       aB   [        U5      U:X  a  U R                  U5      nOX   n Uc  UnO	USU S3-  n[        UUUUS	9$ [	        U 5      (       a6  US
:w  a  / $ [        U  Vs/ s H  n[        UUUUb  US-   OSS	9PM     sn5      $ / $ ! [          a    [        U 5      (       d  / s $ SSKJn  Uc   e[	        U 5      (       aE  / nU  H9  nU" Xs(       a  US-   OSS9  UR                  US-   [        [        U5      45        M;     Us $ U" XS9  U[        [        U 5      4/s $ f = f! [         a    / s $ f = fs  snf )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k, 
QJEs||
	D	e#wws|x  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		(s:   B%  E E >E%D?AD?#D?>D?EEc                d    [        U [        5      (       + =(       a    [        U [        5      (       + $ r   )
isinstancer   r   r@   s    r"   r8   r8      s!    #x((FC1F-FFr/   c                "    [        U [        5      $ r   rC   tuplerD   s    r"   is_tuplerH          c5!!r/   c                "    [        U [        5      $ r   rF   rD   s    r"   
is_tuple_trK      rI   r/   c                "    [        U [        5      $ r   rC   r
   rD   s    r"   is_sequencerN          c8$$r/   c                "    [        U [        5      $ r   rM   rD   s    r"   is_sequence_trQ      rO   r/   c                "    [        U [        5      $ r   rC   r   rD   s    r"   
is_mappingrT          c7##r/   c                "    [        U [        5      $ r   rS   rD   s    r"   is_mapping_trW      rU   r/   c                "    [        U [        5      $ r   )rC   dictrD   s    r"   r<   r<          c4  r/   c                "    [        U [        5      $ r   )rC   listrD   s    r"   r:   r:      rZ   r/   c                "    [        U [        5      $ r   )rC   r	   rD   s    r"   is_iterabler^      rO   r/   c                *   [        U 5      (       a=  [        [        U R                  5        VVs0 s H  u  pU[	        U5      _M     snn5      $ [        U 5      (       a*  [        [        U  Vs/ s H  n[	        U5      PM     sn5      $ U $ s  snnf s  snf )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      sw     $BDJJLILDA,Q//LIJJt}}BdCdU)%0dCDDK JCs   B
,B
z, or)delimfinalc                   [        U 5      nUS:X  a  gUS:X  a  U S   $ US:X  a  U S    SU SU S    3$ UR                  U S S 5      SU SU S    3-   $ )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                    SU  S3$ )zOAdd single quotation marks around the given string. Does *not* do any escaping.'r   )strings    r"   quoterq      s    vha=r/   c                    ^  SU 4S jjnU$ )a   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                8  >^ ^ [         R                  " T 5      R                  nUR                  5        VVs/ s H/  u  p#UR                  UR
                  UR                  1;   d  M-  UPM1     snnm[        R                  " T 5      SU UU4S jj5       nU$ s  snnf )Nc                 n  >^ [        5       m[        U 5       H  u  p# TR                  TU   5        M     UR                  5        H  nTR                  U5        M     T H!  n[        U4S jU 5       5      nU(       d  M!    O   [        T5      S:  aM  [        T VVs/ s H-  nS[        U Vs/ s H  n[        U5      PM     snSS9-   S	-   PM/     snn5      nS
U S3n	Ot[        T5      S:  d   e[        [        TS   5      T-
  5      n
[        U
5      S:  a)  S[        U
 Vs/ s H  n[        U5      PM     sn5       3n	OS[        U
S   5       3n	[	        U	5      eT" U 0 UD6$ ! [         a2    [	        TR
                   S[        T5       S[        U 5       S35      S ef = fs  snf s  snnf s  snf )Nz	() takes z argument(s) but z were givenc              3  ,   >#    U  H	  oT;   v   M     g 7fr   r   ).0paramgiven_paramss     r"   	<genexpr>@required_args.<locals>.inner.<locals>.wrapper.<locals>.<genexpr>  s     J'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"   wrapper-required_args.<locals>.inner.<locals>.wrapper   s   %(UL!$  $$Z]3 ( {{}  % % $J'JK7 $
 x=1$!+muvmubiz*I#5:*IQVWWZ]]muv"J ITjkCx=1,,, #3x{#3l#BCG7|a' <Z_fHg_fX[s_fHg=h<ij ;E'!*<M;NOn$(((9 "  #==/3z?2CCTUXY]U^T__jk   +Jv Ihs)   E(F,
.F'F,
%F2
(<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"   innerrequired_args.<locals>.inner   s    ""4(33  &||~
-zz%%++ -

 
	!	) !	) 
!	)F ]
s   ,B'B)r   r   r   r   r   )r   r   s   ` r"   required_argsr      s    ,0d Lr/   _K_Vc                    g r   r   rD   s    r"   strip_not_givenr   %  s    (+r/   c                    g r   r   rD   s    r"   r   r   )  s    FIr/   c                    g r   r   rD   s    r"   r   r   -  s    ,/r/   c                    U c  g[        U 5      (       d  U $ U R                  5        VVs0 s H  u  p[        U[        5      (       a  M  X_M      snn$ s  snnf )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:3Juh<WJCJXXXs   A	Ac                    [        U SS9$ )N
   )base)intvals    r"   coerce_integerr   <  s    sr/   c                    [        U 5      $ r   )floatr   s    r"   coerce_floatr   @  s    :r/   c                <    U S:H  =(       d    U S:H  =(       d    U S:H  $ )Ntrue1onr   r   s    r"   coerce_booleanr   D  s    &=5C3J5#+5r/   c                     U c  g [        U 5      $ r   )r   r   s    r"   maybe_coerce_integerr   H      
{#r/   c                     U c  g [        U 5      $ r   )r   r   s    r"   maybe_coerce_floatr   N  s    
{r/   c                     U c  g [        U 5      $ r   )r   r   s    r"   maybe_coerce_booleanr   T  r   r/   c                N    U R                  U5      (       a  U [        U5      S $ U $ )zPRemove 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                P    U R                  U5      (       a  U S[        U5      *  $ U $ )zPRemove 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                x    [        U 5      R                  5       n[        R                  R	                  U 5      nX!4$ r   )r   
read_bytesosr-   basename)r-   contents	file_names      r"   file_from_pathr   n  s1    Dz$$&H  &I  r/   c                   UR                  5       n[        U 5      (       aH  U R                  5        H4  u  p4UR                  5       U:X  d  M  [        U[        5      (       d  M2  Us  $    [
        R                  " SS UR                  5       5      nXUR                  5       U4 H  nU R                  U5      nU(       d  M  Us  $    [        SU S35      e)Nz([^\w])(\w)c                d    U R                  S5      U R                  S5      R                  5       -   $ )Nr4   r   )groupupper)pats    r"   <lambda>%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MMODAwwyL(Z3-?-? $
 vvn.]_e_p_p_rs$FLLNDTU-.5L V
 vhg6
77r/   c                 N     [         R                  " 5       $ ! [         a     gf = f)Nfalse)sniffiocurrent_async_library	Exceptionr   r/   r"   get_async_libraryr     s(    ,,.. s    
$$   maxsizec                J    [         R                  " U S9n[        [        U5      $ )zeA 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                   [        U 5      (       a8  U R                  5        VVs0 s H  u  p[        U5      [        U5      _M     snn$ [        U 5      (       a<  [	        U [
        [        [        45      (       d  U  Vs/ s H  n[        U5      PM     sn$ [	        U [        [        45      (       a  U R                  5       $ U $ s  snnf s  snf )znTranslates 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!J,01DD	$D11$4())~~K Q 2s   !C=C)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/   