WOc & @ s d d k Z d d k Z d d k Z d d k Z d d k Z d d k Z d d k Z e d Z d d k l
Z
y d d k Z Wn e j
o d d k
Z n Xe e d e p
e i d^ j Z e o
e Z n e i d_ j o d d k Z e e i f Z nz d d e d d f Z y e i i d e Wn e j
o d d k Z n Xd d k Z e i i e e e i f Z e Z e o d d k Z n3 y d d k Z Wn e j
o d d k Z n Xd
Z! e e d e! Z! e i d` j o d
e" f d YZ# n d
e" f d YZ# e o
d Z$ n
e i$ Z$ e o d d k% l& Z& n
e i& Z& y d d k' l( Z( Wn) e j
o d e" f d YZ( n Xd d Z) d Z* d Z+ y d d k% l, Z, Wn" e j
o da db d Z, n Xy d d k% l- Z- Wn d Z- n Xd d Z. d! Z/ d" Z0 e i dc j o
d# Z1 n
d$ Z1 d% Z2 d& Z3 d' Z4 e5 d( Z6 e5 d) Z7 d* Z8 d+ Z9 d, Z: d- Z; d. Z< e5 d/ Z= d d0 Z> d1 Z? d2 Z@ d3 aA d4 ZB d5 ZC d d d6 d d7 ZD d8 eE f d9 YZF d: e" f d; YZG d< e f d= YZH d> eE f d? YZI d@ eI f dA YZJ dB ZK e ZL e" ZM eH ZN e# ZO e dC ZP dD eE f dE YZQ dF eE f dG YZR dH eR f dI YZS dJ eE f dK YZT dL eT _U dL eE f dM YZV d d d dN ZW dO ZX dP eE f dQ YZY dR eE f dS YZZ dT Z[ dU e i\ f dV YZ] dW Z^ dX Z_ dY Z` d e5 dZ Za d e5 d[ Zb d d\ Zc d] Zd d S(d iNt types( t exct py3kwarningi i i i t ignorec C s | S( N( ( t x( ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyt buffer2 s R i t PopulateDictc B s e Z d Z d Z d Z RS( s A dict which populates missing values via a creation function.
Note the creation function takes a key, unlike
collections.defaultdict.
c C s
| | _ d S( N( t creator( t selfR ( ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyt __init__@ s c C s | i | | | <} | S( N( R ( R t keyt val( ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyt __missing__C s ( t __name__t
__module__t __doc__R R ( ( ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyR 8 s c B s e Z d Z d Z d Z RS( s> A dict which populates missing values via a creation function.c C s
| | _ d S( N( R ( R R ( ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyR J s c C sF y t i | | SWn+ t j
o | i | | | <} | SXd S( N( t dictt __getitem__t KeyErrorR ( R R
t value( ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyR M s
( R
R R R R ( ( ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyR G s c C s
t | d S( Nt __call__( t hasattr( t fn( ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyt callableU s ( t reduce( t defaultdictR c B sS e Z d d Z d Z d Z d Z d Z d Z d Z d Z
RS( c O sN | d j o! t | d o t d n t i | | | | | _ d S( NR s first argument must be callable( t NoneR t TypeErrorR R t default_factory( R R t at kw( ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyR c s
c C s8 y t i | | SWn t j
o | i | SXd S( N( R R R R ( R R
( ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyR i s c C s8 | i d j o t | n | i | | <} | S( N( R R R ( R R
R ( ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyR n s c C sH | i d j o
t } n
| i f } t | | d d | i f S( N( R R t tuplet typet iteritems( R t args( ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyt
__reduce__s s
c C s
| i S( N( t __copy__( R ( ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyt copyy s c C s t | | i | S( N( R R ( R ( ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyR$ { s c C s1 d d k } t | | i | i | i S( Ni( R% R R t deepcopyt items( R t memoR% ( ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyt __deepcopy__} s c C s d | i t i | f S( Ns defaultdict(%s, %s)( R R t __repr__( R ( ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyR* s N( R
R R R R R R# R% R$ R) R* ( ( ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyR b s c C s8 | d j o | St | t t f p | g S| Sd S( N( R t
isinstancet listR ( R t default( ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyt to_list s
c C s> | d j o t St | t p t t | S| Sd S( N( R t setR+ R. ( R ( ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyt to_set s
c C s> | d j o t St | t p t t | S| Sd S( N( R t
column_setR+ R. ( R ( ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyt
to_column_set s
( t update_wrapperR R R
t __dict__c C sa x' | D] } t | | t | | q Wx0 | D]( } t | | i t | | d q1 W| S( N( ( t setattrt getattrt update( t wrappert wrappedt assignedt updatedt attr( ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyR3 s &( t partialc s f d } | S( Nc s* i } | i | | | S( N( R% R7 ( t fargst fkeywordst newkeywords( R" t funct keywords( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyt newfunc s
( ( RA R" RB RC ( ( RB R" RA s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyR= s c s f d } | S( Nc sC t i f d f d } t | S( Nc sr og d j o
t i } n
t i } d i t i d d f } t i | | d d n d S( Nt pendings %s%s now accepts multiple %s arguments as a variable argument list. Supplying %s as a single list is deprecated and support will be removed in a future release.i t
stackleveli ( R t SAPendingDeprecationWarningt SADeprecationWarningt func_namet inspectt
formatargspect warningst warn( t warning_typet msg( t list_deprecationt specR ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyt
_deprecate s
c sO t | d t o* | t | d d ! | d | S| | | Sd S( Nii ( R+ R, ( R R" R ( RQ ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyt go s #( RI t
getargspect decorator( R RR ( RO ( R RQ RP s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyt decorate s ( ( RO RU ( ( RO s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyt accepts_a_list_as_starargs s c ' s t | } x | D]{ t i f t i f d t d } xB | D]* } | | j o | i | | VPqP qP Wt d q Wd S( Nc s t | S( ( t str( t i( t base( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyt s i s& exhausted namespace for symbol base %s( R/ t itertoolst chaint imapt xranget addt NameError( t usedt basest poolt sym( ( RY s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyt unique_symbols s
c s f d } t | S( s' A signature-matching decorator factory.c s t i | } t | d | d d !| i f } t | d d \ } } t d | d | } | i t | d t d | } t | h | 6| | 6 } t
| d | i | _ t | | S( Ni i i t targetR t groupeds1 lambda %(args)s: %(target)s(%(fn)s, %(apply_kw)s)t im_func(
RI RS R RH Re R R7 t format_argspec_plust Falset evalR6 t
func_defaultsR3 ( R RP t namest targ_namet fn_namet metadatat codet decorated( Rf ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyRU s % ( R3 ( Rf RU ( ( Rf s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyRT s
c C s` g } xM | i | i | i f D]3 } t | d o | i } n | i | q Wt | S( sz decode a slice object as sent to __getitem__.
takes into account the 2.5 __index__() method, basically.
t __index__( t startt stopt stepR Rs t appendR ( t slct retR ( ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyt decode_slice s c C s | i | i | i f S( N( Rt Ru Rv ( Rx ( ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyRz s c c s[ xT | D]L } t | t o0 t | d o x" t | D] } | Vq; Wq | Vq Wd S( s Given an iterator of which further sub-elements may also be
iterators, flatten the sub-elements into a single iterator.
t __iter__N( R+ t
basestringR t flatten_iterator( R t elemt y( ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyR} s !
c C s x9 | i D]* } d | i j o t | g } Pq
q
Wg St } x | o | i } | i i d t } | p t | t i o qH n t i
| \ } } } } | i | | o | i | i qH qH W| i
d t | S( sm Return the full set of inherited kwargs for the given `cls`.
Probes a class's __init__ method, collecting all named arguments. If the
__init__ defines a \**kwargs catch-all, then the constructor is presumed to
pass along unrecognized keywords to it's base classes, and the collection
process is repeated recursively on each of the bases.
R R ( t __mro__R4 R/ t popt getRj R+ R t FunctionTypeRI RS R7 t __bases__t discardR, ( t clst ct stackR" t class_t ctrRm t _t has_kw( ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyt get_cls_kwargs s&
c C s t i | d S( s9 Return the full set of legal kwargs for the given `func`.i ( RI RS ( RA ( ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyt get_func_kwargs3 s c C sS t | o t i | p | } t i | } | d o | d d } n$ | d o d | d } n d
} t i | d | d | d } | d d
j o | d d t | d p d } t i | d | d | d | d d } | o t d | d | d
| d | St d | d d !d | d
| d d !d | d d ! Sd
S( s Returns a dictionary of formatted, introspected function arguments.
A enhanced variant of inspect.formatargspec to support code generation.
fn
An inspectable callable or tuple of inspect getargspec() results.
grouped
Defaults to True; include (parens, around, argument) lists
Returns:
args
Full inspect.formatargspec for fn
self_arg
The name of the first positional argument, varargs[0], or None
if the function defines no positional arguments.
apply_pos
args, re-written in calling rather than receiving syntax. Arguments are
passed positionally.
apply_kw
Like apply_pos, except keyword-ish args are passed as keywords.
Example::
>>> format_argspec_plus(lambda self, a, b, c=3, **d: 123)
{'args': '(self, a, b, c=3, **d)',
'self_arg': 'self',
'apply_kw': '(self, a, b, c=c, **d)',
'apply_pos': '(self, a, b, c, **d)'}
i i s %s[0]i i t formatvaluec S s d | S( t =( ( R ( ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyRZ b s R" t self_argt apply_post apply_kwiN( ( R RI RS RJ R t lenR ( R Rg RP R" R R t defaulted_valsR ( ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyRi 7 s # !4! c C s y t | d | SWnq t j
oe d } | t i j o | o d p d } n | o d p d } t d d d | d | d | SXd
S( s format_argspec_plus with considerations for typical __init__ methods
Wraps format_argspec_plus with error handling strategies for typical
__init__ cases::
object.__init__ -> (self)
other unreflectable (usually C) -> (self, *args, **kwargs)
Rg R s (self)s (self, *args, **kwargs)s self, *args, **kwargsR R" R R N( Ri R t objectR R ( t methodRg R R" ( ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyt format_argspec_initj s
c C sb y t i | SWnJ t j
o> | t i j o d g d d d f Sd g d d d f Sn Xd S( s inspect.getargspec with considerations for typical __init__ methods
Wraps inspect.getargspec with error handling for typical __init__ cases::
object.__init__ -> (self)
other unreflectable (usually C) -> (self, *args, **kwargs)
R R" t kwargsN( RI RS R R R R ( R ( ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyt getargspec_init s c C s. t | t i o | i o | i S| Sd S( sI Adjust the incoming callable such that a 'self' argument is not required.N( R+ R t
MethodTypet im_selfRh ( t func_or_cls( ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyt unbound_method_to_callable s c s; t | t i o t St | g t | i } x | o | i } t | t i o q< n x; f d | i D D] } | i | i | q W| i
d j p t | d o q< n xZ g } | i D] } | j o | | q q ~ D] } | i | i | qWq< Wt S( s Return an unordered sequence of all classes related to cls.
Traverses diamond hierarchies.
Fibs slightly: subclasses of builtin types are not returned. Thus
class_hierarchy(class A(object)) returns (A, object), not A plus every
class systemwide that derives from object.
Old-style classes are discarded and hierarchies rooted on them
will not be descended.
c 3 s> x7 | ]0 } | j o t | t i o | Vq q Wd S( N( R+ R t ClassType( t .0R ( t hier( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pys s t __builtin__t __subclasses__(
R+ R R R, R/ R R R Rw R_ R R R ( R t processR t bt _[1]R t s( ( R s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyt class_hierarchy s(
!9
c c s\ t | } xI | D]A } x8 | i D]- } | | i j o | | i | f VPq# q# Wq Wd S( s iterate all the keys and attributes associated with a class, without using getattr().
Does not use getattr() so that class-sensitive descriptors (i.e. property.__get__())
are not called.
N( t dirR R4 ( R t keysR
R ( ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyt iterate_attributes s
c C sj t | t t f oJ | i i } | d j o t S| d j o t St d
| n t | S( Nt truet yest onR t tt 1t falset not offt nt ft 0s String is not true/false: %r( R R R R R R ( R R R R R R ( R+ RW t unicodet stript lowert TrueRj t
ValueErrort bool( t obj( ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyt asbool s
c C s} | | j ol t | | | j oU | | d j oD | t j o | o t | | | | s N( R R! t iterR' R6 R R R ( R R ( ( R R s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyt dictlike_iteritems s
!c C s t | | o | St | t o? t i d | d i d | D t t | f n/ t i d | t | t t | f d S( Ns8 Argument '%s' is expected to be one of type %s, got '%s's or c s s# x | ] } d t | Vq Wd S( s '%s'N( RW ( R R ( ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pys s s6 Argument '%s' is expected to be of type '%s', got '%s'( R+ R R t
ArgumentErrort joinRW R ( t argt argtypet name( ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyt assert_arg_type s
?i c C s t | _ t d 7a d S( s Assign a '_creation_order' sequence to the given instance.
This allows multiple instances to be sorted in order of creation
(typically within a single thread; the counter is not particularly
threadsafe).
i N( t _creation_order( t instance( ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyt set_creation_order s c O s: y | | | SWn" t d t i d d ! n Xd S( sN executes the given function, catches all exceptions and converts to a warning.s %s('%s') ignoredi i N( RL t syst exc_info( RA R" R ( ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyt warn_exception, s s
self.proxyc B s | o
| } n | d j o
d } n g } e | D]O } | i d o9 | i d o) e | | o | | j o | | q9 q9 ~ } x6| D].} y< e | | }
e |
d p w n e |
d |
}
Wn e j
o
q n Xy= e i |
} e i | d
} e i | d
d }
Wn e
j
o d } d
}
n Xd e } | d j o h | | 6p h } | | Uy |
i | | _ Wn e j
o n Xe
| | | | q Wd S( s9 Automates delegation of __specials__ for a proxying type.t __slots__t __del__t __getattribute__t
__metaclass__t __getstate__t __setstate__t __R Rh i i s (self, *args, **kw)s
(*args, **kw)s? def %(method)s%(fn_args)s: return %(name)s.%(method)s%(d_args)sN( s __slots__s __del__s __getattribute__s
__metaclass__s __getstate__s __setstate__( R R t
startswitht endswithR R6 t AttributeErrorRI RS RJ R t localsRl R5 ( t into_clst from_clst skipt onlyR t
from_instancet dundersR t mR R RP t fn_argst d_argst pyt env( ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyt monkeypatch_proxied_specials3 sB
2
!t OrderedPropertiesc B s e Z d Z d Z d Z d Z d Z d Z d Z d Z d Z
d Z d
Z d Z
d Z d
Z d d Z d Z d Z d Z RS( sg An object that maintains the order in which attributes are set upon it.
Also provides an iterator and a very basic getitem/setitem
interface to those attributes.
(Not really a dict, since it iterates over values, not keys. Not really
a list, either, since each value must have a key associated; hence there is
no append or extend.)
c C s t | i d / s ( R/ R ( R R ( ( R s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyt intersection- s c sL t i f d D } | i f d D | S( Nc 3 s* x# | ] } | j o | Vq q Wd S( N( ( R R ( R ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pys 5 s c 3 s* x# | ] } | j o | Vq q Wd S( N( ( R R ( R ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pys 6 s ( R/ R R7 ( R R R ( ( R R s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyt symmetric_difference3 s c s) t | i f d | D S( Nc 3 s* x# | ] } | j o | Vq q Wd S( N( ( R R ( R ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pys = s ( R/ R ( R R ( ( R s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyt
difference; s c C sX t | } t i | | g } | i D] } | | j o | | q* q* ~ | _ | S( N( R/ t intersection_updateR ( R R R R ( ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyR A s 8c C s t i | | g } | i D] } | | j o | | q q ~ | _ | i g } | i D] } | | j o | | q] q] ~ 7_ | S( N( R/ t symmetric_difference_updateR ( R R R R t _[2]( ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyR I s 8>c C sL t i | | g } | i D] } | | j o | | q q ~ | _ | S( N( R/ t difference_updateR ( R R R R ( ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyR Q s 8N( R
R R R R_ R R R R R R{ R* t __str__R7 t __ior__R t __or__R t __and__R t __xor__R t __sub__R t __iand__R t __ixor__R t __isub__( ( ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyR s4 t IdentitySetc B ss e Z d Z e Z d' d Z d Z d Z d Z d Z
d Z d Z d Z
d Z d
Z d Z d Z d
Z d Z d Z d Z d Z d Z d Z d Z d Z d Z d Z d Z d Z d Z d Z d Z! d Z" d Z# d Z$ d Z% d! Z& d" Z' e' Z( d# Z) d$ Z* d% Z+ d& Z, RS(( s A set that considers only object id() for uniqueness.
This strategy has edge cases for builtin types- it's possible to have
two 'foo' strings in one of these sets, for example. Use sparingly.
c C s9 t | _ | o" x | D] } | i | q Wn d S( N( R t _membersR_ ( R R t o( ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyR c s
c C s | | i t | s ( R# R ( R ( ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyR3 s c C s" t | t p t S| i | S( N( R+ R" R, R ( R R ( ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyR s c C s | i | i | _ d S( N( R R# ( R R ( ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyR s c C s& t | t p t S| i | | S( N( R+ R" R, R ( R R ( ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyR s
c C s t | | i i S( N( R R# R ( R ( ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyR% s c C s
t | i S( N( R R# ( R ( ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyR s c C s
| i i S( N( R# R ( R ( ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyR{ s c C s t d d S( Ns set objects are unhashable( R ( R ( ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyt __hash__ s c C s d t | i | i i f S( Ns %s(%r)( R R
R# R ( R ( ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyR* s N(- R
R R R/ R2 R R R_ R R R R R R' R( R) R+ R- R. R/ R0 R1 R R R7 R R R R R! R R R R R R3 R R R R% R$ R R{ R6 R* ( ( ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyR" Y sR
t OrderedIdentitySetc B s* e Z d e f d YZ d d Z RS( R2 c B s e Z e Z RS( ( R
R R t __sa_hash_exempt__( ( ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyR2 $ s c C sF t i | t | _ | o" x | D] } | i | q' Wn d S( N( R" R R R# R_ ( R R R$ ( ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyR + s
N( R
R R R2 R R ( ( ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyR7 # s c c s& x | D] } t | | f Vq Wd S( s* Generator: ((id(o), o) for o in iterable).N( R% ( R R ( ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyR4 2 s c C sJ | } g } | D]/ } | | j o | i | o | | q q ~ S( N( R_ ( t seqt compare_witht seenR R ( ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyt unique_list? s t UniqueAppenderc B s, e Z d Z d d Z d Z d Z RS( s Appends items to a collection ensuring uniqueness.
Additional appends() of the same object are ignored. Membership is
determined by identity (``is a``) not equality (``==``).
c C sv | | _ t | _ | o t | | | _ nA t | d o | i | _ n! t | d o | i | _ n d S( NRw R_ ( t dataR" t _uniqueR6 t _data_appenderR Rw R_ ( R R> t via( ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyR J s c C s5 | | i j o! | i | | i i | n d S( N( R? R@ R_ ( R R ( ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyRw U s
c C s
t | i S( N( R R> ( R ( ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyR{ Z s N( R
R R R R Rw R{ ( ( ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyR= C s t ScopedRegistryc B sG e Z d Z d d Z d Z d Z d Z d Z d Z RS( sx A Registry that can store one or multiple instances of a single
class on a per-thread scoped basis, or on a customized scope.
createfunc
a callable that returns a new object to be placed in the registry
scopefunc
a callable that will return a key to store/retrieve an object.
If None, ScopedRegistry uses a threading.local object instead.
c C s& | p t i t St i | Sd S( N( R t __new__t _TLocalRegistry( R t
createfunct scopefunc( ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyRC j s c C s | | _ | | _ h | _ d S( N( RE RF t registry( R RE RF ( ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyR p s c C sK | i } y | i | SWn) t j
o | i i | | i SXd S( N( RF RG R R RE ( R R
( ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyR u s
c C s | i | i j S( N( RF RG ( R ( ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyt has| s c C s | | i | i ( R ( R ( ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyR* s ( R
R R R# R* ( ( ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyRK s RL c B s) e Z d Z h Z e i Z d Z RS( sI A constant symbol.
>>> symbol('foo') is symbol('foo')
True
>>> symbol('foo')
A slight refinement of the MAGICCOOKIE=object() pattern. The primary
advantage of symbol() is its repr(). They are also singletons.
Repeated calls of symbol('name') will all return the same instance.
c C sd | i i zB | i i | } | d j o t | | i | <} n | SWd t i i Xd S( N( t _lockt acquiret symbolsR R RK RL t release( R R Rd ( ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyRC s
( R
R R RO RI t LockRM RC ( ( ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyRL s
c C sW | o | o t d n t | t o t | | o | St | p9 g } t | D]! } | i d p | | q` q` ~ } t t | } t i } t | t o
| } n* | p t } t i } n
t | } | | i | | o | St | t
j oC | t i j o d p d } t d | | d i | f n d t f d Y}
| o d | i
|
_
n t } x t | D]w \ } }
| | j o t d
| n t |
p t d | |
f n t |
| t |
| i | qW| | | o |
St d d i | | d
S( s Ensure basic interface compliance for an instance or dict of callables.
Checks that ``obj`` implements public methods of ``cls`` or has members
listed in ``methods``. If ``required`` is not supplied, implementing at
least one interface method is sufficient. Methods present on ``obj`` that
are not in the interface are ignored.
If ``obj`` is a dict and ``dict`` does not meet the interface
requirements, the keys of the dictionary are inspected. Keys present in
``obj`` that are not in the interface will raise TypeErrors.
Raises TypeError if ``obj`` does not meet the interface criteria.
In all passing cases, an object with callable members is returned. In the
simple case, ``obj`` is returned as-is; if dict processing kicks in then
an anonymous class is returned.
obj
A type, instance, or dictionary of callables.
cls
Optional, a type. All public methods of cls are considered the
interface. An ``obj`` instance of cls will always pass, ignoring
``required``..
methods
Optional, a sequence of method names to consider as the interface.
required
Optional, a sequence of mandatory implementations. If omitted, an
``obj`` that provides at least one interface method is considered
sufficient. As a convenience, required may be a type, in which case
all public methods of the type are required.
s2 a class or collection of method names are requiredR s any ofs all ofs %r does not implement %s: %ss , t AnonymousInterfacec B s e Z d Z RS( s A callable-holding shell.( R
R R ( ( ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyRR s t Anonymouss %r: unknown in this interfaces %r=%r is not callables, dictionary does not contain required keys %sN( R R+ R R/ R R t operatort get gtR R R R R
R R R5 t staticmethodR_ ( R R t methodst requiredR R t interfacet implementedt compliest qualifierRR t foundR t impl( ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyt as_interface sF ! H
c C sN y
| | _ Wn: t j
o. t i | i | i | | i | i } n X| S( s Return a function with a given __name__.
Will assign to __name__ and return the original function if possible on
the Python implementation, otherwise a new function will be constructed.
( R
R R R t func_codet func_globalsRl t func_closure( R R ( ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyt function_named s
t memoized_propertyc B s# e Z d Z d d Z d Z RS( s2 A read-only @property that is only evaluated once.c C s, | | _ | p | i | _ | i | _ d S( N( t fgetR R
( R Rf t doc( ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyR ) s c C s3 | d j o d S| i | | i | i <} | S( N( R Rf R4 R
( R R R R ( ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyt __get__. s
N( R
R R R R Rh ( ( ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyRe ' s t memoized_instancemethodc B s# e Z d Z d d Z d Z RS( s Decorate a method memoize its return value.
Best applied to no-arg methods: memoization is not sensitive to
argument values, and will always return the same value even when
called with different arguments.
c C s, | | _ | p | i | _ | i | _ d S( N( Rf R R
( R Rf Rg ( ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyR = s c s@ d j o d S f d } i | _ i | _ | S( Nc sP i | | f d } i | _ i | _ | i i < S( Nc s S( ( ( R R ( R ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyRZ G s ( Rf R
R R4 ( R" R R( ( R R ( R s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyt oneshotE s ( R R
R ( R R R Rj ( ( R R s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyRh B s
N( R
R R R R Rh ( ( ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyRi 5 s c C s | i i | d d S( N( R4 R R ( R R ( ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyt reset_memoizedP s t WeakIdentityMappingc B s e Z d Z e d Z d Z d Z d Z d d Z e d Z
d Z d Z d Z
d d
Z d e i f d YZ d
Z RS( s) A WeakKeyDictionary with an object identity index.
Adds a .by_id dictionary to a regular WeakKeyDictionary. Trades
performance during mutation operations for accelerated lookups by id().
The usual cautions about weak dictionaries and iteration also apply to
this subclass.
t nonec C s& t i i | h | _ h | _ d S( N( t weakreft WeakKeyDictionaryR t by_idt _weakrefs( R ( ( s3 /usr/lib/python2.6/site-packages/sqlalchemy/util.pyR _ s c C s] t | } | | i | <| | i j o | i | | i | s H "
$
!
3 (ETd * Q T