TJJc @ s d Z d d k l Z d d k Z d d k Z d d k Z d d k l Z d d k l Z d d k l
Z
d Z d Z d Z
e Z d
Z d Z d e f d
YZ d e f d YZ e Z e Z d e f d YZ e Z g Z y d d k Z Wn e j
o n( Xd d k l Z d d k l Z l Z d e f d YZ d e e e f d YZ e d d d Z d e f d YZ d e f d YZ e d e d Z! e e d! Z" d" Z# d d# k$ l% Z% l& Z& d d$ k l' Z' d d% k l( Z( d S(& sW Interface object implementation
$Id: interface.py 82877 2008-01-14 20:58:02Z witsch $
i( t
generatorsN( t FunctionType( t ro( t Invalidi i t __interface_tagged_values__c C sG t i d i } | i t h } | i d g } | i | t S( Ni t
invariants( t syst _getframet f_localst
setdefaultt TAGGED_DATAt appendt _decorator_non_return( t callR t tagsR ( ( s> /usr/lib64/python2.6/site-packages/zope/interface/interface.pyt invariant# s
c C s2 t i d i } | i t h } | | | /usr/lib64/python2.6/site-packages/zope/interface/interface.pyt taggedValue+ s
t Elementc B sM e Z d d Z d Z d Z d Z d d Z d Z d Z RS( t c C sM | o& | i d d j o | } d } n | | _ | | _ h | _ d S( s* Create an 'attribute' description
t i N( t findt Nonet __name__t __doc__t _Element__tagged_values( t selfR R ( ( s> /usr/lib64/python2.6/site-packages/zope/interface/interface.pyt __init__: s
c C s | i S( s! Returns the name of the object. ( R ( R ( ( s> /usr/lib64/python2.6/site-packages/zope/interface/interface.pyt getNameE s c C s | i S( s+ Returns the documentation for the object. ( R ( R ( ( s> /usr/lib64/python2.6/site-packages/zope/interface/interface.pyt getDocI s c C s | i | S( s* Returns the value associated with 'tag'. ( R ( R t tag( ( s> /usr/lib64/python2.6/site-packages/zope/interface/interface.pyt getTaggedValueM s c C s | i i | | S( s* Returns the value associated with 'tag'. ( R t get( R R t default( ( s> /usr/lib64/python2.6/site-packages/zope/interface/interface.pyt queryTaggedValueQ s c C s
| i i S( s Returns a list of all tags. ( R t keys( R ( ( s> /usr/lib64/python2.6/site-packages/zope/interface/interface.pyt getTaggedValueTagsU s c C s | | i | /usr/lib64/python2.6/site-packages/zope/interface/interface.pyt setTaggedValueY s N(
R t
__module__R R R R! R R$ R& R' ( ( ( s> /usr/lib64/python2.6/site-packages/zope/interface/interface.pyR 3 s t SpecificationBasePyc B s) e Z d Z d Z d Z e Z RS( c C s t | } | | i j S( so Is the interface implemented by an object
>>> 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( R t obt spec( ( s> /usr/lib64/python2.6/site-packages/zope/interface/interface.pyR* _ s c C s t | } | | i j S( 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+ ( R t clsR- ( ( s> /usr/lib64/python2.6/site-packages/zope/interface/interface.pyR. | s c C s
| | i j S( s Is 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+ ( R t interface( ( s> /usr/lib64/python2.6/site-packages/zope/interface/interface.pyt isOrExtends s ( R R( R* R. R1 t __call__( ( ( s> /usr/lib64/python2.6/site-packages/zope/interface/interface.pyR) ] s !t InterfaceBasePyc B s# e Z d Z e d Z d Z RS( s: Base class that wants to be replaced with a C base :)
c C s t | d d } | d j o% | i | } | d j o | Sn | i | } | d j o | S| t j o | St d | | d S( s) Adapt an object to the interface
t __conform__s Could not adaptN( t getattrR t
_call_conformt __adapt__t _markert TypeError( R t objt alternatet conformt adapter( ( s> /usr/lib64/python2.6/site-packages/zope/interface/interface.pyR2 s
c C sK | i | o | Sx/ t D]' } | | | } | d j o | Sq Wd S( s( Adapt an object to the reciever
N( R* t
adapter_hooksR ( R R: t hookR= ( ( s> /usr/lib64/python2.6/site-packages/zope/interface/interface.pyR7 s
( R R( R R8 R2 R7 ( ( ( s> /usr/lib64/python2.6/site-packages/zope/interface/interface.pyR3 s ( t SpecificationBase( t
InterfaceBaseR> t
Specificationc B s e Z d Z e i Z e i Z d d Z d Z d Z d Z e
d e Z d Z d Z
e d Z d d Z d d
Z RS(
sI Specifications
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
c C s+ h | _ t i | _ t | | _ d S( N( R+ t weakreft WeakKeyDictionaryt
dependentst tuplet __bases__( R t bases( ( s> /usr/lib64/python2.6/site-packages/zope/interface/interface.pyR s c C s$ | i i | d d | i | /usr/lib64/python2.6/site-packages/zope/interface/interface.pyt subscribe s c C s\ | i i | d d } | p | i | =n+ | d j o | | i | /usr/lib64/python2.6/site-packages/zope/interface/interface.pyt unsubscribe
s
c C s] x | i D] } | i | q
W| | i d /usr/lib64/python2.6/site-packages/zope/interface/interface.pyt
__setBases s
c C s | i i d d S( RG ( ( RN R" ( R ( ( s> /usr/lib64/python2.6/site-packages/zope/interface/interface.pyt ! s c
C s | i } | i t | } y" t | j o | i t n Wn t j
o n Xt | | _ t g } | D]! } t | t o | | qt qt ~ | _
x | D] } d | | /usr/lib64/python2.6/site-packages/zope/interface/interface.pyRO % s"
* c c sU h } xH | i D]= } x4 | i D]& } | | j o d | | <| Vq# q# Wq Wd 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 = Specification((I2, I3))
>>> spec = Specification((I4, spec))
>>> i = spec.interfaces()
>>> i.next().getName()
'I4'
>>> i.next().getName()
'I2'
>>> i.next().getName()
'I3'
>>> list(i)
[]
i N( RG t
interfaces( R t seent baseR0 ( ( s> /usr/lib64/python2.6/site-packages/zope/interface/interface.pyR_ B s
c C s" | | i j o | p
| | j S( 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+ ( R R0 t strict( ( s> /usr/lib64/python2.6/site-packages/zope/interface/interface.pyt extendsd s (c C s t i | | S( N( RC t ref( R t callback( ( s> /usr/lib64/python2.6/site-packages/zope/interface/interface.pyRC s c C s y
| i } Wn t j
o h } | _ n X| i | } | d j oC x@ | i D]1 } | i | } | d j o | | | /usr/lib64/python2.6/site-packages/zope/interface/interface.pyR" s
( N( R R( R R@ R1 R* R RJ RM t _Specification__setBasest propertyRG RO R_ t TrueRc R RC R" ( ( ( s> /usr/lib64/python2.6/site-packages/zope/interface/interface.pyRB s ' " - RX c B s e Z d Z d d d d d Z d Z d Z d Z e d Z d Z
e d Z d Z e Z
d Z d
Z d d Z d Z d d
Z d Z d Z d Z d Z d Z d Z d Z d Z RS( s0 Prototype (scarecrow) Interfaces Implementation.c
C sj | d j o
h } n | d j od | i d } t | t o | d =q y t i d i d } Wq t t f j
o q Xn | | _ | i d } | d j o6 t | t
p" | d j o
| } n | d =q n | d j o
d } n t i | | | | i
t d } | d j o1 x. | i D] \ } } | i | | q9Wn x. | D]& }
t |
t p t d qdqdWt i | | x | i D] \ } } t | t
o$ | | _ | i p
| | _ q@qt | t o t | | d | | | /usr/lib64/python2.6/site-packages/zope/interface/interface.pyR sV
c c s | Vd S( sG Return an iterator for the interfaces in the specification
for example::
>>> from zope.interface import Interface
>>> class I1(Interface): pass
...
>>>
>>> i = I1.interfaces()
>>> i.next().getName()
'I1'
>>> list(i)
[]
N( ( R ( ( s> /usr/lib64/python2.6/site-packages/zope/interface/interface.pyR_ s c C s | i S( N( RG ( R ( ( s> /usr/lib64/python2.6/site-packages/zope/interface/interface.pyt getBases s c C s | | j p
| i | S( s Same interface or extends?( Rc ( R t other( ( s> /usr/lib64/python2.6/site-packages/zope/interface/interface.pyt isEqualOrExtendedBy s c C sa | p | i i S| i i } x0 | i D]% } | i t i | i | q. W| i S( s4 Return the attribute names defined by the interface.( Rw R% t copyRG t updatet dictt fromkeyst names( R t allt rRa ( ( s> /usr/lib64/python2.6/site-packages/zope/interface/interface.pyR s
#c C s t | i d t S( NR ( t iterR Ro ( R ( ( s> /usr/lib64/python2.6/site-packages/zope/interface/interface.pyt __iter__ s c C sr | p | i i Sh } x: | i d d d D]" } | i t | i | q2 W| i | i | i S( s= Return attribute names and descriptions defined by interface.Ni( Rw Rt RG R R t namesAndDescriptions( R R R Ra ( ( s> /usr/lib64/python2.6/site-packages/zope/interface/interface.pyR s c C s1 | i | } | d j o | St | d S( s4 Return the attribute description for the given name.N( R" R RK ( R Ri R ( ( s> /usr/lib64/python2.6/site-packages/zope/interface/interface.pyt getDescriptionFor" s
c C s | i | d j S( N( R" R ( R Ri ( ( s> /usr/lib64/python2.6/site-packages/zope/interface/interface.pyt __contains__, s c C s | i i | S( N( Rw R" ( R Ri ( ( s> /usr/lib64/python2.6/site-packages/zope/interface/interface.pyRh / s c C s | i | | S( N( R" ( R Ri R# ( ( s> /usr/lib64/python2.6/site-packages/zope/interface/interface.pyt queryDescriptionFor2 s c B sW e | d o | i Sh } d | i | U| | i } | i | i | | _ | S( s6 Return a defered class corresponding to the interface.t _deferreds class %s: pass( t hasattrR R t _InterfaceClass__dRN ( R t klass( ( s> /usr/lib64/python2.6/site-packages/zope/interface/interface.pyt deferred5 s
c C s xa | i d g D]M } y | | Wq t j
o* } | d j o q` | i | q Xq WxO | i D]D } y | i | | Wqn t j
o | d j o q qn Xqn W| o t | n d S( s& validate object to defined invariants.R N( R$ R R R RG t validateInvariants( R R: t errorsR
t eRa ( ( s> /usr/lib64/python2.6/site-packages/zope/interface/interface.pyR C s"
c C s d S( s Retrieve a named interface.N( R ( R R, Ri ( ( s> /usr/lib64/python2.6/site-packages/zope/interface/interface.pyt
_getInterfaceV s c C sp xH | i i D]7 \ } } t | t o | | j o | | | /usr/lib64/python2.6/site-packages/zope/interface/interface.pyt __dZ s
c C sr y | i SWn` t j
oT | i } | i } | o d | | f } n d | i i | f } | | _ | SXd S( Ns %s.%ss <%s %s>( t _v_reprRg R R( t __class__( R Ri t mR ( ( s> /usr/lib64/python2.6/site-packages/zope/interface/interface.pyt __repr__c s c C sI y | | SWn4 t j
o( t i d i d j o qE n Xd S( Ni ( R9 R t exc_infot tb_nextR ( R R< ( ( s> /usr/lib64/python2.6/site-packages/zope/interface/interface.pyR6 o s c C s | i S( N( R ( R ( ( s> /usr/lib64/python2.6/site-packages/zope/interface/interface.pyt
__reduce__ s c C s | | j o d S| d j o d S| d j o d St | d d t t | d d d d f } t | d d t t | d d d d f } t | | S( 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.
i i iR R R( N( R R5 t cmp( R t o1t o2t n1t n2( ( s> /usr/lib64/python2.6/site-packages/zope/interface/interface.pyt __cmp s
!!c C s | i | | } | d j S( Ni ( t _InterfaceClass__cmp( R R} t c( ( s> /usr/lib64/python2.6/site-packages/zope/interface/interface.pyt __lt__ s c C s | i | | } | d j S( Ni ( R ( R R} R ( ( s> /usr/lib64/python2.6/site-packages/zope/interface/interface.pyt __gt__ s ( N( R R( R R R R_ R| R~ t FalseR R R R t __getitem__R Rh R R R R R R R6 R R R R ( ( ( s> /usr/lib64/python2.6/site-packages/zope/interface/interface.pyRX s0 =
% RT R( s zope.interfaceRr c B s e Z d Z d Z RS( s Attribute descriptions
N( R R( R R R0 ( ( ( s> /usr/lib64/python2.6/site-packages/zope/interface/interface.pyRr s R c B s) e Z d Z d Z d Z d Z RS( s Method interfaces
The idea here is that you have objects that describe methods.
This provides an opportunity for rich meta-data.
c O s t | i | i d S( N( t BrokenImplementationR0 R ( R t argst kw( ( s> /usr/lib64/python2.6/site-packages/zope/interface/interface.pyR2 s c C s6 h | i d 6| i d 6| i d 6| i d 6| i d 6S( Nt
positionalt requiredt optionalt varargst kwargs( R R R R R ( R ( ( s> /usr/lib64/python2.6/site-packages/zope/interface/interface.pyt getSignatureInfo s
c C s g } xT | i D]I } | i | | | i i j o | d c d | i |
7 /usr/lib64/python2.6/site-packages/zope/interface/interface.pyt getSignatureString s
$
( R R( R R2 R R ( ( ( s> /usr/lib64/python2.6/site-packages/zope/interface/interface.pyR s i c C sm | p | i } t | | i } | i p d } | i } | i | } | i | } h } | t | }
|
d j o | |
} d }
n | i t t
| |
| | | | _ | |
| _ | | _
| } | i t @o | | | _ | d } n
d | _ | i t @o | | | _ n
d | _ | | _ x- | i i D] \ } }
| i | |
qIW| S( Ni i ( ( R R R t
func_defaultst func_codet co_argcountt co_varnamest lenR R t zipR R R t co_flagst
CO_VARARGSR R t CO_VARKEYWORDSR R0 RN Rt R' ( t funcR0 t imlevelRi t methodt defaultst codet naR t optt nrt argnoR R ( ( s> /usr/lib64/python2.6/site-packages/zope/interface/interface.pyRu s8
c C s" | i } t | | d d d | S( NR i Ri ( t im_funcRu ( t methR0 Ri R ( ( s> /usr/lib64/python2.6/site-packages/zope/interface/interface.pyt
fromMethod s c C s~ d d k l } d d k l } | t | d d k l } | t | d d k l } l } | t | | t
| d S( Ni( t classImplements( t
IAttribute( t IMethod( t
IInterfacet ISpecification( t zope.interface.declarationsR t zope.interface.interfacesR Rr R R R R RX RB ( R R R R R ( ( s> /usr/lib64/python2.6/site-packages/zope/interface/interface.pyt _wire s
( R* R. ( Rv ( R () R t
__future__R R t warningsRC t typesR R t zope.interface.exceptionsR R R R
t objectR R R R R) R@ R8 R3 RA R> t _zope_interface_coptimizationst ImportErrorRB RX RT Rr R R Ru R R R R* R. Rv R ( ( ( s> /usr/lib64/python2.6/site-packages/zope/interface/interface.pyt sL *H ! %-