o y\@s dZddlmZddlZddlZddlZddlZddlZddlZddl Z ddl Z ddl m Z ddl m Z ddl mZd d ZGd d d eZd dZddZddZddZddZddZGdddeZdddZz ddlmZddZWn eyd dZYnwd!d"Zdd$d%Zdd'd(Zdd)d*Z d+d,Z!d-d.Z"dd0d1Z#Gd2d3d3eZ$d4d5Z%d6d7Z&   8 dd9d:Z'd;d<Z(dd=d>Z)Gd?d@d@eZ*dAdBZ+GdCdDdDeZ,GdEdFdFeZ-ddGdHZ.GdIdJdJeZ/dKdLZ0dMdNZ1dOdPZ2ddQdRZ3dSdTZ4dUdVZ5ddWdXZ6dYdZZ7d[d\Z8Gd]d^d^e9Z:Gd_d`d`eZ;GdadbdbeZdee>_?GdfdedeeZ@daAdgdhZBdidjZCddldmZDGdndodoe jEZFdpdqZGdrdsZHdtduZIeJdvZKeJdwZLeLeKfdxdyZMeNdZOdzd{ZPGd|d}d}eNZQd~dZRddZSdS)zRoutines to help with the creation, loading and introspection of modules, classes, hierarchies, attributes, functions, and methods. update_wrapperN) _collections)compat)exccCs*tjr|d}t}|||S)Nzutf-8)rpy3kencodehashlibmd5update hexdigest)xmrM/var/www/html/env/lib/python3.10/site-packages/sqlalchemy/util/langhelpers.pymd5_hexs   rc@s.eZdZdZdZd ddZddZdd Zd S) 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_infoFcC ||_dSN)r)selfrrrr__init__7 zsafe_reraise.__init__cCst|_dSr)sysexc_inforrrrr __enter__:zsafe_reraise.__enter__cCs|dur|j\}}}d|_|jst|||dSdStjs4|jr4|jdr4td|jd|jdfd|_t|||dS)NrzfAn exception has occurred during handling of a previous exception. The previous exception is: %s %s r)rrrreraiser warn)rtype_value tracebackexc_type exc_valueexc_tbrrr__exit__=s zsafe_reraise.__exit__NF)__name__ __module__ __qualname____doc__ __slots__rrr)rrrrr#s   rcCs>g}|j|j|jfD]}t|dr|}||q t|S)zrdecode a slice object as sent to __getitem__. takes into account the 2.5 __index__() method, basically. __index__)startstopstephasattrr0appendtuple)slcretrrrr decode_sliceQs   r9c 'slt|}|D],tftfddtd}|D]}||vr,|||VnqtdqdS)Ncs t|Sr)str)ibaserrds z!_unique_symbols..iz&exhausted namespace for symbol base %s)set itertoolschainritertools_imaprangeadd NameError)usedbasespoolsymrr<r_unique_symbols_s   rJccs2|r||d@}||V||N}|sdSdS)z6Call the given function given each nonzero bit from n.rNr)fnnbrrrmap_bitsos   rNcfdd}t|S)z'A signature-matching decorator factory.cst|s tdt|}t|d|dd|jf}t|dd\}}t||d}| t |dd |j|d <d |}t ||||i|j}t |d |j |_ ||_t||S) Nznot a decoratable functionrrtargetrK)rQrKFgroupednamezDdef %(name)s(%(args)s): return %(target)s(%(fn)s, %(apply_kw)s) im_func)inspect isfunction Exceptionrinspect_getfullargspecr6r+rJdictr format_argspec_plus_exec_code_in_envgetattr __defaults__ __wrapped__r)rKspecnames targ_namefn_namemetadatacode decoratedrQrrdecorate{s$      zdecorator..decorater)rQrhrrgr decoratorxs  ricCst||||Sr)exec)reenvrcrrrr\s r\c Cst|tr|j}|}d|j|f}n|}}d|}|dd}t|}|dd=t|dd}||d<d |}|td } t || | |} |j | _ d | dd d| _ tj s^t|d rd||j_ | S||_ | 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:`.%s` object. This constructor is mirrored as a public API function; see :func:`~%s` for a full usage and argument description.zJThis function is mirrored; see :func:`~%s` for a description of arguments..rFrRrTz5def %(name)s(%(args)s): return cls(%(apply_kw)s) )clssymbol sqlalchemyr__func__) isinstancetyperr+splitrrYr[rorjr.rsplitr,py2kr4rq) rQlocationrK callable_doc location_namer`rdrerkrfrrrpublic_factorys>      r{c@.eZdZd ddZddZddZdd ZdS) PluginLoaderNcCs||_i|_||_dSr)groupimplsauto_fn)rr~rrrrrs zPluginLoader.__init__cCs|jdSr)rclearrrrrrr zPluginLoader.clearcCs||jvr |j|S|jr||}|r||j|<|Szddl}Wn ty,Ynw||j|D] }|j|j|<|Std|j|f)NrzCan't load plugin: %s:%s) rr pkg_resources ImportErroriter_entry_pointsr~loadrNoSuchModuleError)rrTloaderrimplrrrrs$         zPluginLoader.loadcsfdd}||j|<dS)Ncs6t}dddD]}t||}qt|S)Nrlr)rimport_rtr])modtoken modulepathobjnamerrrs   z#PluginLoader.register..load)r)rrTrrrrrrregisterszPluginLoader.registerr)r+r,r-rrrrrrrrr}s   r}cCs|du}|r t}|jdd}|ot|tjot|jtj}|r2t|\}}| ||s2|s2dS|r6|rE|j D] }t ||durDnq9| d|S)aReturn 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.getargspec() to cut down on method overhead. No anonymous tuple arguments please ! NrFr) r?__dict__getrrtypes FunctionType__code__CodeTypeinspect_func_argsr __bases__get_cls_kwargsdiscard)rn_settoplevelctrhas_initrahas_kwcrrrrs*       r)CO_VARKEYWORDScCs8|j}|j}|j}t|d|}t|jt@}||fSr)r co_argcount co_varnameslistboolco_flagsr)rKconargsraargsrrrrr!s rcCst|\}}}}|t|fSr)rinspect_getargspecr)rKra_rrrrr,s cCst|dS)zReturn the set of legal kwargs for the given `func`. Uses getargspec so is safe to call for methods, functions, etc. r)rrfuncrrrget_func_kwargs1srFcCst|r td|t|r.|r)|r)t|}t|jdd|j|j |j St|St |rV|rP|s:|j rPt|j }t|jdd|j|j |j St|j St|rct|j|ddSt|drnt|j St|drt |jrt|j|dStd |td |) 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_initrq__call__)rzCan't inspect callable: %s)rV isbuiltin TypeErrorrWrrArgSpecrvarargskeywordsdefaultsismethod__self__rqisclassget_callable_argspecrr4r)rKrrr`rrrr<s6              rTc Csvt|r t|}n|}tj|}|dr|dd}n |dr(d|d}nd}tjrat|d|d|dd|d}d}|drL|t|d7}|drX|t|d7}|d|d}nt|d|d|d}d}|dr||t|d7}|d}|r|d|d}nd}tj||d|d|d d d } |rt|||| d St|dd ||dd | dd d 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. 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)'} rrz%s[0]NrrPrcSsd|S)N=r)rrrrr>sz%format_argspec_plus..) formatvalue)rself_arg apply_posapply_kwrm)rcallablerYinspect_formatargspecr lenrZ) rKrSr`rrr num_defaults name_argsdefaulted_valsrrrrr[fs^     r[cCsV|tjur |r dp d}nzt||dWSty"|rdpd}Ynwtd|||dS)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)rrRz(self, *args, **kwargs)zself, *args, **kwargs)rrrr)objectrr[rrZ)methodrSrrrrformat_argspec_inits  rcCsJzt|WSty$|tjurdgdddfYSdgdddfYSw)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)rrrrgetargspec_inits   rcCst|tjr |js |jS|S)zSAdjust the incoming callable such that a 'self' argument is not required. )rrr MethodTyperrq) func_or_clsrrrunbound_method_to_callablesrrc s|durg}nt|}tg}t}d}t|D]f\}}z t|j\} } } } Wn ty5Yqw| rz generic_repr..cSsg|]\}}||fqSrr)rrdefaultrrrrsc3s |] }tt|dVqdSr)reprr]robjrr #szgeneric_repr..cSsg|]}t|qSrr)rvalrrrr&rz%s=%rz%s(%s), )rto_listr OrderedDict enumeraterrrrrextendr zipr4r]itemsr5rX __class__r+join)r additional_kw to_inspect omit_kwargpos_argskw_argsvargsr;insp_args_vargsvkwr default_lenoutputrdefvalrr)rrr generic_reprst      rc@s6eZdZdZdZddZddZd dd Zd d Zd S)portable_instancemethodz_Turn an instancemethod into a (parent, name) pair to produce a serializable callable. )rQrTr __weakref__cCs|j|j|jdS)NrQrTrrrrrr __getstate__Fsz$portable_instancemethod.__getstate__cCs&|d|_|d|_|dd|_dS)NrQrTrr)rQrTrr)rstaterrr __setstate__Ms  z$portable_instancemethod.__setstate__rcCs|j|_|j|_||_dSr)rrQr+rTr)rmethrrrrrRs z portable_instancemethod.__init__cOs$||jt|j|j|i|Sr)r rr]rQrT)rrkwrrrrWs z portable_instancemethod.__call__Nr) r+r,r-r.r/rrrrrrrrr>s  rcstjr t|tjr tS|ht|j}|r||}tjr/t|tjr$qfdd|jD}n fdd|jD}|D] }| | |q;tj rW|j dksUt |dsVqn |j dksat |dsbqfdd|DD] }| | |qm|stS) 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. c3s(|]}|vrt|tjs|VqdSr)rrr ClassTyperrhierrrrtsz"class_hierarchy..c3s|] }|vr|VqdSrrrrrrrzbuiltins__subclasses__ __builtin__csg|]}|vr|qSrrrrrrrsz#class_hierarchy..)rrvrrrrr__mro__poprr5rDr r,r4r)rnprocessrrGrMsrrrclass_hierarchy\s<         rccsBt|}|D]}|jD]}||jvr||j|fVnq qdS)ziterate 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)dirrr)rnkeyskeyrrrriterate_attributess  r  self.proxyc s$|r|}ndur dfddt|D}|D]v}zt||}t|ds(Wqt|d|}Wn ty8Yqwzt|} t| d} t| ddd} Wn ty_d } d } Ynwd t} |durm||ipni} t | | z|j | |_ Wn tyYnwt || |qdS) z9Automates delegation of __specials__ for a proxying type.N)r/__del____getattribute__ __metaclass__rrcs6g|]}|dr|drt|s|vr|qS)__) startswithendswithr4rrinto_clsskiprrrsz0monkeypatch_proxied_specials..rrUrrz(self, *args, **kw)z (*args, **kw)z?def %(method)s%(fn_args)s: return %(name)s.%(method)s%(d_args)s) r r]r4AttributeErrorrrrrlocalsexec_r^setattr)rfrom_clsronlyrT from_instancedundersrrKr`fn_argsd_argspyrkrrrmonkeypatch_proxied_specialssJ          r#cCst|d|t|d|uS)z;Return True if the two methods are the same implementation.rq)r])meth1meth2rrrmethods_equivalents r&c Csj|s|stdt|trt||r|St|pddt|D}tt|}tj}t|tr2|}n |s;t}tj}nt|}||||rI|St|t sc|tjurUdpVd}td||d |fGdd d t }|rsd |j |_ t} t |D](\} } | |vrtd | t| std | | ft|| t| | | qz|| |r|Std d || )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 requiredcSsg|] }|ds|qS)r)rrrrrr sz as_interface..zany ofzall ofz%r does not implement %s: %src@seZdZdZdS)z(as_interface..AnonymousInterfacezA callable-holding shell.N)r+r,r-r.rrrrAnonymousInterface$sr' Anonymousz%r: unknown in this interfacez%r=%r is not callablez,dictionary does not contain required keys %s)rrrrsr?r operatorgegt intersectionrZrrr+dictlike_iteritemsrrr staticmethodrD) rrnmethodsrequired interface implementedcomplies qualifierr'foundrrrrr as_interfacesP!         r6c@s6eZdZdZd ddZddZddZed d ZdS) memoized_propertyz2A read-only @property that is only evaluated once.NcCs||_|p|j|_|j|_dSr)fgetr.r+)rr8ryrrrr?s  zmemoized_property.__init__cCs&|dur|S|||j|j<}|Sr)r8rr+)rrrnresultrrr__get__Dszmemoized_property.__get__cCst||jdSr)r7resetr+)rrrrr_resetJszmemoized_property._resetcCs|j|ddSr)rr)rnrrTrrrr;Mszmemoized_property.resetr) r+r,r-r.rr:r< classmethodr;rrrrr7<s r7crO)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. csB|g|Ri|fdd}j|_j|_||jj<S)NcSrrarr9rrmemo^z6memoized_instancemethod..oneshot..memo)r+r.r)rrrrBrKrAroneshot[s   z(memoized_instancemethod..oneshotr)rKrErrDrmemoized_instancemethodRs rFc@s2eZdZdZd ddZddZddZd d Zd S) !group_expirable_memoized_propertyz?A family of @memoized_properties that can be expired in tandem.rcCsg|_|r |j|dSdSr) attributesr)rrHrrrrlsz*group_expirable_memoized_property.__init__cCs"|j}|jD]}||dqdS)z.Expire all memoized properties for *instance*.N)rrHr)rinstancestash attributerrrexpire_instanceqs z1group_expirable_memoized_property.expire_instancecC|j|jt|Sr)rHr5r+r7rrKrrrrwz*group_expirable_memoized_property.__call__cCrMr)rHr5r+rFrNrrrr{rOz(group_expirable_memoized_property.methodNr)r+r,r-r.rrLrrrrrrrGis   rGc@s$eZdZdZdZddZddZdS) 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__. rcCst|r)r)rr rrr_fallback_getattrzMemoizedSlots._fallback_getattrcsdr ttdr td}t||Stdrrrr?rArrrBrCz8MemoizedSlots.__getattr__..oneshot..memo)r+r.r)rrrBrKr rrArrEs   z*MemoizedSlots.__getattr__..oneshot)rrr4r]rr.rQ)rr r$rErrTr __getattr__s    zMemoizedSlots.__getattr__N)r+r,r-r.r/rQrUrrrrrPs  rPcsfdd}|S)Ncsnd}td|ddtt|dg}t||d}t||j|r5t |dr5|j |j|S)Nrlrrm__all__) rtrrrglobalsrr]rr+r4rVr5)rtokensr add_to_all modulenamerrrhs  z dependency_for..decorater)r[rZrhrrYrdependency_fors r\c@sFeZdZdZddZddZeddZeZ iZ Gdd d e Z d S) dependenciesaApply imported dependencies as arguments to a function. E.g.:: @util.dependencies( "sqlalchemy.sql.widget", "sqlalchemy.engine.default" ); def some_func(self, widget, default, arg1, arg2, **kw): # ... Rationale is so that the impact of a dependency cycle can be associated directly with the few functions that cause the cycle, and not pollute the module-level namespace. c GsDg|_|D]}|d}|jtd|dd|dqdS)Nrlrrm) import_depsrtr5r] _importlaterr)rdepsdeprXrrrrs zdependencies.__init__c Cs|j}t|}t|d}|ddv}tt|D]}d||d||r'dnd<qt|dd}|D] }||r:dnd=q3||ddd<t|dd} d| d|d d } t| t} t |d |j | _ t | |S) Nr)rrnzimport_deps[%r]rFrRz!lambda %(args)s: fn(%(apply_kw)s)rr)rrrU) r^rrYrrCrr[evalrr]r^r) rrKr^r` spec_zerohasselfr; inner_specimpname outer_specrerfrrrrs$       zdependencies.__call__cCs(ttjD] }|j|r|qdSr)rr] _unresolved _full_pathr_resolve)rnpathrrrr resolve_alls  zdependencies.resolve_allc@sNeZdZeZiZddZddZeddZ e ddZ d d Z d d Z d S)zdependencies._importlatercCs8|d|}|tjvrtj|St|tj|<}|SNrl)r]_by_keyr__new__)rnrkaddtlr imprrrros   z!dependencies._importlater.__new__cCs||_||_tj|dSr)_il_path _il_addtlr]rhrD)rrkrprrrrsz"dependencies._importlater.__init__cCs|jd|jSrm)rrrsrrrrrisz$dependencies._importlater._full_pathcCs,|tjvrtd|j|jft|j|jS)Nzsz"bool_or_str..bool_or_valuer)rrrrr bool_or_str8s rcCs|dur|St|S)zCoerce to integer.N)int)r$rrrasintGsrcCsb||vr+t|||s-||dur/|tur!|r!t||||<dS|||||<dSdSdSdS)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)rrrr)rr r# flexi_boolrrrcoerce_kw_typeOs "  rcs4t|}|fdd||D||i|S)zInstantiate cls using the __dict__ of obj as constructor arguments. Uses inspect to match the named arguments of ``cls``. c3s(|]}|jvr|j|fVqdSr)r)rkrrrrdsz#constructor_copy..)rr difference)rrnrrrarrrconstructor_copy\s rcs&tjtdfdd}|S)z%Return a threadsafe counter function.rcs&z tWSwr)acquirenextreleasercounterlockrr_nextqszcounter.._next)r threadingLockr@count)rrrrrjs  rcCst|dr|jdurt|jtrtS|jSt|trtpt}||tr%tS||tr,tS||tr3tSt|dr:tSt|drAtSt|drHtS|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__Nr5rDr?)r4r issubclassr?rrrsrrZ)specimenrisarrrduck_type_collection{s(        rcCsXt||r|St|tr td|ddd|Dt|ftd||t|f)Nz8Argument '%s' is expected to be one of type %s, got '%s'z or css|]}d|VqdS)z'%s'Nr)rr@rrrrsz"assert_arg_type..z6Argument '%s' is expected to be of type '%s', got '%s')rrr6r ArgumentErrorrrs)rargtyperTrrrassert_arg_types   rcstjrtdrtSntdrStdr#tStdtdddur7tdtdrFfdd }|Std rXtfd d  DStd) z?Return a (key, value) iterator for almost any dict-like object.r iteritems __getitem__rNzObject '%r' is not dict-likeiterkeysc3s"D] }||fVqdSr)r)r dictlikegetterrriterators z$dictlike_iteritems..iteratorr c3s|] }||fVqdSrr)rr )rrrrrz%dictlike_iteritems..) rr r4rrriterr]rr )rrrrrr-s"         r-c(eZdZdZfddZddZZS) 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. cs*tt|j|g|Ri||j|_dSr)superrrr.)rr8rrrrrrs zclassproperty.__init__cCs ||Sr)r8)descrrnrrrr:rzclassproperty.__get__)r+r,r-r.rr: __classcell__rrrrrs rc@seZdZddZddZdS)hybridpropertycCrrrrrrrrrrzhybridproperty.__init__cCs*|dur||}|jj|_|S||Sr)rr.)rrIownerclsvalrrrr:s    zhybridproperty.__get__N)r+r,r-rr:rrrrrs rc@s eZdZdZddZddZdS) hybridmethodz/Decorate a function as cls- or instance- level.cCrrrrrrrrrzhybridmethod.__init__cCs&|dur |j||jS|j||Sr)rr:r)rrIrrrrr:szhybridmethod.__get__N)r+r,r-r.rr:rrrrrs rc@r|) _symbolNcCs@t|tjsJ|durt|}tt|}||_|r||_|S)zConstruct a new named symbol.N) rrrrhashrrorrTr.)rrTry canonicalvrrrros z_symbol.__new__cCst|jdt|ffS)Nr)rorTrrrrr __reduce__sz_symbol.__reduce__cCst|Srrrrrr__str__rRz_symbol.__str__cCs d|jS)Nz symbol(%r))rTrrrr__repr__rz_symbol.__repr__NN)r+r,r-rorrrrrrrrs    rroc@s(eZdZdZiZejZdddZ dS)roaA 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. NcCsR|jz|j|}|durt||||j|<}|WtjStjwr)_lockrsymbolsrrror)rnrTryrrIrrrro(s  zsymbol.__new__r) r+r,r-r.rrrrrrorrrrros  cCst|_td7adS)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)rIrrrset_creation_order6s rcOs>z||i|WStytdtddYdSw)zXexecutes the given function, catches all exceptions and converts to a warning. z%s('%s') ignoredrrN)rXr"rr)rrrrrrwarn_exceptionCs  rcCs<zt||krd|d|WS|WSty|YSw)Nz%s...r)rr)r$len_rrrellipses_stringNs  rcs0eZdZdZfddZddZddZZS)_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, cs@||d|}tt|||}td|t||f|_|S)Nz6 (this warning may be suppressed after %d occurrences)z%s_%d)rrror_hash)rnr$numr interpolatedrrrrrocs z_hash_limit_string.__new__cCs|jSr)rrrrr__hash__ksz_hash_limit_string.__hash__cCst|t|kSr)r)rotherrrr__eq__nsz_hash_limit_string.__eq__)r+r,r-r.rorrrrrrrrXs  rcCstj|tjdddS)zdIssue a warning. If msg is a string, :class:`.exc.SAWarning` is used as the category. r stacklevelN)warningsr"r SAWarning)msgrrrr"rsr"cCs&|rt|d|}tj|tjdddS)z\Issue a warning with a parameterized string, limiting the number of registrations. rrN)rrr"rr)rrrrr warn_limited|s rcs|gfdd}|S)zNDecorate the given function to be a no-op after it is called exactly once.csr }||i|SdSr)r)rronce_fnoncerrgoszonly_once..gor)rKrrrr only_onces rz%sqlalchemy/([a-z_]+/){0,2}[a-z_]+\.pyzunit(?:2|test2?/)cCsd}t|d}||kr"|||r"|d7}||kr"|||s||kr<|||r<|d8}||kr<|||s-|||dS)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)rsearch)tbexclude_prefixexclude_suffixr1endrrrchop_tracebacks rcCs$d|}t}t|||dS)Nz&def set(obj, value): obj.%s = valuer?)rcopyrj)attrnamererkrrr attrsetters  rcr)EnsureKWArgTypezYApply translation of functions to accept \**kw arguments if they don't already. c sr|j}|r-|D]%}t||}|r,||}t|}|js,||||<} t||| qtt | |||dSr) ensure_kwargrematchrrr _wrap_w_kwrrrr) rnclsnamerGclsdictfn_regr rrKr`wrappedrrrrs   zEnsureKWArgType.__init__csfdd}t|S)Ncs|Srr)rrrDrrwraprRz(EnsureKWArgType._wrap_w_kw..wrapr)rrKrrrDrrs  zEnsureKWArgType._wrap_w_kw)r+r,r-r.rrrrrrrrs  rcCsht|dr t||S|}|jj|_t|dr|j|_t|jdr+|jjr+|jj|_|S|jr2|j|_|S)zAugment functools.update_wrapper() to work with objects with a ``__call__()`` method. :param fn: object with __call__ method r+r,r.)r4rrr+r,rr.)wrapperrK_frrr wrap_callables     rcCsd|vr |dSd}gg}d}t|}||kr`||}|dkrC|dkr>||dkr>||ddkr>|dd|d7}n|dN}n|dkrQ|dkrQ|gn|d||d7}||ksdd|DS)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'] "rlrrrmcSsg|]}d|qS))r)rrrrrrsz'quoted_token_parser..)rtrr5)r$rr9idxlvcharrrrquoted_token_parsers& $   rr)FF)T)rNr)NNr N)NNNr*)r)Tr. functoolsrr rVr@r)rrrrrrrrrrrr9rJrNrir\r{r}rrrrrrr[rrrrrrr r#r&r6r7rFrGrPr\r]rrrrrrrrr-rwrrrrrr+rorrrr text_typerr"rrcompile_SQLA_RE _UNITTEST_RErrsNoneTyperrrrrrrrs    . 0 *(    * Z H3 ? V (u    !  $