ó [³XMc @sždZddlZddlmZmZddlmZddlmZddl m Z de fd„ƒYZ eƒZ d aeed dƒdkr”d „Zn d „Zd „Zd„Ze jd„Zejjeƒd„Zd„Zd„ZeZdd%d„ƒYZde jfd„ƒYZdefd„ƒYZ dd„Z!de"fd„ƒYZ#de"fd„ƒYZ$ddd dddd!d"d#d$g Z%dS(&s² Component architecture for Twisted, based on Zope3 components. Using the Zope3 API directly is strongly recommended. Everything you need is in the top-level of the zope.interface package, e.g.:: from zope.interface import Interface, implements class IFoo(Interface): pass class Foo: implements(IFoo) print IFoo.implementedBy(Foo) # True print IFoo.providedBy(Foo()) # True L{twisted.python.components.registerAdapter} from this module may be used to add to Twisted's global adapter registry. L{twisted.python.components.proxyForInterface} is a factory for classes which allow access to only the parts of another class defined by a specified interface. i’’’’N(t interfacet declarations(tAdapterRegistry(treflect(tstylestComponentsDeprecationWarningcBseZdZRS(s- Nothing emits this warning anymore. (t__name__t __module__t__doc__(((s=/usr/lib/python2.7/dist-packages/twisted/python/components.pyR+sit registeredcCs%|j|ƒjj|iƒjdƒS(s Return the adapter factory for the given parameters in the given registry, or None if there is not one. t(tgett selfImplied(tregistrytrequiredtprovided((s=/usr/lib/python2.7/dist-packages/twisted/python/components.pyt _registered;scCs|j|g|ƒS(s Return the adapter factory for the given parameters in the given registry, or None if there is not one. (R (R RR((s=/usr/lib/python2.7/dist-packages/twisted/python/components.pyRBscGs³t}|std‚t|tjƒs9tj|ƒ}nxI|D]A}t|||ƒ}|dk r@t r@t d|fƒ‚q@q@Wx'|D]}|j |g|d|ƒqŒWdS(s Register an adapter class. An adapter class is expected to implement the given interface, by adapting instances implementing 'origInterface'. An adapter class's __init__ method should accept one parameter, an instance implementing 'origInterface'. sYou need to pass an Interfaces'an adapter (%s) was already registered.R N( tglobalRegistrytAssertionErrort isinstanceRtInterfaceClassRt implementedByRtNonetALLOW_DUPLICATESt ValueErrortregister(tadapterFactoryt origInterfacetinterfaceClassestselftinterfaceClasstfactory((s=/usr/lib/python2.7/dist-packages/twisted/python/components.pytregisterAdapterJs  cCsUt}t|tjƒs*tj|ƒ}n|j||ƒ}|dkrQ|}n|S(s²Return registered adapter for a given class and interface. Note that is tied to the *Twisted* global registry, and will thus not find adapters registered elsewhere. N(RRRRRRtlookup1R(t fromInterfacet toInterfacetdefaultRR((s=/usr/lib/python2.7/dist-packages/twisted/python/components.pytgetAdapterFactorybs  cCs6|tj|ƒ|ƒ}|dkr(dS||ƒSdS(N(Rt providedByR(tifacetobtlookupR((s=/usr/lib/python2.7/dist-packages/twisted/python/components.pyt_hookrs cCstjdtddƒdS(s°DEPRECATED. Does nothing. Previously handled backwards compat from a zope.interface using class to a class wanting old twisted components interface behaviors. sYcomponents.backwardsCompatImplements doesn't do anything in Twisted 2.3, stop calling it.t stackleveliN(twarningstwarnR(tklass((s=/usr/lib/python2.7/dist-packages/twisted/python/components.pytbackwardsCompatImplements}scCstjdtddƒdS(snDEPRECATED. Does nothing. Previously converted class from __implements__ to zope implementation. sRcomponents.fixClassImplements doesn't do anything in Twisted 2.3, stop calling it.R+iN(R,R-R(R.((s=/usr/lib/python2.7/dist-packages/twisted/python/components.pytfixClassImplements†scCstS(sWReturns the Twisted global C{zope.interface.adapter.AdapterRegistry} instance. (R(((s=/usr/lib/python2.7/dist-packages/twisted/python/components.pyt getRegistrystAdaptercBs5eZdZdZdZd„Zd„Zd„ZRS(s/I am the default implementation of an Adapter for some interface. This docstring contains a limerick, by popular demand:: Subclassing made Zope and TR much harder to work with by far. So before you inherit, be sure to declare it Adapter, not PyObject* @cvar temporaryAdapter: If this is True, the adapter will not be persisted on the Componentized. @cvar multiComponent: If this adapter is persistent, should it be automatically registered for all appropriate interfaces. iicCs ||_dS(sDSet my 'original' attribute to be the object I am adapting. N(toriginal(RR3((s=/usr/lib/python2.7/dist-packages/twisted/python/components.pyt__init__®scCs&t|jdƒr"|jj|ƒSdS(sn I forward __conform__ to self.original if it has it, otherwise I simply return None. t __conform__N(thasattrR3R5R(RR((s=/usr/lib/python2.7/dist-packages/twisted/python/components.pyR5³scCs|jj||ƒS(s1 Forward isuper to self.original (R3tisuper(RR'tadapter((s=/usr/lib/python2.7/dist-packages/twisted/python/components.pyR7¼s(RRRttemporaryAdaptertmultiComponentR4R5R7(((s=/usr/lib/python2.7/dist-packages/twisted/python/components.pyR2˜s   t ComponentizedcBsweZdZdZd„Zd„Zd„Zdd„Zd„Zdd„Z d „Z d „Z d d „Z d „ZRS(sįI am a mixin to allow you to be adapted in various ways persistently. I define a list of persistent adapters. This is to allow adapter classes to store system-specific state, and initialized on demand. The getComponent method implements this. You must also register adapters for this class for the interfaces that you wish to pass to getComponent. Many other classes and utilities listed here are present in Zope3; this one is specific to Twisted. icCs i|_dS(N(t _adapterCache(R((s=/usr/lib/python2.7/dist-packages/twisted/python/components.pyR4ŃscCst|||ƒS(N(R%(RR.RR$((s=/usr/lib/python2.7/dist-packages/twisted/python/components.pytlocateAdapterClassŌscCs|j|||ƒƒdS(N(t setComponent(RRt adapterClass((s=/usr/lib/python2.7/dist-packages/twisted/python/components.pyt setAdapter×sicCs ||ƒ}|j||ƒ|S(s³Utility method that calls addComponent. I take an adapter class and instantiate it with myself as the first argument. @return: The adapter instantiated. (t addComponent(RR?t ignoreClasstadapt((s=/usr/lib/python2.7/dist-packages/twisted/python/components.pyt addAdapterŚs cCs||jtj|ƒäscCs^xWtj|ƒD]F}|s=|j|j|dƒ|jkr||jtj|ƒRARHRORRRR5(((s=/usr/lib/python2.7/dist-packages/twisted/python/components.pyR;Ćs         !tReprableComponentizedcBseZd„Zd„ZRS(cCstj|ƒdS(N(R;R4(R((s=/usr/lib/python2.7/dist-packages/twisted/python/components.pyR47scCsCddlm}ddlm}|ƒ}||j|ƒ|jƒS(Ni’’’’(tStringIO(tpprint(t cStringIORURVR<tgetvalue(RRURVtsio((s=/usr/lib/python2.7/dist-packages/twisted/python/components.pyt__repr__:s  (RRR4RZ(((s=/usr/lib/python2.7/dist-packages/twisted/python/components.pyRT6s R3csy‡fd†}i|d6}x!|D]}t|ˆƒ||s>       +s $ 1