ҥq0O d Z ddlmZ ddlZddlZddlZddlZddlZddlZddl Z ddl
Z
ddl Z ddl m
Z
ddl mZ ddl mZ d Z G d
d e Zd Zd
Zd Zd Zd Zd ZdZdZ G d de Zd ZdZdZ d Z d[dZ d\dZ d\d Z d Z!d Z"d]d Z# G d! d"e Z$d# Z%d$ Z& d^d&Z'd' Z(d_d(Z) G d) d*e Z*d+ Z+ G d, d-e Z, G d. d/e Z-d`d0Z.d1 Z/d2 Z0d3 Z1dad4Z2d5 Z3d6 Z4dZd7Z5d8 Z6d9 Z7 G d: d;e8 Z9 G d< d=e Z: G d> d?e Z; G d@ dAe< Z=dBe=_> G dC dBe Z?da@dD ZAdE ZBdbdGZC G dH dIejD ZEdJ ZFdK ZGdL ZH ejI dM ZJ ejI dN ZKeKeJfdOZL eMd ZNdP ZO G dQ dReM ZPdS ZQdT ZRdU ZSdV ZTdW ZUdX ZVdY ZWdS )czRoutines to help with the creation, loading and introspection of
modules, classes, hierarchies, attributes, functions, and methods.
update_wrapperN ) _collections)compat )excc t j r| d } t j }| | | S )Nzutf-8)r py3kencodehashlibmd5update hexdigest)xms o/builddir/build/BUILD/cloudlinux-venv-1.0.10/venv/lib64/python3.11/site-packages/sqlalchemy/util/langhelpers.pymd5_hexr sE
{
HHW
AHHQKKK ;;== c * e Zd ZdZdZddZd Zd ZdS ) safe_reraiseaK Reraise an exception after invoking some
handler code.
Stores the existing exception info before
invoking so that it is maintained across a potential
coroutine context switch.
e.g.::
try:
sess.commit()
except:
with safe_reraise():
sess.rollback()
) warn_only _exc_infoFc || _ d S N)r )selfr s r __init__zsafe_reraise.__init__8 s
"r c 6 t j | _ d S r )sysexc_infor r s r __enter__zsafe_reraise.__enter__; s r c B |3| j \ }}}d | _ | j st j || d S d S t j s@| j r9| j d r,t d| j d d| j d d d | _ t j || d S )N)with_tracebackr z`An exception has occurred during handling of a previous exception. The previous exception is:
r
)r r r raise_r warn)r type_value tracebackexc_type exc_valueexc_tbs r __exit__zsafe_reraise.__exit__> s =*.. 'Hi !DN>
#)
;
4>
dnQ6G
(,~a'8'8'8$.:K:K:KM
"DN M% : : : : : :r NF)__name__
__module__ __qualname____doc__ __slots__r r" r/ r r r r $ sW " +I# # # #( ( (; ; ; ; ;r r c p d d t j d| j D S )Nr% c 3 > K | ]}| V d S r )lower).0ns r z(clsname_as_plain_name..V s; r z
([A-Z][a-z]+))joinrefindallr1 )clss r clsname_as_plain_namerA U sC 88 :&6 EE r c g }| j | j | j fD ];}t |d r| }| | z!_unique_symbols..n s D3q66M r i z&exhausted namespace for symbol base %s)set itertoolschainr itertools_imaprangeadd NameError)usedbasespoolsymrQ s @r _unique_symbolsr^ i s t99D M M
G !"9"9"9"95;; G G
M MC$
Dt KLL L M Mr c # L K |r || dz z } | | V ||z }| dS dS )z6Call the given function given each nonzero bit from n.r Nr6 )fnr; bs r map_bitsrb y sW
!aLbee Q r c . fd}t | S )z'A signature-matching decorator factory.c 4 t j | s#t j | st d t j | }t
|d |dd z | j fz }t |dd \ }}t || }|
t |d | j |d
< d |z }t |||| i| j }t | d | j |_ | |_ t! || S )
Nznot a decoratable functionr r targetr` )rf r` FgroupednamezDdef %(name)s(%(args)s):
return %(target)s(%(fn)s, %(apply_kw)s)
im_func)inspect
isfunctionismethod Exceptionr inspect_getfullargspecrI r1 r^ dictr format_argspec_plus_exec_code_in_envgetattr __defaults__ __wrapped__r ) r` specnames targ_namefn_namemetadatacode decoratedrf s r decoratezdecorator..decorate s( !"%% :g.>r.B.B : 899 9,R00d1gac*bk^; ,UHd C C 7yW555+D%@@@AAA ;
& 9fgr2BK
")Y!;!;!H " i,,,r r )rf r} s ` r decoratorr~ s. - - - - -2 (F + ++r c 2 t | | || S r )exec)r{ envry s r rr rr s sOOO w<r c
t | t r | j }| }d|r|n d| j z d|d}n | x}}d|z }| d d }t j | }|d d= t |d
}||d < d |z } |t d
}
t | |
|
| } t |d rG|j \ } }
| j }|| j
d| j }t |d|
d|d|dd }|| _ n |j | _ d| dd d z | _
| j
t j vrt% d| j
d t
j st |d r0||j _ t |j d s| |f|j _ n ||_ t |d s | |f|_ | S )zProduce a wrapping function for the given cls or classmethod.
Rationale here is so that the __init__ method of the
class can serve as documentation for the function.
zConstruct a new :class:`z.%szX` object.
This constructor is mirrored as a public API function; see :func:`sqlalchemyz,` for a full usage and argument description.zSThis function is mirrored; see :func:`sqlalchemy%s` for a description of arguments..r Frg ri z5def %(name)s(%(args)s):
return cls(%(apply_kw)s)
)r@ symbol
_linked_toNz[.. container:: inherited_member
This documentation is inherited from :func:`sqlalchemyz&`; this constructor, :func:`sqlalchemyz!`, creates a :class:`sqlalchemyzJ` object. See that class for additional details describing this subclass.r
sqlalchemyzpublic_factory location z is not in sys.modules__func__)
isinstancetyper r1 splitr ro rq r r rG r r4 r2 inject_docstring_textrsplitr modules ImportErrorpy2kr )rf locationclass_locationr` callable_doc
location_namerv rz r{ r r| linked_tolinked_to_location
linked_to_docs r public_factoryr sT &$
_ #1Mefo6MMM
Y
.08
9
NN3''+M ( , ,D Q
"4777H$HV v
.
.CsOOOM"Ir< '(*
% %!)
!(.(9(9(96?? KN- M "!!888^^^
=
* J '(//#q*A*A!*DDI3;..k###
&
{ 2gb*-- 2 ! r{L11 ;&/%:BK "
r<(( 2 & 1BM r c ( e Zd ZddZd Zd Zd ZdS ) PluginLoaderNc 0 || _ i | _ || _ d S r )groupimplsauto_fn)r r r s r r zPluginLoader.__init__ s
r c 8 | j d S r )r clearr! s r r zPluginLoader.clear s
r c || j v r | j | S | j r+| | }|r|| j |< | S dd l}| | j | D ]&}|j | j |< | c S n# t $ r Y nw xY wt j d| j d| )Nr zCan't load plugin: :) r r
pkg_resourcesiter_entry_pointsr loadr r NoSuchModuleError)r ri loaderr impls r r zPluginLoader.load s 4: #4:d#%% % < \\$''F
#)
4 vxx # &77
DII
#
##'9
4 yy{{"""
# D ##*.***dd ;
s B
B&%B&c * fd}|| j |< d S )Nc t j } d dd D ]}t | | } t | S )Nr r )r import_r rs )modtoken
modulepathobjnames r r z#PluginLoader.register..load sY .,,C#))#..qrr2
*
* c5))3(( (r )r )r ri r r r s `` r registerzPluginLoader.register s6 ) ) ) ) ) )
4r r )r1 r2 r3 r r r r r6 r r r r sU
. r r c t j }| j }|j }t |j d | t
|j |z fS # t $ r4 t j
| }|d t
|d fcY S w xY w)Nr r ) rk CO_VARKEYWORDS__code__ co_argcountlist co_varnamesboolco_flagsAttributeErrorr ro )r` co_varkeywordsconargsrv s r _inspect_func_argsr # s
/ [ ' ( ( ~- . .
& & &
,R00AwT!W
%%%%
&s A ;B
B
c |du }|rt }| j dd }|o8t |t j o t |j t j }|r-t | \ }}| | |s|sdS |r|r | j
D ]}t || n| d |S )ae 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 its base classes, and the
collection process is repeated recursively on each of the bases.
Uses a subset of inspect.getfullargspec() to cut down on method overhead,
as this is used within the Core typing system to create copies of type
objects which is a performance-sensitive operation.
No anonymous tuple arguments please !
Nr Fr )
rS __dict__getr types FunctionTyper CodeTyper r __bases__get_cls_kwargsdiscard)r@ _settoplevelctrhas_initrw has_kwcs r r r 7 s t|H uu
,
:u
-
-C 5 sE . / / 5 s|U^ 4 4
*3//
v E h 4 v A a&&. / LL Kr c 6 t j | d S )zReturn the set of legal kwargs for the given `func`.
Uses getargspec so is safe to call for methods, functions,
etc.
r )r ro funcs r get_func_kwargsr b s ( . .q 11r Fc t j | rt d| z t j | rq|r[|rYt j | }t j |j dd |j |j |j
|j |j |j
S t j | S t j | r|rg|s| j r^t j | j }t j |j dd |j |j |j
|j |j |j
S t j | j S t j | rt% | j |d S t) | d rt j | j S t) | d rAt j | j rt% | j | S t d | z t d | z )
zReturn the argument signature for any callable.
All pure-Python callables are accepted, including
functions, methods, classes, objects with __call__;
builtins and other edge cases like functools.partial() objects
raise a TypeError.
zCan't inspect builtin: %sr NT)no_self_is_initr __call__)r zCan't inspect callable: %s)rk isbuiltin TypeErrorrl r ro FullArgSpecargsvarargsvarkwdefaults
kwonlyargskwonlydefaults annotationsrm __self__r isclassget_callable_argspecr rG r )r` r r rv s r r r m s *;3b8999 B (; 5 5044D% !""
#
044 4 " ; > >BK >0==D% !""
#
0== = ;# K4
Z ;,R[999 Z ; BK ( ( ?' WEEE E 82 =>> >4r9:::r Tc t j | rt j | }n| }t j | }|d r|d d }n|d r d|d z }nd}t j |d |d |d d|d }d}|d r|t |d z
}|d r|t |d z
}|d |d z }|r|d|z
d }nd}t j ||d |d |d
} |rt |||| S t |dd ||dd | dd S )
a 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)'}
r r z%s[0]Nr re r6 c d| z S )N=r6 )r s r rR z%format_argspec_plus.. s
cAg r ) formatvalue)r self_arg apply_posapply_kwr )r callablero inspect_formatargspeclenrp )
r` rh rv r r r num_defaults name_argsdefaulted_valsr s
r rq rq s @ r ,R00 ' .D Aw 71:
a T!W$, Qa$q'4a I L Aw %DG $ Aw %DG $ Q$q'!I "1|#3#5#56+ Q Q%% H
ad "o ad^
r c | t j u r|rdpd}n( t | | S # t $ r |rdpd}Y nw xY wt d||| S )a 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)
z(self)r rg z(self, *args, **kwargs)zself, *args, **kwargs)r r r r )objectr rq r rp )methodrh r s r format_argspec_initr s #8-v &vw??? ? .-+*
DD ddT J J JJs ( ;;c t j | S # t $ r! | t j u r dgdddfcY S dgdddfcY S w xY w)zinspect.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 Nr kwargs)r ro r r r )r s r getargspec_initr sn 6,V444 6 6 6 V_ $ $HdD$/ / / /Hfh5 5 5 5 6s AA Ac V t | t j r| j s| j S | S )zSAdjust the incoming callable such that a 'self' argument is not
required.
)r r
MethodTyper r ) func_or_clss r unbound_method_to_callabler s2 +u /00 9M ##r r6 c V | g}nt j | }t g }t j }d}t | D ] \ }} t j |j } | j rt | j pd}
|dk rW| j
r| j
}|
r$| | j d|
nR| | j dd n/|
fd| j d|
D |
r@|
d t | j |
d | j D
# t $ r Y w xY wg } | fd|D |=t! | r-| d t# | D | D ]P\ } }
| |v r
t# | }|ur ||
k r| | d| A# t( $ r Y Mw xY w|rN|D ]K\ } }
t# | }|ur ||
k r| | d| <# t( $ r Y Hw xY w j j d d
| d S ) z}Produce a __repr__() based on direct association of the __init__()
specification vs. same-named attributes present.
Nr r c g | ]}|fS r6 r6 )r: argmissings r
z generic_repr..K s IIIc7^IIIr c g | ] \ }}||f
S r6 r6 )r: r defaults r r z generic_repr..P s0 (C g r c 3 T K | ]"}t t |d V #d S r )reprrs )r: r objs r r< z generic_repr..Y s7 DDC$wsC..//DDDDDDr c , g | ]}t | S r6 r )r: vals r r z generic_repr..\ s @@@StCyy@@@r r (, ))r to_listr OrderedDict enumerater ro r r r r extendr r zipr rG rs itemsrH rn __class__r1 r= )r
additional_kw
to_inspect
omit_kwargpos_argskw_argsvargsrP insprv default_lenoutputr defvalr r s ` @r generic_reprr , s[
U
!)*55
hhGH&((G E Z(( 4 0 ??D ->C
,>,>C!KAvv< ) LE 3 OODIa n$=>>>> OODIabbM2222IIIItyK< /HIII
,/ I{lmm 4dm- - # H 2 F
MMDDDD8DDDDDD WS% 0 0
@@GC,?,?@@@AAA }} V * #sG,,C'!!cVmm
cc 2333 D ( KC
c300g%%#--MMSSS##"6777
}---tyy/@/@/@/@ AAs6 E
E,+E,05H&&
H32H3 5I66
JJc 0 e Zd ZdZdZd Zd Zd dZd ZdS )
portable_instancemethodz_Turn an instancemethod into a (parent, name) pair
to produce a serializable callable.
)rf ri r __weakref__c , | j | j | j dS )Nrf ri r r" r! s r __getstate__z$portable_instancemethod.__getstate__| s kIk
r c p |d | _ |d | _ | dd | _ d S )Nrf ri r r6 )rf ri r r )r states r __setstate__z$portable_instancemethod.__setstate__ s1 Ho &M ii"-- r r6 c D |j | _ |j | _ || _ d S r )r rf r1 ri r )r methr s r r z portable_instancemethod.__init__ s m M r c v | | j t | j | j |i |S r )r r rs rf ri )r r kws r r z portable_instancemethod.__call__ s9
$+ .wt{DI..:r:::r Nr6 ) r1 r2 r3 r4 r5 r# r& r r r6 r r r r t sf
:I
. . .
; ; ; ; ;r r c
t j r(t | t j rt S | ht | j }|r&| }t j r/t |t j r>fd|j D }nfd|j D }|D ],}| |
| -t j r |j dk st |d sn |j dk st |d sوfd| D D ],}| |
| -|&t S )a 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 X K | ]$}|vt |t j |V %d S r )r r ClassTyper: _hiers r r< z"class_hierarchy.. sE D==Au)G)G= === r c 3 $ K | ]
}|v|V d S r r6 r/ s r r< z"class_hierarchy.. s' ==1q}}Q}}}}==r builtins__subclasses__ __builtin__c g | ]}|v| S r6 r6 r/ s r r z#class_hierarchy.. s AAA1D==!===r )r r r r r. r __mro__popr rH rX r r2 rG r4 )r@ processr r[ ra sr1 s @r class_hierarchyr; s { c5? + + 66M 5D3; G
KKMM ; >!U_--
EE >=== ===E A NN1 HHQKKKK ; |z)). sl
T""
JJt$$
!,,
TMM
"MMr r rj r r z(self, *args, **kw)z
(*args, **kw)z?def %(method)s%(fn_args)s: return %(name)s.%(method)s%(d_args)s) r= rs rG r r ro r r localsexec_rt setattr)rJ from_clsrK onlyri
from_instancedundersr r` rv fn_argsd_argspyr s ` ` r monkeypatch_proxied_specialsrV s
<D
]]
/ / 6**B2z**
Y++BB H %044D 247;;G1$q'!""+>>FF % % %+G$FFF %
35;XX
>
4'AT=,AGR R ')CK $ $ D &#f+....7/ /s< A!A!!
A.-A.2ACCCD
D('D(c F t | d| t |d| u S )z;Return True if the two methods are the same implementation.r )rs )meth1meth2s r methods_equivalentrZ s0 5*e , ,
z51 1 r c ` |s|st d t |t rt | | r| S t |pd t | D }t t | }t
j }t |t r|}n,|st }t
j }nt | } || | | r| S t | t s<|t
j u rdpd}t | d|dd
| G d d t }|rd
|j z |_ t } t | D ]w\ }
} |
|vrt d |
z t j | st |
d | d
t! ||
t# | | |
x || | r|S t dd
|| z
z )a 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.
z2a class or collection of method names are requiredc < g | ]}| d |S )r0 )rH )r: r s r r z as_interface..C s) M M Ma1<<;L;L M M M Mr zany ofzall ofz does not implement z: r
c e Zd ZdZdS )(as_interface..AnonymousInterfacezA callable-holding shell.N)r1 r2 r3 r4 r6 r r AnonymousInterfacer^ Z s ''''r r_ Anonymousz %r: unknown in this interfacer z is not callablez,dictionary does not contain required keys %s)r r r rS r= operatorgegt intersectionrp r= r r1 dictlike_iteritemsr r rN staticmethodrX ) r r@ methodsrequired interface implementedcomplies qualifierr_ foundr r s r as_interfacern s~ B Nw NLMMM#t C!5!5
GM M M3s88 M M MNNIc#hh--K{H(D!! !
!55;x==x ((33X>>
c4
+8DH ssIIItyy 3 3 3
5
( ( ( ( (V ( ( ( A&1CL&@# EEE*3// " " ;f DEE Et$$ Fvvvttt DEE E"FL,>,>???
&xx "!!
6
))Hu$
%
% & r c < e Zd ZdZddZd Zd Zed ZdS )memoized_propertyz2A read-only @property that is only evaluated once.Nc H || _ |p|j | _ |j | _ d S r )fgetr4 r1 )r rr r s r r zmemoized_property.__init__u s$ *dl
r c V || S | | x|j | j < }|S r )rr r r1 )r r r@ results r __get__zmemoized_property.__get__z s. ;K/3yy~~= T]#f
r c F t || j d S r )rp resetr1 )r r s r _resetzmemoized_property._reset s T]33333r c < |j |d d S r )r r8 )r@ r ri s r rw zmemoized_property.reset s t$$$$$r r ) r1 r2 r3 r4 r ru rx classmethodrw r6 r r rp rp r sg <<& & & &
4 4 4 % % [% % %r rp c . fd}t | S )zDecorate 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 z | g|R i |fd}j |_ j |_ || j j < S )Nc S r r6 ar* rt s r memoz6memoized_instancemethod..oneshot..memo s Mr )r1 r4 r )r r r* r rt r` s @r oneshotz(memoized_instancemethod..oneshot sc D&4&&&2&&
z %)
bk"
r r )r` r s ` r memoized_instancemethodr s. '2 & &&r c , e Zd ZdZddZd Zd Zd ZdS ) !group_expirable_memoized_propertyz?A family of @memoized_properties that can be expired in tandem.r6 c P g | _ |r | j | d S d S r )
attributesr )r r s r r z*group_expirable_memoized_property.__init__ s7 / O " ": . . . . . / /r c T |j }| j D ]}| |d dS )z.Expire all memoized properties for *instance*.N)r r r8 )r instancestash attributes r expire_instancez1group_expirable_memoized_property.expire_instance s< ! ' 'I IIi & & & & ' 'r c ^ | j |j t | S r )r rH r1 rp r r` s r r z*group_expirable_memoized_property.__call__ s( r{+++ $$$r c ^ | j |j t | S r )r rH r1 r r s r r z(group_expirable_memoized_property.method s( r{+++&r***r Nr+ )r1 r2 r3 r4 r r r r r6 r r r r s[ II/ / / /
' ' ' % % %+ + + + +r r c " e Zd ZdZdZd Zd ZdS )
MemoizedSlotszApply memoized items to an object using a __getattr__ scheme.
This allows the functionality of memoized_property and
memoized_instancemethod to be available to a class using __slots__.
r6 c t | r )r )r r? s r _fallback_getattrz MemoizedSlots._fallback_getattr s S!!!r c r d rt t dz r. t dz }t | |S t dz r(t dz fd}j |_ |S S )N _memoizedz_memoized_attr_%sz_memoized_method_%sc v | i |fd}j |_ j |_ t | S )Nc S r r6 r~ s r r z8MemoizedSlots.__getattr__..oneshot..memo s !Mr )r1 r4 rN )r r* r rt r` r? r s @r r z*MemoizedSlots.__getattr__..oneshot sY T R " " " " " !#
!z c4(((
r )rH r rG rs rN r4 r )r r? r* r r` s `` @r __getattr__zMemoizedSlots.__getattr__ s >>+ & & / %% %
T.4
5
5 />E D#u % % %L
T036
7
7 / 4s :;;B
!jGON))#.. .r N)r1 r2 r3 r4 r5 r r r6 r r r r sC I" " "/ / / / /r r c fd}|S )Nc d }t j d |dd t t |d g }t
||d }t || j | r/t |d r |j
| j | S )Nr r r __all__) r r r r= globalsrL rs rN r1 rG r rH )r tokensr
add_to_all
modulenames r r} z dependency_for..decorate s !!#&&n HHVAbD\ " "GIIvxx&*
c6":&&S\3''' -'#y11 - K s| , , ,
r r6 )r r r} s `` r dependency_forr s) Or c t | t j rD| } | dv rdS | dv rdS t d| z t
| S )N)trueyesonyt1T)falsenooffr; f0Fz String is not true/false: %r)r r string_typesstripr9
ValueErrorr )r s r asboolr ss #v*++ Ciikk !! 6 6 64
9
9
95 ;c ABB B 99r c fd}|S )zqReturn a callable that will evaluate a string as
boolean, or one of a set of "alternate" string values.
c . | v r| S t | S r )r )r texts r
bool_or_valuez"bool_or_str..bool_or_value s $;;J#;; r r6 )r r s ` r bool_or_strr s$ r c ( | | S t | S )zCoerce to integer.)int)r* s r asintr s
} u::r c || }|| v rnt |t rt | | | sG| | =|t u r |rt | | ||< dS || | ||< dS dS dS dS )zIf 'key' is present in dict 'kw', coerce its value to type 'type\_' if
necessary. If 'flexi_bool' is True, the string '0' is considered false
when coercing to boolean.
N)r r r r )r* r? r)
flexi_booldests r coerce_kw_typer s | r E4(( 0:2c7E0J0J sG D==Z= r#wDIII bgDIII r c t | }| fd| | D ||i |S )zInstantiate cls using the __dict__ of obj as constructor arguments.
Uses inspect to match the named arguments of ``cls``.
c 3 H K | ] }|j v |j | fV d S r )r )r: kr s r r< z#constructor_copy.., sC !"a3<>O>OCLO >O>O>O>O r )r r
difference)r r@ r r* rw s ` r constructor_copyr $ ss
3 EII &+&6&6r&:&: 3 r c z t j t j d fd} | S )z%Return a threadsafe counter function.r c t S # w xY wr )acquirenextrelease)counterlocks r _nextzcounter.._next9 s? == LLNNNNDLLNNNNs : A)r threadingLockrT count)r r r s @@r r r 2 sN " "Doa G Lr c t | d r/| j !t | j t rt S | j S t | t
rt pt } || t rt S || t rt S || t rt S t | d rt S t | d rt S t | d rt S |S )zGiven an instance or class, guess if it is or is acting as one of
the basic collection types: list, set and dict. If the __emulates__
property is present, return that preferentially.
__emulates__NrH rX rS )rG r
issubclassrS r r r rp )specimenr isas r duck_type_collectionr C s x (( ) , !32
2
, J( (
Xt
$
$
3
AzC
s8T Xs
Xt x"" 5 ! !
5 ! ! r c
6 t | | r| S t |t rHt j d|dd d |D dt | d t j d|d|dt | d ) Nz
Argument 'z ' is expected to be one of type z or c 3 K | ] }d |z V
dS )z'%s'Nr6 )r: r s r r< z"assert_arg_type..k s& $A$AAVaZ$A$A$A$A$A$Ar z, got ''z ' is expected to be of type 'z', got ')r rI r
ArgumentErrorr= r )r argtyperi s r assert_arg_typer d s #w
gu % % ##44$A$A$A$A$AAAAA49999N
##44$s))))-
r c r t j r2t d r!t S nUt d r S t d r!t
S t dt dd t d z t d r fd} | S t d r-t
fd
D S t d z ) z?Return a (key, value) iterator for almost any dict-like object.r iteritems __getitem__r Nz Object '%r' is not dict-likeiterkeysc 3 X K D ]} | | fV d S r )r )r? dictlikegetters r iteratorz$dictlike_iteritems..iterator sH ((**
'
'66#;;&&&&&
'
'r r> c 3 2 K | ]}| | fV d S r r6 )r: r? r s r r< z%dictlike_iteritems.. s0 BB3S&&++&BBBBBBr )
r r rG r r r iterrs r r> )r r r s ` @r re re t sV { * 8W % % *(()) ) * 8[ ) ) *%%'' '
Xw
'
' *(()) )
X}ght.L.L
M
MF
~6ABBBx$$
C ' ' ' ' ' ' xzz 6 " " CBBBB(--//BBBBBB6ABBBr c ( e Zd ZdZ fdZd Z xZS )
classpropertyaA A decorator that behaves like @property except that operates
on classes rather than instances.
The decorator is currently special when using the declarative
module, but note that the
:class:`~.sqlalchemy.ext.declarative.declared_attr`
decorator should be used for this purpose with declarative.
c h t t | j |g|R i | |j | _ d S r )superr r r4 )r rr r r* r s r r zclassproperty.__init__ s= +mT""+D=3==="===| r c , | | S r )rr )descr r@ s r ru zclassproperty.__get__ s yy~~ r )r1 r2 r3 r4 r ru
__classcell__r s @r r r sQ $ $ $ $ $ r r c e Zd Zd Zd ZdS )hybridpropertyc || _ d S r r r r s r r zhybridproperty.__init__
r c |(| | }| j j |_ |S | | S r )r r4 )r r ownerclsvals r ru zhybridproperty.__get__ s< YYu%%F !Y .FNM99X&& &r N)r1 r2 r3 r ru r6 r r r r s2 ' ' ' ' 'r r c e Zd ZdZd Zd ZdS ) hybridmethodz/Decorate a function as cls- or instance- level.c || _ d S r r r s r r zhybridmethod.__init__ r r c | | | j ||j S | j || S r )r ru r )r r r s r ru zhybridmethod.__get__ s: 9$$UEO<< <9$$Xu55 5r N)r1 r2 r3 r4 r ru r6 r r r r s8 99 6 6 6 6 6r r c ( e Zd ZddZd Zd Zd ZdS )_symbolNc t |t j sJ |t | }t t | }||_ |r||_ |S )z Construct a new named symbol.) r r r hashr __new__r ri r4 )r ri r canonicalvs r r z_symbol.__new__ sZ $ 344444 T
I KK + + AIr c > t | j dt | ffS )Nr )r ri r r! s r
__reduce__z_symbol.__reduce__ s 3D 222r c t | S r r r! s r __str__z_symbol.__str__ s Dzzr c d| j z S )Nz
symbol(%r))ri r! s r __repr__z_symbol.__repr__ s di''r NN)r1 r2 r3 r r r r r6 r r r r sU 3 3 3 ( ( ( ( (r r r c j e Zd ZdZi Zej ZddZ e
dd Z dS )r a 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.
The optional ``doc`` argument assigns to ``__doc__``. This
is strictly so that Sphinx autoattr picks up the docstring we want
(it doesn't appear to pick up the in-module docstring if the datamember
is in a different module - autoattribute also blows up completely).
If Sphinx fixes/improves this then we would no longer need
``doc`` here.
Nc * | j | j | }|t ||| x| j |< }|t
j S # t
j w xY wr )_lockr symbolsr r r r )r@ ri r r r] s r r zsymbol.__new__ s #+//$''C{*1$Y*G*GG D!C L " " " "FL " " " "s 8A2 2 BFc | D ]&\ }}||u r|c S |r||j k r|c S ||v r|c S '|dS t j d|d| )a Given a user parameter, parse the parameter into a chosen symbol.
The user argument can be a string name that matches the name of a
symbol, or the symbol object itself, or any number of alternate choices
such as True/False/ None etc.
:param arg: the user argument.
:param choices: dictionary of symbol object to list of possible
entries.
:param name: name of the argument. Used in an :class:`.ArgumentError`
that is raised if the parameter doesn't match any available argument.
:param resolve_symbol_names: include the name of each symbol as a valid
entry.
NzInvalid value for 'z': )r ri r r )r@ r choicesri resolve_symbol_namesr] choices r parse_user_argumentzsymbol.parse_user_argument s , #==?? KCczz
%
#//
;4 cc JKKKr r r0 ) r1 r2 r3 r4 r r r r r r rz r r6 r r r r sv * G ! ! # #E# # # # 6; L L L [ L L Lr c 2 t | _ t dz
a dS )zAssign 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).
r N)_creation_order)r s r set_creation_orderr ! s /H qOOOr c | |i |S # t $ r/ t dt j dd z Y dS w xY w)zXexecutes the given function, catches all exceptions and converts to
a warning.
z%s('%s') ignoredr r N)rn r( r r )r r r s r warn_exceptionr . sc
7tT$V$$$ 7 7 7
#,..1"5
56666667s
5AA c l t | |k r
d| d| z S | S # t $ r | cY S w xY w)Nz%s...r )r r )r* len_s r ellipses_stringr 9 sT u:: U1T6]* *L s $ $ 33c . e Zd ZdZ fdZd Zd Z xZS )_hash_limit_stringa/ A string subclass that can only be hashed on a maximum amount
of unique values.
This is used for warnings so that we can send out parameterized warnings
without the __warningregistry__ of the module, or the non-overridable
"once" registry within warnings.py, overloading memory,
c ||z d|z z }t t | | | }t d|t | |z fz |_ |S )Nz6 (this warning may be suppressed after %d occurrences)z%s_%d)r r r r _hash)r@ r* numr interpolatedr r s r r z_hash_limit_string.__new__N sf Ds J
'--55c<HH'UD ,>,>,D$EEFF
r c | j S r )r r! s r __hash__z_hash_limit_string.__hash__V s
zr c B t | t | k S r )r )r others r __eq__z_hash_limit_string.__eq__Y s DzzT%[[((r )r1 r2 r3 r4 r r r r r s @r r r C s` ) ) ) ) ) ) )r r c H t j | t j d dS )zdIssue a warning.
If msg is a string, :class:`.exc.SAWarning` is used as
the category.
r
stacklevelN)warningsr( r SAWarning)msgs r r( r( ] s#
M#s}333333r c n |rt | d| } t j | t j d dS )z\Issue a warning with a parameterized string, limiting the number
of registrations.
r r" N)r r$ r( r r% )r& r s r warn_limitedr) g s<
0 b$// M#s}333333r c g fd}|S )zNDecorate the given function to be a no-op after it is called exactly
once.c }r; } || i |S # r d| xY wd S )Nr )r8 insert)r r* strong_fnonce_fnr` onceretry_on_exceptions r gozonly_once..gow sk hhjjG
w*r***
% ,KK7+++ s # >r6 )r` r0 r1 r/ s `` @r only_oncer2 q s8
4D Ir z%sqlalchemy/([a-z_]+/){0,2}[a-z_]+\.pyzunit(?:2|test2?/)c ` d}t | dz
}||k rA| | | r&|dz
}||k r| | | &||k rA| | | r&|dz }||k r| | | &| ||dz S )at Chop extraneous lines off beginning and end of a traceback.
:param tb:
a list of traceback lines as returned by ``traceback.format_stack()``
:param exclude_prefix:
a regular expression object matching lines to skip at beginning of
``tb``
:param exclude_suffix:
a regular expression object matching lines to skip at end of ``tb``
r r )r search)tbexclude_prefixexclude_suffixrD ends r chop_tracebackr9 s
E
b''A+C
3,,>00E;;,
3,,>00E;;,
3,,>00C99, q 3,,>00C99,
ecAgo r c | d| z }t }t || |d S )Nz&def set(obj, value): obj.%s = valuerS )rL copyr )attrnamer{ r s r
attrsetterr= s4 6 AD
((--//CsOOO u:r c ( e Zd ZdZ fdZd Z xZS )EnsureKWArgTypezYApply translation of functions to accept \**kw arguments if they
don't already.
c B | j }|rj|D ]g}t j || }|rN|| }t j | }|j s+| | x||< } t | || ht t |
||| d S r ) ensure_kwargr> matchr ro r
_wrap_w_kwrN r r? r ) r@ clsnamer[ clsdictfn_regr? r r` rv wrappedr s r r zEnsureKWArgType.__init__ s ! 3
3
3HVS)) 3 B!8<.wrap s 2s8Or r )r r` rJ s ` r rC zEnsureKWArgType._wrap_w_kw s. dB'''r )r1 r2 r3 r4 r rC r r s @r r? r? sV
F F F F F( ( ( ( ( ( (r r? c 0 t |d rt | | S | }|j j |_ t |d r |j |_ t |j d r |j j r|j j |_ n|j r |j |_ |S )zAugment functools.update_wrapper() to work with objects with
a ``__call__()`` method.
:param fn:
object with __call__ method
r1 r2 r4 )rG r r r1 r2 r r4 )wrapperr` _fs r
wrap_callablerN s r:
gr***
l+ 2| $ $ * MBM 2; * * $r{/B $,BJJ
Z $BJ r c d| vr| d S d}g g}d}t | }||k r| | }|dk rE|dk r9||dz
k r0| |dz dk r!|d d |dz
}nC|dz }n=|dk r |dk r| g n|d | |dz
}||k d |D S )a Parse a dotted identifier with accommodation for quoted names.
Includes support for SQL-style double quotes as a literal character.
E.g.::
>>> quoted_token_parser("name")
["name"]
>>> quoted_token_parser("schema.name")
["schema", "name"]
>>> quoted_token_parser('"Schema"."Name"')
['Schema', 'Name']
>>> quoted_token_parser('"Schema"."Name""Foo"')
['Schema', 'Name""Foo']
"r r r r c 8 g | ]}d | S ) )r= )r: r s r r z'quoted_token_parser.. s" / / /uBGGENN / / /r )r r rH )r* r% rt idxlvchars r quoted_token_parserrV s $ %{{3
ETF
C UB
((Sz 3;;zzcBFlluS1W~/D/Dr
!!#&&&q
S[[UaZZ MM" 2J d # # # q (( 0 / / / //r c > t j fd}|S )Nc v | j d ur| j pd}|r t |fdD }|| _ | S )NrR c i | ]}|S r6 r6 )r: paramr s r
z8add_parameter_text..decorate.. s )J)J)J%%)J)J)Jr )r4 inject_param_text)r` r paramsr s r r} z$add_parameter_text..decorate sT j$39r L#C)J)J)J)J6)J)J)JKKC
r )r r )r] r r} s `` r add_parameter_textr^ s9
!&
)
)F Or c | dd }t | dk r| S |\ }}| d s|dz t j | z S t j | S )Nr& r r% )r r rH textwrapdedent)r
split_text firstline remainings r _dedent_docstringre su D!$$J
:! ) 9 $ $ %4 (/)"<"<<<t$$$r c , t | pd } | d }t | dk r| d t j | d }|d r| dd d t | D }| dd |t |t | dz
}|d| |z ||d z }d | S )NrR r& r r c @ g | ]\ }}| | S r6 )r )r: r lines r r z)inject_docstring_text..+ s)
H
H
Hic44::<<
Hc
H
H
Hr )
re r r rH r` ra r, r minr= )doctext
injecttextposlines injectlinesblanks
inject_poss r r r " s
2..G MM$ E
5zzQ
R/*--33D99K1~ "1b!!!
H
H9U#3#3
H
H
HF
MM!QCVq 112J !J, + -jkk0B BE 99U r c 8 | }g }d }|r| d }|t j d| }|r| d }||v rwdt | d z dz }|rBt j d|d } | r%dt | d z }||| z }n| d rB| d | | | d d }n| sB| | | | | d d }nT|
d r?| | | | d | | |d | S )
Nr z (\s+):param (?:\\\*\*?)?(.+?):r r% r z(\s+)\Sz:param r& z::)
splitlinesr8 r> rB r r lstriprH rH rstriprI r= )
rj
inject_paramsdoclinesrm to_injectrh r rZ indentm2s
r r\ r\ 4 s
!!##H EI
$||A :DAAA
>
M)) 3qwwqzz?? 2S 8F < Xj(1+ > > <%(3rxx{{+;+;%;F & u)= =I
[[]]
%
%i
0
0 LL LL # # # LL II LL LL # # # LL II
]]4
LL LL Q
TI $L 99U r c * t | dk rdS t | dk }|r
| dd n| dd | dd z } d | D }|rd | S d |dd d|d S ) zTrims a list of strings from the middle and return a string of up to
four elements. Strings greater than 11 characters will be truncatedr Nr re r c R g | ]$}t | d k r
d|dd z n|%S ) z%s..N)r )r: ri s r r z$repr_tuple_names..i s8
L
L
LdTR 6D"I T
L
L
Lr r
z, ..., )r r= )rw flagress r repr_tuple_namesr b s 5zzQt u::?D ;E!A#JJE!A#Jrss$;E
L
Le
L
L
LC >yy~~ $ #ac( 3 3 3 3SWW==r r )FF)T)r6 Nr6 )NNrA N)NNNr0 )TN)r )Xr4 functoolsr r
rk rT ra r> r r` r r$ rR r r r r r r rA rL r^ rb r~ rr r r r r r r rq r r r r r r; r@ rV rZ rn rp r r r r r r r r r r r r re propertyr r r r r r1 r r r r r text_typer r( r) r2 compile_SQLA_RE _UNITTEST_REr9 r NoneTyper= r? rN rV r^ re r r\ r r6 r r r s % $ $ $ $ $
.; .; .; .; .;6 .; .; .;b
M
M
M , , ,>
P P P Pf' ' ' ' ' 6 ' ' ' T
(( ( ( (V2 2 23; 3; 3; 3;lP
P
P
P
fK K K K06 6 6$ EB EB EB EBP; ; ; ; ;f ; ; ;<0 0 0f
&
</ </ </ </~ S S S Sl% % % % % % % %,' ' '.+ + + + + + + +.%/ %/ %/ %/ %/F %/ %/ %/P ' ' ' '( " B
C C C: H &
'
'
'
'
'V
'
'
'
6
6
6
6
66
6
6
6( ( ( ( (c ( ( (, DL DL DL DL DLV DL DL DLN
7 7 7 ) ) ) ) )) ) ) )44 4 44 4 4 , 2:> ? ?rz.// '38 , 4:: ( ( ( ( (d ( ( (4 0)0 )0 )0X
% % % $+ + + \ > > > > >r