+hdZddlZddlmZddlZddlZddlZddlZddlZddl Z ddl Z ddl Z ddl Z ddl mZddl mZddl mZd ZGd d eZd Zd ZdZdZdZdZdZdZdZdZd]dZGddeZdZ d]dZ!dZ"d^dZ#d_dZ$d_dZ% d`dZ&d Z'd!Z(dad"Z)Gd#d$eZ*d%Z+d&Z, dbd'Z-d(Z.dcd)Z/Gd*d+eZ0d,Z1Gd-d.eZ2Gd/d0eZ3d1Z4d2Z5d3Z6ddd4Z7d5Z8d6Z9d7Z:d]d8Z;d9ZZ?Gd=d>eZ@Gd?d@eZAGdAdBeBZCdCeC_DGdDdCeZEdaFdEZGdFZHdedGZIGdHdIejZKd]dJZLdKZMdfdLZNdMZOejdNZQejdOZReReQfdPZSeTdZUdQZVGdRdSeTZWdTZXdUZYdVZZdWZ[dXZ\ejdYZ]dZZ^d[Z_d\Z`y)gzRoutines to help with the creation, loading and introspection of modules, classes, hierarchies, attributes, functions, and methods. Nupdate_wrapper) _collections)compat)excctjr|jd}tj}|j ||j S)Nzutf-8)rpy3kencodehashlibmd5update hexdigest)xms N/var/www/html/venv/lib/python3.12/site-packages/sqlalchemy/util/langhelpers.pymd5_hexrs9 {{ HHW  AHHQK ;;=c(eZdZdZdZddZdZdZy) safe_reraiseaKReraise 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_infoc||_yN)r)selfrs r__init__zsafe_reraise.__init__:s "rc6tj|_yr)sysexc_inforrs r __enter__zsafe_reraise.__enter__=srcj|<|j\}}}d|_|jstj||yytjsG|jr;|jdr,t d|jdd|jddd|_tj||y)N)with_tracebackrz`An exception has occurred during handling of a previous exception. The previous exception is: r  )rrrraise_r warn)rtype_value tracebackexc_type exc_valueexc_tbs r__exit__zsafe_reraise.__exit__@s =*... 'Hi!DN>> #)" ;;4>>dnnQ6G(,~~a'8$..:KM "DN MM% :rNF)__name__ __module__ __qualname____doc__ __slots__rr"r/rrrr&s"+I#(;rrc#Kt}|g}|rM|j}||vr|j||j|j ||rLyywr)setpopaddextend__subclasses__)clsseenstacks rwalk_subclassesr@WsV 5D EE iik $;  HHSM S'')*  s AA A czt|tjr|S t|S#t$rd|zcYSwxYw)Nzunprintable element %r) isinstancer string_typesstr Exception)elements rstring_or_unprintablerGes@'6../ 6w<  6+g5 5 6s )::cndjdtjd|jDS)Nr%c3<K|]}|jywr)lower).0ns r z(clsname_as_plain_name..ps sz ([A-Z][a-z]+))joinrefindallr1)r=s rclsname_as_plain_namerQos0 88::&6 E rczt|ts |j}n|}|j}t ||}||k7S)z1Return True if the two class methods don't match.)rBtype __class__r1getattr)instance_or_clsagainst_method current_cls method_namecurrent_methods rmethod_is_overriddenr[us@ ot ,%// %  ))K[+6N ^ ++rcg}|j|j|jfD]/}t|dr|j }|j |1t |S)zrdecode a slice object as sent to __getitem__. takes into account the 2.5 __index__() method, basically. __index__)startstopstephasattrr]appendtuple)slcretrs r decode_slicerfsW C YY#(( * 1k " A 1  :rc 'Kt|}|D]htjftjfdt d}|D]}||vs|j ||[tdzyw)Nc t|zSr)rD)ibases rz!_unique_symbols..sD3q6Mriz&exhausted namespace for symbol base %s)r8 itertoolschainritertools_imapranger: NameError)usedbasespoolsymrjs @r_unique_symbolsrus t9D M G  ! !"95; G  MC$    M DtKL L Ms AA=(A=c#HK|r||dzz}||||z}|ryyw)z6Call the given function given each nonzero bit from n.rNr6)fnrLbs rmap_bitsrys1 !aLe  Q s""c&fd}t|S)z'A signature-matching decorator factory.c`tj|s tj|s tdt j |}i}t ||}t|d|ddz|jfz}t|dd\}}t||}|jt|d |j|d <d |z}|j| ||d |jit|||j}t|d |j |_||_t%||S)Nznot a decoratable functionrrtargetrw)r}rwFgroupednamezDdef %(name)s(%(args)s): return %(target)s(%(fn)s, %(apply_kw)s) r1__func__)inspect isfunctionismethodrErinspect_getfullargspec!_update_argspec_defaults_into_envrcr1rudictrformat_argspec_plusr2_exec_code_in_envrU __defaults__ __wrapped__r) rwspecenvnames targ_namefn_namemetadatacode decoratedr}s rdecoratezdecorator..decorates !!"%g.>.>r.B89 9,,R00s;d1ga*bkk^;,UHdC 7yW5+D%@A;;     IvwJ NO%dC= !(Z!.load\sK..,C#))#.qr2 *c5) *3( (r)r)rrrrrs `` rregisterzPluginLoader.register[s )   4rr)r1r2r3rrrrr6rrrr?s  & rrc" tj}|j}|j}t |j d|t |j|zfS#t$r+tj|}|dt |dfcYSwxYw)Nrr) rCO_VARKEYWORDS__code__ co_argcountr co_varnamesboolco_flagsAttributeErrorrr)rwco_varkeywordsconargsrs r_inspect_func_argsres  //[[ ' ( ~- .   & ,,R0AwT!W %% &sA1B Bc|du}|r t}|jjdd}|xr@t|tj xr$t|j tj}|r$t|\}}|j||s|sy|rr|jD]}t||n|jd|S)aeReturn 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 ! NrFr) r8__dict__getrBtypes FunctionTyperCodeTyperr __bases__get_cls_kwargsdiscard)r=_settoplevelctrhas_initrhas_kwcs rrryst|Hu ,,  :u -C  5 sE.. / 5 s||U^^ 4 *3/ v Eh v Aa&.  LL Krc2tj|dS)zReturn the set of legal kwargs for the given `func`. Uses getargspec so is safe to call for methods, functions, etc. r)rr)funcs rget_func_kwargsrs  ( ( .q 11rc tj|rtd|ztj|r|r{|ryt j |}t j |jdd|j|j|j|j|j|jSt j |Stj|r|r|s |jrt j |j }t j |jdd|j|j|j|j|j|jSt j |j Stj"|rt%|j&|dSt)|drt j |j St)|drDtj|j*rt%|j*|Std |ztd |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: %srNT)no_self_is_initr__call__)rzCan't inspect callable: %s)r isbuiltin TypeErrorrrrrargsvarargsvarkwr kwonlyargskwonlydefaults annotationsr__self__risclassget_callable_argspecrrar)rwrrrs rrrs3b899   B  004D%% !"    ##   004 4   "  BKK00=D%% !"    ##   00= =  # KK4   Z ,,R[[99 Z   BKK (' WE E82=> >4r9::rc tj|rtj|}n|}tj|}tj|d|d|dd|d}|dr1|dd}tj|ddd|d|dd|d}n|dr d|dz}|}nd}|}d}|dr|t |dz }|dr|t |dz }|d|dz}|r |d|z d} nd} tj||d|d| d } |dr%tj|dd|d|d| d } n| } |rt |||| || St |dd ||dd | dd |dd | dd  S)aReturns 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. apply_pos_proxied Like apply_pos but omits the self/cls argument 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)'} rrrNz%s[0]r|r6c d|zSN=r6rs rrkz%format_argspec_plus..3s cAgr) formatvaluec d|zSrr6rs rrkz%format_argspec_plus..<s #'r)rself_arg apply_posapply_kwapply_pos_proxiedapply_kw_proxiedr)rcallablerinspect_formatargspeclenr) rwrrrrrr num_defaults name_argsdefaulted_valsrrs rrrsDr,,R0  ' ' .D,, Qa$q'4aI Aw71:"88 GABKa$q'4a  aT!W$%%L AwDG $  AwDG $ Q$q'!I"1|#3#56++ Q Q% H Aw!77 abM G G )  $/-   a"oa^/"5-a3   rc|tjur |rdnd}|rdnd}n t||St d||||| S#t$r|rdnd}|rdnd }Y(wxYw) 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)rz()r~z(self, *args, **kwargs)zself, *args, **kwargsz(*args, **kwargs)z*args, **kwargs)rrrrrr)objectrrrr)methodrrproxieds rformat_argspec_initrUs "x!$r L&vw? ?  !   L*,  .5):KG  Ls ?AAc&fd}|S)zA class decorator that will copy attributes to a proxy class. The class to be instrumented must define a single accessor "_proxied". c td fd } fd}D]2}t||rtd|d|t||||4D]2}t||rtd|d|t||||4D]4}t||rtd|d|t||||d6|S)Nct |}tj|}d|ji}t ||}t |d}|j |d|d|d|dd}|r d |z} |d <nd |z}t|||j }t|d |j|_t|jd d dd|_ |r t|}|S)Nr1Fr~rrrr)rrrrrzLdef %(name)s(%(args)s): return target_cls.%(name)s(%(apply_kw_proxied)s) target_clszWdef %(name)s(%(args)s): return %(self_arg)s._proxied.%(name)s(%(apply_kw_proxied)s)r0.. container:: class_bases Proxied for the  class on behalf of the  class.r) rUrrr2rrr1rrrr4 classmethod) rclslevelrwrrcaller_argspecrrproxy_fnproxy_cls_sphinx_namertarget_cls_sphinx_names r instrumentz:create_proxy_methods..decorate..instrumentsT*B004Dr}}-C4T3?D0uEN %34G%H$23E$F&v.*:6 HK %/L!V )sBKK@H$+B B$?$L$LH !4 *+@B  H &x0Orcjj|d}|t|jdddd}nd}dd|iz}t |d|id}|S) Nrrrrzdef set_(self, attr): self._proxied.%(name)s = attr def get(self): return self._proxied.%(name)s get.__doc__ = doc getset = property(get, set_)rrgetset)rrrr4r)rattrrrr"rrrs rmakepropz8create_proxy_methods..decorate..makepropsy&&**46D+LL/-   / D'teS\8DFMrzclass z already has a method Trr0)rarsetattr) r=r r$methprop attributes classmethodsmethodsrrrs rrz&create_proxy_methods..decorates+ Z < 1DsD!:=tD Cz$/ 0  1 /DsD!:=tD Cx~ .  /! @DsD!:=tD Cz$> ?  @ rr6)rrrr*r+r)rs`````` rcreate_proxy_methodsr,vsaaF Orc tj|S#t$r%|tjur dgdddfcYSdgdddfcYSwxYw)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) rNrkwargs)rrrrr)rs rgetargspec_initr/sU6,,V44 6 V__ $HdD$/ /Hfh5 5 6s"AAAcjt|tjr|js |jS|S)zSAdjust the incoming callable such that a 'self' argument is not required. )rBr MethodTyperr) func_or_clss runbound_method_to_callabler3s. +u//09M9M###rc v|g}ntj|}t}g}tj}d}t |D]%\}} t j | j} | jxrt| jxsd} |dk(rY| jr | j}| r |j| jd| nN|j| jddn/|j| jd| D cgc]} | |fc} | s|jt| j| d| jD cgc] \} } | | f c} } (g}|jfd|D|>t!|r2|jt#|Dcgc] }t%|c}|j'D]7\} }| |vr t#| |}||ur||k7r|j)| d|9|r7|D]2\} } t#| |}||ur||k7r|j)| d|4j,j.ddj1|dScc} wcc} } w#t$rYJwxYwcc}w#t*$rYwxYw#t*$rYwxYw) z}Produce a __repr__() based on direct association of the __init__() specification vs. same-named attributes present. Nrrc3JK|]}tt|dywr)reprrU)rKrobjs rrMzgeneric_repr..5sDC$wsC./Ds #r(, ))rto_listr OrderedDict enumeraterrrrr rr;rrziprrarUr6itemsrbrErTr1rN)r7 additional_kw to_inspect omit_kwargmissingpos_argskw_argsvargsriinspr default_lenrdefaultoutputvaldefvals` r generic_reprrMs U !))*5 hGH&&(G EZ(4 00?D-->C ,>C!KAv<< LLEOODIIa $=>OODIIabM2/3yyKfd|jD}nfd|jD}|D]$}|j|j|&tjr|jdk(s t|ds|jdk(s t|ds|jDcgc] }|vs| c}D]$}|j|j|&|r%t Scc}w)aReturn 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. c3^K|]$}|vrt|tjs|&ywr)rBr ClassTyperK_hiers rrMz"class_hierarchy..s-D=Au)Gs*-c3,K|] }|vs| ywrr6r]s rrMz"class_hierarchy..s=1q}Q=s rr<r)rrrBrr\r__mro__r9rrbr:r r2rar<)r=processrrrrxr^sr_s @rclass_hierarchyrdns<{{ c5?? +6M 5D3;;G  KKM ;;!U__-E > =E A NN1  HHQK  ;;||z)F  35;X > 4'AT=,AGR R ')CK $ &#f+.7/  "     %+G$F %   sB;D"D'3 D'AD6;E ' D32D36 EE EEc6t|d|t|d|uS)z;Return True if the two methods are the same implementation.r)rU)meth1meth2s rmethods_equivalentrs( 5*e , z51 rc |s |s tdt|trt||r|St|xs+t |Dcgc]}|j dr|c}}tt |}t j}t|tr|}n(|st}t j}n t|}||j||r|St|ts<|t juxrdxsd}t|d|ddj|Gdd t} |rd |jz| _ t} t|D]d\} } | |vrtd | ztj | st| d | d t#| | t%| | j'| f|| |r| Stddj|| z zcc}w)aEnsure 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 requiredr^zany ofzall ofz does not implement z: r9ceZdZdZy)(as_interface..AnonymousInterfacezA callable-holding shell.N)r1r2r3r4r6rrAnonymousInterfacer6s'rr Anonymousz%r: unknown in this interfacerz is not callablez,dictionary does not contain required keys %s)rrBrSr8rfrooperatorgegt intersectionrrNrr1dictlike_iteritemsrrr& staticmethodr:) r7r=r+requiredr interface implementedcomplies qualifierrfoundrrs r as_interfacersB wLMM#tC!5 GM3s8Ma1<<;LMNIc#h-K{{H(D! 5;;x= ((3X>  c4  +8DH Ityy3 5  (V( &1CLL&@# EE*3/   ";fDE Et$vtDE E"FL,>? & x !! 6 ))Hu$ % & S Ns G7G7c4eZdZdZddZdZdZedZy)memoized_propertyz2A read-only @property that is only evaluated once.Nc^||_|xs |j|_|j|_yrfgetr4r1rrrs rrzmemoized_property.__init__Qs$ *dll   rcb||S|j|x|j|j<}|Sr)rrr1rr7r=results r__get__zmemoized_property.__get__Vs0 ;K/3yy~= T]]#f rcDtj||jyr)rresetr1)rr7s r_resetzmemoized_property._reset\sT]]3rc<|jj|dyr)rr9)r=r7rs rrzmemoized_property.reset_s t$rr) r1r2r3r4rrrrrr6rrrrNs(<&  4%%rrc&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|g|i|fd}j|_j|_||jj<S)NcSrr6arYrs rmemoz6memoized_instancemethod..oneshot..memopsMr)r1r4rrrrYrrrws @roneshotz(memoized_instancemethod..oneshotmsKD&4&2&   zz %) bkk" rr)rwrs` rmemoized_instancemethodrds  '2 &&rcZeZdZdZdZeZdZdZdZ Gdde Z e dZ y ) HasMemoizedzyA class that maintains the names of memoized elements in a collection for easy cache clearing, generative, etc. r6c^|jD]}|jj|d yr)_memoized_keysrr9rrs r_reset_memoizationszHasMemoized._reset_memoizationss+'' *D MM  dD ) *rcF|jD]}||jvrJyr)rrrs r_assert_no_memoizationsz#HasMemoized._assert_no_memoizationss)'' -Dt}}, ,, -rcN||j|<|xj|hzc_yr)rr)rrhr*s r_set_memoized_attributez#HasMemoized._set_memoized_attributes#" c u$rceZdZdZddZdZy)HasMemoized.memoized_attributezTA read-only @property that is only evaluated once. :meta private: Nc^||_|xs |j|_|j|_yrrrs rrz'HasMemoized.memoized_attribute.__init__s$DI.$,,DL MMDMrc||S|j|x|j|j<}|xj|jhzc_|Sr)rrr1rrs rrz&HasMemoized.memoized_attribute.__get__sG{ 3799S> ACLL '&   4==/ 1 Mrr)r1r2r3r4rrr6rrmemoized_attributers  *  rrc&fd}t|S)z+Decorate a method memoize its return value.c|g|i|fd}j|_j|_||jj<|xjjhzc_S)NcSrr6rs rrzBHasMemoized.memoized_instancemethod..oneshot..memos r)r1r4rrrs @rrz4HasMemoized.memoized_instancemethod..oneshotsb*t*r*F KKDM::DL)-DMM"++ &   BKK= 0 Mrr)r=rwrs ` rrz#HasMemoized.memoized_instancemethods gr**rN)r1r2r3r4r5 frozensetrrrrrrrrr6rrrr{sD I[N*-%V&++rrc eZdZdZdZdZdZy) 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__. r6ct|r)r)rrhs r_fallback_getattrzMemoizedSlots._fallback_getattrs S!!rc6jdr ttdzr#tdz}t ||Stdzr)tdzfd}j |_|Sj S)N _memoizedz_memoized_attr_%sz_memoized_method_%sc|i|fd}j|_j|_t|S)NcSrr6rs rrz8MemoizedSlots.__getattr__..oneshot..memos!Mr)r1r4r&)rrYrrrwrhrs @rrz*MemoizedSlots.__getattr__..oneshots>TR"!#  !zz c4( r)rorrarUr&r4r)rrhr*rrws`` @r __getattr__zMemoizedSlots.__getattr__s >>+ & % % T.4 5E D#u %L T036 74s:;B !jjGON))#. .rN)r1r2r3r4r5rrr6rrrrsI"/rrct|tjr6|jj }|dvry|dvryt d|zt |S)N)trueyesonyt1T)falsenooffrLf0FzString is not true/false: %r)rBrrCstriprJ ValueErrorr)r7s rasboolrsY#v**+iik! 6 6 9 9;cAB B 9rcfd}|S)zqReturn a callable that will evaluate a string as boolean, or one of a set of "alternate" string values. c&|vr|St|Sr)r)r7texts r bool_or_valuez"bool_or_str..bool_or_values $;J#; rr6)rrs` r bool_or_strrs  rc ||St|S)zCoerce to integer.)int)r*s rasintrs } u:rc||}||vrQt|trt|||s1||+|tur|rt||||<y|||||<yyyy)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)rBrSrr)rYrhr) flexi_booldests rcoerce_kw_typerss  | r E4( 2c7E0J sG  D=Zr#wDIbgDI 1K rcJt|}|ftfd|DzS)zbProduce a tuple structure that is cacheable using the __dict__ of obj to retrieve values c3^K|]$}|jvs|j|f&ywrrrKkr7s rrMz"constructor_key..s.!"qCLL/@CLLO--)rrc)r7r=rs` rconstructor_keyrs2 3 E 6E&+ rc|t|}|jfd|j|D||i|S)zInstantiate cls using the __dict__ of obj as constructor arguments. Uses inspect to match the named arguments of ``cls``. c3^K|]$}|jvs|j|f&ywrrrs rrMz#constructor_copy..*s.!"a3<<>OCLLOr)rr difference)r7r=rrYrs` rconstructor_copyr"sE 3 EII&+&6&6r&:   rc|tjjtjdfd}|S)z%Return a threadsafe counter function.rcJ5tcdddS#1swYyxYwr)next)counterlocksr_nextzcounter.._next7s"  != ! ! !s ")r threadingLockrlcount)rrrs @@rrr0s3    "Dooa G! Lrct|dr8|j t|jtrtS|jSt |t xrtxst}||t rt S||trtS||trtSt|drt St|drtSt|drtS|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__rbr:r8)rar issubclassr8rBrSrr)specimenrIisas rduck_type_collectionr>s x(  ,  ! !32 J(( ( Xt $ 3 AzC 8T Xs  Xt  x" 5 ! 5 ! rc  t||r|St|tr>tjd|ddj d|Ddt |dtjd|d|dt |d) Nz Argument 'z ' is expected to be one of type z or c3&K|] }d|z yw)z'%s'Nr6)rKrs rrMz"assert_arg_type..fs$AAVaZ$Asz, got ''z' is expected to be of type 'z', got ')rBrcr ArgumentErrorrNrS)rargtypers rassert_arg_typer_ss#w gu %##$A$AA49N  ##$s)- rc tjr%tdrZtj Stdrj Stdrt j Stdtddtdztdr fd}|Std r"t fd jDStdz) z?Return a (key, value) iterator for almost any dict-like object.r? iteritems __getitem__rNzObject '%r' is not dict-likeiterkeysc3PKjD]}||fywr)r)rhdictlikegetters riteratorz$dictlike_iteritems..iterators.((* '6#;&& 's#&rgc32K|]}||fywrr6)rKrhrs rrMz%dictlike_iteritems..sB3S&+&Bs) rr rarr?riterrUrrg)rrrs` @rrros{{ 8W %() ) 8[ )%%' ' Xw '() ) X}ght.L MF ~6ABBx$ 'z 6 "B(--/BBB6ABBrc(eZdZdZfdZdZxZS) classpropertyaAA 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. cVtt| |g|i||j|_yr)superr rr4)rrrrYrTs rrzclassproperty.__init__s' mT+D=3="=|| rc$|j|Sr)r)descrr=s rrzclassproperty.__get__syy~r)r1r2r3r4rr __classcell__rTs@rr r s$rr ceZdZdZdZdZy)hybridpropertyc ||_||_yr)rrrrs rrzhybridproperty.__init__s  rcN||j|}|S|j|Sr)rr)rinstanceownerclsvals rrzhybridproperty.__get__s*  ]]5)FM99X& &rc||_|Srr%rs r classlevelzhybridproperty.classlevel  rN)r1r2r3rrrr6rrrrs'rrc"eZdZdZdZdZdZy) hybridmethodz/Decorate a function as cls- or instance- level.c.|x|_|_||_yr)rrrrs rrzhybridmethod.__init__s$(( DM rc|&|jj||jS|jj||Sr)rrrTr)rrrs rrzhybridmethod.__get__s:  ==((@ @99$$Xu5 5rc||_|Srr%rs rrzhybridmethod.classlevelrrN)r1r2r3r4rrrr6rrrrs96 rrc&eZdZddZdZdZdZy)_symbolNct|tjsJ| t|}tj t |}||_|r||_|S)zConstruct a new named symbol.) rBrrChashr__new__r$rr4)rrr canonicalvs rr'z_symbol.__new__sM$ 3 3444  T I KK + AIrc>t|jdt|ffS)Nr)rrrr!s r __reduce__z_symbol.__reduce__s 3D 222rct|Sr)r6r!s r__str__z_symbol.__str__s Dzrc d|jzS)Nz symbol(%r))rr!s r__repr__z_symbol.__repr__sdii''rNN)r1r2r3r'r+r-r/r6rrr$r$s 3(rr$rcdeZdZdZiZej jZddZ e ddZ y)raA 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|j5|jj|}|t|||x|j|<}|cdddS#1swYyxYwr)_locksymbolsrr$)r=rrr(rts rr'zsymbol.__new__sT YY ++//$'C{*1$Y*GG D!C    s ;AAc|jD]*\}}||ur|cS|r||jk(r|cS||vs(|cS|ytjd|d|)aGiven 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?rr r)r=rchoicesrresolve_symbol_namesrtchoices rparse_user_argumentzsymbol.parse_user_argumentsg,#==? KCcz %#/    ;c JKKrr0r0) r1r2r3r4r4rrrr3r'rr9r6rrrrs@*G    ! ! #E6; L Lrc,t|_tdz ay)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). rN)_creation_order)rs rset_creation_orderr<"s /HqOrcx ||i|S#t$r&tdtjddzYywxYw)zXexecutes the given function, catches all exceptions and converts to a warning. z%s('%s') ignoredrrN)rEr(rr )rrr.s rwarn_exceptionr>/sA 7T$V$$ 7 #,,.1"5 567s  ,99cV t||kDrd|d|zS|S#t$r|cYSwxYw)Nz%s...r)r r)r*len_s rellipses_stringrA:s= u: U1T]* *L  s ((c.eZdZdZfdZdZdZxZS)_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||zd|zz}tt| ||}td|t||zfz|_|S)Nz6 (this warning may be suppressed after %d occurrences)z%s_%d)rrCr'r&_hash)r=r*numr interpolatedrrTs rr'z_hash_limit_string.__new__OsT Ds J '5c<H'UD,>,D$EEF  rc|jSr)rEr!s r__hash__z_hash_limit_string.__hash__Ws zzrc0t|t|k(Sr)r&)rothers r__eq__z_hash_limit_string.__eq__ZsDzT%[((r)r1r2r3r4r'rIrLrrs@rrCrCDs)rrCc~|r!ttj||yt|tjy)zdIssue a warning. If msg is a string, :class:`.exc.SAWarning` is used as the category. )rN)_warnings_warnr SAWarning)msgrs rr(r(^s( s}}St45sCMM*rcV|r t|d|}t|tjy)z\Issue a warning with a parameterized string, limiting the number of registrations. N)rCrNr rO)rPrs r warn_limitedrSks#   b$/3 &rc tj|}|utjd|jj ddrE|j }|dz }|2tjd|jj ddrD |tj|||dzytj||dzy#t$rd}YFd}YKxYw)Nz^(?:sqlalchemy\.|alembic\.)r1rrr) stacklevel) r _getframerOmatch f_globalsrf_backrwarningsr()messagecategoryrUframes rrNrNus j)BHH *EOO,?,? B,O% LLE !OJ BHH *EOO,?,? B,O%  gxJNC g*q.9+   sC CCc gfd}|S)zNDecorate the given function to be a no-op after it is called exactly once.ct}rj} ||i|Sy#rjd|xYw)Nr)r9insert)rrY strong_fnonce_fnrwonceretry_on_exceptions rgozonly_once..gosM hhjG *r**  %KK7+s 7r6)rwrdrercs`` @r only_oncerfs 4D  Irz%sqlalchemy/([a-z_]+/){0,2}[a-z_]+\.pyzunit(?:2|test2?/)cd}t|dz }||kr3|j||r|dz }||kr|j||r||kr3|j||r|dz}||kr|j||r|||dzS)atChop 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`` rr)r search)tbexclude_prefixexclude_suffixr^ends rchop_tracebackrms E b'A+C 3,>00E;   3,>00E; 3,>00C9 q 3,>00C9 ecAg rc^d|z}tj}t|||dS)Nz&def set(obj, value): obj.%s = valuer8)rqcopyr)attrnamerrs r attrsetterrqs, 6 AD (--/CsO u:rc(eZdZdZfdZdZxZS)EnsureKWArgTypezYApply translation of functions to accept \**kw arguments if they don't already. c |j}|rj|D]e}tj||}|s||}tj|}|j rC|j |x||<} t||| gtt|+|||yr) ensure_kwargrOrWrrr _wrap_w_kwr&rrsr) r=clsnamerrclsdictfn_regrhrrwrwrappedrTs rrzEnsureKWArgType.__init__s!!  3HHVS) B!88.wraps s8Orr)rrwr}s ` rrvzEnsureKWArgType._wrap_w_kws dB''r)r1r2r3r4rrvrrs@rrsrss F(rrscvt|dr t||S|}|jj|_t|dr|j|_t|j dr3|j j r|j j |_|S|j r|j |_|S)zAugment functools.update_wrapper() to work with objects with a ``__call__()`` method. :param fn: object with __call__ method r1r2r4)rarrTr1r2rr4)wrapperrw_fs r wrap_callablersr:gr** ll++ 2| $MMBM 2;; *r{{/B/B,,BJ ZZBJ rcd|vr|jdSd}gg}d}t|}||kr}||}|dk(r8|dk(r-||dz kr%||dzdk(r|djd|dz }n6|dz}n0|dk(r|dk(r|jgn|dj||dz }||kr}|Dcgc]}dj|c}Scc}w)aParse 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'] "rrrrr)rr rbrN)r*rUridxlvcharrs rquoted_token_parserrs$ %{{3 ETF C UB (Sz 3;zcBFluS1W~/Dr !!#&q  S[UaZ MM"  2J  d # q ()/ /uBGGEN // /s.C c@tjfd}|S)Nc|jduxr |jxsd}|rt|Dcic]}|c}}||_|Scc}w)Nr)r4inject_param_text)rwrparamparamsrs rrz$add_parameter_text..decorate-sOjj$39r #C6)J%%+)JKC  *Ks A )rr;)rrrs`` radd_parameter_textr*s  ! !& )F Orc|jdd}t|dk(r|S|\}}|jds|dztj|zStj|S)Nr&rr%)rr rotextwrapdedent)r split_text firstline remainings r_dedent_docstringr7scD!$J :! ) 9    $4(//)"<<<t$$rct|xsd}|jd}t|dk(r|jdt j |jd}|dr|j ddt|Dcgc]\}}|jr|}}}|j dd|t|t|dz }|d||z||dz}dj|Scc}}w)Nrr&rr) rrr rbrrr`r=rminrN) doctext injecttextposlines injectlinesrFlineblanks inject_poss rrrCs 2.G MM$ E 5zQ R//*-33D9K1~1b!#,U#3 Hic44::%(3rxx{+;%;F &u)= =I  LL$ 40 1I LL$ 40 1I ]]4  LL$ 0 0 23 4  T? B 99U rct|dk(ryt|dk}|r|ddn |dd|ddz}|Dcgc]}t|dkDrd|ddzn|}}|rdj|Sdj|ddd |dScc}w) zTrims a list of strings from the middle and return a string of up to four elements. Strings greater than 11 characters will be truncatedrNrr|r z%s..r9z, ..., )r rN)rflagrress rrepr_tuple_namesrs 5zQ u:?DE!AJE!AJrs$;EFK LdTR6D"I T 9 LC L yy~ $ #a( 3SW== MsBcH ddlm}ddlm}ddlm}y#t$rYywxYw)Nr)cimmutabledict) cprocessors) cresultproxyTF)rrrrr)rrrs rhas_compiled_extrs%-*+ s  !!r)FF)T)r6r6r6)r6Nr6)NNz self.proxyN)NNN)TN))Nr)ar4r functoolsrr rrlrrOrrrrZrrrr rrrr@rGrQr[rfruryrrrrrrrrrrrr,r/r3rMrOrdrir|rrrrrrrrrrrrrrrrpropertyr rrrr$r1rr;r<r>rA text_typerCr(rSrNrfcompile_SQLA_RE _UNITTEST_RErmrSNoneTyperqrsrrrrrrrrrr6rrrs} $  .;6.;b 6 ,  M  ,F* Tn# 6# L ((V23;lm `J  qh6$ EBP;f;<0f &   </~Sl%%,'.9+&9+x%/F%/R  '(  B  C:H&V"6$(c(,ALVALH 7))))4 +'::, 2::> ?rzz./ '38, :(d(40)0X  %$RZZ- . (V >r