܎j4ddlmZddlZddlZddlZddlZddlmZmZm 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$dvdZ%dddwdZ&dxd"Z'dyd*Z(dzd-Z)d{d/Z*d|d2Z+d}d4Z,d~d7Z-dd9Z.dd<Z/dd>Z0dd@Z1ddBZ2dCdDdEddIZ3ddKZ4ddNZ5e dOZ6e dPZ7eddRZ8eddUZ8eddVZ8ddXZ8ddZZ9dd\Z:dd^Z;dd`ZddfZ?ddhZ@ddjZAddnZBddoZCdpdqddsZDdduZEdS)) annotationsN) AnyTupleMappingTypeVarCallableIterableSequencecastoverload)Path)datedatetime) TypeGuardget_args)OmitNotGiven FileTypes ArrayFormat HeadersLike_T_TupleT.)bound _MappingT _SequenceT CallableTtIterable[Iterable[_T]]returnlist[_T]cd|DS)Ncg|] }|D]}| Sr$).0sublistitems EC:\Projects\DSCons\.venv\Lib\site-packages\anthropic\_utils\_utils.py zflatten.."s% 6 6 6Wg 6 6dD 6 6 6 6r$)rs r(flattenr+!s 6 6 6 6 66r*brackets) array_formatqueryMapping[str, object]pathsSequence[Sequence[str]]r-rlist[tuple[str, FileTypes]]c bg}|D])}|t||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)r.r0r-filespaths r( extract_filesr;%sH$*,Ejj ^E4q[ghhhiiii Lr* array_indexintstrc |dkrdS|dkrd|dS|dks|dkrdStd |d d tt) Nr,z[]indices[]repeatcommazUnknown array_format value: z, choose from , )NotImplementedErrorjoinrr)r-r<s r( _array_suffixrI=sz!!ty  !;!!!!x<7#:#:r e|ee499XVaMbMbCcCcee  r*objobjectr: Sequence[str]r5r6 str | Nonec P }n#t$rt|sgcYSddlm}Jt |rkg}t |D]U\}} t |} r| zn| } || | || tt| fV|cYS||tt|fgcYSwxYwdz t|ru tddDr| |} n||} n#t$rgcYSwxYw|n d|dz t| St |r3|d krgStfd t |DSgS) Nr)assert_is_file_content)keyc3"K|] }|dkV dS)Nr$)r%ps r( z!_extract_items..qs&88a1 >888888r*rArBr4rSc hg|].\}}t|ndt|z/S)NrEr4)r8rI)r%r<r'r-r6r5r:s r(r)z"_extract_items..sg   &K*7*C}]ikvOwOww!-   r*) IndexErroris_given_filesrOis_list enumeraterIappendr ris_dictallpopKeyErrorr8r+) rJr:r5r6r-rPrOr9r<entrysuffix emitted_keyr's ```` r(r8r8Ksx75k 777}} III 433333((( 3<< 13E&/nn D D" U&|[AA:GS}v55V &&u+>>>> k4 5+A+ABCCCCLLLs 6666Y 4 456666+7. QJEs||)  884<88888 wws||3x   III    MM ZZZZ 'M  '%       )  I       *33      Is-CBC0%CC0?D00 D?>D?_T | NotGiven | Omit TypeGuard[_T]cZt|t ot|t SN) isinstancerrrJs r(rXrXs'#x(( ( FC1F1F-FFr*TypeGuard[tuple[object, ...]]c,t|tSrgrhtupleris r(is_tuplern c5 ! !!r*_TupleT | objectTypeGuard[_TupleT]c,t|tSrgrlris r( is_tuple_trsror*TypeGuard[Sequence[object]]c,t|tSrgrhr ris r( is_sequencerw c8 $ $$r*_SequenceT | objectTypeGuard[_SequenceT]c,t|tSrgrvris r( is_sequence_tr|rxr*TypeGuard[Mapping[str, object]]c,t|tSrgrhrris r( is_mappingr c7 # ##r*_MappingT | objectTypeGuard[_MappingT]c,t|tSrgrris r( is_mapping_trrr*TypeGuard[dict[object, object]]c,t|tSrg)rhdictris r(r]r] c4  r*TypeGuard[list[object]]c,t|tSrg)rhlistris r(rZrZrr*TypeGuard[Iterable[object]]c,t|tSrg)rhr ris r( is_iterablerrxr*rFor)delimfinalseqrrct|}|dkrdS|dkr|dS|dkr|dd|d|dS||ddd|d|dzS)NrrErQr )lenrH)rrrsizes r( human_joinrs s88D qyyr qyy1v  qyya&++5++3q6+++ ::c#2#h  "7e"7"7c"g"7"7 77r*stringcd|dS)zOAdd single quotation marks around the given string. Does *not* do any escaping.'r$)rs r(quoters v===r*variants Callable[[CallableT], CallableT]cdfd }|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: ... ``` funcrr ctjj}d|Dt jdfd }|S)NcBg|]\}}|j|j|jhv|Sr$)kindPOSITIONAL_ONLYPOSITIONAL_OR_KEYWORD)r%nameparams r(r)z0required_args..inner..sL   ez%+ r*argsrKkwargsr c H t t|D]g\}}  |"#t$r9t jdt dt |ddwxYw|D]} | D]!}t fd|D}|rnŌ"t dkr td D}d|d}nt d ksJtt d  z } t | dkrd td | D}nd t| d }t | |i|S) Nz () takes z argument(s) but z were givenc3 K|]}|vV dSrgr$)r%r given_paramss r(rUz@required_args..inner..wrapper..s(JJu 4JJJJJJr*rQcPg|]#}dtd|Ddzdz$S)(c,g|]}t|Sr$rr%args r(r)zLrequired_args..inner..wrapper...s*I*I*I#5::*I*I*Ir*and)r))r)r%variants r(r)zArequired_args..inner..wrapper..sAvvvbiz*I*I*I*I*IQVWWWWZ]]vvvr*z,Missing required arguments; Expected either z arguments to be givenrzMissing required arguments: c,g|]}t|Sr$rrs r(r)zArequired_args..inner..wrapper.."sHgHgHgX[sHgHgHgr*zMissing required argument: ) setr[addrW TypeError__name__rkeysr^rrr)rri_rPrmatches variationsmsgmissingrr positionalrs @r(wrapperz-required_args..inner..wrappers %(UUL!$  1  $$Z]3333!   #=kk3z??kkUXY]U^U^kkk  {{}} & &  %%%%# % %JJJJ'JJJKKEx==1$$!+vvmuvvv""JlkkkCCx==1,,,,#3x{#3#3l#BCCG7||a''jZHgHg_fHgHgHg=h=hjjOE'!*.inners"4((3  %||~~      ! )! )! )! )! )! )! )  ! )Fr*)rrr rr$)rrs` r( required_argsrs),000000d Lr*_K_VNonecdSrgr$ris r(strip_not_givenr1s(+r*Mapping[_K, _V | NotGiven] dict[_K, _V]cdSrgr$ris r(rr5sFIcr*cdSrgr$ris r(rr9s,/Cr* object | Nonech|dSt|s|Sd|DS)zHRemove all top-level keys where their values are instances of `NotGiven`NcDi|]\}}t|t||Sr$)rhrr%rPvalues r( z#strip_not_given..Es- X X X:3Juhz%get_required_header..s,#))A,,STI[I[I]I]:]r*zCould not find z header) lowerrrrhr>resub capitalizer get ValueError)rr lower_headerkvintercaps_headernormalized_headerrs r(get_required_headerrs<<>>LGMMOO  DAqwwyyL((Z3-?-?(vn.].]_e_p_p_r_rss$lFLLNNDTU -..  LLL  6v666 7 77r*cL tjS#t$rYdSwxYw)Nfalse)sniffiocurrent_async_library Exceptionr$r*r(get_async_libraryrs8,... wws  ##maxsizer cVtj|}tt|S)zmA version of functools.lru_cache that retains the type signature for the wrapped function arguments. r)r lru_cacher r)r rs r(r"r"s0!G W  r*datac:t|rd|DSt|r.t|tt t fs d|DSt|ttfr| S|S)zvTranslates a mapping / sequence recursively in the same fashion as `pydantic` v2's `model_dump(mode="json")`. cNi|]"\}}t|t|#Sr$ json_safers r(rzjson_safe..s,PPPZS% # % 0 0PPPr*c,g|]}t|Sr$r&)r%r's r(r)zjson_safe..s111D $111r*) rrrrhr>bytes bytearrayrr isoformat)r#s r(r'r's$QPP4::<<PPPP42D3y2I!J!J211D1111$4()) ~~ Kr*)rrr r!)r.r/r0r1r-rr r2)r-rr<r=r r>) rJrKr:rLr5r=r6rMr-rr r2)rJrdr re)rJrKr rj)rJrpr rq)rJrKr rt)rJryr rz)rJrKr r})rJrr r)rJrKr r)rJrKr r)rJrKr r)rrLrr>rr>r r>)rr>r r>)rrLr r)rJrr r)rJrr r)rJrKr rK)rJrr rK)rr>r r=)rr>r r)rr>r r)rrMr r)rrMr r)rrMr r)rr>rr>r r>)rr>rbr>r r>)r:r>r r)rrrr>r r>)r r>)r rr r)r#rKr rK)F __future__rrr rrtypingrrrrrr r r r pathlibr rrtyping_extensionsrrr_typesrrrrrrrKrr>rrrr+r;rIr8rXrnrsrwr|rrr]rZrrrrrrrrrrrrrrrrrrr"r'r$r*r(r1s""""""                       ########11111111HHHHHHHHHHHHHH WT]] ')5#5 6 6 6 GKwsF{'; < < < W\&)9 : : : GKxS'9 : : : 7777!+ 0    NNNNbGGGG""""""""%%%%%%%%$$$$$$$$!!!!!!!!%%%% 48d 8 8 8 8 8 8 HHHHV WT]] WT]] +++ + III I /// /YYYY6666   !!!! 8888&(+      r*