o fq i @sUdZddlmZddlZddlZddlmZddlZddlZddl Z ddl Z ddl Z ddl Z ddl Z ddlZddlmZddlmZddlmZddlmZdd lmZdd lmZdd lmZdd lmZdd lmZddlmZddlmZddlmZddlmZddlmZddlmZddlmZddlm Z ddlm!Z!ddlm"Z"ddlm#Z#ddl$Z$ddl%m&Z&ddl%m'Z'ddl(m)Z)ddlm*Z*ddl%m+Z+e"d Z,e"d!d"d#Z-e"d$ed%efd&Z.e"d'd(d&Z/e"d)d*d&Z0e"d+d,d&Z1e"d-d.d&Z2e'j3r(dd/l4m5Z5dd0l4m6Z6d1d2Z7e8j9d3j:Z;d4d5Z<dZdd?Z>ne'j?r3d[d@d?Z>nd[dAd?Z>d\dDdEZ@GdFdGdGZAd]dKdLZBd^dNdOZC d_d`dSdTZDdadZd[ZEdbd_d`ZFdcdedfZGdddldmZHe"dndXd&ZIdedqdrZJdfdxdyZKe"dzZLe"d{ZMGd|d}d}ZNd~dZOedd%ddgddZPeddddhddZPddddhddZPdiddZQ djdkddZR "dldmddZSdlddZT dndoddZUddZVddZW  dpdqddZXGdddZYddZZddZ[   drddZ\ddZ]dsddZ^e"ddd&Z_Gdd„dee-Z`GddĄde`e-ZaGddƄde`e-Zbe!rJe`Zce`ZdeeZfeeZgnebZcZfeaZdZgdtddȄZhGddʄdʃZie!reeeZjneijkZjGdd̄d̃Zldudd΄Zmdvdd҄ZndwddքZo " dxdydd߄ZpdzddZqd{ddZrd|ddZs d_d}ddZtd~ddZuddZvGdddeeZwGdddee,ZxGdddee,ZyGdddee,ZzGddde{Z|Gddde8Z}Gddde}dZ~e!rddlmZeZne~Ze"dejd&Z ddd d Zdadd dZdddZdddZGdddeZd_dddZdddZiZded<dd#d$Ze d%Z  ddd)d*Zdd.d/Ze d0Ze d1Zeefdd6d7Ze8dZd8d9Ze d:ZGd;d<d<ZGd=d>d>Zd?d@ZdAdBZddDdEZddFdGZddKdLZe dMZddQdRZddTdUZddVdWZGdXdYdYejZejZe#e,e*ejfZdS(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)FormatcCsBt|dd}|durt|||d}t|tst|d|SdS)N __annotate__)ownerz!.__annotate__ returned a non-dict)getattrr) isinstancedict ValueError)objformatZannotateannr4b/home/app/PaddleOCR-VL/.venv_paddleocr/lib/python3.10/site-packages/sqlalchemy/util/langhelpers.py_get_and_call_annotateFs  r6__annotations__cCsft|trzt|}WntyiYSwt|dd}|dur#iSt|ts/t|dt|S)Nr7z+.__annotations__ is neither a dict nor None)r.type_BASE_GET_ANNOTATIONSAttributeErrorr-r/r0r1r3r4r4r5_get_dunder_annotationsRs     r<r1rr2r*returnMapping[str, Any]cCszt|}Wn tyYn w|durt|St||}|dur%t|}|dur;t|ts2t|r4iSt|d|s?iSt|S)z:A sparse implementation of annotationlib.get_annotations()Nz does not have annotations)r< Exceptionr/r6r.r8callable TypeError)r1r2r3r4r4r5_vendored_get_annotationsds"   rBcCst|tjdS)N)r2)rBr*Z FORWARDREFr1r4r4r5get_annotationssrDcCs t|SN)inspectrDrCr4r4r5rD cCs>t|tr |jdd}nt|dd}|durtjStd|S)Nr7r>)r.r8__dict__getr-r EMPTY_DICTrr;r4r4r5rDs   xstrcCs*|d}t}||tt|S)Nzutf-8)encoderZmd5_not_for_securityupdaterrL hexdigest)rKmr4r4r5md5_hexs  rQc@s2eZdZUdZdZded<dddZdddZdS) 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]]rSr=NonecCst|_dSrE)sysexc_inforSselfr4r4r5 __enter__zsafe_reraise.__enter__type_Optional[Type[BaseException]]valueOptional[BaseException] tracebackOptional[types.TracebackType]rcCsZ|jdusJ|dur|j\}}}|dusJd|_||d|_|dus(J||rE)rSwith_traceback)rXr[r]r_exc_type exc_valueexc_tbr4r4r5__exit__s     zsafe_reraise.__exit__Nr=rT)r[r\r]r^r_r`r=r)__name__ __module__ __qualname____doc__ __slots__r7rYrer4r4r4r5rRs  rRclsType[_T]Iterator[Type[_T]]ccsNt}|g}|r%|}||vrq|||||V|s dSdSrE)setpopaddextend__subclasses__)rlseenstackr4r4r5walk_subclassess  rvelementcCs4t|tr|Szt|WStyd|YSw)Nzunprintable element %r)r.rLr?)rwr4r4r5string_or_unprintables    rx Type[Any]use_name Optional[str]cCs&|p|j}dddtd|DS)N css|]}|VqdSrE)lower).0nr4r4r5 z(clsname_as_plain_name..z([A-Z][a-z]+|SQL))rgjoinrefindall)rlrznamer4r4r5clsname_as_plain_names rinstance_or_clsUnion[Type[Any], object]against_methodCallable[..., Any]boolcCs.t|ts |j}n|}|j}t||}||kS)z1Return True if the two class methods don't match.)r.r8 __class__rgr-)rrZ current_cls method_nameZcurrent_methodr4r4r5method_is_overriddens  rslcsliceTuple[Any, ...]cCs>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__)startstopstephasattrrappendtuple)rretrKr4r4r5 decode_slices   rused Sequence[str]bases Iterator[str]c'sjt|}|D]+tftfddtd}|D]}||vr+|||VnqtdqdS)Ncs t|SrErL)ibaser4r5+ z!_unique_symbols..iz&exhausted namespace for symbol base %s)ro itertoolschainmaprangerq NameError)rrZused_setpoolsymr4rr5_unique_symbols&s   rfnCallable[[int], Any]rint Iterator[Any]ccs2|r||d@}||V||N}|sdSdS)z6Call the given function given each nonzero bit from n.rNr4)rrbr4r4r5map_bits6s   r_FntargetCallable[[_Fn], _Fn]csdfdd }t|S)z'A signature-matching decorator factory.rrr=c st|st|stdt|dd}|dur*d|_z t|}W||_n ||_wt|}dt|j p5d}t |j p>d}|j i||d}ttd|dtd|dd |jf}t|d d \}}t ||d }|t|d d|j|d<t|rd|d<d|d<nd|d<d|d<dt|dvrd|} nd|} |||d|ji} ttjt| | |j} |j| _|j| _t| |S)Nznot a decoratable functionr+rEr4)rdefaultskwonlydefaultszTuple[str, ...]rrrr)rrFgroupedrzasync prefixzawait Z 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) rg)rF isfunctionismethodr?r-r+rinspect_getfullargspeclenrr/fromkeysr_replacerrrgrrNformat_argspec_plusiscoroutinefunctionreprrhtypes FunctionType_exec_code_in_env __defaults____kwdefaults__r) rZannofuncspecZempty_defaultsZempty_kwdefaultsnamesZ targ_namefn_namemetadatacodeenvZ decoratedrr4r5decorateGsf            zdecorator..decorateN)rrr=rr)rrr4rr5 decoratorDs VrrUnion[str, types.CodeType]rDict[str, Any]rcCst||||SrE)exec)rrrr4r4r5rs r_PF_TEc@s@eZdZ ddddZdd Zdd dZdddZdddZdS) PluginLoaderNgrouprLauto_fnOptional[Callable[..., Any]]cCs||_i|_||_dSrE)rimplsr)rXrrr4r4r5__init__s zPluginLoader.__init__cCs|jdSrE)rclearrWr4r4r5rrZzPluginLoader.clearrr=rcCs||jvr |j|S|jr||}|r||j|<|St|jD]}|j|kr6|j|j|<|Sq#td|j|f)NzCan't load plugin: %s:%s) rrrZimportlib_metadata_getrrloadrZNoSuchModuleError)rXrloaderimplr4r4r5rs        zPluginLoader.load modulepathobjnamerTcsfdd}||j|<dS)Ncs4t}dddD]}t||}q t|S)N.r) __import__splitr-)modtokenrrr4r5rs  z#PluginLoader.register..loadr)rXrrrrr4rr5registerszPluginLoader.registercCs |j|=dSrEr)rXrr4r4r5 deregisters zPluginLoader.deregisterrE)rrLrr)rrLr=r)rrLrrLrrLr=rT)rrLr=rT)rgrhrirrrrrr4r4r4r5rs    rcCshztj}Wntyt|}|dt|dfYSw|j}|j}t|j d|t|j |@fS)Nrr) rFCO_VARKEYWORDSr:rrr__code__ co_argcountlist co_varnamesco_flags)rZco_varkeywordsrconargsr4r4r5_inspect_func_argss     r)_setraiseerrr8rOptional[Set[str]]r Literal[True]Set[str]cCdSrEr4rlrrr4r4r5get_cls_kwargssrFcCrrEr4rr4r4r5rsc Cs|du}|r t}|dusJ|jdd}|o$t|tjo$t|jtj}|rCt|\}}| ||sB|sB|r@t d|ddSnd}|rI|rY|j D] }t ||ddurXnqL| d|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 ! NrFz given cls z doesn't have an __init__ method)rrX)rorHrIr.rrrrrrNrA __bases__rdiscard) rlrrtoplevelZctrZhas_initrZhas_kwcr4r4r5rs8        func List[str]cCst|dS)zReturn the set of legal kwargs for the given `func`. Uses getargspec so is safe to call for methods, functions, etc. r)rr)rr4r4r5get_func_kwargs.srno_self_is_initcompat.FullArgSpecc Cs0t|r td|t|r4|r/|r/t|}t|jdd|j|j |j |j |j |j St|St|rb|r\|s@|jr\t|j}t|jdd|j|j |j |j |j |j St|jSt|rot|j|ddSt|drzt|jSt|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)rr__func____call__)rzCan't inspect callable: %s)rF isbuiltinrArrr FullArgSpecargsvarargsvarkwr kwonlyargsrrr__self__r isclassget_callable_argspecrrr )rrrrr4r4r5r9sN              r-Union[Callable[..., Any], compat.FullArgSpec]rDict[str, Optional[str]]c Cst|r t|}n|}tj|}t|d|d|dd|d}|drB|dd}t|ddd|d|dd|d}n|drOd|d}|}nd}|}d}|drf|tttt|d7}|drr|t|d7}|d|d}|r|d|d} nd} tj||d|d| d d d } |drtj|dd|d|d| d d d } n| } |rt|||| || d St|||dd| dd|dd| ddd 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) {'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]rr4cS dt|SN=rrKr4r4r5rrz%format_argspec_plus..) formatvaluecSrrrrr4r4r5rr) grouped_argsself_arg apply_posapply_kwapply_pos_proxiedapply_kw_proxied) r@rrinspect_formatargspecrrrrr/) rrrrrrr! num_defaultsZ name_argsZdefaulted_valsr r"r4r4r5rqsv$   "       rcCsz|tjurd}|r dnd}|rdnd}nzt||dWSty2d}|r(|nd}|r.dnd }Ynwtd|||||d S) 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)rXz()rrz(self, *args, **kwargs)zself, *args, **kwargsz(*args, **kwargs)z*args, **kwargs)rrrr r!r")objectrrrAr/)methodrrrZproxiedr4r4r5format_argspec_inits&    r(r4 target_clstarget_cls_sphinx_nameproxy_cls_sphinx_name classmethodsmethods attributesuse_intermediate_variableCallable[[_T], _T]cCs dd}|S)aSA 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. cSs|SrEr4)rlr4r4r5rz&create_proxy_methods..decorater4)r)r*r+r,r-r.r/rr4r4r5create_proxy_methodssr2cCsJzt|WSty$|tjurdgdddfYSdgdddfYSw)ainspect.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) rXNrkwargs)rrrAr&r)r'r4r4r5getargspec_init s   r4cCst|tjr |js |jS|S)zSAdjust the incoming callable such that a 'self' argument is not required. )r.r MethodTyperr )Z func_or_clsr4r4r5unbound_method_to_callable4sr6 additional_kwSequence[Tuple[str, Any]] to_inspect%Optional[Union[object, List[object]]] omit_kwargc s6|durg}nt|}tg}t}d}t|D]p\}}zt|j} Wn ty1Yqw| j r:t | j nd} |dkr_| j rF| j }| rT| | j d| n| | j ddn|fdd| j d| D| r| j sxJ|ddt| j | d| j Dqg} | fdd|D|durt|r| d dt|D|D]+\} } | |vrqzt| }|ur|| kr| d | |fWqtyYqw|r|D])\} } zt| }|ur|| kr| d | |fWqtyYqwd jjd | fS) z}Produce a __repr__() based on direct association of the __init__() specification vs. same-named attributes present. Nrrcsg|]}|fqSr4r4r~arg)missingr4r5 dz generic_repr..cSsg|]\}}||fqSr4r4)r~r=defaultr4r4r5r?jsc3s |] }tt|dVqdSrE)rr-r<rCr4r5rsszgeneric_repr..cSsg|]}t|qSr4r)r~valr4r4r5r?vr@z%s=%rz%s(%s), )rto_listr& OrderedDict enumeraterrrrArrrrrrrNziprr-itemsrr?rrgr)r1r7r9r;Zpos_argsZkw_argsZvargsrZinsprZ default_lenoutputr=ZdefvalrCr4)r>r1r5 generic_repr@sv        rKc@s6eZdZdZdZddZddZd dd Zd d Zd S)portable_instancemethodz_Turn an instancemethod into a (parent, name) pair to produce a serializable callable. )rrr3 __weakref__cCs|j|j|jdS)Nrrr3rNrWr4r4r5 __getstate__sz$portable_instancemethod.__getstate__cCs&|d|_|d|_|dd|_dS)Nrrr3r4)rrrIr3)rXstater4r4r5 __setstate__s  z$portable_instancemethod.__setstate__r4cCs|j|_|j|_||_dSrE)rrrgrr3)rXmethr3r4r4r5rs z portable_instancemethod.__init__cOs$||jt|j|j|i|SrE)rNr3r-rr)rXr=kwr4r4r5r s z portable_instancemethod.__call__N)r4) rgrhrirjrkrOrQrr r4r4r4r5rLs  rLcs|ht|j}|rV|}fdd|jD}|D] }|||q|jdks1t|ds2qfddt|t s@| n| |DD] }|||qG|s tS)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. c3s|] }|vr|VqdSrEr4r~_Zhierr4r5rz"class_hierarchy..builtinsrscsg|]}|vr|qSr4r4rTrVr4r5r?s z#class_hierarchy..) r__mro__rprrrqrhr issubclassr8rs)rlprocessrrrsr4rVr5class_hierarchys&      r]ccsBt|}|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)dirrYrH)rlkeyskeyrr4r4r5iterate_attributess  ra self.proxyc s.|r|}ndur dfddt|D}|D]{}zt||}t|ds(Wqt|d|}ttj|} Wn ty>Yqwzt| } t | d} t | ddd} Wn t yed } d } Ynwd t } |durs||ipti}t | |z| j ||_ Wn tyYnwt|||qdS) z9Automates delegation of __specials__ for a proxying type.N)rk__del____getattribute__ __metaclass__rOrQcs6g|]}|dr|drt|s|vr|qS)r) startswithendswithrr~rPinto_clsskipr4r5r?sz0monkeypatch_proxied_specials..r r rrz(self, *args, **kw)z (*args, **kw)z?def %(method)s%(fn_args)s: return %(name)s.%(method)s%(d_args)s)r^r-rrrrr:rrr$rAlocalsrrsetattr)rjZfrom_clsrkonlyrZ from_instanceZdundersr'Zmaybe_fnrrZfn_argsZd_argspyrr4rir5monkeypatch_proxied_specialssN           rpcCst|d|t|d|uS)z;Return True if the two methods are the same implementation.r )r-)Zmeth1Zmeth2r4r4r5methods_equivalent%s rqc Csf|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 }|rrd |j |_ t} t |D]'\} } | |vrtd | t | std | | ft|| t| | | qy|| |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)rU)rfrhr4r4r5r?Tsz as_interface..zany ofzall ofz%r does not implement %s: %srDc@eZdZdZdS)z(as_interface..AnonymousInterfacezA callable-holding shell.Nrgrhrirjr4r4r4r5AnonymousInterfacekrtZ Anonymousz%r: unknown in this interfacez%r=%r is not callablez,dictionary does not contain required keys %s)rAr.r8ror^operatorgegt intersectionr/rrgdictlike_iteritemsr@rm staticmethodrq) r1rlr-requiredZ interfaceZ implementedZcompliesZ qualifierrtfoundr'rr4r4r5 as_interface-sP!        r~_GFDzgeneric_fn_descriptor[Any]c@seZdZUdZded<ded<ded<d%d&d d Zed'ddZed(ddZd)ddZer8d*ddZ d+ddZ d,d d!Z e d-d#d$Z dS).generic_fn_descriptoragDescriptor 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]fgetr{rjrLrgNdoccC||_|p|j|_|j|_dSrErrjrgrXrrr4r4r5r  zgeneric_fn_descriptor.__init__rXrr1rTrlrr=cCrrEr4rXr1rlr4r4r5__get__r1zgeneric_fn_descriptor.__get__r&r!cCrrEr4rr4r4r5rr1Union[_GFD, _T_co]cCtrENotImplementedErrorrr4r4r5rinstancer]cCrrEr4rXrr]r4r4r5__set__zgeneric_fn_descriptor.__set__cCrrEr4)rXrr4r4r5 __delete__rz generic_fn_descriptor.__delete__cCrrErrXr1r4r4r5_resetrzgeneric_fn_descriptor._resetrcCrrErrlr1rr4r4r5resetszgeneric_fn_descriptor.resetrE)rrrr{)rXrr1rTrlrr=r)r1r&rlrr=r!)rXrr1rrlrr=rrrr]rr=rTrrr=rT)r1rr=rT)r1rrrLr=rT)rgrhrirjr7rrrrrrr classmethodrr4r4r4r5rs"         rc@s eZdZdZesddZdSdS)_non_memoized_propertyza 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. cCs|dur|S||SrErrr4r4r5rs z_non_memoized_property.__get__N)rgrhrirjrrr4r4r4r5rs  rc@s0eZdZdZes ddZddZeddZdS) _memoized_propertyz2A read-only @property that is only evaluated once.cCs&|dur|S|||j|j<}|SrE)rrHrgrXr1rlresultr4r4r5rsz_memoized_property.__get__cCst||jdSrE)rrrgrr4r4r5rsz_memoized_property._resetcCs|j|ddSrE)rHrprr4r4r5rsz_memoized_property.resetN) rgrhrirjrrrrrr4r4r4r5rsrcsfdd}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. csB|g|Ri|fdd}j|_j|_||jj<S)NcSrEr4arSrr4r5memor1z6memoized_instancemethod..oneshot..memo)rgrjrHrXrrSrrrr5oneshots   z(memoized_instancemethod..oneshotr)rrr4rr5memoized_instancemethods rc@sheZdZUdZes dZeZded<dddZ dd d Z dddZ Gddde e ZedddZdS) HasMemoizedzA mixin class that maintains the names of memoized elements in a collection for easy cache clearing, generative, etc. r4zFrozenSet[str]_memoized_keysr=rTcCs|jD] }|j|dqdSrE)rrHrprXelemr4r4r5_reset_memoizations zHasMemoized._reset_memoizationscCs|jD] }||jvs JqdSrE)rrHrr4r4r5_assert_no_memoizationsrz#HasMemoized._assert_no_memoizationsr`rLr]rcCs||j|<|j|hO_dSrE)rHr)rXr`r]r4r4r5_set_memoized_attributes z#HasMemoized._set_memoized_attributec@sZeZdZUdZded<ded<ded<ddd d ZedddZedddZddZdS)zHasMemoized.memoized_attributezTA read-only @property that is only evaluated once. :meta private: Callable[..., _T]rr{rjrLrgNrcCrrErrr4r4r5r,rz'HasMemoized.memoized_attribute.__init__rXr&r1rTrlrr=cCrrEr4rr4r4r5r1r1z&HasMemoized.memoized_attribute.__get__r cCrrEr4rr4r4r5r4r1cCs8|dur|S|||j|j<}|j|jhO_|SrE)rrHrgrrr4r4r5r7s rE)rrrr{)rXr&r1rTrlrr=r&)r1rrlrr=r )rgrhrirjr7rrrr4r4r4r5memoized_attribute!s     rrr#csd fdd }t|S) zMDecorate a method memoize its return value. :meta private: rXrrrSr=csT|g|Ri|fdd}j|_j|_||jj<|jjhO_S)NcrrEr4rrr4r5rIr1zBHasMemoized.memoized_instancemethod..oneshot..memo)rgrjrHrrrrr5rFs  z4HasMemoized.memoized_instancemethod..oneshotN)rXrrrrSrr=rr)rlrrr4rr5r>s z#HasMemoized.memoized_instancemethodNrf)r`rLr]rr=rTrr#r=r#)rgrhrirjrrk frozensetrr7rrrmemoized_propertyr rrrr4r4r4r5rs    rc@s&eZdZdZdZddZd d d Zd S) MemoizedSlotsaTApply 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__. The memoized get is not threadsafe under freethreading and the creator method may in extremely rare cases be called more than once. r4cCst|rE)r:)rXr`r4r4r5_fallback_getattrhzMemoizedSlots._fallback_getattrr`rLr=rcsds drttjdr(td}t||StjdrGtdfdd}j|_|SS)NZ_memoized_attr_Z_memoized_method_cs:|i|fdd}j|_j|_t|S)NcrrEr4rrr4r5r}r1z8MemoizedSlots.__getattr__..oneshot..memo)rgrjrm)rrSrr`rRrXrr5rzs   z*MemoizedSlots.__getattr__..oneshot)rfr:rrr-rmrjr)rXr`r]rr4rr5 __getattr__ks   zMemoizedSlots.__getattr__N)r`rLr=r)rgrhrirjrkrrr4r4r4r5r[s  rcCsBt|tr|}|dvrdS|dvrdStd|t|S)N)trueyesonyt1T)falsenooffrf0FzString is not true/false: %r)r.rLstripr}r0rrCr4r4r5asbools   rtext!Callable[[str], Union[str, bool]]csdfdd }|S) zqReturn a callable that will evaluate a string as boolean, or one of a set of "alternate" string values. r1rLr=Union[str, bool]cs|vr|St|SrE)rrCrr4r5 bool_or_valuesz"bool_or_str..bool_or_valueN)r1rLr=rr4)rrr4rr5 bool_or_strsrr] Optional[int]cCs|dur|St|S)zCoerce to integer.N)r)r]r4r4r5asintsrrSr`r[ flexi_booldestOptional[Dict[str, Any]]rTcCsx|dur|}||vr6t|trt|||s:||dur8|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)r.r8rr)rSr`r[rrr4r4r5coerce_kw_types    rcs$t|}|ftfdd|DS)zbProduce a tuple structure that is cacheable using the __dict__ of obj to retrieve values c3(|]}|jvr|j|fVqdSrErHr~krCr4r5rz"constructor_key..)rr)r1rlrr4rCr5constructor_keys rrcs4t|}|fdd||D||i|S)zInstantiate cls using the __dict__ of obj as constructor arguments. Uses inspect to match the named arguments of ``cls``. c3rrErrrCr4r5rrz#constructor_copy..)rrN difference)r1rlrrSrr4rCr5constructor_copys rCallable[[], int]cs$ttdfdd}|S)z%Return a threadsafe counter function.rcs0 tWdS1swYdSrE)nextr4counterlockr4r5_nexts$zcounter.._next) threadingLockrcount)rr4rr5rs rspecimenrAOptional[Type[Any]]cCst|dr|jdurt|jtrtS|jSt|trtnt}||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__Nrrqro)rrrZror.r8rr/)rrAZisar4r4r5duck_type_collections(        rr=argtype'Union[Tuple[Type[Any], ...], Type[Any]]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'Nr4)r~rr4r4r5rrz"assert_arg_type..z6Argument '%s' is expected to be of type '%s', got '%s')r.rr ArgumentErrorrr8)r=rrr4r4r5assert_arg_types   rcstdr tStdtdddurtdtdr.fdd}|Std r@tfd d DStd) z?Return a (key, value) iterator for almost any dict-like object.rI __getitem__rINzObject '%r' is not dict-likeiterkeysc3s.D]}dus J||fVqdSrE)r)r`dictlikegetterr4r5iterator1s   z$dictlike_iteritems..iteratorr_c3s|] }||fVqdSrEr4)r~r`)rr4r5r8rWz%dictlike_iteritems..)rrrIr-rAiterr_)rrr4rr5rz%s      rzcs8eZdZUdZded<dfdd ZddddZZS) 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. Callable[[Any], Any]rr=rrScs&tj|g|Ri||j|_dSrE)superrrj)rXrr=rSrr4r5rJs zclassproperty.__init__Nr1rlOptional[type]r=cCs ||SrErrr4r4r5rNrGzclassproperty.__get__)rrr=rrSrrE)r1rrlrr=r)rgrhrirjr7rr __classcell__r4r4rr5r=s  rc@s*eZdZdddZdd d ZdddZdS)hybridpropertyrrcCs||_||_dSrE)rclslevelrXrr4r4r5rSs zhybridproperty.__init__rrr,r=r cC |dur ||}|S||SrErrrXrr,Zclsvalr4r4r5rW  zhybridproperty.__get__rhybridproperty[_T]cC ||_|SrErrr4r4r5 classlevel^zhybridproperty.classlevelNrrrrr,rr=r )rrr=r)rgrhrirrrr4r4r4r5rRs  rc@s>eZdZdddZdd d ZdddZdddZdddZdS)rw_hybridpropertyrrcCs||_||_d|_dSrE)rrsetfnrr4r4r5rds zrw_hybridproperty.__init__rrr,r=r cCrrErrr4r4r5rirzrw_hybridproperty.__get__r]rTcCs|jdusJ|||dSrEr rr4r4r5rpszrw_hybridproperty.__set__rrw_hybridproperty[_T]cCrrEr rr4r4r5settertrzrw_hybridproperty.settercCrrErrr4r4r5rxrzrw_hybridproperty.classlevelNrrr)rrr=r )rgrhrirrrr rr4r4r4r5rcs     rc@s.eZdZdZdddZdd d ZdddZdS) hybridmethodz/Decorate a function as cls- or instance- level.rrcCs||_|_||_dSrE)rr rrr4r4r5rs  zhybridmethod.__init__rrr,r=cCs&|dur |j||jS|j||SrE)rrrr)rXrr,r4r4r5rszhybridmethod.__get__rhybridmethod[_T]cCrrErrr4r4r5rrzhybridmethod.classlevelNr)rrr,rr=r)rrr=r)rgrhrirjrrrr4r4r4r5r }s   r c@sVeZdZUdZded<iZded<eZ  ddd d Z ddZ ddZ ddZ dS)symbolaIA 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. rLrzDict[str, symbol]symbolsNrr{ canonicalrr=cCs|jG|j|}|dur1t|tsJ|durt|}tt|}||_ |r+||_ ||j|<n|rA||krAt d|d||WdS1sMwYdS)Nz#Can't replace canonical symbol for z with new int value ) _lockrrIr.rLhashr__new__rrrjrA)rlrrrrr4r4r5rs&    $zsymbol.__new__cCst|jdt|ffS)NrK)rrrrWr4r4r5 __reduce__szsymbol.__reduce__cCst|SrErBrWr4r4r5__str__rzsymbol.__str__cCsd|jdS)Nzsymbol()rrWr4r4r5__repr__rZzsymbol.__repr__)NN)rrLrr{rrr=r) rgrhrirjr7rrrrrrrrr4r4r4r5rs    rc@s eZdZdd d ZdddZdS) _IntFlagMeta classnamerLrTuple[Type[Any], ...]dict_rrSrr=rTc Ksg|_}|D],\}}td|rq t|tr t||d}n |ds)tdq t |||| |q t dd|D|_ dS)Nz^__.*__$)rrUz#Expected integer values for IntFlagcSsi|]}|j|qSr4r)r~rr4r4r5 r@z)_IntFlagMeta.__init__..)Z_itemsrIrmatchr.rrrfrArmrrZ immutabledict __members__) rlrrrrSrIrvrr4r4r5rs        z_IntFlagMeta.__init__Iterator[symbol]cCstd)Nziter not implemented to ensure compatibility with Python 3.11 IntFlag. Please use __members__. See https://github.com/python/cpython/issues/99304rrWr4r4r5__iter__sz_IntFlagMeta.__iter__N) rrLrrrrrSrr=rT)r=r")rgrhrirr#r4r4r4r5rs rc@rr) _FastIntFlagzAn 'IntFlag' copycat that isn't slow when performing bitwise operations. the ``FastIntFlag`` class will return ``enum.IntFlag`` under TYPE_CHECKING and ``_FastIntFlag`` otherwise. Nrsr4r4r4r5r$rur$) metaclass)IntFlag_EchoicesDict[_E, List[Any]]resolve_symbol_names Optional[_E]cCsj|D]\}}||ur|S|r||jkr|S||vr#|Sq|dur*dStd|d|)aOGiven 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': )rIrrr)r=r(rr*Z enum_valuechoicer4r4r5parse_user_argument_for_enumsr-rcCst|_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)rr4r4r5set_creation_order's r/r3cOs>z||i|WStytdtddYdSw)zXexecutes the given function, catches all exceptions and converts to a warning. z%s('%s') ignoredrrN)r?warnrUrV)rrr3r4r4r5warn_exception4s  r1cCs<zt||krd|d|WS|WSty|YSw)Nz%s...r)rrA)r]Zlen_r4r4r5ellipses_string?s  r3cs@eZdZUdZded<dfd d Zdd d ZdddZZS)_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, r_hashr]rLnumr Sequence[Any]r=cs<||d|}t||}td|t||f|_|S)Nz6 (this warning may be suppressed after %d occurrences)z%s_%d)rrrr5)rlr]r6rZ interpolatedrXrr4r5rVs z_hash_limit_string.__new__cCs|jSrE)r5rWr4r4r5__hash__`rz_hash_limit_string.__hash__otherrrcCst|t|kSrE)r)rXr9r4r4r5__eq__csz_hash_limit_string.__eq__)r]rLr6rrr7r=r4)r=r)r9rr=r) rgrhrirjr7rr8r:rr4r4rr5r4Is   r4msgcCs*|r ttj||ddSt|tjdS)zdIssue a warning. If msg is a string, :class:`.exc.SAWarning` is used as the category. )rN)_warnings_warnr SAWarning)r;rr4r4r5r0gsr0r7cCs |rt|d|}t|tjdS)z\Issue a warning with a parameterized string, limiting the number of registrations. N)r4r<rr=)r;rr4r4r5 warn_limitedts r?z)Dict[CodeType, Tuple[str, Type[Warning]]] _warning_tagsmessagecategory Type[Warning]Callable[[_F], _F]csfdd}|S)Ncsft|j<|SrE)r@rrrBrAr4r5gosz#tag_method_for_warnings..gor4)rArBrFr4rEr5tag_method_for_warningssrGz&^(?:sqlalchemy\.(?!testing)|alembic\.)Union[str, Warning]Optional[Type[Warning]] stacklevelcCszt|}Wntyd}YnKd}YnDd}}|dur]|s0tt|jdds0d}|jt vrJd}t |j\}}|pA|}|d|d}|j }|sT|d7}n|rY|rYn|dus!|durmt j |||dd dSt j ||dd dS) NrFrgrTz (rr)rJ) rU _getframer0rr_not_sa_pattern f_globalsrIf_coder@f_backwarningsr0)rArBrJframeZstacklevel_foundZwarning_tag_foundZ_suffixZ _categoryr4r4r5r<s4   r<rretry_on_exceptionCallable[..., Optional[_T]]csgd fdd }|S) zNDecorate the given function to be a no-op after it is called exactly once.r=rrSr= Optional[_T]cs>}r}z||i|WSrd|dS)Nr)rpinsert)r=rSZ strong_fnZonce_fnroncerRr4r5rFs zonly_once..goN)r=rrSrr=rTr4)rrRrFr4rVr5 only_oncesrXz%sqlalchemy/([a-z_]+/){0,2}[a-z_]+\.pyzunit(?:2|test2?/)tbexclude_prefixre.Pattern[str]exclude_suffixcCsd}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)rYrZr\rendr4r4r5chop_tracebacks r_cCs$d|}t}t|||dS)Nz&def set(obj, value): obj.%s = valuero)rlcopyr)attrnamerrr4r4r5 attrsetters  rbz^__.+__$cs&eZdZdZdZdfdd ZZS) TypingOnlyzA mixin class that marks a class as 'typing only', meaning it has absolutely no methods, attributes, or runtime functionality whatsoever. r4r=rTcsBt|jvrdd|jD}|rtd|d|dtdS)NcSsh|] }t|s|qSr4)_dundersrr~rr4r4r5 s  z/TypingOnly.__init_subclass__..zClass z< directly inherits TypingOnly but has additional attributes r)rcrrHAssertionErrorr__init_subclass__)rl remainingrr4r5rhs zTypingOnly.__init_subclass__rf)rgrhrirjrkrhrr4r4rr5rcsrccs<eZdZUdZded< d fdd Zed d d ZZS) EnsureKWArga6Apply 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. rL ensure_kwargr=rTcsf|j}|j}|r,|D]!}t||}|r+||}t|}|js+||}t|||q t dSrE) rkrHrrrrr _wrap_w_kwrmrrh)rlZfn_regZclsdictr`rPrrwrappedrr4r5rh.s    zEnsureKWArg.__init_subclass__rrcsdfdd }t|S)Nr=rrSr=cs|SrEr4)r=rSrr4r5wrap>rz$EnsureKWArg._wrap_w_kw..wrap)r=rrSrr=rr)rlrrnr4rr5rl<s zEnsureKWArg._wrap_w_kwrf)rrr=r) rgrhrirjr7rhrrlrr4r4rr5rjs  rjcCsht|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 rgrhrj)rrrrgrhr rj)wrapperrZ_fr4r4r5 wrap_callableDs     rpcCsd|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'] "rrrr#cSsg|]}d|qS)r)r)r~rr4r4r5r?sz'quoted_token_parser..)rrr)r]rPridxlvcharr4r4r5quoted_token_parser\s& $   ruparamscstfdd}|S)Ncs:|jdur|jp d}|rt|fddD}||_|S)Nrcsi|]}|qSr4r4)r~paramrr4r5rsz8add_parameter_text..decorate..)rjinject_param_text)rrrvrr4r5rs z$add_parameter_text..decorate)rrE)rvrrr4ryr5add_parameter_texts rzcCsJ|dd}t|dkr|S|\}}|ds |dt|St|S)N rr|)rrrftextwrapdedent)rZ split_text firstlinerir4r4r5_dedent_docstrings    r given_doctext injecttextposcCst|pd}|d}t|dkr|dt|d}|dr(|ddddt|D}|dd|t|t|d}|d||||d}d |S)Nrr{rrcSsg|] \}}|s|qSr4)r)r~r6liner4r4r5r?sz)inject_docstring_text..) rrrrr|r}rUrGminr)rrrdoctextlinesZ injectlinesZblanksZ inject_posr4r4r5inject_docstring_texts       rz(\s+):param (.+?):r inject_paramsDict[str, str]c Cs t|}g}d}|r|}t|}|durO|rN|dd}||vrNdt|dd}|rHt d|d} | rHdt| d}|||}n+|r\| d|dgd}n| sk| ||dgd}n| drz| ||gq | ||s d|S) Nr*r|rz(\s+)\Srr{z::) collectionsdeque splitlinespopleft _param_regrrlstriprrrrrstriprgrr) rrZdoclinesrZ to_injectrrPrwindentm2r4r4r5rxs:     !rxrcCs~t|dkrdSt|dk}|r|ddn |dd|dd}dd|D}|r0d|Sd d|dd|dfS) zTrims a list of strings from the middle and return a string of up to four elements. Strings greater than 11 characters will be truncatedrNrrr#cSs,g|]}t|dkrd|ddn|qS) z%s..N)rrer4r4r5r?s,z$repr_tuple_names..rDz %s, ..., %s)rr)rflagresr4r4r5repr_tuple_namess  ( rcCstrdS|r tddS)NTzDcython extensions were expected to be installed, but are not presentF)r ImportError)Zraise_r4r4r5has_compiled_extsrc@seZdZeZdS)_MissingN)rgrhrienumautoMissingr4r4r4r5rs r)r1rr2r*r=r>)r1rr=r>)rKrr=rL)rlrmr=rn)rwrr=rLrE)rlryrzr{r=rL)rrrrr=r)rrr=r)rrrrLr=r)rrrrr=r)rrr=r)rrrrrrLr=r)rlr8rrrrr=r)rlr8rrrrr=r)rrr=r)FF)rrrrrrr=r )T)rrrrr=r)r4r4r4r4)r)ryr*rLr+rLr,rr-rr.rr/rr=r0)r4Nr4) r1rr7r8r9r:r;rr=rL)NNrbN)NNNr)r1rr=r)rrLr=r)r]rr=r)TN) rSrr`rLr[ryrrrrr=rT)r1rrlryr=r) r1r rlrmrrrSrr=r )r=r)rrrArr=r)r=rrrrrLr=r)F) r=rr(r)rrLr*rr=r+r)rrrrr3rr=r)r2)r;rLrr{r=rT)r;rLrr7r=rT)rArLrBrCr=rD)Nr)rArHrBrIrJrr=rT)rrrRrr=rS)rYrrZr[r\r[r=r)rvrrrLr=rD)rrLr=rL)rr{rrLrrr=rL)rrLrrr=rL)rrr=r{)rj __future__rrr functoolsrrFrrvrrUr|rrrtypingrrrr r r r r rrrrrrrrrrrrPrrrZ_has_cyrrrr r!r#r%r&r'r(Zpy314Z annotationlibr)r*r6r8rHrr9r<rBrDZpy310rQrRrvrxrrrrrrrrrrrrrrrrr(r2r4r6rKrLr]rarprqr~rrrrrZnon_memoized_propertypropertyZro_memoized_propertyZro_non_memoized_propertyrrZ!HasMemoized_ro_memoized_attributerrrrrrrrrrrrzrrrr rrrr$r&Z FastIntFlagEnumr'r-r.r/r1r3rLr4r0r?r@r7rGcompilerLr<rXZ_SQLA_REZ _UNITTEST_REr_NoneTyperbrdrcrjrprurzrrrrxrrrrZ MissingOrr4r4r4r5s|                                    !   ;        \+ 5 9 u%N& C  V+ M 1     #<" "      3     ) ,  +