,h n %SrSSKJr SSKrSSKrSSKJr SSKrSSKrSSK r SSK r SSK r SSK r SSK r SSKrSSKJr SSKJr SSKJr SSKJr SS KJr SS KJr SS KJr SS KJr SS KJr SSKJr SSKJr SSKJr SSKJr SSKJr SSKJr SSKJr SSKJ r SSKJ!r! SSKJ"r" SSKJ#r# SSK$r$SSK%J&r& SSK%J'r' SSK(J)r) SSKJ*r* SSK%J+r+ \""S 5r,\""S!S"S#9r-\""S$\S%\4S&9r.\""S'S(S&9r/\""S)S*S&9r0\""S+S,S&9r1\""S-S.S&9r2\'Rf(a<SS/K4J5r5 SS0K4J6r6 S1r7\8RrS2Rtr;S3r<SS4jr=SS5jr>O\'R~(aSS6jr>OSS7jr>SS8jr@"S9S:5rASS;jrBSS<jrCSSS=jjrDSS?jrESS@jrFSSAjrGSSBjrH\""SCS>S&9rISSDjrJSSEjrK\""SF5rL\""SG5rM"SHSI5rNSJrO\SS%SK.SSLjj5rP\SSMSK.SSNjj5rPSSMSK.SSOjjrPSSPjrQSSSQjjrRSSSRjjrSSSSjrTSSSTjjrUSUrVSVrWSSSWjjrX"SXSY5rYSZrZS[r[SS\jr\S]r]SS^jr^\""S_S`S&9r_"SaSb\\-5r`"ScSd\`\-5ra"SeSf\`\-5rb\!(a \`rc\`rd\erf\ergO\b=rcrf\a=rdrgSSgjrh"ShSi5ri\!(a\erjO \iRrj"SjSk5rlSSljrmSSmjrnSSnjroSSSojjrpSSpjrqSSqjrrSSrjrsSSSsjjrtSStjruSurv"SvSw\e5rw"SxSy\\,5rx"SzS{\\,5ry"S|S}\\,5rz"S~S\{5r|"SS\85r}"SS\}S9r~\!(a SSKJr \rO\~r\""S\GRS&9rSSSjjrSqSSjrSSjrSSjr"SS\5rSSSjjrSSjr0rS\S'SSjr\ GR"S5rSSSjjrSSjr\ GR"S5r\ GR"S5r\\4SSjjr\8"S5rSr\ GR"S5r"SS5r"SS5rSrSrSSjrSSjrSSjr\ GR"S5rSSjrSSjrSSjr"SS\GR5r\GRJr\#\,\*\GRJ4rg)zRoutines to help with the creation, loading and introspection of modules, classes, hierarchies, attributes, functions, and methods. ) annotationsNupdate_wrapper)CodeType)Any)Callable)cast)Dict) FrozenSet)Generic)Iterator)List)Mapping)NoReturn)Optional)overload)Sequence)Set)Tuple)Type) TYPE_CHECKING)TypeVar)Union) _collections)compat)HAS_CYEXTENSION)Literal)exc_T_T_coT) covariant_F.)bound_MPzmemoized_property[Any]_MAz#HasMemoized.memoized_attribute[Any]_HPzhybridproperty[Any]_HMzhybridmethod[Any])call_annotate_function)Formatc[USS5nUb0[X!US9n[U[5(d[ U<S35eU$g)N __annotate__)ownerz!.__annotate__ returned a non-dict)getattrr* isinstancedict ValueError)objformatannotateanns S/var/www/auris/envauris/lib/python3.13/site-packages/sqlalchemy/util/langhelpers.py_get_and_call_annotater8FsJ35  (ECc4(( C7*K!LMMJ__annotations__c[U[5(a [U5nO[ USS5nUc0$[U[ 5(d[ U<S35e[ U5$![a 0s$f=f)Nr:z+.__annotations__ is neither a dict nor None)r0type_BASE_GET_ANNOTATIONSAttributeErrorr/r1r2r3r6s r7_get_dunder_annotationsr@Rs c4  +C0 #0$7C{ #t$$'DE Cy"   s A$$ A32A3c$[U5nUb [U5$[X5nUc [U5nUc6[ U[ 5(d[ U5(a0$[U<S35eU(d0$[U5$![a Nrf=f)z:A sparse implementation of annotationlib.get_annotations()z does not have annotations)r@r1 Exceptionr8r0r<callable TypeError)r3r4r6s r7_vendored_get_annotationsrEds  !)#.CCy %S1 ; *#.C ;#t$$  sg%?@A AICy1   s B BBc2[U[RS9$)N)r4)rEr+ FORWARDREFr3s r7get_annotationsrIs )V5F5FGGr9c.[R"U5$N)inspectrIrHs r7rIrIs&&s++r9c[U[5(aURRSS5nO [ USS5nUc[ R $[SU5$)Nr:Mapping[str, Any])r0r<__dict__getr/r EMPTY_DICTr r?s r7rIrIsV c4 ,,""#4d;C#0$7C ;** *+S1 1r9cURS5n[R"5nURU5 [ [ UR 55$)Nzutf-8)encodermd5_not_for_securityupdater str hexdigest)xms r7md5_hexrZs< A##%AHHQK Q[[] ##r9cL\rSrSr%SrSrS\S'S SjrS SjrSr g) safe_reraiseaReraise 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() TODO: we should at some point evaluate current behaviors in this regard based on current greenlet, gevent/eventlet implementations in Python 3, and also see the degree to which our own asyncio (based on greenlet also) is impacted by this. .rollback() will cause IO / context switch to occur in all these scenarios; what happens to the exception context from an "except:" block if we don't explicitly store it? Original issue was #2703. ) _exc_infozdUnion[None, Tuple[Type[BaseException], BaseException, types.TracebackType], Tuple[None, None, None]]r^c8[R"5UlgrK)sysexc_infor^selfs r7 __enter__safe_reraise.__enter__sr9cURceUc,URupEnUceSUlURU5eSUlUceURU5erK)r^with_traceback)rctype_value tracebackexc_type exc_valueexc_tbs r7__exit__safe_reraise.__exit__so ~~))) =*... 'H( ((!DN**62 2!DN$ $$&&y1 1r9NreturnNone)rhzOptional[Type[BaseException]]rizOptional[BaseException]rjzOptional[types.TracebackType]rqr) __name__ __module__ __qualname____firstlineno____doc__ __slots__r:rdrn__static_attributes__r9r7r\r\sH0I(2,2'21 2  2r9r\c## [5nU/nU(aUUR5nX;aMURU5 URUR 55 Uv U(aMTgg7frK)setpopaddextend__subclasses__)clsseenstacks r7walk_subclassesrsUUD EE iik ;  HHSM S'')*  %s A'A-+A-cr[U[5(aU$[U5$![a SU-s$f=f)Nzunprintable element %r)r0rVrB)elements r7string_or_unprintablers='3 6w<  6+g5 5 6s $66cU=(d URnSRS[R"SU555$)N c3@# UHoR5v M g7frK)lower).0ns r7 (clsname_as_plain_name..sN'M!GGII'Msz([A-Z][a-z]+|SQL))rsjoinrefindall)ruse_namenames r7clsname_as_plain_namers3  #s||D 88Nrzz2F'MN NNr9Callable[..., Any]c[U[5(d URnOUnURn[ X#5nXA:g$)z1Return True if the two class methods don't match.)r0r< __class__rsr/)instance_or_clsagainst_method current_cls method_namecurrent_methods r7method_is_overriddenrs? ot , ,%// %  ))K'.{'HN  ++r9c/nURURUR4H5n[US5(aUR 5nUR U5 M7 [ U5$)zjdecode a slice object as sent to __getitem__. takes into account the 2.5 __index__() method, basically. __index__)startstopstephasattrrappendtuple)slcretrXs r7 decode_slicersU C YY#(( * 1k " " A 1 + :r9c '^# [U5nUHdm[R"T4[U4Sj[ S555nUH nXB;dM UR U5 Uv MV [ ST-5e g7f)Nc >T[U5-$rKrV)ibases r7!_unique_symbols..+s $Q-r9iz&exhausted namespace for symbol base %s)r| itertoolschainmapranger~ NameError)usedbasesused_setpoolsymrs @r7_unique_symbolsr&st4yH G 't 5 C" S!   DtKL Ls AA:+A:c#Z# U(a X)S--nU"U5v X-nU(aMgg7f)z6Call the given function given each nonzero bit from n.rNrz)fnrbs r7map_bitsr6s. aLe   !s%++_Fnc,^SU4Sjjn[UT5$)z'A signature-matching decorator factory.cD>[R"U5(d&[R"U5(d [S5e[ USS5nUb%SUl[ R"U5nXlO[ R"U5nS[UR=(d S5-n[RUR=(d S5nUR0UUS9n[[SUS55[SUSS 5-UR 4-n[#US S 5upg[XgS 9nUR%['US S95 UR US'[R("U5(a SUS'SUS'O SUS'SUS'S[+US5;aSU-n OSU-n UT XpSUR,0n [[.R0[3XUR 55n UR4U lUR6U l5$!Xlf=f)Nznot a decoratable functionr-rKrz)rdefaultskwonlydefaultszTuple[str, ...]rrtargetr)rrFgroupedrzasync prefixzawait target_prefix__zf%(prefix)sdef %(name)s%(grouped_args)s: return %(target_prefix)s%(target)s(%(fn)s, %(apply_pos)s) ze%(prefix)sdef %(name)s%(grouped_args)s: return %(target_prefix)s%(target)s(%(fn)s, %(apply_kw)s) rs)rL isfunctionismethodrBr/r-rinspect_getfullargspeclenrr1fromkeysr_replacerr rsrrUformat_argspec_plusiscoroutinefunctionreprrttypes FunctionType_exec_code_in_env __defaults____kwdefaults__r) rannofuncspecempty_defaultsempty_kwdefaultsnames targ_namefn_namemetadatacodeenv decoratedrs r7decoratedecorator..decorateGs&!!"%%g.>.>r.B.B89 92~t4  "BO +44R8"*004D!3t}}':#;;==)<)<)BC}}#+  $($q'2 3$d1Qi0 1{{n   -UHdC -1-O+D%@A;;  & &r * *!)HX (0H_ %!#HX (*H_ % 4Q=      v         d 5 "$ #%#4#4  i,,Q#+s HH)rrrqrr)rrs` r7 decoratorrDsT-l (F ++r9c [X5 X$rK)exec)rrrs r7rrs O <r9_PF_TEcN\rSrSrS S SjjrSrS SjrS SjrS SjrSr g) PluginLoaderiNc*Xl0UlX lgrK)groupimplsauto_fn)rcrrs r7__init__PluginLoader.__init__s %'  r9c8URR5 grK)rclearrbs r7rPluginLoader.clears r9cXR;aURU"5$UR(a-URU5nU(aX RU'U"5$[R"UR5H>nUR U:XdMUR URU'UR 5s $ [R"SUR<SU<35e)NzCan't load plugin: :) rrrimportlib_metadata_getrrloadr NoSuchModuleError)rcrloaderimpls r7rPluginLoader.loads :: ::d#% % <<\\$'F#) 4 x11$**=DyyD #'99 4 yy{"> ##*.**d ;  r9c2^^UU4SjnX@RU'g)Nc~>[T5nTRS5SSHn[X5nM [UT5$)N.r) __import__splitr/)modtoken modulepathobjnames r7r#PluginLoader.register..loads@Z(C#))#.qr2c)33( (r9r)rcrrrrs `` r7registerPluginLoader.registers )  4r9cURU grKr )rcrs r7 deregisterPluginLoader.deregisters JJt r9)rrrrK)rrVrzOptional[Callable[..., Any]])rrVrqr)rrVrrVrrVrqrr)rrVrqrr) rsrtrurvrrrr rryrzr9r7rrs.BF#? & r9rc&[RnURnURn[ UR SU5[ URU-54$![a, [R"U5nUS[ US54s$f=f)Nrr) rLCO_VARKEYWORDS__code__ co_argcountlist co_varnamesboolco_flagsr>rr)rco_varkeywordsconargsrs r7_inspect_func_argsrs  //[[ ' ( ~- .   & ,,R0AwT!W %% &sA3BB)_setraiseerrcgrKrzrrrs r7get_cls_kwargsr s r9FcgrKrzrs r7r r sr9c$USLnU(a [5nUceURRSS5nU=(aE [U[R 5=(a$ [UR [R5nU(aD[U5upgURU5 U(dU(dU(a[SUS35egOSnU(aU(aURHn[XS9bM O URS5 U$)aAReturn 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 ! NrFz given cls z doesn't have an __init__ method)rrc)r|rOrPr0rrrrrrUrD __bases__r discard) rrrtoplevelctrhas_initrhas_kwcs r7r r s"t|Hu    ,,  :u -C  5 sE.. / 5 s||U^^ 4 *3/  Eh %EF vAa+3 LL Kr9c4[R"U5S$)zwReturn the set of legal kwargs for the given `func`. Uses getargspec so is safe to call for methods, functions, etc. r)rr)funcs r7get_func_kwargsr,.s  ( ( .q 11r9c [R"U5(a[SU-5e[R"U5(aU(aU(a{[R "U5n[R "URSSURURURURURUR5$[R "U5$[R"U5(aU(aU(dUR(a[R "UR 5n[R "URSSURURURURURUR5$[R "UR 5$[R""U5(a[%UR&USS9$[)US5(a [R "UR 5$[)US5(aG[R"UR*5(a[%UR*US9$[S U-5e[S U-5e) 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_init__func____call__)r.zCan't inspect callable: %s)rL isbuiltinrDrrr FullArgSpecargsvarargsvarkwr kwonlyargsrrr__self__r0isclassget_callable_argspecrrr1)rr.r/rs r7r:r:9s3b899   B   004D%% !"    ##   004 4   "   BKK00=D%% !"    ##   00= =   # KK4   Z ,,R[[99 Z   BKK ( (' WE E82=> >4r9::r9c >[U5(a[R"U5nOUn[R"U6n[R"USUSUSSUS5nUS(a2USSn[R"USSSUSUSSUS5nOUS(a SUS-nUnOSnUnSnUS(a&U[ [ [ [US55- nUS(aU[ US5- nUSUS-nU(a USU- Sn OSn [R"UUSUSU S S 9n US(a#[R"USSUSUSU S S 9n OU n U(a[UUUU UU S 9$[UUUSS U SS USS U SS S 9$)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) {'grouped_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]rrzcS[U5-$N=rrXs r7r%format_argspec_plus..s cCFlr9) formatvaluecS[U5-$r>rr@s r7rrAs #A,r9) grouped_argsself_arg apply_posapply_kwapply_pos_proxiedapply_kw_proxied) rCrrinspect_formatargspecrr rrr1) rrrr4rFrErH num_defaults name_argsdefaulted_valsrGrIs r7rrqsH||,,R0  ' ' .D,, Qa$q'4aI Aw71:"88 GABKa$q'4a  aT!W$%%L AwDsT!W566  AwDG $ Q$q'!I"1|#3#56++ Q Q* H Aw!77 abM G G .  $/-   "oa^/"5-a3   r9c U[RLaSnU(aSOSnU(aSOSnO [XS9$[ SUUUUUS 9$![a SnU(aUOSnU(aSOS nN2f=f) a format_argspec_plus with considerations for typical __init__ methods Wraps format_argspec_plus with error handling strategies for typical __init__ cases: .. sourcecode:: text object.__init__ -> (self) other unreflectable (usually C) -> (self, *args, **kwargs) z(self)rcz()rrz(self, *args, **kwargs)zself, *args, **kwargsz(*args, **kwargs)z*args, **kwargs)rErDrFrGrHrI)objectrrrDr1)methodrrDr4proxieds r7format_argspec_initrSs  "x!$r L&v? ? !!    L4L#*<0GD-4):KG LsA"A*)A*c SnU$)a;A class decorator indicating attributes should refer to a proxy class. This decorator is now a "marker" that does nothing at runtime. Instead, it is consumed by the tools/generate_proxy_methods.py script to statically generate proxy methods and attributes that are fully recognized by typing tools such as mypy. cU$rKrz)rs r7r&create_proxy_methods..decorates r9rz) target_clstarget_cls_sphinx_nameproxy_cls_sphinx_name classmethodsmethods attributesuse_intermediate_variablers r7create_proxy_methodsr^s& Or9c[R"U5$![a& U[RLa S/SSS4s$S/SSS4s$f=f)zinspect.getargspec with considerations for typical __init__ methods Wraps inspect.getargspec with error handling for typical __init__ cases: .. sourcecode:: text object.__init__ -> (self) other unreflectable (usually C) -> (self, *args, **kwargs) rcNr4kwargs)rrrDrPr)rQs r7getargspec_initra sU6,,V44 6 V__ $HdD$/ /Hfh5 5 6s$AAAc~[U[R5(aUR(d UR$U$)zKAdjust the incoming callable such that a 'self' argument is not required. )r0r MethodTyper8r0) func_or_clss r7unbound_method_to_callablere4s1 +u//009M9M###r9c $^UcT/nO[R"U5n[5n/n[R"5nSn[ U5GHOup[ R "U R5n U R(a[U R5OSn US:XacU R(a U RnU (a URU RSU *5 OPURU RSS5 O1URU RSU *V s/sHoU4PM sn 5 U (a_U R(deUR[U RU *SU R5V V s/sHupX4PM sn n 5 GMOGMR /nURU4SjU55 UbF[!TU5(a5UR[#TU5Vs/sHn[%U5PM sn5 UR'5H@un nX;aM [#TX5nXLa"UU:waUR)U <SU<35 M>M@MB U(a?UH9un n[#TX5nXLa"UU:waUR)U <SU<35 M7M9M; TR,R.<SSR1U5<S3$s sn fs sn n f![a GMf=fs snf![*a Mf=f![*a Mf=f) zuProduce a __repr__() based on direct association of the __init__() specification vs. same-named attributes present. Nrrc3P># UHn[[TUS55v M g7frK)rr/)rargr3s r7rgeneric_repr..ss"D8C$wsC.//8s#&r?(, ))rto_listrP OrderedDict enumeraterrrrrr5rr4rUziprDrr/ritemsrrBrrsr)r3 additional_kw to_inspect omit_kwargmissingpos_argskw_argsvargsrinspr default_lenrhdefaultoutputvaldefvals` r7 generic_reprr@sU !))*5 hGH2>2J2J2LG EZ( 00?D15 #dmm,1KAv<< LLEOODIIa $=>OODIIabM2/3yyKA     sH K" K K +K+%.K0+.L K('K(0 K>=K> LLc8\rSrSrSrSrSrSrS SjrSr Sr g ) portable_instancemethodizWTurn an instancemethod into a (parent, name) pair to produce a serializable callable. )rrr` __weakref__cJURURURS.$)Nrrr`rrbs r7 __getstate__$portable_instancemethod.__getstate__s!kkIIkk  r9cZUSUlUSUlURSS5Ulg)Nrrr`rz)rrrPr`)rcstates r7 __setstate__$portable_instancemethod.__setstate__s*Ho &M ii"- r9cTURUlURUlX lgrK)r8rrsrr`)rcmethr`s r7r portable_instancemethod.__init__smm MM  r9cURUR5 [URUR5"U0UD6$rK)rUr`r/rr)rcrhkws r7r1 portable_instancemethod.__call__s1 $++t{{DII.:r::r9)r`rrN)rz) rsrtrurvrwrxrrrr1ryrzr9r7rrs" :I .  ;r9rcL^U1m[UR5nU(aUR5nU4SjUR5nUH%nUR U5 TR U5 M' UR S:Xd[US5(dM{[U[5(dUR5OURU5Vs/sH nUT;dM UPM snH%nUR U5 TR U5 M' U(aM[T5$s snf)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. c36># UHoT;dM Uv M g7frKrz)r_hiers r7r"class_hierarchy..s9KqD=Ks  builtinsr) r__mro__r}r#rr~rtr issubclassr<r)rprocessr)rrrsrs @r7class_hierarchyrs 5D3;;G  KKM9AKK9A NN1  HHQK <<: %WQ8H-I-I  "!T**  "%%a() ) } ) A NN1  HHQK  ', : s D!D!c## [U5nUH:nURH'nX#R;dMX#RU4v M8 M< g7f)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)dirrrO)rkeyskeyr)s r7iterate_attributesrsF s8DAjj JJsO,,s -AAc6U(aUnOiUcSn[U5Vs/sHNnURS5(dMURS5(dM3[X5(aMEXr;dMLUPMP nnUHn[ X5n [U S5(dM"[ U SU 5n [ [ RU 5n [R"U 5n [R"U S5n [R"U SSS5n S [5-nUSL=(a XE0=(d 0n[X5 U RXl[!XX5 M gs snf![a Mf=f![a Sn S n N|f=f![a NIf=f) z9Automates delegation of __specials__ for a proxying type.N)rx__del____getattribute__ __metaclass__rrrr1r0rrz(self, *args, **kw)z (*args, **kw)z?def %(method)s%(fn_args)s: return %(name)s.%(method)s%(d_args)s)r startswithendswithrr/r rrr>rrrKrDlocalsrrsetattr)into_clsfrom_clsskiponlyr from_instancedundersrYrQmaybe_fnrrfn_argsd_argspyrs r7monkeypatch_proxied_specialsrs  <D]  " T" JJt$   ,  M "    x0H8Z00xX>He(((3B %004D2247;G11$q'!"+>F  35;X >  % ?4*? E2  R  ')CK $ #+.?  &     %+G$F %   sYE!E!E!%E!,E!:E&'E&A E7;F & E43E47FF FFc6[USU5[USU5L$)z;Return True if the two methods are the same implementation.r0)r/)meth1meth2s r7methods_equivalentr%s( 5*e , z51 r9c |U(dU(d [S5e[U[5(a[X5(aU$[U=(d3 [ U5Vs/sHoDR S5(aMUPM sn5n[[ U55n[ Rn[U[5(aUnO-U(d[5n[ RnO [U5nU"URU5U5(aU$[U[5(dIU[ RL=(a S=(d Sn[U<SU<SSRU5<35e"SS 5n U(aS UR-U l [5n [U5HaupX;a[S U -5e[U 5(d[U <S U <S 35e[X[!U 55 U R#U 5 Mc U"X5(aU $[SSRX:- 5-5es snf)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 requiredrzany ofzall ofz does not implement z: rkc\rSrSrSrSrg)(as_interface..AnonymousInterfaceikzA callable-holding shell.rzNrsrtrurvrwryrzr9r7AnonymousInterfacerks'r9r Anonymousz%r: unknown in this interfacer?z is not callablez,dictionary does not contain required keys %s)rDr0r<r|rroperatorgegt intersectionr1rrsdictlike_iteritemsrCr staticmethodr~) r3rr[requiredrY interface implementedcomplies qualifierrfoundrQrs r7 as_interfacer-sB wLMM#tC!5!5 GM3s8M8a<<;L8MNIc#h-K{{H(D!! 5;;x= ((3X>>  c4  +8DH Ityy3 5  (( &1CLL&@# EE*3/   ";fDE E~~vtDE E"L,>? & 0  !! 6 ))H$ % & S Ns H99H9_GFDzgeneric_fn_descriptor[Any]c\rSrSr%SrS\S'S\S'S\S'SSS jjr\SS j5r\SS j5rSS jr\ (a SSjr SSjr SSjr \ SSj5rSrg )generic_fn_descriptoriaODescriptor which proxies a function when the attribute is not present in dict This superclass is organized in a particular way with "memoized" and "non-memoized" implementation classes that are hidden from type checkers, as Mypy seems to not be able to handle seeing multiple kinds of descriptor classes used for the same attribute. Callable[..., _T_co]fget Optional[str]rwrVrsNcfXlU=(d URUlURUlgrKrrwrsrcrdocs r7rgeneric_fn_descriptor.__init__s" *dll   r9cgrKrzrcr3rs r7__get__generic_fn_descriptor.__get__s:=r9cgrKrzrs r7rrs7:r9c[5erKNotImplementedErrorrs r7rr !##r9cgrKrzrcinstanceris r7__set__generic_fn_descriptor.__set__scr9cgrKrz)rcrs r7 __delete__ generic_fn_descriptor.__delete__sSr9c[5erKrrcr3s r7_resetgeneric_fn_descriptor._resetrr9c[5erKrrr3rs r7resetgeneric_fn_descriptor.resets !##r9rwrsrrK)rrrr)rcrr3rrrrrqr)r3rPrrrqr")rcrr3rrrrqzUnion[_GFD, _T_co]rrrirrqrrrrrqrr)r3rrqrr)r3rrrVrqrr)rsrtrurvrwr:rrrrrrr classmethodrryrzr9r7rrsf  M& == ::$A8$$$r9rc2\rSrSrSr\(dSrSrgSrg)_non_memoized_propertyiza plain descriptor that proxies a function. primary rationale is to provide a plain attribute that's compatible with memoized_property which is also recognized as equivalent by mypy. c.UcU$URU5$rKrrs r7r_non_memoized_property.__get__s{ 99S> !r9rzN)rsrtrurvrwrrryrzr9r7rrs  " r9rcB\rSrSrSr\(dSrSr\S5r Sr g)_memoized_propertyiz2A read-only @property that is only evaluated once.cdUcU$URU5=URUR'nU$rK)rrOrsrcr3rresults r7r_memoized_property.__get__s0{ 3799S> ACLL '&Mr9cB[RXR5 grK)rrrsrs r7r_memoized_property._resets  mm4r9c<URRUS5 grK)rOr}rs r7r_memoized_property.resets t$r9rzN) rsrtrurvrwrrrrrryrzr9r7rrs&<   5%%r9rc(^U4Sjn[UT5$)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>^T"U/UQ70UD6mU4SjnTRUlTRUlX0RTR'T$)Nc>T$rKrzarrs r7memo6memoized_instancemethod..oneshot..memosMr9)rsrwrOrcr4rrrrs @r7oneshot(memoized_instancemethod..oneshotsID&4&2&   zz %) bkk" r9r)rr s` r7memoized_instancemethodr s  '2 &&r9c\rSrSr%Sr\(dSr\"5rS\ S'S Sjr S Sjr SSjr "S S \ \5r\SS j5rSrg ) HasMemoizedizwA mixin class that maintains the names of memoized elements in a collection for easy cache clearing, generative, etc. rzzFrozenSet[str]_memoized_keyscbURHnURRUS5 M! grK)rrOr}rcelems r7_reset_memoizationsHasMemoized._reset_memoizationss&''D MM  dD )(r9cLURHnXR;aMe grK)rrOrs r7_assert_no_memoizations#HasMemoized._assert_no_memoizationss"''D}}, ,,(r9cLX RU'U=RU1-slgrK)rOr)rcrris r7_set_memoized_attribute#HasMemoized._set_memoized_attributes!" c u$r9ct\rSrSr%SrS\S'S\S'S\S'SSS jjr\SS j5r\SS j5rS rSr g )HasMemoized.memoized_attributei!zDA read-only @property that is only evaluated once. :meta private: Callable[..., _T]rrrwrVrsNcfXlU=(d URUlURUlgrKrrs r7r'HasMemoized.memoized_attribute.__init__,s"I.$,,DL MMDMr9cgrKrzrs r7r&HasMemoized.memoized_attribute.__get__1s ACLL '&   4==/ 1 Mr9rrK)rrrr)rcr'r3rrrrrqr')r3rrrrqr!) rsrtrurvrwr:rrrryrzr9r7memoized_attributer!sB    * ? ? 8 8 r9r$c,^SU4Sjjn[UT5$)z=Decorate a method memoize its return value. :meta private: c>^T"U/UQ70UD6mU4SjnTRUlTRUlX0RTR'U=RTR1-slT$)Nc>T$rKrzrs r7rBHasMemoized.memoized_instancemethod..oneshot..memoIs r9)rsrwrOrr s @r7r 4HasMemoized.memoized_instancemethod..oneshotFs`*t*r*F KKDM::DL)-MM"++ &   BKK= 0 Mr9)rcrr4rrrrqrr)rrr s ` r7r #HasMemoized.memoized_instancemethod>s gr**r9Nrp)rrVrirrqrrrr$rqr$)rsrtrurvrwrrx frozensetrr:rrrmemoized_propertyr!r$rr ryrzr9r7rrsT  %.[NN0*-%.r2:++r9rc,\rSrSrSrSrSrSSjrSrg) MemoizedSlotsi[zApply 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__. rzc[U5erK)r>)rcrs r7_fallback_getattrMemoizedSlots._fallback_getattres S!!r9c^^^TRS5(dTRS5(a [T5e[TRST35(a#[ TST35"5n[ TTU5 U$[TRST35(a*[ TST35mUUU4SjnTR UlU$TRT5$)N_memoized_attr__memoized_method_c>^T"U0UD6mU4SjnTRUlTRUl[TTU5 T$)Nc>T$rKrzrs r7r8MemoizedSlots.__getattr__..oneshot..memozs!Mr9)rsrwr)r4rrrrrrcs @r7r *MemoizedSlots.__getattr__..oneshotws>TR"!#  !zz c4( r9)rr>rrr/rrwr1)rcrrir rs`` @r7 __getattr__MemoizedSlots.__getattr__hs >>+ , , 1 1 !% %T^^se%< = =DOC5"9: ? ?!23%89B !jjGON))#. .r9N)rrVrqr) rsrtrurvrwrxr1r:ryrzr9r7r/r/[sI"/r9r/c[U[5(a:UR5R5nUS;agUS;ag[ SU-5e[ U5$)N)trueyesonyt1T)falsenooffrf0FzString is not true/false: %r)r0rVstriprr2rrHs r7asboolrIsV#siik! 6 6 9 9;cAB B 9r9c^SU4SjjnU$)ziReturn a callable that will evaluate a string as boolean, or one of a set of "alternate" string values. c*>UT;aU$[U5$rK)rI)r3texts r7 bool_or_value"bool_or_str..bool_or_values $;J#; r9)r3rVrqzUnion[str, bool]rz)rLrMs` r7 bool_or_strrOs  r9c"UcU$[U5$)zCoerce to integer.)int)ris r7asintrRs } u:r9cUcUnX;a\[U[5(a[XU5(d3Xb-U[LaU(a[X5XA'gU"X5XA'gggg)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)r0r<rrI)rrrh flexi_booldests r7coerce_kw_typerVsk | E4(( 27E0J0J G  D=ZrwDIbgDI 1K r9cL^[U5nU4[U4SjU55-$)zZProduce a tuple structure that is cacheable using the __dict__ of obj to retrieve values c3h># UH'oTR;dMUTRU4v M) g7frKrOrkr3s r7r"constructor_key..s-&+CLL/@CLLOe22)r r)r3rrs` r7constructor_keyr^s2 3 E 6E&+ r9c~^[U5nURU4SjURU555 U"U0UD6$)z|Instantiate cls using the __dict__ of obj as constructor arguments. Uses inspect to match the named arguments of ``cls``. c3h># UH'oTR;dMUTRU4v M) g7frKrYrZs r7r#constructor_copy..s.&:3<<>OCLLO&:r])r rU difference)r3rr4rrs` r7constructor_copyrcsE 3 EII&+&6&6r&:   r9cn^^[R"5m[R"S5mUU4SjnU$)z%Return a threadsafe counter function.rcT>T [T5sSSS5 $!,(df  g=frK)next)counterlocksr7_nextcounter.._nexts =TTs  ') threadingLockrcount)rirgrhs @@r7rgrgs+ >> Dooa G! Lr9c[US5(a>URb%[UR[5(a[$UR$[ U[ 5(a[O[nU"U[ 5(a[ $U"U[5(a[$U"U[5(a[$[US5(a[ $[US5(a[$[US5(a[$U$)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__rr~r|)rrorr|r0r<rr1)specimenr{isas r7duck_type_collectionrrsx((  ,  ! !32 2 J(( ("8T22* C 8T Xs   Xt   x"" 5 ! ! 5 ! ! r9c ,[X5(aU$[U[5(aB[R"SU<SSR SU55<S[ U5<S35e[R"SU<SU<S[ U5<S35e) Nz Argument 'z ' is expected to be one of type z or c3,# UH nSU-v M g7f)z'%s'Nrz)rrs r7r"assert_arg_type..s$AAVaZsz, got ''z' is expected to be of type 'z', got ')r0rr ArgumentErrorrr<)rhargtypers r7assert_arg_typerysy# gu % %##$A$AA49N  ##$s)- r9c n^^[TS5(a[TR55$[TS[TSS55mTc[ ST-5e[TS5(aUU4SjnU"5$[TS5(a#[ U4S jTR 555$[ ST-5e) z?Return a (key, value) iterator for almost any dict-like object.rq __getitem__rPNzObject '%r' is not dict-likeiterkeysc3^># TR5HnTceUT"U54v M g7frK)r|)rdictlikegetters r7iterator$dictlike_iteritems..iterator.s4((*)))6#;&&+s*-rc36># UHoT"U54v M g7frKrz)rrrs r7r%dictlike_iteritems..5sB/3&+&/s)rrrqr/rDiterr)r~rrs` @r7rr"sx!!HNN$%% X}ght.L MF ~6ABBx$$ ' z 6 " "B(--/BBB6ABBr9cJ^\rSrSr%SrS\S'SU4SjjrS S SjjrSrU=r $) classpropertyi:a)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. Callable[[Any], Any]rcP>[TU]"U/UQ70UD6 URUlgrK)superrrw)rcrrhrrs r7rclassproperty.__init__Gs% **r*|| r9c$URU5$rKrrs r7rclassproperty.__get__Ksyy~r9)rw)rrrhrrrrK)r3rrzOptional[type]rqr) rsrtrurvrwr:rrry __classcell__rs@r7rr:s $r9rc2\rSrSrSSjrSSjrS SjrSrg) hybridpropertyiOcXlXlgrK)r+clslevelrcr+s r7rhybridproperty.__init__Ps   r9cPUcURU5nU$URU5$rKrr+rcrr.clsvals r7rhybridproperty.__get__T*  ]]5)FM99X& &r9cXlU$rKrrs r7 classlevelhybridproperty.classlevel[   r9rNr+rrrr.rrqr!)r+rrqzhybridproperty[_T])rsrtrurvrrrryrzr9r7rrOs'r9rcF\rSrSrS SjrS SjrS SjrS SjrS SjrSr g) rw_hybridpropertyi`c*XlXlSUlgrK)r+rsetfnrs r7rrw_hybridproperty.__init__as  37 r9cPUcURU5nU$URU5$rKrrs r7rrw_hybridproperty.__get__frr9cDURceURX5 grKrrs r7rrw_hybridproperty.__set__mszz%%% 8#r9cXlU$rKrrs r7setterrw_hybridproperty.setterqs   r9cXlU$rKrrs r7rrw_hybridproperty.classlevelurr9)rr+rNrrr)r+rrqzrw_hybridproperty[_T]) rsrtrurvrrrrrryrzr9r7rr`s8 '$r9rc6\rSrSrSrSSjrS SjrS SjrSrg) hybridmethodizz/Decorate a function as cls- or instance- level.c,U=UlUlXlgrK)r+r0rrs r7rhybridmethod.__init__}s$(( DM r9cUc%URRX"R5$URRX5$rK)rrrr+)rcrr.s r7rhybridmethod.__get__s6  ==((@ @99$$X5 5r9cXlU$rKrrs r7rhybridmethod.classlevelrr9)r0rr+Nr)rrr.rrqr)r+rrqzhybridmethod[_T]) rsrtrurvrwrrrryrzr9r7rrzs96 r9rc\rSrSr%SrS\S'0rS\S'\R"5r S SSjjr S r S r S r S rg)symbolia)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. rVrzDict[str, symbol]symbolsNcUR URRU5nUca[U[5(deUc [ U5n[ R[U5nXl U(aX$l X@RU'OU(aX4:wa[SU<SU35eUsSSS5 $!,(df  g=f)Nz#Can't replace canonical symbol for z with new int value ) _lockrrPr0rVhashrQ__new__rrrwrD)rrr canonicalrs r7rsymbol.__new__s YY++//$'C{!$,,,,$ $T Ikk&)4"%K %( D!!1#=dXF..7[:-YYs BB66 Cc>[URS[U544$)NrX)rrrQrbs r7 __reduce__symbol.__reduce__s 3D 222r9c[U5$rK)rrbs r7__str__symbol.__str__s Dzr9c$SUR<S3$)Nzsymbol(rl)rrbs r7__repr__symbol.__repr__s Q''r9rz)NN)rrVrrr Optional[int]rqr)rsrtrurvrwr:rrkrlrrrrrryrzr9r7rrsg  I!#G # NN E "#' !   <3(r9rc<\rSrSrSSjrSSjrSrg) _IntFlagMetaic /=UlnUR5Hupg[R"SU5(aM#[ U[ 5(a [ XgS9nO#URS5(d [S5eMe[XU5 URU5 M [R"UVs0sHoRU_M sn5Ulgs snf)Nz^__.*__$)rrz#Expected integer values for IntFlag)_itemsrqrmatchr0rQrrrDrrr immutabledictr __members__) r classnamerdict_rrqr[vrs r7r_IntFlagMeta.__init__s  UKKMDAxx Q''!S!!Q,\\#&& EFF CC LL "'44&+ ,esXXs]e ,  ,s4Cc[S5e)Nziter not implemented to ensure compatibility with Python 3.11 IntFlag. Please use __members__. See https://github.com/python/cpython/issues/99304rrbs r7__iter___IntFlagMeta.__iter__s! =  r9rzN) rrVrzTuple[Type[Any], ...]rDict[str, Any]rrrqrr)rqzIterator[symbol])rsrtrurvrrryrzr9r7rrs<  %       2 r9rc\rSrSrSrSrg) _FastIntFlagizAn 'IntFlag' copycat that isn't slow when performing bitwise operations. the ``FastIntFlag`` class will return ``enum.IntFlag`` under TYPE_CHECKING and ``_FastIntFlag`` otherwise. rzNrrzr9r7rrsr9r) metaclass)IntFlag_EcUR5H0upEXLaUs $U(aXR:XaUs $X;dM.Us $ Ucg[R"SUSU<35e)a'Given a user parameter, parse the parameter into a chosen value from a list of choice objects, typically Enum values. 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 enum values to lists of possible entries for each. :param name: name of the argument. Used in an :class:`.ArgumentError` that is raised if the parameter doesn't match any available argument. NzInvalid value for 'z': )rqrr rw)rhchoicesrresolve_symbol_names enum_valuechoices r7parse_user_argument_for_enumrsi(&mmo    !c__&<  ]  . {  1$s3'B CCr9c,[Ul[S- qg)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 r7set_creation_orderr$s /HqOr9c|U"U0UD6$![a' [S[R"5SS-5 gf=f)zPexecutes the given function, catches all exceptions and converts to a warning. z%s('%s') ignoredrrN)rBwarnr`ra)r+r4r`s r7warn_exceptionr1sA 7T$V$$ 7 #,,.1"5 567s  .;;cZ[U5U:aSUSU-$U$![a Us$f=f)Nz%s...r)rrD)rilen_s r7ellipses_stringr<s= u: U1T]* *L  s **c`^\rSrSr%SrS\S'S U4SjjrS SjrS SjrSr U=r $) _hash_limit_stringiFaA 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, rQ_hashc|>X-SU--n[TU]X5n[SU[U5U-4-5UlU$)Nz6 (this warning may be suppressed after %d occurrences)z%s_%d)rrrr)rrinumr4 interpolatedrcrs r7r_hash_limit_string.__new__SsN Ds J ws1'UD,>,D$EEF  r9cUR$rKrrbs r7__hash___hash_limit_string.__hash__]s zzr9c0[U5[U5:H$rK)r)rcothers r7__eq___hash_limit_string.__eq__`sDzT%[((r9r)rirVrrQr4 Sequence[Any]rqr)rqrQ)rrrqr) rsrtrurvrwr:rrrryrrs@r7rrFsC J!)6 ))r9rcU(a[[R"XS95 g[U[R5 g)zXIssue a warning. If msg is a string, :class:`.exc.SAWarning` is used as the category. )rN)_warnings_warnr SAWarning)msgrs r7rrds& s}}S45sCMM*r9c`U(a [USU5n[U[R5 g)zTIssue a warning with a parameterized string, limiting the number of registrations. N)rrr r)rr4s r7 warn_limitedrqs#   b$/3 &r9z)Dict[CodeType, Tuple[str, Type[Warning]]] _warning_tagsc^^UU4SjnU$)Nc2>TT4[UR'U$rK)rr)rcategorymessages r7go#tag_method_for_warnings..gos&-x%8 bkk" r9rz)r r r s`` r7tag_method_for_warningsr ~s Ir9z&^(?:sqlalchemy\.(?!testing)|alembic\.)c,[R"U5nS=pEUbU(d<[R"[UR R SS55(dSnUR[;a*Sn[URupgU=(d UnUSUS3nURnU(dUS- nOU(aU(aOUbMUb[R"XUS-S 9 g[R"XS-S 9 g![a SnNB SnNG=f) NFrsrTz (rlrr) stacklevel) r` _getframerr_not_sa_pattern f_globalsrPf_coderf_backr2warningsr)r r rframestacklevel_foundwarning_tag_found_suffix _categorys r7rrs  % j)054$BHH!4!4Z!D-- $( ||},$(!'4U\\'B$#0y$IRy2LLE#a !&736 gJNC gq.9Q   sD DDc&^^^T/mSUUU4SjjnU$)zJDecorate the given function to be a no-op after it is called exactly once.c>TnT(aTR5nU"U0UD6$g! T(aTRSU5 e=f)Nr)r}insert)rhr strong_fnonce_fnronceretry_on_exceptions r7r only_once..gosM hhjG *r**   %KK7+s %A)rhrrrrqz Optional[_T]rz)rr!r r s`` @r7 only_oncer#s 4D   Ir9z%sqlalchemy/([a-z_]+/){0,2}[a-z_]+\.pyzunit(?:2|test2?/)c4Sn[U5S- nX4::a<URX5(a$US- nX4::aURX5(aM$X4::a<URX5(a$US-nX4::aURX5(aM$XUS-$)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_suffixrends r7chop_tracebackr*s" E b'A+C ,>00;;   ,>00;; ,>0099 q ,>0099 cAg r9c\SU-n[5R5n[X5 US$)Nz&def set(obj, value): obj.%s = valuer|)rcopyr)attrnamerrs r7 attrsetterr.s* 3h >D (--/CO u:r9z^__.+__$c4^\rSrSrSrSrSU4SjjrSrU=r$) TypingOnlyizA mixin class that marks a class as 'typing only', meaning it has absolutely no methods, attributes, or runtime functionality whatsoever. rzc>[UR;aQURVs1sH!n[R U5(aMUiM# nnU(a[ SUSUS35e[ TU]5 gs snf)NzClass z< directly inherits TypingOnly but has additional attributes r)r0r#rO_dundersrAssertionErrorr__init_subclass__)rr remainingrs r7r4TypingOnly.__init_subclass__ sv  &!$!-X^^D5I $SE"--6Kq: !#s A6A6rp) rsrtrurvrwrxr4ryrrs@r7r0r0s I $ $r9r0cR^\rSrSr%SrS\S'SU4Sjjr\S Sj5rSr U=r $) EnsureKWArgia"Apply translation of functions to accept \**kw arguments if they don't already. Used to ensure cross-compatibility with third party legacy code, for things like compiler visit methods that need to accept ``**kw`` arguments, but may have been copied from old code that didn't accept them. rV ensure_kwargcD>URnURnU(arUHln[R"X5nU(dM"X#n[R "U5nUR (aMOURU5n[XU5 Mn [TU])5 grK) r9rOrrrrr6 _wrap_w_kwrrr4) rfn_regclsdictrrYrrwrappedrs r7r4EnsureKWArg.__init_subclass__+s|!!,, HHV)1 B!88T"U6$rKrz)rhrrs r7wrap$EnsureKWArg._wrap_w_kw..wrap;s s8Or9)rhrrrrqrr)rrrBs ` r7r;EnsureKWArg._wrap_w_kw9s dB''r9rzrp)rrrqr) rsrtrurvrwr:r4rr;ryrrs@r7r8r8s. $((r9r8c[US5(a [X5$UnURRUl[US5(aURUl[UR S5(a8UR R (aUR R UlU$UR (aUR UlU$)zAugment functools.update_wrapper() to work with objects with a ``__call__()`` method. :param fn: object with __call__ method rsrtrw)rrrrsrtr1rw)wrapperr_fs r7 wrap_callablerHAsr:g** ll++ 2| $ $MMBM 2;; * *r{{/B/B,,BJ ZZBJ r9cSU;aURS5$Sn//nSn[U5nX4:aXnUS:Xa9US:Xa-X4S- :a%XS-S:XaUSRS5 US- nO8US-nO2US:XaUS:XaUR/5 OUSRU5 US- nX4:aMUVs/sHnSRU5PM sn$s snf)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'] "rrrrJr)rrrr)rirridxlvcharrs r7quoted_token_parserrNYs$ %{{3 E!dF C UB (z 3;zcFlu1W~/Dr !!#&q  S[UaZ MM"  2J  d # q ()/ /uBGGEN // /s4CcD^^[R"T5mUU4SjnU$)Nc>URSL=(a UR=(d SnU(a[UTVs0sHo"T_M sn5nXlU$s snf)Nr)rwinject_param_text)rrparamparamsrLs r7r$add_parameter_text..decoratesOjj$39r #C6)J6%+6)JKC  *Ks A )rrm)rSrLrs`` r7add_parameter_textrUs  ! !& )F Or9cURSS5n[U5S:XaU$Uup#URS5(dUS-[R"U5-$[R"U5$)N rr)rrrtextwrapdedent)rL split_text firstliner5s r7_dedent_docstringr\sdD!$J :! )    $ $4(//)"<<<t$$r9c[U=(d S5nURS5n[U5S:XaURS5 [R "U5RS5nUS(aUR SS5 [U5VVs/sHupgUR5(aMUPM nnnUR SS5 U[U[U5S- 5n USU U-XIS-nSRU5$s snnf)NrrWrr) r\rrrrXrYrrorHminr) given_doctext injecttextposdoctextlines injectlinesrlineblanks inject_poss r7inject_docstring_textrhs%]%8b9G MM$ E 5zQ R//*-33D9K1~1b!#,U#3 H#3ic4::[R "SUS5n U (aS[U R S55-nXU-nOU(aURSUS/5 SnOdUR5(dURXTS/5 SnO9URS5(a#URXRR5/5 GMKURU5 U(aGM^SRU5$) Nr*rrz(\s+)\SrrWz::) collectionsdeque splitlinespopleft _param_regrrlstriprrrrstriprrr) rb inject_paramsdoclinesrc to_injectrerYrRindentm2s r7rQrQsX  !3!3!56H EI !   T "   ))#.) 3qwwqz?2S8F XXj(1+>%(3rxx{+;%;F &u)= =I  LL$ 40 1I LL$40 1I ]]4  LL$ 0 0 23 4  T? (B 99U r9c4[U5S:Xag[U5S:*nU(aUSSO USSUSS-nUVs/sHn[U5S:aSUSS-OUPM nnU(aSRU5$SRUSS5<S US<3$s snf) zTrims a list of strings from the middle and return a string of up to four elements. Strings greater than 11 characters will be truncatedrNr<rrJ z%s..rkz, ..., )rr)rflagrress r7repr_tuple_namesr{s 5zQ u:?DE!AJE!AJrs$;EFK LedTR6D"I T 9eC L yy~ $ #a( 3SW== Ms#Bc@[(agU(a [S5eg)NTzDcython extensions were expected to be installed, but are not presentF)r ImportError)raise_s r7has_compiled_extrs$  "  r9c6\rSrSr\R "5rSrg)_MissingirzN)rsrtrurvenumautoMissingryrzr9r7rrs iikGr9r)r3rr4r+rqrN)r3rrqrN)rXrrqrV)rType[_T]rqzIterator[Type[_T]])rrrqrVrK)r Type[Any]rrrqrV)rzUnion[Type[Any], object]rrrqr)rslicerqTuple[Any, ...])r Sequence[str]rrVrqz Iterator[str])rzCallable[[int], Any]rrQrqz Iterator[Any])rrrqzCallable[[_Fn], _Fn])rzUnion[str, types.CodeType]rrrrVrqr)rr<rOptional[Set[str]]rz Literal[True]rqzSet[str])rr<rrrrrqr)r+rrq List[str])FF)rrr.rr/rrqzcompat.FullArgSpec)T)rz-Union[Callable[..., Any], compat.FullArgSpec]rrrqzDict[str, Optional[str]])rzrzrzrz)rWrrXrVrYrVrZrr[rr\rr]rrqzCallable[[_T], _T])rzNrz) r3rrrzSequence[Tuple[str, Any]]rsz%Optional[Union[object, List[object]]]rtrrqrV)NNz self.proxyN)NNNr+)r3rrqr)rLrVrqz!Callable[[str], Union[str, bool]])rirrqr)TN) rrrrVrhrrTrrUzOptional[Dict[str, Any]]rqrr)r3rrrrqr) r3r!rrr4rrrrqr!)rqzCallable[[], int])rprr{Optional[Type[Any]]rqr)rhrrxz'Union[Tuple[Type[Any], ...], Type[Any]]rrVrqr)F) rhrrzDict[_E, List[Any]]rrVrrrqz Optional[_E]r)r+rr4rr`rrqr))rrVrrrqrr)rrVr4rrqrr)r rVr z Type[Warning]rqCallable[[_F], _F])Nr)r zUnion[str, Warning]r zOptional[Type[Warning]]rrQrqrr)rrr!rrqzCallable[..., Optional[_T]])r&rr're.Pattern[str]r(rrqr)rSrrLrVrqr)rLrVrqrV)r_rr`rVrarQrqrV)rbrVrrzDict[str, str]rqrV)rrrqr)rw __future__rrkr functoolsrrLrrrr`rXrkrrtypingrrr r r r r rrrrrrrrrrrrrrrr_has_cyrrr r!r"r$r&r'r(r)py314 annotationlibr*r+r8r<rOrr=r@rErIpy310rZr\rrrrrrrrrrrrrrr r,r:rrSr^rarerrrrrrrrrrrr-non_memoized_propertypropertyro_memoized_propertyro_non_memoized_propertyr r!HasMemoized_ro_memoized_attributer$r/rIrOrRrVr^rcrgrrryrrrrrrQrrrr FastIntFlagEnumrrrrrrrVrrrrr:r compilerrr#_SQLA_RE _UNITTEST_REr*NoneTyper.r2r0r8rHrNrUr\rhrorQr{rrr MissingOrrzr9r7rs# $   $ T]4( T#s(+, e34 e@A e01 e./ <<5$!MM*;<DD$ # BH \\, 2"$8282v 6/3O O+OO,-,&, ,$  M e/0 Y,x $+9DGen en((V (  $!        -1E *=A  .2E2 2*2=A22j2EJ5;5;%)5;=A5;5;rHLr 5r @Dr r jJ#% "/1      -26( 028< " KB KB,KB6KB KB  KB\;;<#L &   @/FSlv9:($GEN($V"259""%.u5%<.1 $'0BA,7MM4'.J+J+Z(0%(3(F(F%*/*/\  %) '' ' ' ' # '  '4  37  /  F >FI$C0H*WR[" 472;$9(S9(x 4 D\KK T#"' D D D D D  DD 7))< +'<> 8= )**FG )-0: 0:%0:0: 0:f/3 4 ::> ?zz./ '3&.#$ 4 : ::j !$$*&(&(R0)0X  % .18;(ZZ- . (V > tyy    "gh..// 0 r9