ó €k[c@sddlmZddlZddlmZmZmZmZddlm Z ddl m Z m Z ddl Zdefd„ƒYZd „Zd „Zed „Zd „Zd „Zdefd„ƒYZd„Zdefd„ƒYZd„Zd„ZdS(iÿÿÿÿ(twarnNi(torderingt ambiguitiestsuper_signaturetAmbiguityWarning(t expand_tuples(tVariadict isvariadictMDNotImplementedErrorcBseZdZRS(s- A NotImplementedError for multiple dispatch (t__name__t __module__t__doc__(((s:lib/python2.7/site-packages/multipledispatch/dispatcher.pyR scCstt|j|ƒtƒdS(sC 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(Rt warning_texttnameR(t dispatcherR((s:lib/python2.7/site-packages/multipledispatch/dispatcher.pytambiguity_warn scCstdtƒdS(s:Deprecated interface to temporarily disable ordering. s=halt_ordering is deprecated, you can safely remove this call.N(RtDeprecationWarning(((s:lib/python2.7/site-packages/multipledispatch/dispatcher.pyt halt_orderingscCstdtƒdS(s9Deprecated interface to temporarily resume ordering. srestart_ordering is deprecated, if you would like to eagerly orderthe dispatchers, you should call the ``reorder()`` method on each dispatcher.N(RR(t on_ambiguity((s:lib/python2.7/site-packages/multipledispatch/dispatcher.pytrestart_ordering'sccsœt|ƒ}t|ƒ}x}|D]5}t||ƒ}|Vt|ƒst|ƒ}qqWyt|ƒ}Wn(tk r’t|ƒsŠt‚tVnXtVdS(sjCheck if a set of input types matches a variadic signature. Notes ----- The algorithm is as follows: Initialize the current signature to the first in the sequence For each type in `types`: If the current signature is variadic If the type matches the signature yield True Else Try to get the next signature If no signatures are left we can't possibly have a match so yield False Else yield True if the type matches the current signature Get the next signature N(titertnextt issubclassRt StopIterationtAssertionErrortTruetFalse(ttypestfull_signaturetsigitertsigttyptmatches((s:lib/python2.7/site-packages/multipledispatch/dispatcher.pytvariadic_signature_matches_iter2s      cCs|s t‚tt||ƒƒS(N(RtallR!(RR((s:lib/python2.7/site-packages/multipledispatch/dispatcher.pytvariadic_signature_matches\s t DispatchercBsãeZdZdZdd„Zd„Zed „ƒZed „ƒZ d „Z e d „ƒZ e d „Zd„Zd„ZeZd„Zd„Zd„Zd„Zd„Ze d„ƒZd„Zd„Zd„Zd„ZRS(sW Dispatch methods based on type signature Use ``dispatch`` to add implementations Examples -------- >>> from multipledispatch import dispatch >>> @dispatch(int) ... def f(x): ... return x + 1 >>> @dispatch(float) ... def f(x): ... return x - 1 >>> f(3) 4 >>> f(3.0) 2.0 R R tfuncst _orderingt_cachetdoccCs/||_|_i|_||_i|_dS(N(R R R%R(R'(tselfR R(((s:lib/python2.7/site-packages/multipledispatch/dispatcher.pyt__init__zs  cs‡‡‡fd†}|S(sÞ register dispatcher with new implementation >>> 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ˆ|ˆ|S(N(tadd(tfunc(tkwargsR)R(s:lib/python2.7/site-packages/multipledispatch/dispatcher.pyt_›s((R)RR-R.((R-R)Rs:lib/python2.7/site-packages/multipledispatch/dispatcher.pytregisterscCs/ttdƒr+tj|ƒ}|jjƒSdS(Nt signature(thasattrtinspectR0t parameterstvalues(tclsR,R((s:lib/python2.7/site-packages/multipledispatch/dispatcher.pytget_func_params scsq|j|ƒ}|rmtj‰‡fd†|Dƒ}td„|Dƒƒ}t‡fd†|Dƒƒrm|SndS(s; get annotations of function positional parameters c3s0|]&}|jˆjˆjfkr|VqdS(N(tkindtPOSITIONAL_ONLYtPOSITIONAL_OR_KEYWORD(t.0tparam(t Parameter(s:lib/python2.7/site-packages/multipledispatch/dispatcher.pys ®scss|]}|jVqdS(N(t annotation(R:R;((s:lib/python2.7/site-packages/multipledispatch/dispatcher.pys ´sc3s|]}|ˆjk VqdS(N(tempty(R:tann(R<(s:lib/python2.7/site-packages/multipledispatch/dispatcher.pys ·sN(R6R2R<ttupleR"(R5R,tparamst annotations((R<s:lib/python2.7/site-packages/multipledispatch/dispatcher.pytget_func_annotations¦s  c Cs–|s'|j|ƒ}|r'|}q'ntd„|Dƒƒrhx$t|ƒD]}|j||ƒqJWdSg}xãt|ddƒD]Ï\}}t|ttfƒsÚdjd„|Dƒƒ}t d|||j fƒ‚nt|tƒrC|t |ƒkr t dƒ‚nt |ƒdkr+t d ƒ‚n|j t |d ƒq|j |ƒqW||jt|ƒ<|jjƒy |`Wntk r‘nXdS( sL Add new types/method pair to 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ƒVqdS(N(t isinstanceR@(R:R((s:lib/python2.7/site-packages/multipledispatch/dispatcher.pys ÓsNtstartis, css3|])}t|tƒr!|jn t|ƒVqdS(N(RDttypeR tstr(R:tc((s:lib/python2.7/site-packages/multipledispatch/dispatcher.pys ÜssDTried to dispatch on non-type: %s In signature: <%s> In function: %ss+Variadic signature must be the last elementsVariadic signature must contain exactly one element. To use a variadic union type place the desired types inside of a tuple, e.g., [(int, str)]i(RCtanyRR+t enumerateRDRFtlisttjoint TypeErrorR tlentappendRR%R@R'tclearR&tAttributeError( R)R0R,RBttypst new_signaturetindexRtstr_sig((s:lib/python2.7/site-packages/multipledispatch/dispatcher.pyR+ºs<        cCs*y |jSWntk r%|jƒSXdS(N(R&RQtreorder(R)((s:lib/python2.7/site-packages/multipledispatch/dispatcher.pyRüs  cCs?t|jƒ|_}t|jƒ}|r;|||ƒn|S(N(RR%R&R(R)Rtodtamb((s:lib/python2.7/site-packages/multipledispatch/dispatcher.pyRVs cOs%tg|D]}t|ƒ^q ƒ}y|j|}WnUtk r|j|Œ}|s}td|jt|ƒfƒ‚n||j|sFMatching functions for %s: <%s> found, but none completed successfully( R@RFR'tKeyErrortdispatchtNotImplementedErrorR t str_signatureRt dispatch_iterR(R)targsR-targRR,R%((s:lib/python2.7/site-packages/multipledispatch/dispatcher.pyt__call__ s.%     cCs d|jS(Ns(R (R)((s:lib/python2.7/site-packages/multipledispatch/dispatcher.pyt__str__(scGsJ||jkr|j|Syt|j|ŒƒSWntk rEdSXdS(sQDeterimine 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 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: ``multipledispatch.conflict`` - module to determine resolution order N(R%RR]RtNone(R)R((s:lib/python2.7/site-packages/multipledispatch/dispatcher.pyRZ,s   cgs¦t|ƒ}x“|jD]ˆ}t|ƒ|kr[ttt||ƒƒr[|j|}|Vqt|ƒrt|dƒrt||ƒrž|j|}|VqžqqWdS(Niÿÿÿÿ(RNRR"tmapRR%RR#(R)RtnR0tresult((s:lib/python2.7/site-packages/multipledispatch/dispatcher.pyR]Js *  cCstdtƒ|j|ŒS(s“ Deterimine appropriate implementation for this type signature .. deprecated:: 0.4.4 Use ``dispatch(*types)`` instead s-resolve() is deprecated, use dispatch(*types)(RRRZ(R)R((s:lib/python2.7/site-packages/multipledispatch/dispatcher.pytresolveVscCsi|jd6|jd6S(NR R%(R R%(R)((s:lib/python2.7/site-packages/multipledispatch/dispatcher.pyt __getstate__as cCs<|d|_|d|_t|jƒ|_tƒ|_dS(NR R%(R R%RR&tdictR'(R)td((s:lib/python2.7/site-packages/multipledispatch/dispatcher.pyt __setstate__es  cCs÷d|jg}|jr,|j|jƒng}x’|jddd…D]z}|j|}|jr°dt|ƒ}|dt|ƒd7}||jjƒ7}|j|ƒqI|jt|ƒƒqIW|rê|jddj |ƒƒndj |ƒS( NsMultiply dispatched method: %siÿÿÿÿs Inputs: <%s> t-s sOther signatures: s s ( R R(RORR%R R\RNtstripRL(R)tdocstotherRR,ts((s:lib/python2.7/site-packages/multipledispatch/dispatcher.pyR ks   cGs|jtt|ƒŒjS(N(RZRcRFR (R)R^((s:lib/python2.7/site-packages/multipledispatch/dispatcher.pyt_help‚scOs|j|ŒGHdS(s: Print docstring for the function corresponding to inputs N(Rp(R)R^R-((s:lib/python2.7/site-packages/multipledispatch/dispatcher.pythelp…scGs7|jtt|ƒŒ}|s-tdƒ‚nt|ƒS(NsNo function found(RZRcRFRMtsource(R)R^R,((s:lib/python2.7/site-packages/multipledispatch/dispatcher.pyt_source‰scOs|j|ŒGHdS(s< Print source code for the function corresponding to inputs N(Rs(R)R^R-((s:lib/python2.7/site-packages/multipledispatch/dispatcher.pyRrs(R R R%R&R'R(N(R R R t __slots__RbR*R/t classmethodR6RCR+tpropertyRRRVR`Rat__repr__RZR]RfRgRjRpRqRsRr(((s:lib/python2.7/site-packages/multipledispatch/dispatcher.pyR$bs,   B         cCs*dtj|ƒ}|tj|ƒ}|S(Ns File: %s (R2t getsourcefilet getsource(R,Ro((s:lib/python2.7/site-packages/multipledispatch/dispatcher.pyRr”stMethodDispatchercBs5eZdZdZed„ƒZd„Zd„ZRS(sP Dispatch methods based on type signature See Also: Dispatcher tobjR5cCs>ttdƒr:tj|ƒ}tj|jjƒddƒSdS(NR0i(R1R2R0titltisliceR3R4Rb(R5R,R((s:lib/python2.7/site-packages/multipledispatch/dispatcher.pyR6¢scCs||_||_|S(N(R{R5(R)tinstancetowner((s:lib/python2.7/site-packages/multipledispatch/dispatcher.pyt__get__¨s  cOsotg|D]}t|ƒ^q ƒ}|j|Œ}|s\td|jt|ƒfƒ‚n||j||ŽS(Ns%Could not find signature for %s: <%s>(R@RFRZR[R R\R{(R)R^R-R_RR,((s:lib/python2.7/site-packages/multipledispatch/dispatcher.pyR`­s %(R{R5(R R R RtRuR6R€R`(((s:lib/python2.7/site-packages/multipledispatch/dispatcher.pyRzšs  cCsdjd„|DƒƒS(sc String representation of type signature >>> str_signature((int, float)) 'int, float' s, css|]}|jVqdS(N(R (R:R5((s:lib/python2.7/site-packages/multipledispatch/dispatcher.pys ¼s(RL(R((s:lib/python2.7/site-packages/multipledispatch/dispatcher.pyR\¶scCs–d|}|d7}x3|D]+}|ddjd„|Dƒƒd7}qW|d7}|djg|D]$}d tt|ƒƒd |^qdƒ7}|S( s! The text for ambiguity warnings s. Ambiguities exist in dispatched function %s s;The following signatures may result in ambiguous behavior: s s, css#|]}dt|ƒdVqdS(t[t]N(R\(R:Ro((s:lib/python2.7/site-packages/multipledispatch/dispatcher.pys Åss s, Consider making the following additions: s s @dispatch(s ) def %s(...)(RLR\R(R RXttexttpairRo((s:lib/python2.7/site-packages/multipledispatch/dispatcher.pyR ¿s   &  2(twarningsRR2tconflictRRRRtutilsRtvariadicRRt itertoolsR|R[RRRRR!R#tobjectR$RrRzR\R (((s:lib/python2.7/site-packages/multipledispatch/dispatcher.pyts" "   * ÿ3