Ñò
Get an enclosing frame that skips DecoratorTools callback codet __name__( t syst _getframet f_globalst getR t f_back( R t level( ( s8 /usr/lib/python2.6/site-packages/peak/util/decorators.pyR
$ s
c C sk d d k l } l } | i } | d j o
d } n | | ƒ \ } } } } | | | | | ƒ d d !f S( Niÿÿÿÿ( t
formatargspect
getargspecs t anonymousi ( t inspectR R! R ( t funcR R! t funcnamet argst varargst kwargst defaults( ( s8 /usr/lib/python2.6/site-packages/peak/util/decorators.pyt
name_and_spec* s
c C s) | i } | o | d | i p | i S( Nt .( t
__module__R ( R$ t m( ( s8 /usr/lib/python2.6/site-packages/peak/util/decorators.pyt qname3 s c N sò e | ƒ \ } } e | ƒ \ } } | i i d d ƒ i d d ƒ } h } d | d } | e ƒ ;} d e | ƒ e | ƒ e | ƒ f }
e | |
d ƒ | i | U| | | | | Ž } e |
| | ƒ | i | _ | i | _ | i
| _
| S( Nt %s %%s $argss %(argspec)ssA
def %(wrapname)s(%(wrapspec)s):
def %(funcname)s(%(argspec)s): s
return %(funcname)s
s <%s wrapping %s at 0x%08X>t exec( R* t __doc__t replacet localsR. t idt compilet func_globalsR t
func_defaultst __dict__( t wrapperR$ R& t kwR% t argspect wrapnamet wrapspect bodyR t filenamet f( ( s8 /usr/lib/python2.6/site-packages/peak/util/decorators.pyt apply_template8 s !
% c C s d „ } t | | | ƒ S( s Create a wrapper with the signature of `func` and a body of `wrapper`
Example::
def before_and_after(func):
def decorated(*args, **kw):
print "before"
try:
return func(*args, **kw)
finally:
print "after"
return rewrap(func, decorated)
The above function is a normal decorator, but when users run ``help()``
or other documentation tools on the returned wrapper function, they will
see a function with the original function's name, signature, module name,
etc.
This function is similar in use to the ``@template_function`` decorator,
but rather than generating the entire decorator function in one calling
layer, it simply generates an extra layer for signature compatibility.
NOTE: the function returned from ``rewrap()`` will have the same attribute
``__dict__`` as the original function, so if you need to set any function
attributes you should do so on the function returned from ``rewrap()``
(or on the original function), and *not* on the wrapper you're passing in
to ``rewrap()``.
c S s d S( s return __decorated($args)N( ( t
__originalt __decorated( ( s8 /usr/lib/python2.6/site-packages/peak/util/decorators.pyR p s ( RA ( R$ R9 R ( ( s8 /usr/lib/python2.6/site-packages/peak/util/decorators.pyR S s s 2.5c C sê | d j o t i i ƒ } n" | t i j o
| g } n d Sx¢ | D]š } t i | \ } } } } | d j o qH n y t i | ƒ } Wn# t i j
o t i | =qH n X| | i j p | | i j o t i | =qH qH Wd S( sY Discard cache entries that are out of date.
(This is not checked upon each call!)N( t Nonet linecachet cachet keyst ost statt errort st_sizet st_mtime( R? t filenamest sizet mtimet linest fullnameRI ( ( s8 /usr/lib/python2.6/site-packages/peak/util/decorators.pyt
checkcache~ s"
c s˜ | d j o
ˆ } n) d d k l } | | ‡ f d † ƒ } d d k a t i d j o t i i t j o
t t _ n d d | | f t i ˆ š s s 2.5i (
RD t weakrefRS RE R t versionRR R, R RF ( R? RP t ownerRS ( ( R? s8 /usr/lib/python2.6/site-packages/peak/util/decorators.pyt _cache_lines• s
#
c C s t | | i t ƒ | ƒ d S( N( RZ t
splitlinest True( R? t sourceRY ( ( s8 /usr/lib/python2.6/site-packages/peak/util/decorators.pyR s c C s( | d j o t d „ ƒ St i | ƒ S( sË Decorator that uses its wrapped function's docstring as a template
Example::
def before_and_after(func):
@template_function
def wrap(__func, __message):
'''
print "before", __message
try:
return __func($args)
finally:
print "after", __message
'''
return wrap(func, "test")
The above code will return individually-generated wrapper functions whose
signature, defaults, ``__name__``, ``__module__``, and ``func_globals``
match those of the wrapped functions.
You can use define any arguments you wish in the wrapping function, as long
as the first argument is the function to be wrapped, and the arguments are
named so as not to conflict with the arguments of the function being
wrapped. (i.e., they should have relatively unique names.)
Note that the function body will *not* have access to the globals of the
calling module, as it is compiled with the globals of the *wrapped*
function! Thus, any non-builtin values that you need in the wrapper should
be passed in as arguments to the template function.
c S s
t | ƒ S( ( R
( R@ R R t o( ( s8 /usr/lib/python2.6/site-packages/peak/util/decorators.pyRV Å s N( RD R RA t __get__( R9 ( ( s8 /usr/lib/python2.6/site-packages/peak/util/decorators.pyR
¥ s
c s ‡ ‡ f d † } t | ƒ S( s‰ Turn a function into a simple data structure class
This decorator creates a tuple subclass with the same name and docstring as
the decorated function. The class will have read-only properties with the
same names as the function's arguments, and the ``repr()`` of its instances
will look like a call to the original function. The function should return
a tuple of values in the same order as its argument names, as it will be
used by the class' constructor. The function can perform validation, add
defaults, and/or do type conversions on the values.
If the function takes a ``*``, argument, it should flatten this argument
into the result tuple, e.g.::
@struct()
def pair(first, *rest):
return (first,) + rest
The ``rest`` property of the resulting class will thus return a tuple for
the ``*rest`` arguments, and the structure's ``repr()`` will reflect the
way it was created.
The ``struct()`` decorator takes optional mixin classes (as positional
arguments), and dictionary entries (as keyword arguments). The mixin
classes will be placed before ``tuple`` in the resulting class' bases, and
the dictionary entries will be placed in the class' dictionary. These
entries take precedence over any default entries (e.g. methods, properties,
docstring, etc.) that are created by the ``struct()`` decorator.
c s ‡ f d † } ‡ f d † } d d k } | i ˆ ƒ \ } } } }
t d | d | d ˆ i d ˆ i d | d | d
g ƒ } xH t | ƒ D]: \ } }
t |
t ƒ o t | d d „ ƒ | |
Metaclass that delegates selected operations back to the classc C sL t t | ƒ i | | | | ƒ } t | d ƒ i } | ƒ | | | | | ƒ S( Nt
__class_new__( t superRµ Rb R´ t next( R‡ Rg R… R† Rc t supr( ( s8 /usr/lib/python2.6/site-packages/peak/util/decorators.pyRb p s !c C s+ t | d ƒ i } | ƒ | | | | | ƒ S( Nt __class_init__( R´ R¸ ( Rc Rg R… R† R¹ ( ( s8 /usr/lib/python2.6/site-packages/peak/util/decorators.pyt __init__u s c O s | i i | | | Ž S( N( t __class_call__R² ( Rc R& R: ( ( s8 /usr/lib/python2.6/site-packages/peak/util/decorators.pyt __call__y s ( R R, R1 Rb R» R½ ( ( ( s8 /usr/lib/python2.6/site-packages/peak/util/decorators.pyRµ m s c B sA e Z d Z e Z d Z d „ Z d „ Z d „ Z e e ƒ Z RS( s: Base class for classes that want to be their own metaclassc C s t i | | | | ƒ S( N( R` Rb ( R‡ Rg R… R† R¹ ( ( s8 /usr/lib/python2.6/site-packages/peak/util/decorators.pyR¶ ‚ s c C s t i | | | | ƒ S( N( R` R» ( Rc Rg R… R† R¹ ( ( s8 /usr/lib/python2.6/site-packages/peak/util/decorators.pyRº … s c O s t i | | | Ž S( N( R` R½ ( Rc R& R: ( ( s8 /usr/lib/python2.6/site-packages/peak/util/decorators.pyR¼ ˆ s ( (
R R, R1 Rµ R„ Rj R¶ Rº R¼ t classmethod( ( ( s8 /usr/lib/python2.6/site-packages/peak/util/decorators.pyR } s (! t typesR R R RH t __all__R RD R
R* R. RA R RX RR RZ R R
R R R t FalseR R R– RŽ R R R´ R` Rµ t objectR ( ( ( s8 /usr/lib/python2.6/site-packages/peak/util/decorators.pyt s8 ) ) R ) )M " )R