*h/%SSKJr SSKJr SSKrSSKJrJrJrJ r SSK J r SSK r "SS\5rS r"S S 5rS r\"5rS \S'S/rSr\4Sjr"SS5rSr"SS\5rSrSrg)) annotations)warnN)ordering ambiguitiessuper_signatureAmbiguityWarning) expand_tuplesc\rSrSrSrSrg)MDNotImplementedError z,A NotImplementedError for multiple dispatch N)__name__ __module__ __qualname____firstlineno____doc____static_attributes__r^/home/mande/repo/quber/.venv/lib/python3.13/site-packages/sympy/multipledispatch/dispatcher.pyr r s7rr cL[[URU5[5 g)aRaise warning when ambiguity is detected Parameters ---------- dispatcher : Dispatcher The dispatcher on which the ambiguity was detected ambiguities : set Set of type signature pairs that are ambiguous within this dispatcher See Also: Dispatcher.add warning_text N)r warning_textnamer ) dispatcherrs rambiguity_warnrs joo{ 35EFrc$\rSrSrSrSrSrSrg)RaiseNotImplementedError!z*Raise ``NotImplementedError`` when called.cXlgNr)selfrs r__init__!RaiseNotImplementedError.__init__$s$rc[SU55n[SURR<S[ U5<S35e)Nc38# UHn[U5v M g7fr )type).0as r 4RaiseNotImplementedError.__call__..(s,t!d1ggtzAmbiguous signature for : <>)tupleNotImplementedErrorrr str_signature)r"argskwargstypess r__call__!RaiseNotImplementedError.__call__'s8,t,,! OO -"6   rr!N)rrrrrr#r5rrrrrr!s4% rrcUHOn[[U55n[[U55S:XaM1UR U[ U5[ S9 MQ g)a If super signature for ambiguous types is duplicate types, ignore it. Else, register instance of ``RaiseNotImplementedError`` for ambiguous types. Parameters ---------- dispatcher : Dispatcher The dispatcher on which the ambiguity was detected ambiguities : set Set of type signature pairs that are ambiguous within this dispatcher See Also: Dispatcher.add ambiguity_warn r on_ambiguityN)r/rlensetaddr#ambiguity_register_error_ignore_dup)rramb signatures rr=r=.sP /#./ s9~ ! #  / ;<  rzset[Dispatcher]_unresolved_dispatchersTcS[S'g)NFr)_resolverrr halt_orderingrCNs HQKrcS[S'[(a1[R5nURUS9 [(aM0gg)NTrr8)rBr@popreorder)r9rs rrestart_orderingrGRs8HQK ! !,002  5 " !rc\rSrSrSrSrSSjrSr\S5r \S5r \ 4S jr \ 4S jr S rS r\rS rSrSrSrSr\S5rSrSrSrSrSrg) DispatcherYa-Dispatch methods based on type signature Use ``dispatch`` to add implementations Examples -------- >>> from sympy.multipledispatch import dispatch >>> @dispatch(int) ... def f(x): ... return x + 1 >>> @dispatch(float) ... def f(x): # noqa: F811 ... return x - 1 >>> f(3) 4 >>> f(3.0) 2.0 )rrfuncsr_cachedocNcVU=UlUl0Ul0Ul/UlX lgr )rrrKrLrrM)r"rrMs rr#Dispatcher.__init__qs*$(( DM   rc^^^UUU4SjnU$)aRegister dispatcher with new implementation >>> from sympy.multipledispatch.dispatcher import Dispatcher >>> f = Dispatcher('f') >>> @f.register(int) ... def inc(x): ... return x + 1 >>> @f.register(float) ... def dec(x): ... return x - 1 >>> @f.register(list) ... @f.register(tuple) ... def reverse(x): ... return x[::-1] >>> f(1) 2 >>> f(1.0) 0.0 >>> f([1, 2, 3]) [3, 2, 1] c0>TR"TU40TD6 U$r )r<)funcr3r"r4s r_Dispatcher.register.._s HHUD +F +Krr)r"r4r3rSs``` rregisterDispatcher.registerxs6 rc[[S5(a0[R"U5nURR 5$g)Nr?)hasattrinspectr? parametersvaluesclsrRsigs rget_func_paramsDispatcher.get_func_paramss7 7K ( (##D)C>>((* * )rc^URU5nU(aK[RmU4SjU5n[SU55n[ U4SjU55(dU$gg)z:Get annotations of function positional parameters c3x># UH/nURTRTR4;dM+Uv M1 g7fr )kindPOSITIONAL_ONLYPOSITIONAL_OR_KEYWORD)r(param Parameters rr*2Dispatcher.get_func_annotations..s;9 00 6688es*: :c3:# UHnURv M g7fr ) annotation)r(rfs rr*rhs %#E  #sc3>># UHoTRLv M g7fr )empty)r(annrgs rr*rhsE#ioo-sN)r_rYrgr/any)r]rRparamsrrgs @rget_func_annotationsDispatcher.get_func_annotationssn$$T* ))I99F   %# %%KEEEE""F rc U(dURU5nU(aUn[SU55(a%[U5HnURXRU5 M gUHQn[ U[ 5(aMSR SU55n[SU<SU<SUR<35e X RU'URUS9 URR5 g) aAdd new types/method pair to dispatcher >>> from sympy.multipledispatch import Dispatcher >>> D = Dispatcher('add') >>> D.add((int, int), lambda x, y: x + y) >>> D.add((float, float), lambda x, y: x + y) >>> D(1, 2) 3 >>> D(1, 2.0) Traceback (most recent call last): ... NotImplementedError: Could not find signature for add: When ``add`` detects a warning it calls the ``on_ambiguity`` callback with a dispatcher/itself, and a set of ambiguous type signature pairs as inputs. See ``ambiguity_warn`` for an example. c3B# UHn[U[5v M g7fr ) isinstancer/)r(typs rr*!Dispatcher.add..s;#z#u%%sN, c3z# UH1n[U[5(a URO [U5v M3 g7fr )rtr'rstr)r(cs rr*rvs4$D9BA3=Q2E2EAJJ),Q%09Bs9;zTried to dispatch on non-type: z In signature: In function: r8) rprnr r<rtr'join TypeErrorrrKrFrLclear)r"r?rRr9rtypsrustr_sigs rr<Dispatcher.adds(33D9K'  ;; ; ;%i0\21 Cc4(())$D9B$DD"%gtyy!:;; !% 9 , / rc[S(a@[UR5Ul[UR5nU(a U"X5 gg[R U5 g)Nr)rBrrKrr@r<)r"r9r>s rrFDispatcher.reordersG A;$TZZ0DMdjj)CT' $ ' ' -rc &[UVs/sHn[U5PM sn5nURUnU"U0UD6$s snf![aN UR"U6nU(d'[ SUR <S[U5<S35eXPRU'Nef=f![ag UR"U6n[U5 UHnU"U0UD6s s$![a Mf=f [ SUR <S[U5<S35ef=f)NCould not find signature for r-r.zMatching functions for z(> found, but none completed successfully) r/r'rLKeyErrordispatchr0rr1r dispatch_iternext)r"r2r3argr4rRrKs rr5Dispatcher.__call__sD1DStCyD12 &;;u%D K(( (2 &==%(D)YY e 4677"&KK   &% K&&.E K000, &)-M%4H'JK K KsE?ABABB)D CD C#D"C##-Dc SUR-$)Nz)rr"s r__str__Dispatcher.__str__s 499,,rcXR;aURU$[UR"U65$![a gf=f)aDeterimine appropriate implementation for this type signature This method is internal. Users should call this object as a function. Implementation resolution occurs within the ``__call__`` method. >>> from sympy.multipledispatch import dispatch >>> @dispatch(int) ... def inc(x): ... return x + 1 >>> implementation = inc.dispatch(int) >>> implementation(3) 4 >>> print(inc.dispatch(float)) None See Also: ``sympy.multipledispatch.conflict`` - module to determine resolution order N)rKrr StopIterationr"r4s rrDispatcher.dispatchsJ, JJ ::e$ $ **E23 3  s8 AAc'# [U5nURHGn[U5U:XdM[[[X55(dM4UR UnUv MI g7fr )r:rallmap issubclassrK)r"r4nr?results rrDispatcher.dispatch_iter#sL JI9~"s3z5+L'M'MI. 's(A&A&A&c@[S[5 UR"U6$)zzDeterimine appropriate implementation for this type signature .. deprecated:: 0.4.4 Use ``dispatch(*types)`` instead z-resolve() is deprecated, use dispatch(*types))rDeprecationWarningrrs rresolveDispatcher.resolve*s# <  !}}e$$rc4URURS.$)NrrKrrs r __getstate__Dispatcher.__getstate__5s % %rcnUSUlUSUl[UR5Ul0Ulg)NrrK)rrKrrL)r"ds r __setstate__Dispatcher.__setstate__9s/fI wZ  ,  rc<SUR-/nUR(aURUR5 /nURSSS2HnURUnUR (aQS[ U5-nUS[U5-S-- nXTR R5- nURU5 MtUR[ U55 M U(a#URSSRU5-5 SRU5$) NzMultiply dispatched method: %sz Inputs: <%s> - zOther signatures: z  ) rrMappendrrKrr1r:stripr{)r"docsotherr^rRss rrDispatcher.__doc__?s0499<= 88 KK !==2&C::c?D||$}S'99S3q6\D((\\'')) A ]3/0'  KK1HMM%4HH I{{4  rcPUR"[[U56R$r )rrr'r)r"r2s r_helpDispatcher._helpVs}}c$o.666rc4[UR"U65 g)z9Print docstring for the function corresponding to inputs N)printrr"r2r3s rhelpDispatcher.helpYs djj$ rcvUR"[[U56nU(d [S5e[ U5$)NzNo function found)rrr'r|source)r"r2rRs r_sourceDispatcher._source]s/}}c$o./0 0d|rc4[UR"U65 g)z;Print source code for the function corresponding to inputs N)rrrs rrDispatcher.sourcecs dllD!"r)rrLrMrKrrr )rrrrr __slots__r#rU classmethodr_rprr<rFr5r__repr__rrrrrpropertyrrrrrrrrrIrIYs*II@++ ##&1?*X$2.K4-H< %% !!,7! #rrIcjS[R"U5-nU[R"U5-nU$)Nz File: %s )rY getsourcefile getsource)rRrs rrrhs1..t44A G  d ##A Hrc4\rSrSrSr\S5rSrSrSr g)MethodDispatcherinzCDispatch methods based on type signature See Also: Dispatcher c[[S5(aF[R"U5n[R"UR R 5SS5$g)Nr?r)rXrYr?itlislicerZr[r\s rr_ MethodDispatcher.get_func_paramsusD 7K ( (##D)C::cnn335q$? ? )rcXlX lU$r )objr])r"instanceowners r__get__MethodDispatcher.__get__{s rc[UVs/sHn[U5PM sn5nUR"U6nU(d'[SUR<S[ U5<S35eU"UR /UQ70UD6$s snf)Nrr-r.)r/r'rr0rr1r)r"r2r3rr4rRs rr5MethodDispatcher.__call__sqD1DStCyD12}}e$%'+yy-2F'HI IDHH.t.v.. 2sA9)r]rN) rrrrrrr_rr5rrrrrrns' @@  /rrc2SRSU55$)zString representation of type signature >>> from sympy.multipledispatch.dispatcher import str_signature >>> str_signature((int, float)) 'int, float' rwc38# UHoRv M g7fr )r)r(r]s rr* str_signature..s1Sc\\Sr,)r{)r^s rr1r1s 991S1 11rc SU-nUS- nUH$nUSSRSU55-S-- nM& US- nUSRUVs/sH nS [[U55-S U--PM" sn5- nU$s snf) z The text for ambiguity warnings z. Ambiguities exist in dispatched function %s z;The following signatures may result in ambiguous behavior:  rwc3D# UHnS[U5-S-v M g7f)[]N)r1)r(rs rr*warning_text..sADqcM!,,s2Ds rz, Consider making the following additions: rz @dispatch(z ) def %s(...))r{r1r)rr>textpairrs rrrs >$ GD JJD  IIADA ABDHI I >>DFKKrs"NN 8/8 G"    8,/50 6#16L#L#^ /z/62 r