Your IP : 216.73.216.196

Current Path : /opt/alt/python27/lib/python2.7/site-packages/logilab/common/
Upload File :
Current File : //opt/alt/python27/lib/python2.7/site-packages/logilab/common/decorators.pyo

�
�d{Tc@sldZddlmZdZddlZddlZddlmZmZddlm	Z	m
Z
ddlmZde
fd	��YZd
e
fd��YZdefd
��YZdefd��YZddd�Zde
fd��YZd�Zd�Zd�Zde
fd��YZde
fd��YZde
fd��YZd�Zd�Zdd�ZdS(s* A few useful function/method decorators. i����(tprint_functionsrestructuredtext enN(tclockttime(tisgeneratorfunctiont
getargspec(tmethod_typetcached_decoratorcBs#eZddd�Zdd�ZRS(cCs||_||_dS(N(t	cacheattrtkeyarg(tselfRR((sJ/opt/alt/python27/lib/python2.7/site-packages/logilab/common/decorators.pyt__init__"s	cCstt|�j�dks*|jdkr?t||j�}n6|jrct||j|j�}nt||j�}|j�S(Nii(	tlenRtargsRt_SingleValueCacheRt_MultiValuesKeyArgCachet_MultiValuesCachetclosure(R	tcallableobjtcache((sJ/opt/alt/python27/lib/python2.7/site-packages/logilab/common/decorators.pyt__call__%s*	N(t__name__t
__module__tNoneR
R(((sJ/opt/alt/python27/lib/python2.7/site-packages/logilab/common/decorators.pyR!sR
cBs/eZdd�Zd�Zd�Zd�ZRS(cCs5||_|dkr(d|j|_n	||_dS(Ns
_%s_cache_(tcallableRRR(R	RR((sJ/opt/alt/python27/lib/python2.7/site-packages/logilab/common/decorators.pyR
1s	cGsPy|j|jSWn7tk
rK|j||�}t||j|�|SXdS(N(t__dict__RtKeyErrorRtsetattr(t_SingleValueCache__meR	Rtvalue((sJ/opt/alt/python27/lib/python2.7/site-packages/logilab/common/decorators.pyR9s
csH�fd�}�|_y"�jj|_�jj|_WnnX|S(Ncs�j||�S(N(R(Rtkwargs(R	(sJ/opt/alt/python27/lib/python2.7/site-packages/logilab/common/decorators.pytwrappedBs(t	cache_objRt__doc__R(R	R((R	sJ/opt/alt/python27/lib/python2.7/site-packages/logilab/common/decorators.pyRAs	cCs|jj|jd�dS(N(RtpopRR(R	tholder((sJ/opt/alt/python27/lib/python2.7/site-packages/logilab/common/decorators.pytclearLsN(RRRR
RRR#(((sJ/opt/alt/python27/lib/python2.7/site-packages/logilab/common/decorators.pyR
0s		RcBseZd�Zd�ZRS(cCsEy|j|j}Wn*tk
r@i}t||j|�nX|S(N(RRRR(R	R"t_cache((sJ/opt/alt/python27/lib/python2.7/site-packages/logilab/common/decorators.pyt
_get_cacheQs
cOsN|j|�}y||SWn,tk
rI|j||�||<||SXdS(N(R%RR(t_MultiValuesCache__meR	RRR$((sJ/opt/alt/python27/lib/python2.7/site-packages/logilab/common/decorators.pyRYs
(RRR%R(((sJ/opt/alt/python27/lib/python2.7/site-packages/logilab/common/decorators.pyRPs	RcBseZdd�Zd�ZRS(cCs&tt|�j||�||_dS(N(tsuperRR
R(R	RRR((sJ/opt/alt/python27/lib/python2.7/site-packages/logilab/common/decorators.pyR
bscOsb|j|�}||jd}y||SWn/tk
r]|j|||�||<||SXdS(Ni(R%RRR(t_MultiValuesKeyArgCache__meR	RRR$tkey((sJ/opt/alt/python27/lib/python2.7/site-packages/logilab/common/decorators.pyRfs
N(RRRR
R(((sJ/opt/alt/python27/lib/python2.7/site-packages/logilab/common/decorators.pyRascKs4||d<t|�}|dkr&|S||�SdS(s0Simple decorator to cache result of method call.RN(RR(RRRt	decorator((sJ/opt/alt/python27/lib/python2.7/site-packages/logilab/common/decorators.pytcachedps

tcachedpropertycBs8eZdZdZd�Zed��Zdd�ZRS(s� Provides a cached property equivalent to the stacking of
    @cached and @property, but more efficient.

    After first usage, the <property_name> becomes part of the object's
    __dict__. Doing:

      del obj.<property_name> empties the cache.

    Idea taken from the pyramid_ framework and the mercurial_ project.

    .. _pyramid: http://pypi.python.org/pypi/pyramid
    .. _mercurial: http://pypi.python.org/pypi/Mercurial
    RcCs<y|jWn!tk
r.td|��nX||_dS(Ns!%s must have a __name__ attribute(RtAttributeErrort	TypeErrorR(R	R((sJ/opt/alt/python27/lib/python2.7/site-packages/logilab/common/decorators.pyR
�s
cCs-t|jdd�}d|r(d|ndS(NR s+<wrapped by the cachedproperty decorator>%ss
%st(tgetattrRR(R	tdoc((sJ/opt/alt/python27/lib/python2.7/site-packages/logilab/common/decorators.pyR �scCs9|dkr|S|j|�}t||jj|�|S(N(RRRR(R	tinsttobjtypetval((sJ/opt/alt/python27/lib/python2.7/site-packages/logilab/common/decorators.pyt__get__�s
(RN(RRR t	__slots__R
tpropertyRR5(((sJ/opt/alt/python27/lib/python2.7/site-packages/logilab/common/decorators.pyR,zs

	cCs:|j}t||�}t|t�r3|j}n|jS(N(t	__class__R0t
isinstanceR7tfgetR(tobjtfuncnametclstmember((sJ/opt/alt/python27/lib/python2.7/site-packages/logilab/common/decorators.pytget_cache_impl�s
	cCst||�j|�dS(s�Clear a cache handled by the :func:`cached` decorator. If 'x' class has
    @cached on its method `foo`, type

    >>> clear_cache(x, 'foo')

    to purge this method's cache on the instance.
    N(R?R#(R;R<((sJ/opt/alt/python27/lib/python2.7/site-packages/logilab/common/decorators.pytclear_cache�scCsEt||�j}yt|||j|�Wntk
r@nXdS(s/Copy cache for <funcname> from cacheobj to obj.N(R?RRRR(R;R<tcacheobjR((sJ/opt/alt/python27/lib/python2.7/site-packages/logilab/common/decorators.pyt
copy_cache�s

t	wpropertycBs)eZdZd�Zd�Zd�ZRS(s�Simple descriptor expecting to take a modifier function as first argument
    and looking for a _<function name> to retrieve the attribute.
    cCs||_d|j|_dS(Ns_%s(tsetfuncRtattrname(R	RD((sJ/opt/alt/python27/lib/python2.7/site-packages/logilab/common/decorators.pyR
�s	cCs|j||�dS(N(RD(R	R;R((sJ/opt/alt/python27/lib/python2.7/site-packages/logilab/common/decorators.pyt__set__�scCst||j�S(N(R0RE(R	R;R=((sJ/opt/alt/python27/lib/python2.7/site-packages/logilab/common/decorators.pyR5�s(RRR R
RFR5(((sJ/opt/alt/python27/lib/python2.7/site-packages/logilab/common/decorators.pyRC�s		t
classpropertycBs eZdZd�Zd�ZRS(sCthis is a simple property-like class but for class attributes.
    cCs
||_dS(N(tget(R	RH((sJ/opt/alt/python27/lib/python2.7/site-packages/logilab/common/decorators.pyR
�scCs
|j|�S(N(RH(R	R2R=((sJ/opt/alt/python27/lib/python2.7/site-packages/logilab/common/decorators.pyR5�s(RRR R
R5(((sJ/opt/alt/python27/lib/python2.7/site-packages/logilab/common/decorators.pyRG�s	ticlassmethodcBs)eZdZd�Zd�Zd�ZRS(s�Descriptor for method which should be available as class method if called
    on the class or instance method if called on an instance.
    cCs
||_dS(N(tfunc(R	RJ((sJ/opt/alt/python27/lib/python2.7/site-packages/logilab/common/decorators.pyR
�scCs5|dkr"t|j||j�St|j||�S(N(RRRJR8(R	tinstanceR3((sJ/opt/alt/python27/lib/python2.7/site-packages/logilab/common/decorators.pyR5�scCstd��dS(Nscan't set attribute(R-(R	RKR((sJ/opt/alt/python27/lib/python2.7/site-packages/logilab/common/decorators.pyRF�s(RRR R
R5RF(((sJ/opt/alt/python27/lib/python2.7/site-packages/logilab/common/decorators.pyRI�s		cs�fd�}|S(NcsMt�}t�}�||�}td�jt�|t�|f�|S(Ns%s clock: %.9f / time: %.9f(RRtprintR(RRtttctres(tf(sJ/opt/alt/python27/lib/python2.7/site-packages/logilab/common/decorators.pytwrap�s		((RPRQ((RPsJ/opt/alt/python27/lib/python2.7/site-packages/logilab/common/decorators.pyttimed�scs��fd�}|S(s�Decorator taking two methods to acquire/release a lock as argument,
    returning a decorator function which will call the inner method after
    having called acquire(self) et will call release(self) afterwards.
    cs���fd�}|S(Ncs0�|�z�|||�SWd�|�XdS(N((R	RR(tacquireRPtrelease(sJ/opt/alt/python27/lib/python2.7/site-packages/logilab/common/decorators.pytwrapper�s
((RPRU(RSRT(RPsJ/opt/alt/python27/lib/python2.7/site-packages/logilab/common/decorators.pyR*�s((RSRTR*((RSRTsJ/opt/alt/python27/lib/python2.7/site-packages/logilab/common/decorators.pytlocked�scs��fd�}|S(s}Decorator extending class with the decorated callable. This is basically
    a syntactic sugar vs class assignment.

    >>> class A:
    ...     pass
    >>> @monkeypatch(A)
    ... def meth(self):
    ...     return 12
    ...
    >>> a = A()
    >>> a.meth()
    12
    >>> @monkeypatch(A, 'foo')
    ... def meth(self):
    ...     return 12
    ...
    >>> a.foo()
    12
    csKy�p|j}Wn!tk
r6td|��nXt�||�|S(NsI%s has no __name__ attribute: you should provide an explicit `methodname`(RR-R(RJtname(tklasst
methodname(sJ/opt/alt/python27/lib/python2.7/site-packages/logilab/common/decorators.pyR*s
((RXRYR*((RXRYsJ/opt/alt/python27/lib/python2.7/site-packages/logilab/common/decorators.pytmonkeypatch�s	(R t
__future__Rt
__docformat__tsysttypesRRtinspectRRtlogilab.common.compatRtobjectRR
RRRR+R,R?R@RBRCRGRIRRRVRZ(((sJ/opt/alt/python27/lib/python2.7/site-packages/logilab/common/decorators.pyt<module>s, 
&