o o╟h┬/у@s▐UddlmZddlmZddlZddlmZmZmZm Z ddl mZddlZ GddДdeГZd d ДZGddДdГZd dДZeГZded<dgZddДZefddДZGddДdГZddДZGddДdeГZddДZddДZdS) щ)┌annotations)┌warnNщ)┌ordering┌ambiguities┌super_signature┌AmbiguityWarning)┌ expand_tuplesc@seZdZdZdS)┌MDNotImplementedErrorz- A NotImplementedError for multiple dispatch N)┌__name__┌ __module__┌__qualname__┌__doc__йrr·u/var/www/html/construction_image-detection-poc/venv/lib/python3.10/site-packages/sympy/multipledispatch/dispatcher.pyr sr cCstt|j|ГtГdS)aC Raise 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_text┌namer)┌ dispatcherrrrr┌ambiguity_warnsrc@s eZdZdZddДZddДZdS)┌RaiseNotImplementedErrorz*Raise ``NotImplementedError`` when called.cCs ||_dSйN)r)┌selfrrrr┌__init__$є z!RaiseNotImplementedError.__init__cOs*tddД|DГГ}td|jjt|ГfГВ)NcssБ|]}t|ГVqdSrй┌type)┌.0┌arrr┌ (sАz4RaiseNotImplementedError.__call__..z Ambiguous signature for %s: <%s>)┌tuple┌NotImplementedErrorrr┌ str_signature)r┌args┌kwargs┌typesrrr┌__call__'s z!RaiseNotImplementedError.__call__N)rrr rrr%rrrrr!srcCs@|D]}tt|ГГ}tt|ГГdkrq|j|t|ГtdНqdS)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)rr┌len┌set┌addr┌#ambiguity_register_error_ignore_dup)rr┌amb┌ signaturerrrr+.s■№r+zset[Dispatcher]┌_unresolved_dispatchersTcCsdtd<dS)NFr)┌_resolverrrr┌ halt_orderingNsr0cCs,dtd<trtаб}|j|dНtsdSdS)NTrr&)r/r.┌pop┌reorder)r'rrrr┌restart_orderingRs ■r3c@s╛eZdZdZdZd(ddДZddДZedd ДГZed dДГZ e fdd ДZe fddДZddДZ ddДZeZddДZddДZddДZddДZddДZeddДГZd d!ДZd"d#ДZd$d%ДZd&d'ДZdS))┌ Dispatcheraj 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 )rr┌funcsr┌_cache┌docNcCs(||_|_i|_i|_g|_||_dSr)rrr5r6rr7)rrr7rrrrqs zDispatcher.__init__csЗЗЗfddД}|S)a# Register 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] csИjИ|fiИдО|Sr)r*)┌funcйr#rr$rr┌_УszDispatcher.register.._r)rr$r#r:rr9r┌registerxszDispatcher.registercCs"ttdГrtа|б}|jабSdS)Nr-)┌hasattr┌inspectr-┌ parameters┌valuesй┌clsr8┌sigrrr┌get_func_paramsШs ■zDispatcher.get_func_paramscsZ|а|б}|r)tjЙЗfddД|DГ}tddД|DГГ}tЗfddД|DГГs+|SdSdS)z; Get annotations of function positional parameters c3s&Б|]}|jИjИjfvr|VqdSr)┌kind┌POSITIONAL_ONLY┌POSITIONAL_OR_KEYWORDйr┌paramй┌ ParameterrrrжsА z2Dispatcher.get_func_annotations..csєБ|]}|jVqdSr)┌ annotationrGrrrrлs А c3sБ|]}|ИjuVqdSr)┌empty)r┌annrIrrrпєАN)rCr=rJr┌any)rAr8┌paramsrrrIr┌get_func_annotationsЮs ■єzDispatcher.get_func_annotationscCsи|s|а|б}|r|}tddД|DГГr$t|ГD] }|а|||бqdS|D]}t|tГsAdаddД|DГб}td|||jfГВq&||j |<|j |dН|jабdS)aЖ Add 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. cssБ|]}t|tГVqdSr)┌ isinstancer)r┌typrrrr╠rOz!Dispatcher.add..N·, css(Б|]}t|tГr|jnt|ГVqdSr)rSrr┌str)r┌crrrr╙sА zDTried to dispatch on non-type: %s In signature: <%s> In function: %sr&) rRrPr r*rSr┌join┌ TypeErrorrr5r2r6┌clear)rr-r8r'r┌typsrT┌str_sigrrrr*▓s( ¤¤ zDispatcher.addcCsBtdrt|jГ|_t|jГ}|r|||ГdSdStа|бdS)Nr)r/rr5rr.r*)rr'r,rrrr2▐s zDispatcher.reordercOs▐tddД|DГГ}z|j|}Wn ty0|j|О}|s)td|jt|ГfГВ||j|<Ynwz||i|дОWStyn|j|О}t |Г|D]}z||i|дОWYStybYqKwtd|jt|ГfГВw)NcSєg|]}t|ГСqSrrйr┌argrrr┌ шєz'Dispatcher.__call__..·%Could not find signature for %s: <%s>zFMatching functions for %s: <%s> found, but none completed successfully) rr6┌KeyError┌dispatchr rr!r ┌ dispatch_iter┌next)rr"r#r$r8r5rrrr%чs8 · ■°zDispatcher.__call__cCs d|jS)Nzйrйrrrr┌__str__rzDispatcher.__str__cGs:||jvr |j|Szt|j|ОГWStyYdSw)a` Deterimine 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)r5rfre┌ StopIterationйrr$rrrrds zDispatcher.dispatchcgsFБt|Г}|jD]}t|Г|kr ttt||ГГr |j|}|VqdSr)r(r┌all┌map┌ issubclassr5)rr$┌nr-┌resultrrrre#sА А¤zDispatcher.dispatch_itercCstdtГ|j|ОS)zУ Deterimine appropriate implementation for this type signature .. deprecated:: 0.4.4 Use ``dispatch(*types)`` instead z-resolve() is deprecated, use dispatch(*types))r┌DeprecationWarningrdrkrrr┌resolve*s zDispatcher.resolvecCs|j|jdЬS)Nйrr5rsrhrrr┌__getstate__5s zDispatcher.__getstate__cCs*|d|_|d|_t|jГ|_i|_dS)Nrr5)rr5rr6)r┌drrr┌__setstate__9s zDispatcher.__setstate__cCs▓d|jg}|jr|а|jбg}|jdddЕD].}|j|}|jr@dt|Г}|dt|Гd7}||jаб7}|а|бq|аt|Гбq|rT|аddа |ббdа |бS) NzMultiply dispatched method: %sщ z Inputs: <%s> ·-┌ zOther signatures: z · ) rr7┌appendrr5rr!r(┌striprX)r┌docs┌otherrBr8┌srrrr?s zDispatcher.__doc__cGs|jtt|ГОjSr)rdrmrr)rr"rrr┌_helpVszDispatcher._helpcOєt|j|ОГdS)z: Print docstring for the function corresponding to inputs N)┌printrАйrr"r#rrr┌helpYєzDispatcher.helpcGs$|jtt|ГО}|stdГВt|ГS)NzNo function found)rdrmrrY┌source)rr"r8rrr┌_source]szDispatcher._sourcecOrБ)z< Print source code for the function corresponding to inputs N)rВrЗrГrrrrЖcrЕzDispatcher.sourcer)rrr r┌ __slots__rr;┌classmethodrCrRrr*r2r%ri┌__repr__rdrerrrtrv┌propertyrАrДrЗrЖrrrrr4Ys2 , r4cCs dtа|б}|tа|б}|S)Nz File: %s )r=┌ getsourcefile┌ getsource)r8rrrrrЖhsrЖc@s,eZdZdZeddДГZddДZddДZdS) ┌MethodDispatcherzP Dispatch methods based on type signature See Also: Dispatcher cCs,ttdГrtа|б}tа|jабddбSdS)Nr-r)r<r=r-┌itl┌islicer>r?r@rrrrCus ■z MethodDispatcher.get_func_paramscCs||_||_|Sr)┌objrA)r┌instance┌ownerrrr┌__get__{szMethodDispatcher.__get__cOsNtddД|DГГ}|j|О}|std|jt|ГfГВ||jg|вRi|дОS)NcSr]rrr^rrrr`Бraz-MethodDispatcher.__call__..rb)rrdr rr!rС)rr"r#r$r8rrrr%Аs zMethodDispatcher.__call__N)rrr rrЙrCrФr%rrrrrОns rОcCsdаddД|DГбS)zз String representation of type signature >>> from sympy.multipledispatch.dispatcher import str_signature >>> str_signature((int, float)) 'int, float' rUcsrKr)r)rrArrrrРsАz str_signature..йrX)rBrrrr!Йsr!csbdИ}|d7}|D]}|ddаddД|DГбd7}q |d7}|d аЗfd dД|DГб7}|S)z! The text for ambiguity warnings z. Ambiguities exist in dispatched function %s z;The following signatures may result in ambiguous behavior: · rUcss Б|]}dt|ГdVqdS)·[·]N)r!йrrrrrrЩsАzwarning_text..ryz, Consider making the following additions: rzcs$g|]}dtt|ГГdИСqS)z @dispatch(z ) def %s(...))r!rrЩrgrrr`Ыs z warning_text..rХ)rr,┌text┌pairrrgrrУs r)┌ __future__r┌warningsrr=┌conflictrrrr┌utilsr ┌ itertoolsrПr r rrr+r)r.┌__annotations__r/r0r3r4rЖrОr!rrrrr┌s*