2(Vc@sCdZdZddlZddlmZddlmZddlmZddlZddlZddl m Z ddl m Z dd l m Z dd l mZdd lmZdd lmZiZd ZdZdefdYZdefdYZdefdYZdZeZdZdZdZdd;dYZdd<dYZ dZ!dZ"dZ#d efd!YZ$e$Z%ej&Z'd"Z$e(e$_)d#Z*d$Z+d%Z,d&efd'YZ-e-Z.e-Z/yddl0Z0Wne1k rnXdd(l0m/Z/d)ee/fd*YZ2d+Z3d,Z4d-Z5d.d=d/YZ6d0Z7d1Z8d2Z9e9Z:d3Z;e;Z<d4efd5YZ=e=Z>dd6Z@eZAyddl0Z0Wne1k rnAXdd7l0mZdd8l0m<Z<dd9l0m:Z:dd:l0m>Z>e>ZBdS(>sImplementation 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. trestructuredtextiN(t FunctionType(t MethodType(t ModuleType(taddClassAdvisor(tInterfaceClass(tSpecificationBase(t Specification(t CLASS_TYPES(tPYTHON3sIClass advice impossible in Python3. Use the @%s class decorator instead.s\The %s API is deprecated, and will not work in Python3 Use the @%s class decorator instead.tnamedcBseZdZdZRS(cCs ||_dS(N(tname(tselfR ((s?/usr/lib/python2.7/dist-packages/zope/interface/declarations.pyt__init__6scCs|j|_|S(N(R t__component_name__(R tob((s?/usr/lib/python2.7/dist-packages/zope/interface/declarations.pyt__call__9s (t__name__t __module__R R(((s?/usr/lib/python2.7/dist-packages/zope/interface/declarations.pyR 4s t DeclarationcBsSeZdZdZdZdZdZdZdZdZ e Z RS(sInterface declarationscGstj|t|dS(N(RR t_normalizeargs(R t 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.pyRCs   cCs|j|o||jkS(s:Test whether an interface is in the specification (textendsR(R t interface((s?/usr/lib/python2.7/dist-packages/zope/interface/declarations.pyt __contains__JscCs |jS(sCReturn an iterator for the interfaces in the specification (R(R ((s?/usr/lib/python2.7/dist-packages/zope/interface/declarations.pyt__iter__PscCs t|jS(sCReturn an iterator of all included and extended interfaces (titert__iro__(R ((s?/usr/lib/python2.7/dist-packages/zope/interface/declarations.pyt flattenedUscCsTtg|jD]=}g|jD]}|j|dr#|^q#s|^qS(s/Remove interfaces from a specification i(RRR(R tothertitj((s?/usr/lib/python2.7/dist-packages/zope/interface/declarations.pyt__sub__ZscCsi}g}x+|jD]}d||<|j|qWx:|jD],}||krGd||<|j|qGqGWt|S(sCAdd two specifications or a specification and an interface i(RtappendR(R R!tseentresultR"((s?/usr/lib/python2.7/dist-packages/zope/interface/declarations.pyt__add__ds   ( RRt__doc__R RRRR R$R(t__radd__(((s?/usr/lib/python2.7/dist-packages/zope/interface/declarations.pyR=s      t ImplementscBs,eZdZdZdZdZdZRS(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((RRtNoneR/tdeclaredR-R0(((s?/usr/lib/python2.7/dist-packages/zope/interface/declarations.pyR+|s  cCs`y|jjd}Wnutk rt|dd }|d krgtj|}|d k rc|StS|jtkrz|St t |fSXt |tr|S|d krtj|}|d k r|Sn|d k r|f}tt |}d |_ |` nsy |j}Wn5tk rLt|sCtd|nd }nXtg|D]}t|^qW}||_ t|ddpddt|ddpd|_ym||_ t|dst|_nt |trd|jkrt|t|d t||_nWn<tk r[t |tsNtd |n|t|(RFRRGRHR&tbRI((s?/usr/lib/python2.7/dist-packages/zope/interface/declarations.pyRKs      cCs*|jd\}}|`||||S(Nt__implements_advice_data__(R8RO(RFRRK((s?/usr/lib/python2.7/dist-packages/zope/interface/declarations.pyt_implements_advices t implementercBs eZdZdZdZRS(sDeclare the interfaces implemented by instances of a class. This function is called as a class decorator. The arguments 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. Previous declarations include declarations for base classes unless implementsOnly was used. This function is provided for convenience. It provides a more convenient way to call classImplements. For example:: @implementer(I1) class C(object): pass is equivalent to calling:: classImplements(C, I1) after the class has been created. cGs ||_dS(N(R(R R((s?/usr/lib/python2.7/dist-packages/zope/interface/declarations.pyR 5scCsft|tr#t||j|St|j}y ||_Wn tk ratd|nX|S(NsCan't declare implements(R=RCRKRR+R3RR@(R RRG((s?/usr/lib/python2.7/dist-packages/zope/interface/declarations.pyR8s  (RRR)R R(((s?/usr/lib/python2.7/dist-packages/zope/interface/declarations.pyRQs timplementer_onlycBs eZdZdZdZRS(snDeclare the only interfaces implemented by instances of a class This function is called as a class decorator. The arguments are one or more interfaces or interface specifications (IDeclaration objects). Previous declarations including declarations for base classes are overridden. This function is provided for convenience. It provides a more convenient way to call classImplementsOnly. For example:: @implementer_only(I1) class C(object): pass is equivalent to calling:: classImplementsOnly(I1) after the class has been created. cGs ||_dS(N(R(R R((s?/usr/lib/python2.7/dist-packages/zope/interface/declarations.pyR \scCs<t|ttfr$tdnt||j|SdS(NsIThe implementer_only decorator is not supported for methods or functions.(R=RRt ValueErrorRLR(R R((s?/usr/lib/python2.7/dist-packages/zope/interface/declarations.pyR_s(RRR)R R(((s?/usr/lib/python2.7/dist-packages/zope/interface/declarations.pyRRDs cCstrtdntjd}|j}||jksHd|kr[t|dnd|krzt|dn||f|d(Ritprovides((s?/usr/lib/python2.7/dist-packages/zope/interface/declarations.pyRmTs  cGstrttdntjd}|j}||jksLd|kr[tdnd|krvtdnt||ds    ? W   ,'     $    2  ,   1