ó ÔËÞKc@sødZdZddlZddlZddlmZmZddlmZddlm Z m Z m Z ddl m Z iZdefd „ƒYZd efd „ƒYZd „ZeZd „Zd„Zd„Zdd2d„ƒYZdd3d„ƒYZd„Zd„Zd„Zdefd„ƒYZeZejƒZd„Zee_ y ddlm!Z!e!e"fZ#Wne$k r‰e"fZ#nXd„Z%d„Z&d„Z'de(fd„ƒYZ)e)Z*yddl+Z+Wne$k ränXdd l+m*Z*d!ee*fd"„ƒYZ,d#„Z-d$„Z.d%„Z/d&d4d'„ƒYZ0d(„Z1d)„Z2d*„Z3d+„Z4d,e(fd-„ƒYZ5e5Z6dd.„Z8eƒZ9yddl+Z+Wne$k r´n7Xdd/l+mZm4Z4dd0l+m3Z3dd1l+m6Z6e6ƒZ:dS(5sëImplementation of interface declarations There are three flavors of declarations: - Declarations are used to simply name declared interfaces. - ImplementsDeclarations are used to express the interfaces that a class implements (that instances of the class provides). Implements specifications support inheriting interfaces. - ProvidesDeclarations are used to express interfaces directly provided by objects. $Id: declarations.py 110736 2010-04-11 10:59:30Z regebro $ trestructuredtextiÿÿÿÿN(tInterfaceClasst Specification(tSpecificationBase(t ModuleTypet MethodTypet FunctionType(taddClassAdvisort DeclarationcBsSeZdZd„Zd„Zd„Zd„Zd„Zd„Zd„Z e Z RS(sInterface declarationscGstj|t|ƒƒdS(N(Rt__init__t_normalizeargs(tselft interfaces((s?/usr/lib/python2.7/dist-packages/zope/interface/declarations.pyR ,scCs2tj||ƒy |`Wntk r-nXdS(N(Rtchangedt_v_attrstAttributeError(R toriginally_changed((s?/usr/lib/python2.7/dist-packages/zope/interface/declarations.pyR /s   cCs|j|ƒo||jƒkS(sJTest whether an interface is in the specification for example: >>> from zope.interface import Interface >>> class I1(Interface): pass ... >>> class I2(I1): pass ... >>> class I3(Interface): pass ... >>> class I4(I3): pass ... >>> spec = Declaration(I2, I3) >>> spec = Declaration(I4, spec) >>> int(I1 in spec) 0 >>> int(I2 in spec) 1 >>> int(I3 in spec) 1 >>> int(I4 in spec) 1 (textendsR (R t interface((s?/usr/lib/python2.7/dist-packages/zope/interface/declarations.pyt __contains__6scCs |jƒS(s/Return an iterator for the interfaces in the specification for example: >>> from zope.interface import Interface >>> class I1(Interface): pass ... >>> class I2(I1): pass ... >>> class I3(Interface): pass ... >>> class I4(I3): pass ... >>> spec = Declaration(I2, I3) >>> spec = Declaration(I4, spec) >>> i = iter(spec) >>> [x.getName() for x in i] ['I4', 'I2', 'I3'] >>> list(i) [] (R (R ((s?/usr/lib/python2.7/dist-packages/zope/interface/declarations.pyt__iter__QscCs t|jƒS(sIReturn an iterator of all included and extended interfaces for example: >>> from zope.interface import Interface >>> class I1(Interface): pass ... >>> class I2(I1): pass ... >>> class I3(Interface): pass ... >>> class I4(I3): pass ... >>> spec = Declaration(I2, I3) >>> spec = Declaration(I4, spec) >>> i = spec.flattened() >>> [x.getName() for x in i] ['I4', 'I2', 'I1', 'I3', 'Interface'] >>> list(i) [] (titert__iro__(R ((s?/usr/lib/python2.7/dist-packages/zope/interface/declarations.pyt flattenediscCsTtg|jƒD]=}g|jƒD]}|j|dƒr#|^q#s|^qŒS(sÎRemove interfaces from a specification Examples: >>> from zope.interface import Interface >>> class I1(Interface): pass ... >>> class I2(I1): pass ... >>> class I3(Interface): pass ... >>> class I4(I3): pass ... >>> spec = Declaration() >>> [iface.getName() for iface in spec] [] >>> spec -= I1 >>> [iface.getName() for iface in spec] [] >>> spec -= Declaration(I1, I2) >>> [iface.getName() for iface in spec] [] >>> spec = Declaration(I2, I4) >>> [iface.getName() for iface in spec] ['I2', 'I4'] >>> [iface.getName() for iface in spec - I4] ['I2'] >>> [iface.getName() for iface in spec - I1] ['I4'] >>> [iface.getName() for iface ... in spec - Declaration(I3, I4)] ['I2'] i(RR R(R tothertitj((s?/usr/lib/python2.7/dist-packages/zope/interface/declarations.pyt__sub__‚s$cCsi}g}x:|jƒD],}||krd||<|j|ƒqqWx:|jƒD],}||krVd||<|j|ƒqVqVWt|ŒS(sAdd two specifications or a specification and an interface Examples: >>> from zope.interface import Interface >>> class I1(Interface): pass ... >>> class I2(I1): pass ... >>> class I3(Interface): pass ... >>> class I4(I3): pass ... >>> spec = Declaration() >>> [iface.getName() for iface in spec] [] >>> [iface.getName() for iface in spec+I1] ['I1'] >>> [iface.getName() for iface in I1+spec] ['I1'] >>> spec2 = spec >>> spec += I1 >>> [iface.getName() for iface in spec] ['I1'] >>> [iface.getName() for iface in spec2] [] >>> spec2 += Declaration(I3, I4) >>> [iface.getName() for iface in spec2] ['I3', 'I4'] >>> [iface.getName() for iface in spec+spec2] ['I1', 'I3', 'I4'] >>> [iface.getName() for iface in spec2+spec] ['I3', 'I4', 'I1'] i(R tappendR(R RtseentresultR((s?/usr/lib/python2.7/dist-packages/zope/interface/declarations.pyt__add__­s%    ( t__name__t __module__t__doc__R R RRRRRt__radd__(((s?/usr/lib/python2.7/dist-packages/zope/interface/declarations.pyR)s      + 2t ImplementscBs,eZdZdZdZd„Zd„ZRS(t?cCs d|jS(Ns(R (R ((s?/usr/lib/python2.7/dist-packages/zope/interface/declarations.pyt__repr__òscCst|jffS(N(t implementedBytinherit(R ((s?/usr/lib/python2.7/dist-packages/zope/interface/declarations.pyt __reduce__õsN((R R!tNoneR(tdeclaredR&R)(((s?/usr/lib/python2.7/dist-packages/zope/interface/declarations.pyR$ès  c Cs`y|jjdƒ}Wnutk rt|dd ƒ}|d krgtj|ƒ}|d k rc|StS|jtkrz|St t |fƒŒSXt |tƒr¡|S|d krÏtj|ƒ}|d k rÏ|Sn|d k r|f}tt |ƒŒ}d |_ |` nsy |j}Wn5tk rLt|ƒsCtd|ƒ‚nd }nXtg|D]}t|ƒ^qWŒ}||_ t|ddƒpddt|ddƒp©d|_ym||_ t|dƒs×t|_nt |tƒrd|jkrt|t|d t|ƒƒƒ|_nWn<tk r[t |tƒsNtd |ƒ‚n|t|>> from zope.interface import Interface >>> class I1(Interface): pass ... >>> class I2(I1): pass ... >>> class I3(Interface): pass ... >>> class I4(I3): pass ... >>> class C1(object): ... implements(I2) >>> class C2(C1): ... implements(I3) >>> [i.getName() for i in implementedBy(C2)] ['I3', 'I2'] Really, any object should be able to receive a successful answer, even an instance: >>> class Callable(object): ... def __call__(self): ... return self >>> implementedBy(Callable()) Note that the name of the spec ends with a '?', because the `Callable` instance does not have a `__name__` attribute. t__implemented__s$ImplementedBy called for non-factoryR!R%t.R t__providedBy__t __provides__t __class__s!ImplementedBy called for non-typeN((t__dict__tgetRtgetattrR*t#BuiltinImplementationSpecificationst_emptyR0R$RR t isinstanceR(R,t __bases__tcallablet TypeErrorR'R thasattrtobjectSpecificationDescriptorR.tDescriptorAwareMetaClassest ClassProvidesttypeR/(tclstspectbasestc((s?/usr/lib/python2.7/dist-packages/zope/interface/declarations.pytimplementedByFallbackøs\&             % 5  % cGs/t|ƒ}d|_d|_t||ŒdS(süDeclare the only interfaces implemented by instances of a class The arguments after the class are one or more interfaces or interface specifications (``IDeclaration`` objects). The interfaces given (including the interfaces in the specifications) replace any previous declarations. Consider the following example: >>> from zope.interface import Interface >>> class I1(Interface): pass ... >>> class I2(Interface): pass ... >>> class I3(Interface): pass ... >>> class I4(Interface): pass ... >>> class A(object): ... implements(I3) >>> class B(object): ... implements(I4) >>> class C(A, B): ... pass >>> classImplementsOnly(C, I1, I2) >>> [i.getName() for i in implementedBy(C)] ['I1', 'I2'] Instances of ``C`` provide only ``I1``, ``I2``, and regardless of whatever interfaces instances of ``A`` and ``B`` implement. N((R'R+R*R(tclassImplements(R?R R@((s?/usr/lib/python2.7/dist-packages/zope/interface/declarations.pytclassImplementsOnlyrs!   cGsÛt|ƒ}|jtt|ƒƒ7_g}i}x7|jD],}||kr=d||<|j|ƒq=q=W|jdk rÈxI|jjD]8}t|ƒ}||kr‰d||<|j|ƒq‰q‰Wnt|ƒ|_dS(s¸Declare additional interfaces implemented for instances of a class The arguments after the class are one or more interfaces or interface specifications (``IDeclaration`` objects). The interfaces given (including the interfaces in the specifications) are added to any interfaces previously declared. Consider the following example: >>> from zope.interface import Interface >>> class I1(Interface): pass ... >>> class I2(Interface): pass ... >>> class I3(Interface): pass ... >>> class I4(Interface): pass ... >>> class I5(Interface): pass ... >>> class A(object): ... implements(I3) >>> class B(object): ... implements(I4) >>> class C(A, B): ... pass >>> classImplements(C, I1, I2) >>> [i.getName() for i in implementedBy(C)] ['I1', 'I2', 'I3', 'I4'] >>> classImplements(C, I5) >>> [i.getName() for i in implementedBy(C)] ['I1', 'I2', 'I5', 'I3', 'I4'] Instances of ``C`` provide ``I1``, ``I2``, ``I5``, and whatever interfaces instances of ``A`` and ``B`` provide. iN(R'R+ttupleR RR(R*R7(R?R R@RARtbRB((s?/usr/lib/python2.7/dist-packages/zope/interface/declarations.pyRD˜s'      cCs*|jd\}}|`|||Œ|S(Nt__implements_advice_data__(R1RH(R?R RD((s?/usr/lib/python2.7/dist-packages/zope/interface/declarations.pyt_implements_adviceÔs t implementercBseZd„Zd„ZRS(cGs ||_dS(N(R (R R ((s?/usr/lib/python2.7/dist-packages/zope/interface/declarations.pyR ÝscCsft|tƒr#t||jŒ|St|jŒ}y ||_Wn tk ratd|ƒ‚nX|S(NsCan't declare implements(R6R<RDR R$R,RR9(R tobR@((s?/usr/lib/python2.7/dist-packages/zope/interface/declarations.pyt__call__às  (R R!R RL(((s?/usr/lib/python2.7/dist-packages/zope/interface/declarations.pyRJÛs timplementer_onlycBseZd„Zd„ZRS(cGs ||_dS(N(R (R R ((s?/usr/lib/python2.7/dist-packages/zope/interface/declarations.pyR îscCs<t|ttfƒr$tdƒ‚nt||jŒ|SdS(NsIThe implementor_only decorator is not supported for methods or functions.(R6RRt ValueErrorRER (R RK((s?/usr/lib/python2.7/dist-packages/zope/interface/declarations.pyRLñs(R R!R RL(((s?/usr/lib/python2.7/dist-packages/zope/interface/declarations.pyRMìs cCsœtjdƒ}|j}||jksFd|krYtjd d krYt|dƒ‚nd|krxt|dƒ‚n||f|d>> from zope.interface import Interface >>> class IA1(Interface): pass ... >>> class IA2(Interface): pass ... >>> class IB(Interface): pass ... >>> class IC(Interface): pass ... >>> class A(object): ... implements(IA1, IA2) >>> class B(object): ... implements(IB) >>> class C(A, B): ... implements(IC) >>> ob = C() >>> int(IA1 in providedBy(ob)) 1 >>> int(IA2 in providedBy(ob)) 1 >>> int(IB in providedBy(ob)) 1 >>> int(IC in providedBy(ob)) 1 Instances of ``C`` implement ``I1``, ``I2``, and whatever interfaces instances of ``A`` and ``B`` implement. t implementsN(RXRD(R ((s?/usr/lib/python2.7/dist-packages/zope/interface/declarations.pyRYs>> from zope.interface import Interface >>> class IA1(Interface): pass ... >>> class IA2(Interface): pass ... >>> class IB(Interface): pass ... >>> class IC(Interface): pass ... >>> class A(object): ... implements(IA1, IA2) >>> class B(object): ... implements(IB) >>> class C(A, B): ... implementsOnly(IC) >>> ob = C() >>> int(IA1 in providedBy(ob)) 0 >>> int(IA2 in providedBy(ob)) 0 >>> int(IB in providedBy(ob)) 0 >>> int(IC in providedBy(ob)) 1 Instances of ``C`` implement ``IC``, regardless of what instances of ``A`` and ``B`` implement. timplementsOnlyN(RXRE(R ((s?/usr/lib/python2.7/dist-packages/zope/interface/declarations.pyRZLs8tProvidescBs/eZdZd„Zd„ZdZd„ZRS(sImplement __provides__, the instance-specific specification When an object is pickled, we pickle the interfaces that it implements. cGs:|f||_||_tj||t|ƒfŒdS(N(t_Provides__argst_clsRR R'(R R?R ((s?/usr/lib/python2.7/dist-packages/zope/interface/declarations.pyR s cCs t|jfS(N(R[R\(R ((s?/usr/lib/python2.7/dist-packages/zope/interface/declarations.pyR)•sszope.interfacecCs/|dkr||jkr|Stdƒ‚dS(sÍMake sure that a class __provides__ doesn't leak to an instance For example: >>> from zope.interface import Interface >>> class IFooFactory(Interface): pass ... >>> class C(object): ... pass >>> C.__provides__ = ProvidesClass(C, IFooFactory) >>> [i.getName() for i in C.__provides__] ['IFooFactory'] >>> getattr(C(), '__provides__', 0) 0 R/N(R*R]R(R tinstR?((s?/usr/lib/python2.7/dist-packages/zope/interface/declarations.pyt__get__šs(R R!R"R R)R_(((s?/usr/lib/python2.7/dist-packages/zope/interface/declarations.pyR[Šs   cGs8tj|ƒ}|dkr4t|Œ}|t|>> import gc >>> def collect(): ... for i in range(4): ... gc.collect() ) >>> collect() >>> before = len(InstanceDeclarations) >>> class C(object): ... pass >>> from zope.interface import Interface >>> class I(Interface): ... pass >>> c1 = C() >>> c2 = C() >>> len(InstanceDeclarations) == before 1 >>> directlyProvides(c1, I) >>> len(InstanceDeclarations) == before + 1 1 >>> directlyProvides(c2, I) >>> len(InstanceDeclarations) == before + 1 1 >>> del c1 >>> collect() >>> len(InstanceDeclarations) == before + 1 1 >>> del c2 >>> collect() >>> len(InstanceDeclarations) == before 1 N(tInstanceDeclarationsR2R*t ProvidesClass(R R@((s?/usr/lib/python2.7/dist-packages/zope/interface/declarations.pyR[»s 7   (t ClassTypecGsât|ddƒ}|dk rWt|ddƒ|krWt|tƒsWtdƒ‚qWnt|ƒ}|dkr~t|ƒ}nt}x'tD]}t||ƒr‹t }Pq‹q‹W|rÌt |||Œ|_ nt ||Œ|_ dS(s³Declare interfaces declared directly for an object The arguments after the object are one or more interfaces or interface specifications (``IDeclaration`` objects). The interfaces given (including the interfaces in the specifications) replace interfaces previously declared for the object. Consider the following example: >>> from zope.interface import Interface >>> class I1(Interface): pass ... >>> class I2(Interface): pass ... >>> class IA1(Interface): pass ... >>> class IA2(Interface): pass ... >>> class IB(Interface): pass ... >>> class IC(Interface): pass ... >>> class A(object): ... implements(IA1, IA2) >>> class B(object): ... implements(IB) >>> class C(A, B): ... implements(IC) >>> ob = C() >>> directlyProvides(ob, I1, I2) >>> int(I1 in providedBy(ob)) 1 >>> int(I2 in providedBy(ob)) 1 >>> int(IA1 in providedBy(ob)) 1 >>> int(IA2 in providedBy(ob)) 1 >>> int(IB in providedBy(ob)) 1 >>> int(IC in providedBy(ob)) 1 The object, ``ob`` provides ``I1``, ``I2``, and whatever interfaces instances have been declared for instances of ``C``. To remove directly provided interfaces, use ``directlyProvidedBy`` and subtract the unwanted interfaces. For example: >>> directlyProvides(ob, directlyProvidedBy(ob)-I2) >>> int(I1 in providedBy(ob)) 1 >>> int(I2 in providedBy(ob)) 0 removes I2 from the interfaces directly provided by ``ob``. The object, ``ob`` no longer directly provides ``I2``, although it might still provide ``I2`` if it's class implements ``I2``. To add directly provided interfaces, use ``directlyProvidedBy`` and include additional interfaces. For example: >>> int(I2 in providedBy(ob)) 0 >>> directlyProvides(ob, directlyProvidedBy(ob), I2) adds ``I2`` to the interfaces directly provided by ob:: >>> int(I2 in providedBy(ob)) 1 R0sHAttempt to make an interface declaration on a non-descriptor-aware classN( R3R*R6R<R9R R>tFalset issubclasstTrueR=R/R[(tobjectR R?tissubtdamc((s?/usr/lib/python2.7/dist-packages/zope/interface/declarations.pytdirectlyProvidessP$   cGst|t|ƒ|ŒdS(sŒDeclare interfaces declared directly for an object The arguments after the object are one or more interfaces or interface specifications (``IDeclaration`` objects). The interfaces given (including the interfaces in the specifications) are added to the interfaces previously declared for the object. Consider the following example: >>> from zope.interface import Interface >>> class I1(Interface): pass ... >>> class I2(Interface): pass ... >>> class IA1(Interface): pass ... >>> class IA2(Interface): pass ... >>> class IB(Interface): pass ... >>> class IC(Interface): pass ... >>> class A(object): ... implements(IA1, IA2) >>> class B(object): ... implements(IB) >>> class C(A, B): ... implements(IC) >>> ob = C() >>> directlyProvides(ob, I1) >>> int(I1 in providedBy(ob)) 1 >>> int(I2 in providedBy(ob)) 0 >>> int(IA1 in providedBy(ob)) 1 >>> int(IA2 in providedBy(ob)) 1 >>> int(IB in providedBy(ob)) 1 >>> int(IC in providedBy(ob)) 1 >>> alsoProvides(ob, I2) >>> int(I1 in providedBy(ob)) 1 >>> int(I2 in providedBy(ob)) 1 >>> int(IA1 in providedBy(ob)) 1 >>> int(IA2 in providedBy(ob)) 1 >>> int(IB in providedBy(ob)) 1 >>> int(IC in providedBy(ob)) 1 The object, ``ob`` provides ``I1``, ``I2``, and whatever interfaces instances have been declared for instances of ``C``. Notice that the alsoProvides just extends the provided interfaces. N(RitdirectlyProvidedBy(RfR ((s?/usr/lib/python2.7/dist-packages/zope/interface/declarations.pyt alsoProvideshsAcCs9t|t|ƒ|ƒ|j|ƒr5tdƒ‚ndS(s: This removes a directly provided interface from an object. Consider the following two interfaces: >>> from zope.interface import Interface >>> class I1(Interface): pass ... >>> class I2(Interface): pass ... ``I1`` is provided through the class, ``I2`` is directly provided by the object: >>> class C(object): ... implements(I1) >>> c = C() >>> alsoProvides(c, I2) >>> I2.providedBy(c) True Remove I2 from c again: >>> noLongerProvides(c, I2) >>> I2.providedBy(c) False Removing an interface that is provided through the class is not possible: >>> noLongerProvides(c, I1) Traceback (most recent call last): ... ValueError: Can only remove directly provided interfaces. s-Can only remove directly provided interfaces.N(RiRjt providedByRN(RfR((s?/usr/lib/python2.7/dist-packages/zope/interface/declarations.pytnoLongerProvides«s#tClassProvidesBasePycBseZd„ZRS(cCs6||jkr&|dkr|S|jStdƒ‚dS(NR/(R]R*RXR(R R^R?((s?/usr/lib/python2.7/dist-packages/zope/interface/declarations.pyR_Ôs  (R R!R_(((s?/usr/lib/python2.7/dist-packages/zope/interface/declarations.pyRnÒs(tClassProvidesBaseR=cBs)eZdZd„Zd„ZejZRS(seSpecial descriptor for class __provides__ The descriptor caches the implementedBy info, so that we can get declarations for objects without instance-specific interfaces a bit quicker. For example: >>> from zope.interface import Interface >>> class IFooFactory(Interface): ... pass >>> class IFoo(Interface): ... pass >>> class C(object): ... implements(IFoo) ... classProvides(IFooFactory) >>> [i.getName() for i in C.__provides__] ['IFooFactory'] >>> [i.getName() for i in C().__provides__] ['IFoo'] cGsL||_t|ƒ|_||f||_tj||t|ƒfŒdS(N(R]R'RXt_ClassProvides__argsRR (R R?tmetaclsR ((s?/usr/lib/python2.7/dist-packages/zope/interface/declarations.pyR s cCs|j|jfS(N(R0Rp(R ((s?/usr/lib/python2.7/dist-packages/zope/interface/declarations.pyR) s(R R!R"R R)RoR_(((s?/usr/lib/python2.7/dist-packages/zope/interface/declarations.pyR=ìs  cCsBt|ddƒ}|dks-t|tƒr1tSt|jd ƒS(spReturn the interfaces directly provided by the given object The value returned is an ``IDeclaration``. R/iÿÿÿÿN(R3R*R6R$R5RR7(Rftprovides((s?/usr/lib/python2.7/dist-packages/zope/interface/declarations.pyRjs  cGstjdƒ}|j}||jks3d|krBtdƒ‚nd|kr]tdƒ‚nt|ƒ|d>> from zope.interface import Interface >>> class IFoo(Interface): pass ... >>> class IFooFactory(Interface): pass ... >>> class C(object): ... implements(IFoo) ... classProvides(IFooFactory) >>> [i.getName() for i in C.__providedBy__] ['IFooFactory'] >>> [i.getName() for i in C().__providedBy__] ['IFoo'] if equivalent to: >>> from zope.interface import Interface >>> class IFoo(Interface): pass ... >>> class IFooFactory(Interface): pass ... >>> class C(object): ... implements(IFoo) >>> directlyProvides(C, IFooFactory) >>> [i.getName() for i in C.__providedBy__] ['IFooFactory'] >>> [i.getName() for i in C().__providedBy__] ['IFoo'] iR!s7classProvides can be used only from a class definition.R/s:classProvides can only be used once in a class definition.ROiN(RPRQRRRSR9R Rt_classProvides_advice(R RVRW((s?/usr/lib/python2.7/dist-packages/zope/interface/declarations.pyt classProvides"s;   cCs$|jd}|`t||Œ|S(NR/(R1R/Ri(R?R ((s?/usr/lib/python2.7/dist-packages/zope/interface/declarations.pyRsls  tprovidercBs eZdZd„Zd„ZRS(s(Class decorator version of classProvidescGs ||_dS(N(R (R R ((s?/usr/lib/python2.7/dist-packages/zope/interface/declarations.pyR uscCst||jŒ|S(N(RiR (R RK((s?/usr/lib/python2.7/dist-packages/zope/interface/declarations.pyRLxs(R R!R"R RL(((s?/usr/lib/python2.7/dist-packages/zope/interface/declarations.pyRurs cGsztjdƒ}|j}||jk s3d|krBtdƒ‚nd|kr]tdƒ‚nttt|ƒŒ|d>> from zope.interface import Interface >>> class I1(Interface): pass ... >>> class I2(Interface): pass ... >>> class I3(Interface): pass ... >>> class I31(I3): pass ... >>> class I4(Interface): pass ... >>> class I5(Interface): pass ... >>> class A(object): ... implements(I1) >>> class B(object): __implemented__ = I2 ... >>> class C(A, B): ... implements(I31) >>> c = C() >>> directlyProvides(c, I4) >>> [i.getName() for i in providedBy(c)] ['I4', 'I31', 'I1', 'I2'] >>> [i.getName() for i in providedBy(c).flattened()] ['I4', 'I31', 'I3', 'I1', 'I2', 'Interface'] >>> int(I1 in providedBy(c)) 1 >>> int(I3 in providedBy(c)) 0 >>> int(providedBy(c).extends(I3)) 1 >>> int(providedBy(c).extends(I31)) 1 >>> int(providedBy(c).extends(I5)) 0 >>> class COnly(A, B): ... implementsOnly(I31) >>> class D(COnly): ... implements(I5) >>> c = D() >>> directlyProvides(c, I4) >>> [i.getName() for i in providedBy(c)] ['I4', 'I5', 'I31'] >>> [i.getName() for i in providedBy(c).flattened()] ['I4', 'I5', 'I31', 'I3', 'Interface'] >>> int(I1 in providedBy(c)) 0 >>> int(I3 in providedBy(c)) 0 >>> int(providedBy(c).extends(I3)) 1 >>> int(providedBy(c).extends(I1)) 0 >>> int(providedBy(c).extends(I31)) 1 >>> int(providedBy(c).extends(I5)) 1 (R[(tdirectR?((s?/usr/lib/python2.7/dist-packages/zope/interface/declarations.pytObjectSpecification¦sBcCs`t|ddƒ}|dk r4t|tƒr4|Sny |j}Wntk rUtSXt|ƒS(NR/(R3R*R6RR0RR5R'(RKRrR?((s?/usr/lib/python2.7/dist-packages/zope/interface/declarations.pytgetObjectSpecificationês   cCs´y |j}Wntk r't|ƒSXy |jWnztk r¯y |j}Wntk rmt|jƒSXy|jj}Wntk r’|SX||kr°t|jƒSnX|S(N(R.RRyRR/R'R0(RKtrtcp((s?/usr/lib/python2.7/dist-packages/zope/interface/declarations.pyRlùs$         tObjectSpecificationDescriptorPycBseZdZd„ZRS(s„Implement the `__providedBy__` attribute The `__providedBy__` attribute computes the interfaces peovided by an object. cCsB|dkrt|ƒSt|ddƒ}|dk r8|St|ƒS(súGet an object specification for an object For example: >>> from zope.interface import Interface >>> class IFoo(Interface): pass ... >>> class IFooFactory(Interface): pass ... >>> class C(object): ... implements(IFoo) ... classProvides(IFooFactory) >>> [i.getName() for i in C.__providedBy__] ['IFooFactory'] >>> [i.getName() for i in C().__providedBy__] ['IFoo'] R/N(R*RyR3R'(R R^R?Rr((s?/usr/lib/python2.7/dist-packages/zope/interface/declarations.pyR_2s    (R R!R"R_(((s?/usr/lib/python2.7/dist-packages/zope/interface/declarations.pyR|+scCsn|dkrg}n|j}t|jks<t|jkrL|j|ƒnx|D]}t||ƒqSW|S(sËNormalize declaration arguments Normalization arguments might contain Declarions, tuples, or single interfaces. Anything but individial interfaces or implements specs will be expanded. N(R*R0Rt__mro__R$RR (tsequencetoutputR?tv((s?/usr/lib/python2.7/dist-packages/zope/interface/declarations.pyR Vs    (R'Rl(Ry(tObjectSpecificationDescriptor((((;R"t __docformat__RPtweakreftzope.interface.interfaceRRRttypesRRRtzope.interface.adviceRR4RR$RCR'RERDRIRJRMRXRYRZR[RatWeakValueDictionaryR`Ret__safe_for_unpickling__RbR>R<t ImportErrorRiRkRmRfRnRot_zope_interface_coptimizationsR=RjRtRsRuRvRxRyRlR|RR*R R5R;(((s?/usr/lib/python2.7/dist-packages/zope/interface/declarations.pytsz  ¿ x & <   > >+  =    h C ' $  J  * D  2'