AXj73ddlmZddlZddlZddlZddlZddlmZmZm Z m Z m Z m Z m Z mZmZddlmZddlmZmZddlmZmZddlZddlmZmZmZmZmZe d Ze d eed f Z e d e e!ef Z"e de e Z#e de d ef Z$d;dZ%dd ddZ(d?dZ)d@dZ*dAdZ+dBdZ,dCdZ-dDdZ.dEdZ/dFdZ0dGdZ1dHdZ2d d!d"dId#Z3dJd$Z4dKd%Z5e d&Z6e d'Z7edLd(Z8edMd)Z8edNd*Z8dOd+Z8dPd,Z9dQd-Z:dRd.Z;dSd/ZdVd2Z?dWd3Z@dXd4ZAdYd5ZBdZd6ZCd7d8d[d9ZDd\d:ZEy)]) annotationsN) AnyTupleMappingTypeVarCallableIterableSequencecastoverload)Path)datedatetime) TypeGuardget_args)OmitNotGiven FileTypes ArrayFormat HeadersLike_T_TupleT.)bound _MappingT _SequenceT CallableTc@|Dcgc] }|D]}| c}}Scc}}wN)tsublistitems ]/var/www/html/content_generation/venv/lib/python3.12/site-packages/anthropic/_utils/_utils.pyflattenr%!s" ! 6WgdDgD 66 6sbrackets) array_formatc Vg}|D]!}|jt||dd|#|S)aRecursively extract files from the given dictionary based on specified paths. A path may look like this ['foo', 'files', '', 'data']. ``array_format`` controls how ```` segments contribute to the emitted field name. Supported values: ``"brackets"`` (``foo[]``), ``"repeat"`` and ``"comma"`` (``foo``), ``"indices"`` (``foo[0]``, ``foo[1]``). Note: this mutates the given dictionary. rNindex flattened_keyr')extend_extract_items)querypathsr'filespaths r$ extract_filesr2%s2$*,E ^E4q[ghi Lc |dk(ry|dk(rd|dS|dk(s|dk(rytd |d d jtt) Nr&z[]indices[]repeatcommazUnknown array_format value: z, choose from , )NotImplementedErrorjoinrr)r' array_indexs r$ _array_suffixr?=sez!y ;-q!!x<7#:  &|nN499XVaMbCcBde r3c ||}|dz }t|rK td||dDr|j|} n||} ||}n |d|dz }t| ||||St |rM|d k7rgStt |D cgc]&\}} t| ||||nd t ||z|(c} }SgS#t$rt|sgcYSddlm}|Jt |rYg}t |D]E\}} t ||} |r|| zn| } || | |j| tt| fG|cYS||||tt|fgcYSwxYw#t$rgcYSwxYwcc} }w) Nr)assert_is_file_content)keyc3&K|] }|dk( yw)Nr ).0ps r$ z!_extract_items..qs8entrysuffix emitted_keyr#s r$r-r-Ks75k0 QJEs| 84<88wws|3x  M qQZ 'M  '%     ) I*33 *8%K*7*C}]ikvOww!-*8   II 7}I 4((( 3<13E&/n" U&|[A:G}v5V &u+> k4 5+ABC '5 Ls 6Y 4566+7@ I  * s5B<,E%+E6 <E"A,E"E"!E"% E32E3cJt|t xrt|t Sr) isinstancerrrSs r$rJrJs!#x( ( FC1F-FFr3c"t|tSrrXtuplerYs r$is_tupler] c5 !!r3c"t|tSrr[rYs r$ is_tuple_tr`r^r3c"t|tSrrXr rYs r$ is_sequencerc c8 $$r3c"t|tSrrbrYs r$ is_sequence_trfrdr3c"t|tSrrXrrYs r$ is_mappingri c7 ##r3c"t|tSrrhrYs r$ is_mapping_trlrjr3c"t|tSr)rXdictrYs r$rOrO c4  r3c"t|tSr)rXlistrYs r$rLrLror3c"t|tSr)rXr rYs r$ is_iterablersrdr3r;or)delimfinalct|}|dk(ry|dk(r|dS|dk(r|dd|d|dS|j|ddd|d|dzS)Nrr:rCr )lenr=)seqrurvsizes r$ human_joinr}sv s8D qy qy1v  qya&5'3q6(++ ::c#2h AeWAc"gY"7 77r3cd|dS)zOAdd single quotation marks around the given string. Does *not* do any escaping.'r )strings r$quoters vha=r3cdfd }|S)a4Decorator 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$tjj}|jDcgc]+\}}|j|j |j hvr|-c}}tjdfd }|Scc}}w)Ncl t t|D]\}} j ||jD]} j|D]}t fd|D}|snt dkDrTtDcgc],}dt|Dcgc] }t|c}dzd z.c}}}d |d } t | t d kDsJttd  z } t | dkDr0d t| Dcgc] }t|c}} t | dt| d } t |  |i|S#t$r2t j dt dt |ddwxYwcc}wcc}}wcc}w)Nz () takes z argument(s) but z were givenc3&K|]}|v ywrr )rFparam given_paramss r$rHz@required_args..inner..wrapper..sJ'u 4'srC(and)rv)z,Missing required arguments; Expected either z arguments to be givenrzMissing required arguments: zMissing required argument: ) setrMaddrI TypeError__name__rzkeysrPr}rrq)argskwargsi_rBvariantmatchesarg variationsmsgmissingrfunc positionalvariantss @r$wrapperz-required_args..inner..wrappers%(UL!$1  $$Z]3({{}  %%$J'JK$ x=1$!+muvmubiz*I#5:*IQVWWZ]]muv"JI TjkC n$x=1,,,#3x{#3l#BCG7|a' .inners""4(33 &||~ - ezz%%++ -   ! ) ! )F] s0B )rrrrr )rrs` r$ required_argsrs,0d Lr3_K_Vcyrr rYs r$strip_not_givenr1s(+r3cyrr rYs r$rr5sFIr3cyrr rYs r$rr9s,/r3c|yt|s|S|jDcic]\}}t|tr||c}}Scc}}w)zHRemove all top-level keys where their values are instances of `NotGiven`N)rirrXr)rSrBvalues r$rr=sE { c? ), X:3Juhz%get_required_header..s##))A,STI[I[I]:]r3zCould not find z header) lowerrlrrXstrresub capitalizerget ValueError)headersheader lower_headerkvintercaps_headernormalized_headerrs r$get_required_headerrs<<>LGMMODAqwwyL(Z3-?$ vvn.]_e_p_p_rs$lFLLNDTU -. LV vhg6 77r3cJ tjS#t$rYywxYw)Nfalse)sniffiocurrent_async_library Exceptionr r3r$get_async_libraryrs(,,.. s  ""maxsizecNtj|}tt|S)zmA version of functools.lru_cache that retains the type signature for the wrapped function arguments. r)r lru_cacher r)rrs r$rrs&!!G W r3cht|r6|jDcic]\}}t|t|c}}St|r4t |t t tfs|Dcgc] }t|c}St |ttfr|jS|Scc}}wcc}w)zvTranslates a mapping / sequence recursively in the same fashion as `pydantic` v2's `model_dump(mode="json")`. ) rir json_safersrXrbytes bytearrayrr isoformat)datarBrr#s r$rrs$CG::<Prrr) rSrr1 Sequence[str]r*rr+ str | Noner'rrr)rSz_T | NotGiven | Omitrz TypeGuard[_T])rSrrzTypeGuard[tuple[object, ...]])rSz_TupleT | objectrzTypeGuard[_TupleT])rSrrzTypeGuard[Sequence[object]])rSz_SequenceT | objectrzTypeGuard[_SequenceT])rSrrzTypeGuard[Mapping[str, object]])rSz_MappingT | objectrzTypeGuard[_MappingT])rSrrzTypeGuard[dict[object, object]])rSrrzTypeGuard[list[object]])rSrrzTypeGuard[Iterable[object]])r{rrurrvrrr)rrrr)rrr Callable[[CallableT], CallableT])rSNonerr)rSzMapping[_K, _V | NotGiven]rz dict[_K, _V])rSrrr)rSz object | Nonerr)rrrr)rrrr)rrrbool)rrr int | None)rrrz float | None)rrrz bool | None)rrrrrr)rrrUrrr)r1rrr)rrrrrr)rr)rrrr)rrrr)F __future__rrrrrtypingrrrrrr r r r pathlibr rrtyping_extensionsrrr_typesrrrrrrrrrrrrr%r2r?r-rJr]r`rcrfrirlrOrLrsr}rrrrrrrrrrrrrrrrrrr r3r$r s"    #1HH T] )5#5 6 KwsF{'; < \&)9 : KxS'9 : 7!+   #   !0 N N N  N  N  N!NbG""%%$$!!% 48d 8 HV T] T] + + I I / /Y6   ! 8&(+ r3