ó ÔËÞKc@s>dZddlmZddlZddlmZddlZddlmZddl m Z dZ dZ d Z eƒZd „Zd „Zd efd „ƒYZdefd„ƒYZeZyddlmZWnek ränXeƒZdefd„ƒYZeZyddlmZWnek r1nXgZyddlmZWnek r_nXdefd„ƒYZdeeefd„ƒYZedddƒZdefd„ƒYZdefd„ƒYZe d e d!„Z!e e d"„Z"d#„Z#dd$l$m%Z%dd%l$m&Z&dd&lm'Z'dd'lm(Z(dS((s Interface object implementation iÿÿÿÿ(t generatorsN(t FunctionType(tInvalid(troiit__interface_tagged_values__cCsGtjdƒj}|jtiƒ}|jdgƒ}|j|ƒtS(Nit invariants(tsyst _getframetf_localst setdefaultt TAGGED_DATAtappendt_decorator_non_return(tcallRttagsR((s</usr/lib/python2.7/dist-packages/zope/interface/interface.pyt invariant s  cCs2tjdƒj}|jtiƒ}|||>> from zope.interface import * >>> class I1(Interface): ... pass >>> class C(object): ... implements(I1) >>> c = C() >>> class X(object): ... pass >>> x = X() >>> I1.providedBy(x) False >>> I1.providedBy(C) False >>> I1.providedBy(c) True >>> directlyProvides(x, I1) >>> I1.providedBy(x) True >>> directlyProvides(C, I1) >>> I1.providedBy(C) True (t providedByt_implied(Rtobtspec((s</usr/lib/python2.7/dist-packages/zope/interface/interface.pyR*\s cCst|ƒ}||jkS(s‹Test whether the specification is implemented by a class or factory. Raise TypeError if argument is neither a class nor a callable.(t implementedByR+(RtclsR-((s</usr/lib/python2.7/dist-packages/zope/interface/interface.pyR.ys cCs ||jkS(sIs the interface the same as or extend the given interface Examples:: >>> from zope.interface import Interface >>> from zope.interface.declarations import Declaration >>> class I1(Interface): pass ... >>> class I2(I1): pass ... >>> class I3(Interface): pass ... >>> class I4(I3): pass ... >>> spec = Declaration() >>> int(spec.extends(Interface)) 1 >>> spec = Declaration(I2) >>> int(spec.extends(Interface)) 1 >>> int(spec.extends(I1)) 1 >>> int(spec.extends(I2)) 1 >>> int(spec.extends(I3)) 0 >>> int(spec.extends(I4)) 0 (R+(Rt interface((s</usr/lib/python2.7/dist-packages/zope/interface/interface.pyt isOrExtendss(RR(R*R.R1t__call__(((s</usr/lib/python2.7/dist-packages/zope/interface/interface.pyR)Zs   !(tSpecificationBasetInterfaceBasePycBs#eZdZed„Zd„ZRS(s:Base class that wants to be replaced with a C base :) cCs…t|ddƒ}|dk r@|j|ƒ}|dk r@|Sn|j|ƒ}|dk r_|S|tk ro|Std||ƒ‚dS(s)Adapt an object to the interface t __conform__sCould not adaptN(tgetattrRt _call_conformt __adapt__t_markert TypeError(Rtobjt alternatetconformtadapter((s</usr/lib/python2.7/dist-packages/zope/interface/interface.pyR2­s    cCsG|j|ƒr|Sx-tD]%}|||ƒ}|dk r|SqWdS(s(Adapt an object to the reciever N(R*t adapter_hooksR(RR;thookR>((s</usr/lib/python2.7/dist-packages/zope/interface/interface.pyR8¿s   (RR(RR9R2R8(((s</usr/lib/python2.7/dist-packages/zope/interface/interface.pyR4©s (t InterfaceBase(R?t SpecificationcBseZdZejZejZd d„Zd„Zd„Zd„Z e d„e ƒZ d„Z d„Z ed„Zd d „Zd d „ZRS( sISpecifications An interface specification is used to track interface declarations and component registrations. This class is a base class for both interfaces themselves and for interface specifications (declarations). Specifications are mutable. If you reassign their cases, their relations with other specifications are adjusted accordingly. For example: >>> from zope.interface import Interface >>> class I1(Interface): ... pass >>> class I2(I1): ... pass >>> class I3(I2): ... pass >>> [i.__name__ for i in I1.__bases__] ['Interface'] >>> [i.__name__ for i in I2.__bases__] ['I1'] >>> I3.extends(I1) 1 >>> I2.__bases__ = (Interface, ) >>> [i.__name__ for i in I2.__bases__] ['Interface'] >>> I3.extends(I1) 0 cCs+i|_tjƒ|_t|ƒ|_dS(N(R+tweakreftWeakKeyDictionaryt dependentsttuplet __bases__(Rtbases((s</usr/lib/python2.7/dist-packages/zope/interface/interface.pyRs cCs$|jj|dƒd|j|%scCs÷y |`Wntk rnX|j}|jƒt|ƒ}y t|kr\|jtƒnWntk rpnXt|ƒ|_ tg|D]}t |t ƒrŠ|^qŠƒ|_ x|D]}d||>> from zope.interface import Interface >>> class I1(Interface): pass ... >>> class I2(I1): pass ... >>> class I3(Interface): pass ... >>> class I4(I3): pass ... >>> spec = Specification((I2, I3)) >>> spec = Specification((I4, spec)) >>> i = spec.interfaces() >>> [x.getName() for x in i] ['I4', 'I2', 'I3'] >>> list(i) [] iN(RGt interfaces(RtseentbaseR0((s</usr/lib/python2.7/dist-packages/zope/interface/interface.pyR`Js   cCs ||jko| p||kS(sòDoes the specification extend the given interface? Test whether an interface in the specification extends the given interface Examples:: >>> from zope.interface import Interface >>> from zope.interface.declarations import Declaration >>> class I1(Interface): pass ... >>> class I2(I1): pass ... >>> class I3(Interface): pass ... >>> class I4(I3): pass ... >>> spec = Declaration() >>> int(spec.extends(Interface)) 1 >>> spec = Declaration(I2) >>> int(spec.extends(Interface)) 1 >>> int(spec.extends(I1)) 1 >>> int(spec.extends(I2)) 1 >>> int(spec.extends(I3)) 0 >>> int(spec.extends(I4)) 0 >>> I2.extends(I2) 0 >>> I2.extends(I2, False) 1 >>> I2.extends(I2, strict=False) 1 (R+(RR0tstrict((s</usr/lib/python2.7/dist-packages/zope/interface/interface.pytextendshs(cCstj||ƒS(N(RCtref(Rtcallback((s</usr/lib/python2.7/dist-packages/zope/interface/interface.pyRC•scCs¡y |j}Wntk r-i}|_nX|j|ƒ}|dkr‰x=|jD]/}|j|ƒ}|dk rS|||>> from zope.interface import Interface >>> class I1(Interface): pass ... >>> >>> i = I1.interfaces() >>> [x.getName() for x in i] ['I1'] >>> list(i) [] N((R((s</usr/lib/python2.7/dist-packages/zope/interface/interface.pyR`õscCs|jS(N(RG(R((s</usr/lib/python2.7/dist-packages/zope/interface/interface.pytgetBasesscCs||kp|j|ƒS(sSame interface or extends?(Rd(Rtother((s</usr/lib/python2.7/dist-packages/zope/interface/interface.pytisEqualOrExtendedBy scCs_|s|jjƒS|jjƒ}x0|jD]%}|jtj|j|ƒƒƒq,W|jƒS(s4Return the attribute names defined by the interface.(RwR%tcopyRGtupdatetdicttfromkeystnames(RtalltrRb((s</usr/lib/python2.7/dist-packages/zope/interface/interface.pyRƒ s  #cCst|jdtƒƒS(NR„(titerRƒRn(R((s</usr/lib/python2.7/dist-packages/zope/interface/interface.pyt__iter__scCsp|s|jjƒSi}x:|jddd…D]"}|jt|j|ƒƒƒq0W|j|jƒ|jƒS(s=Return attribute names and descriptions defined by interface.Niÿÿÿÿ(RwRtRGR€RtnamesAndDescriptions(RR„R…Rb((s</usr/lib/python2.7/dist-packages/zope/interface/interface.pyRˆs  cCs/|j|ƒ}|dk r|St|ƒ‚dS(s4Return the attribute description for the given name.N(R"RRK(RRhR…((s</usr/lib/python2.7/dist-packages/zope/interface/interface.pytgetDescriptionFor)s cCs|j|ƒdk S(N(R"R(RRh((s</usr/lib/python2.7/dist-packages/zope/interface/interface.pyt __contains__3scCs|jj|ƒS(N(RwR"(RRh((s</usr/lib/python2.7/dist-packages/zope/interface/interface.pyRg6scCs|j||ƒS(N(R"(RRhR#((s</usr/lib/python2.7/dist-packages/zope/interface/interface.pytqueryDescriptionFor9scBsRe|dƒr|jSi}d|j|U||j}|j|ƒ||_|S(s6Return a defered class corresponding to the interface.t _deferredsclass %s: pass(thasattrRŒRt_InterfaceClass__d(Rtklass((s</usr/lib/python2.7/dist-packages/zope/interface/interface.pytdeferred<s   cCsÇx]|jdgƒD]I}y||ƒWqtk r[}|dkrK‚q\|j|ƒqXqWxK|jD]@}y|j||ƒWqjtk r©|dkrª‚qªqjXqjW|rÃt|ƒ‚ndS(s&validate object to defined invariants.RN(R$RRR RGtvalidateInvariants(RR;terrorsR teRb((s</usr/lib/python2.7/dist-packages/zope/interface/interface.pyR‘Js   cCsdS(sRetrieve a named interface.N(R(RR,Rh((s</usr/lib/python2.7/dist-packages/zope/interface/interface.pyt _getInterface]scCsvxN|jjƒD]=\}}t|tƒr||jkrt|||ƒqqWx|jD]}|j|ƒq[WdS(N(RwRtRYtMethodRNtsetattrRGRŽ(RRtktvRP((s</usr/lib/python2.7/dist-packages/zope/interface/interface.pyt__das cCsny |jSWn\tk ri|j}|j}|rFd||f}nd|jj|f}||_|SXdS(Ns%s.%ss<%s %s>(t_v_reprRTRR(t __class__(RRhtmR…((s</usr/lib/python2.7/dist-packages/zope/interface/interface.pyt__repr__is     cCsEy||ƒSWn0tk r@tjƒdjdk rA‚qAnXdS(Ni(R:Rtexc_infottb_nextR(RR=((s</usr/lib/python2.7/dist-packages/zope/interface/interface.pyR7us   cCs|jS(N(R(R((s</usr/lib/python2.7/dist-packages/zope/interface/interface.pyt __reduce__ˆscCs¤||krdS|dkr dS|dkr0dSt|ddƒtt|ddƒddƒf}t|ddƒtt|ddƒddƒf}||k||kS(súMake interfaces sortable TODO: It would ne nice if: More specific interfaces should sort before less specific ones. Otherwise, sort on name and module. But this is too complicated, and we're going to punt on it for now. For now, sort on interface and module name. None is treated as a pseudo interface that implies the loosest contact possible, no contract. For that reason, all interfaces sort before None. iiiÿÿÿÿRRR(N(RR6(Rto1to2tn1tn2((s</usr/lib/python2.7/dist-packages/zope/interface/interface.pyt__cmp‹s   !!cCs|j||ƒ}|dkS(Ni(t_InterfaceClass__cmp(RR}tc((s</usr/lib/python2.7/dist-packages/zope/interface/interface.pyt__lt__°scCs|j||ƒ}|dkS(Ni(R¦(RR}R§((s</usr/lib/python2.7/dist-packages/zope/interface/interface.pyt__gt__µs(N(RR(RRRR`R|R~tFalseRƒR‡RˆR‰t __getitem__RŠRgR‹RR‘R”RŽRR7R R¦R¨R©(((s</usr/lib/python2.7/dist-packages/zope/interface/interface.pyRZ¬s0  @               % RVR(szope.interfaceRrcBseZdZdZRS(sAttribute descriptions N(RR(RRR0(((s</usr/lib/python2.7/dist-packages/zope/interface/interface.pyRr½sR•cBs)eZdZd„Zd„Zd„ZRS(sŽMethod interfaces The idea here is that you have objects that describe methods. This provides an opportunity for rich meta-data. cOst|j|jƒ‚dS(N(tBrokenImplementationR0R(Rtargstkw((s</usr/lib/python2.7/dist-packages/zope/interface/interface.pyR2ÕscCs6i|jd6|jd6|jd6|jd6|jd6S(Nt positionaltrequiredtoptionaltvarargstkwargs(R¯R°R±R²R³(R((s</usr/lib/python2.7/dist-packages/zope/interface/interface.pytgetSignatureInfoØs     cCs¬g}xR|jD]G}|j|ƒ||jjƒkr|dcd|j| 7sX     *H  "  Óÿ %-