/usr/lib/python3/dist-packages/twisted/python/__pycache__
Edit: /usr/lib/python3/dist-packages/twisted/python/__pycache__/components.cpython-310.pyc (14364B)
o
bw7 @ s d Z ddlmZ ddlmZ ddlmZmZ ddlm Z ddl
m Z e Z da
dd Zd d
Zd d Zd
d Zee dd ZeZG dd dZG dd dZG dd deZd ddZG dd dZG d d d Zg d Zd S )!a
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, implementer
class IFoo(Interface):
pass
@implementer(IFoo)
class Foo:
pass
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.
)StringIO)Dict) declarations interface)AdapterRegistry)reflectc G sz t }|sJ dt|tjst|}|D ]}||g|}|dur,ts,td| dq|D ] }| |g|d| q/dS )a
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'.
z You need to pass an InterfaceNz an adapter (z) was already registered. )
globalRegistry
isinstancer InterfaceClassr
implementedBy
registeredALLOW_DUPLICATES
ValueErrorregister)adapterFactory
origInterfaceinterfaceClassesselfinterfaceClassfactory r ;/usr/lib/python3/dist-packages/twisted/python/components.pyregisterAdapter2 s
r c C s6 t }t| tjs
t| } || |}|du r|}|S )zReturn 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)r r
r r r r lookup1)
fromInterface toInterfacedefaultr r r r r getAdapterFactoryJ s
r c s" | j fdd}tj| |S )z
Add an adapter hook which will attempt to look up adapters in the given
registry.
@type registry: L{zope.interface.adapter.AdapterRegistry}
@return: The hook which was added, for later use with L{_removeHook}.
c s$ t || }|d u rd S ||S N)r
providedBy)ifaceobr lookupr r _hookd s z_addHook.
._hook)r r
adapter_hooksappend)registryr% r r# r _addHookY s r) c C s t j| dS )z
Remove a previously added adapter hook.
@param hook: An object previously returned by a call to L{_addHook}. This
will be removed from the list of adapter hooks.
N)r r& remove)hookr r r _removeHooko s r, c C s t S )zWReturns the Twisted global
C{zope.interface.adapter.AdapterRegistry} instance.
)r r r r r getRegistry} s r- c @ s0 e Zd ZdZdZdZdd Zdd Zdd Zd
S ) Adaptera/ 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.
r c C s
|| _ dS )z;Set my 'original' attribute to be the object I am adapting.Noriginalr r1 r r r __init__ s
zAdapter.__init__c C s t | jdr | j|S dS )zn
I forward __conform__ to self.original if it has it, otherwise I
simply return None.
__conform__N)hasattrr1 r4 r r r r r r4 s zAdapter.__conform__c C s | j ||S )z1
Forward isuper to self.original
)r1 isuper)r r! adapterr r r r7 s zAdapter.isuperN) __name__
__module__ __qualname____doc__temporaryAdaptermultiComponentr3 r4 r7 r r r r r. s r. c @ sj e Zd ZdZdZdd Zdd Zdd Zdd
d Zd d
Z dddZ
dd Z dd Z dddZ
dd ZdS )
Componentizeda 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.
r/ c C s
i | _ d S r )
_adapterCacher r r r r3
zComponentized.__init__c C s t |||S r )r )r klassr r r r r locateAdapterClass s z Componentized.locateAdapterClassc C s | ||| dS )zv
Cache a provider for the given interface, by adapting C{self} using
the given adapter class.
N) setComponent)r r adapterClassr r r
setAdapter s zComponentized.setAdapterr c C s || }| || |S )zUtility method that calls addComponent. I take an adapter class and
instantiate it with myself as the first argument.
@return: The adapter instantiated.
) addComponent)r rF ignoreClassadaptr r r
addAdapter s zComponentized.addAdapterc C s || j t|< dS )z:
Cache a provider of the given interface.
Nr@ r qual)r r componentr r r rE s zComponentized.setComponentc C s> t |D ]}|s| | j|d|jkr || jt|< qdS )a
Add a component to me, for all appropriate interfaces.
In order to determine which interfaces are appropriate, the component's
provided interfaces will be scanned.
If the argument 'ignoreClass' is True, then all interfaces are
considered appropriate.
Otherwise, an 'appropriate' interface is one for which its class has
been registered as an adapter for my class according to the rules of
getComponent.
N)r r rD __class__r@ r rM )r rN rI r! r r r rH s zComponentized.addComponentc C s | j t|= dS )z;Remove my component specified by the given interface class.NrL )r r r r r unsetComponent s z Componentized.unsetComponentc C s@ g }t | j D ]\}}||u r | j|= |t| q |S )z
Remove the given component from me entirely, for all interfaces for which
it has been registered.
@return: a list of the interfaces that were removed.
)listr@ itemsr' r namedObject)r rN lkvr r r removeComponent s z Componentized.removeComponentNc C st t |}|| jv r| j| S || }|dur2t|dr |js2|| j|< t|dr2|jr2| | |du r8|S |S )a Create or retrieve an adapter for the given interface.
If such an adapter has already been created, retrieve it from the cache
that this instance keeps of all its adapters. Adapters created through
this mechanism may safely store system-specific state.
If you want to register an adapter that will be created through
getComponent, but you don't require (or don't want) your adapter to be
cached and kept alive for the lifetime of this Componentized object,
set the attribute 'temporaryAdapter' to True on your adapter class.
If you want to automatically register an adapter for all appropriate
interfaces (with addComponent), set the attribute 'multiComponent' to
True on your adapter class.
Nr= r> )r rM r@ __adapt__r5 r= r> rH )r r r rU r8 r r r getComponent s
zComponentized.getComponentc C s
| |S r )rY r6 r r r r4 # rB zComponentized.__conform__)r r )r9 r: r; r< persistenceVersionr3 rD rG rK rE rH rP rW rY r4 r r r r r? s
r? c @ s" e Zd Zdd ZdefddZdS )ReprableComponentizedc C s t | d S r )r? r3 rA r r r r3 ( s z ReprableComponentized.__init__returnc C s& ddl m } t }|| j| | S )Nr )pprint)r] r r@ getvalue)r r] sior r r __repr__+ s z ReprableComponentized.__repr__N)r9 r: r; r3 strr` r r r r r[ ' s r[ r1 c sX fdd}d|i}| D ] }t | ||< q tdt| dtf|}t|| |S )a
Create a class which proxies all method calls which adhere to an interface
to another provider of that interface.
This function is intended for creating specialized proxies. The typical way
to use it is by subclassing the result::
class MySpecializedProxy(proxyForInterface(IFoo)):
def someInterfaceMethod(self, arg):
if arg == 3:
return 3
return self.original.someInterfaceMethod(arg)
@param iface: The Interface to which the resulting object will conform, and
which the wrapped object must provide.
@param originalAttribute: name of the attribute used to save the original
object in the resulting class. Default to C{original}.
@type originalAttribute: C{str}
@return: A class whose constructor takes the original object as its only
argument. Constructing the class creates the proxy.
c s t | | d S r )setattrr2 originalAttributer r r3 L s z#proxyForInterface..__init__r3 z (Proxy for ))_ProxyDescriptortyper rM objectr classImplements)r! rd r3 contentsnameproxyr rc r proxyForInterface3 s rm c @ s e Zd ZdZdd Zdd ZdS )_ProxiedClassMethoda
A proxied class method.
@ivar methodName: the name of the method which this should invoke when
called.
@type methodName: L{str}
@ivar __name__: The name of the method being proxied (the same as
C{methodName}).
@type __name__: L{str}
@ivar originalAttribute: name of the attribute of the proxy where the
original object is stored.
@type originalAttribute: L{str}
c C s | | _ | _|| _d S r )
methodNamer9 rd )r ro rd r r r r3 j s
z _ProxiedClassMethod.__init__c O s& t || j}t || j}||i |S )z
Invoke the specified L{methodName} method of the C{original} attribute
for proxyForInterface.
@param oself: an instance of a L{proxyForInterface} object.
@return: the result of the underlying method.
)getattrrd ro )r oselfargskwr1 actualMethodr r r __call__n s z _ProxiedClassMethod.__call__N)r9 r: r; r< r3 ru r r r r rn Y s rn c @ s2 e Zd ZdZdd Zd ddZdd Zd d
ZdS ) rf a
A descriptor which will proxy attribute access, mutation, and
deletion to the L{_ProxyDescriptor.originalAttribute} of the
object it is being accessed from.
@ivar attributeName: the name of the attribute which this descriptor will
retrieve from instances' C{original} attribute.
@type attributeName: C{str}
@ivar originalAttribute: name of the attribute of the proxy where the
original object is stored.
@type originalAttribute: C{str}
c C s || _ || _d S r )
attributeNamerd )r rv rd r r r r3 s
z_ProxyDescriptor.__init__Nc C s. |du r t | j| jS t|| j}t|| jS )zL
Retrieve the C{self.attributeName} property from I{oself}.
N)rn rv rd rp )r rq rg r1 r r r __get__ s z_ProxyDescriptor.__get__c C s t || j}t|| j| dS )zE
Set the C{self.attributeName} property of I{oself}.
N)rp rd rb rv )r rq valuer1 r r r __set__ s z_ProxyDescriptor.__set__c C s t || j}t|| j dS )zH
Delete the C{self.attributeName} property of I{oself}.
N)rp rd delattrrv )r rq r1 r r r
__delete__ s z_ProxyDescriptor.__delete__r )r9 r: r; r< r3 rw ry r{ r r r r rf | s
rf )r r r. r? r[ r- rm Nr0 ) r< ior typingr zope.interfacer r zope.interface.adapterr twisted.pythonr r r r r r) r, r- TypeError CannotAdaptr. r? r[ rm rn rf __all__r r r r s, *u
&# +