관리-도구
편집 파일: langhelpers.cpython-38.pyc
U -?�fB� � @ s� U d Z ddlmZ ddlZddlZddlmZ ddlZddlZddl Z ddl Z ddl Z ddl Z ddl Z ddlZddlmZ ddlmZ ddlmZ ddlmZ dd lmZ dd lmZ dd lmZ dd lmZ dd lmZ ddlmZ ddlmZ ddlmZ ddlm Z ddlm Z ddlm Z ddlm Z ddlm Z ddlm!Z! ddlm"Z" ddlm#Z# ddl$Z$ddl%m&Z& ddl%m'Z' dd l(m)Z) dd lm*Z* d d l%m+Z+ e"d �Z,e"d!d"d#�Z-e"d$ed%ef d&�Z.e"d'd(d&�Z/e"d)d*d&�Z0e"d+d,d&�Z1e"d-d.d&�Z2e'j3�rd/d0d1�d2d3�Z4nd/d0d1�d4d3�Z4d/d5d6�d7d8�Z5G d9d:� d:�Z6d;d<d=�d>d?�Z7d/d5d@�dAdB�Z8�d6dCdDd5dE�dFdG�Z9dHdIdJdK�dLdM�Z:dNdOdP�dQdR�Z;dSd5dTdU�dVdW�Z<dXdYdZd[�d\d]�Z=e"d^dId&�Z>dId_d`�dadb�Z?dcdd� Z@dedfd5dIdg�dhdi�ZAe"dj�ZBe"dk�ZCG dldm� dm�ZDdndo� ZEe dd%dp�dqdrdsdtdu�dvdw��ZFe ddxdp�dqdrdJdrdu�dydw��ZFddxdp�dqdrdJdrdu�dzdw�ZFdId{d|�d}d~�ZG�d7dIdJdJdd��d�d��ZH�d8d�dJd�d��d�d��ZI�d9d�d��ZJ�d:dCd5d5dSdSdSdSd�d��d�d��ZKd�d�� ZLd�d�� ZM�d;d/d�d�dSd5d��d�d��ZNG d�d�� d��ZOd�d�� ZPd�d�� ZQ�d<d�d��ZRd�d�� ZS�d=d�d��ZTe"d�d�d&�ZUG d�d�� d�ee- �ZVG d�d�� d�eVe- �ZWG d�d�� d�eVe- �ZXe!�r�eVZYeVZZe[Z\e[Z]neX ZYZ\eW ZZZ]d$d$d��d�d��Z^G d�d�� d��Z_e!�r�e[Z`ne_jaZ`G d�d�� d��Zbd/dJd1�d�d��Zcd5d�d��d�d��Zdd/d�d��d�d��Ze�d>dfd5dCdJd�d�d��d�dZfd/dCdOdÜd�dńZgd d;d/d/d dƜd�dȄZhd�dʜd�d̄Zi�d?d/d�d�dΜd�dЄZjd/d�d5d/dҜd�dԄZkd�dք ZlG d�d d�e[�ZmG d�dڄ d�ee, �ZnG d�d܄ d�ee, �ZoG d�dބ d�ee, �ZpG d�d� d�eq�ZrG d�d� d�es�ZtG d�d� d�etd�Zue!�rBdd�lmvZv evZwneuZwe"d�ejxd&�Zy�d@d/d�d5dJd�d�d�d�Zzda{d/d�d�d�d�Z|dId/d/d/d�d�d�Z}�dAd�d��Z~G d�d�� d�e�Z��dBd5dDd�d��d�d��Z�d5d�d�d��d�d��Z�i Z�d�e��d < d5�d�d�d��d�d�Z�e ���d�Z��dC�d�ddYd��d ��d �d �Z��d dJ�d �d��d�d�Z�e ���d�Z�e ���d�Z�e�e�fd{�d�dd{�d��d�d�Z�esd�Z��d�d� Z�e ���d�Z�G �d�d� �d�Z�G �d �d � �d �Z��d �d � Z��d �d!� Z�d/d5�d�d"��d#�d$�Z�d5d5d���d%�d&�Z�dDd5dYd5�d'��d(�d)�Z�e ���d*�Z�d5�d+d5�d,��d-�d.�Z�d{dD�d/��d0�d1�Z��dD�d2�d3�Z�G �d4�d5� �d5ejx�Z�e�j�Z�e#e,e*e�j� f Z�dS (E z�Routines to help with the creation, loading and introspection of modules, classes, hierarchies, attributes, functions, and methods. � )� annotationsN��update_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]r �Mapping[str, Any]��obj�returnc C s t �| �S �N)�inspect�get_annotations�r+ � r1 �K/opt/hc_python/lib64/python3.8/site-packages/sqlalchemy/util/langhelpers.pyr/ A s r/ c C sB t | t�r| j�dd �}n t| dd �}|d kr4tjS td|�S d S )N�__annotations__r) )� isinstance�type�__dict__�get�getattrr � EMPTY_DICTr )r+ �annr1 r1 r2 r/ F s �str)�xr, c C s* | � d�} t�� }|�| � tt|�� �S )Nzutf-8)�encoder Zmd5_not_for_security�updater r; � hexdigest)r< �mr1 r1 r2 �md5_hexW s rA c @ s@ e Zd ZU dZdZded< dd�dd�Zd d d d d �dd�ZdS )� safe_reraisea Reraise an exception after invoking some handler code. Stores the existing exception info before invoking so that it is maintained across a potential coroutine context switch. e.g.:: try: sess.commit() except: with safe_reraise(): sess.rollback() 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_infozfUnion[None, Tuple[Type[BaseException], BaseException, types.TracebackType], Tuple[(None, None, None)]]rC �None�r, c C s t �� | _d S r- )�sys�exc_inforC ��selfr1 r1 r2 � __enter__� s zsafe_reraise.__enter__z Optional[Type[BaseException]]zOptional[BaseException]z Optional[types.TracebackType]r )�type_�value� tracebackr, c C s` | j d k st�|d kr@| j \}}}|d k s.t�d | _ |�|��n d | _ |d k sRt�|�|��d S r- )rC �AssertionError�with_traceback)rI rK rL rM �exc_type� exc_value�exc_tbr1 r1 r2 �__exit__� s zsafe_reraise.__exit__N)�__name__� __module__� __qualname__�__doc__� __slots__r3 rJ rS r1 r1 r1 r2 rB ^ s rB zType[_T]zIterator[Type[_T]])�clsr, c c sH t � }| g}|rD|�� } | |kr$q n |�| � |�| �� � | V q d S r- )�set�pop�add�extend�__subclasses__)rY �seen�stackr1 r1 r2 �walk_subclasses� s ra )�elementr, c C s: t | t�r| S z t| �W S tk r4 d| Y S X d S )Nzunprintable element %r)r4 r; � Exception)rb r1 r1 r2 �string_or_unprintable� s rd z Type[Any]� Optional[str])rY �use_namer, c C s& |p| j }d�dd� t�d|�D ��S )N� c s s | ]}|� � V qd S r- )�lower)�.0�nr1 r1 r2 � <genexpr>� s z(clsname_as_plain_name.<locals>.<genexpr>z([A-Z][a-z]+|SQL))rT �join�re�findall)rY rf �namer1 r1 r2 �clsname_as_plain_name� s rp zUnion[Type[Any], object]�Callable[..., Any]�bool)�instance_or_cls�against_methodr, c C s. t | t�s| j}n| }|j}t||�}||kS )z1Return True if the two class methods don't match.)r4 r5 � __class__rT r8 )rs rt Z current_cls� method_nameZcurrent_methodr1 r1 r2 �method_is_overridden� s rw �slicezTuple[Any, ...])�slcr, c C s> g }| j | j| jfD ] }t|d�r*|�� }|�|� qt|�S )zrdecode a slice object as sent to __getitem__. takes into account the 2.5 __index__() method, basically. � __index__)�start�stop�step�hasattrrz �append�tuple)ry �retr< r1 r1 r2 � decode_slice� s r� z Sequence[str]z Iterator[str])�used�basesr, c ' sh t | �}|D ]V� t�� ft� fdd�td���}|D ] }||kr4|�|� |V q q4td� ��q d S )Nc s � t | � S r- �r; )�i��baser1 r2 �<lambda>� � z!_unique_symbols.<locals>.<lambda>i� z&exhausted namespace for symbol base %s)rZ � itertools�chain�map�ranger\ � NameError)r� r� Zused_set�pool�symr1 r� r2 �_unique_symbols� s � r� zCallable[[int], Any]�intz Iterator[Any])�fnrj r, c c s* |r&|| d @ }| |�V ||N }q dS )z6Call the given function given each nonzero bit from n.r Nr1 )r� rj �br1 r1 r2 �map_bits� s r� �_FnzCallable[[_Fn], _Fn])�targetr, c s ddd�� fdd� }t |� �S )z'A signature-matching decorator factory.r� �r� r, c sN t �| �s t �| �s td��t�| �}i }t||�}ttd|d ��td|dd� � | j f }t |dd�\}}t ||d�}|� t |d d �� | j |d < t �| �r�d |d < d|d< nd|d < d|d< dt|d �kr�d| }nd| }tj| j }|� t|�� |� |� || d| ji� ttjt||| j ��} t| d| �j| _| | _t| | �S )Nznot a decoratable functionzTuple[str, ...]r r � r� r� )r� r� F��groupedro zasync �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) rT �__func__)r. � isfunction�ismethodrc r �inspect_getfullargspec�!_update_argspec_defaults_into_envr� r rT r� �dictr> �format_argspec_plus�iscoroutinefunction�reprrF �modulesrU �vars�types� FunctionType�_exec_code_in_envr8 � __defaults__� __wrapped__r ) r� �spec�env�namesZ targ_name�fn_name�metadata�code�modZ decorated�r� r1 r2 �decorate� sN ��� �� �� �zdecorator.<locals>.decorater )r� r� r1 r� r2 � decorator� s Ar� c C s| | j rtg }d}| j D ]@}t|�jdkrJd| }|||< |�|� |d7 }q|�|� qt| �}t|�|d< tj|� S | S dS )zCgiven a FullArgSpec, convert defaults to be symbol names in an env.r )�builtins� __builtin__zx%dr r� N)�defaultsr5 rU r �listr� r � FullArgSpec)r� r� Z new_defaultsr� �argro �elemr1 r1 r2 r� = s r� zUnion[str, types.CodeType]�Dict[str, Any])r� r� r� r, c C s t | |� || S r- )�exec)r� r� r� r1 r1 r2 r� R s r� �_PF�_TEc @ sJ e Zd Zdddd�dd�Zdd� Zdd d �d d �Zdddd d�dd�ZdS )� PluginLoaderNr; z Optional[Callable[..., Any]])�group�auto_fnc C s || _ i | _|| _d S r- )r� �implsr� )rI r� r� r1 r1 r2 �__init__^ s zPluginLoader.__init__c C s | j �� d S r- )r� �clearrH r1 r1 r2 r� e s zPluginLoader.clearr )ro r, c C s� || j kr| j | � S | jr:| �|�}|r:|| j |< |� S t�| j�D ]&}|j|krF|j| j |< |�� S qFt�d| j|f ��d S )NzCan't load plugin: %s:%s) r� r� r Zimportlib_metadata_getr� ro �loadr ZNoSuchModuleError)rI ro �loader�implr1 r1 r2 r� h s �zPluginLoader.loadrD )ro � modulepath�objnamer, c s � �fdd�}|| j |< d S )Nc s4 t � �} � �d�dd � D ]}t| |�} qt| ��S )N�.r )� __import__�splitr8 )r� �token�r� r� r1 r2 r� | s z#PluginLoader.register.<locals>.load)r� )rI ro r� r� r� r1 r� r2 �register{ s zPluginLoader.register)N)rT rU rV r� r� r� r� r1 r1 r1 r2 r� ] s �r� c C sn z t j}W n2 tk r< t�| �}|d t|d �f Y S X | j}|j}t|j d |� �t|j |@ �fS d S )Nr r ) r. �CO_VARKEYWORDS�AttributeErrorr r� rr �__code__� co_argcountr� � co_varnames�co_flags)r� Zco_varkeywordsr� �co�nargsr1 r1 r2 �_inspect_func_args� s �r� )�_set�raiseerrr5 zOptional[Set[str]]z Literal[True]zSet[str])rY r� r� r, c C s d S r- r1 �rY r� r� r1 r1 r2 �get_cls_kwargs� s r� Fc C s d S r- r1 r� r1 r1 r2 r� � s c C s� |dk}|rt � }|dk s t�| j�dd�}|oHt|tj�oHt|jtj�}|r�t |�\}}|� |� |s�|s�|r�t d| � d���q�dS nd}|r�|r�| j D ]}t ||d�dkr� q�q�|�d� |S )ae Return the full set of inherited kwargs for the given `cls`. Probes a class's __init__ method, collecting all named arguments. If the __init__ defines a \**kwargs catch-all, then the constructor is presumed to pass along unrecognized keywords to its base classes, and the collection process is repeated recursively on each of the bases. Uses a subset of inspect.getfullargspec() to cut down on method overhead, as this is used within the Core typing system to create copies of type objects which is a performance-sensitive operation. No anonymous tuple arguments please ! Nr� Fz given cls z doesn't have an __init__ method)r� rI )rZ rN r6 r7 r4 r� r� r� r r� r> � TypeError� __bases__r� �discard) rY r� r� �toplevelZctrZhas_initr� Zhas_kw�cr1 r1 r2 r� � s4 � � � z List[str]��funcr, c C s t �| �d S )z�Return the set of legal kwargs for the given `func`. Uses getargspec so is safe to call for methods, functions, etc. r )r r� �r� r1 r1 r2 �get_func_kwargs� s r� zcompat.FullArgSpec)r� �no_self�_is_initr, c C sD t �| �rtd| ���n&t �| �rn|rb|rbt�| �}t�|jdd� |j|j |j |j |j |j �S t�| �S n�t �| �r�|r�|s�| jr�t�| j�}t�|jdd� |j|j |j |j |j |j �S t�| j�S ntt �| �r�t| j|dd�S t| d�� r�t�| j�S t| d��r4t �| j��r&t| j|d�S td | ��n td | ��dS ) z�Return the argument signature for any callable. All pure-Python callables are accepted, including functions, methods, classes, objects with __call__; builtins and other edge cases like functools.partial() objects raise a TypeError. zCan't inspect builtin: %sr NT)r� r� r� �__call__)r� zCan't inspect callable: %s)r. � isbuiltinr� r� r r� r� �args�varargs�varkwr� � kwonlyargs�kwonlydefaultsr r� �__self__r� �isclass�get_callable_argspecr� r~ r� )r� r� r� r� r1 r1 r2 r� � sR � � � r� z-Union[Callable[..., Any], compat.FullArgSpec]zDict[str, Optional[str]])r� r� r, c C s� t | �rt�| �}n| }tj|� }t�|d |d |d d|d �}|d r�|d d }t�|d dd� |d |d d|d �}n"|d r�d|d }|}nd}|}d}|d r�|tttt |d ��7 }|d r�|t|d �7 }|d |d }|�r |d| d� } nd} tj||d |d | d d � d �} |d �rdtj|dd� |d |d | d d � d �} n| } |�r�t|||| || d �S t|||dd� | dd� |dd� | dd� d �S dS )a Returns a dictionary of formatted, introspected function arguments. A enhanced variant of inspect.formatargspec to support code generation. fn An inspectable callable or tuple of inspect getargspec() results. grouped Defaults to True; include (parens, around, argument) lists Returns: args Full inspect.formatargspec for fn self_arg The name of the first positional argument, varargs[0], or None if the function defines no positional arguments. apply_pos args, re-written in calling rather than receiving syntax. Arguments are passed positionally. apply_kw Like apply_pos, except keyword-ish args are passed as keywords. 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)'} r r r N� z%s[0]r� r1 c S s dt | � S �N�=r� �r< r1 r1 r2 r� s r� z%format_argspec_plus.<locals>.<lambda>)� formatvaluec S s dt | � S r� r� r� r1 r1 r2 r� | r� )� grouped_args�self_arg� apply_pos�apply_kw�apply_pos_proxied�apply_kw_proxied���) �callabler r� �inspect_formatargspec�lenr r r r� ) r� r� r� r� r� r� r � num_defaultsZ name_argsZdefaulted_valsr r r1 r1 r2 r� s� $ � � � �� �r� c C s| | t jkr(d}|rdnd}|r"dnd}n@zt| |d�W S tk rf d}|rR|nd}|r^dnd }Y nX td|||||d �S ) a format_argspec_plus with considerations for typical __init__ methods Wraps format_argspec_plus with error handling strategies for typical __init__ cases:: object.__init__ -> (self) other unreflectable (usually C) -> (self, *args, **kwargs) z(self)rI z()r� r� z(self, *args, **kwargs)zself, *args, **kwargsz(*args, **kwargs)z*args, **kwargs)r� r� r� r r r )�objectr� r� r� r� )�methodr� r� r� Zproxiedr1 r1 r2 �format_argspec_init� s$ �r r1 zCallable[[_T], _T])� target_cls�target_cls_sphinx_name�proxy_cls_sphinx_name� classmethods�methods� attributes�use_intermediate_variabler, c C s dd� }|S )aS 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. c S s | S r- r1 )rY r1 r1 r2 r� � s z&create_proxy_methods.<locals>.decorater1 )r r r r r r r r� r1 r1 r2 �create_proxy_methods� s r c C sT z t �| �W S tk rN | tjkr8dgdddf Y S dgdddf Y S Y nX dS )z�inspect.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) rI Nr� �kwargs)r r� r� r r� )r r1 r1 r2 �getargspec_init� s r c C s t | tj�r| js| jS | S dS )zSAdjust the incoming callable such that a 'self' argument is not required. N)r4 r� � MethodTyper� r� )Z func_or_clsr1 r1 r2 �unbound_method_to_callable� s r zSequence[Tuple[str, Any]]z%Optional[Union[object, List[object]]])r+ � additional_kw� to_inspect� omit_kwargr, c sV |dkr�g}n t �|�}t� � g }t �� }d}t|�D ]�\}}zt�|j�} W n tk rh Y q8Y q8X | j rzt | j �nd} |dkr�| j r�| j }| r�|� | j d| � � q�|� | j dd� � n$|�� fdd�| j d| � D �� | r8| j s�t�|�dd� t| j | d� | j �D �� q8g } | � �fdd�|D �� |dk �rlt�|��rl| � d d� t�|�D �� |�� D ]f\} } | |k�r��qtz6t�| � �}|� k �r�|| k�r�| �d | |f � W n tk �r� Y nX �qt|�r@|D ]X\} } z6t�| � �}|� k �r"|| k�r"| �d | |f � W n tk �r: Y nX �q�d �jjd �| �f S ) z}Produce a __repr__() based on direct association of the __init__() specification vs. same-named attributes present. Nr r c s g | ] }|� f�qS r1 r1 �ri r� )�missingr1 r2 � <listcomp> s z generic_repr.<locals>.<listcomp>c S s g | ]\}}||f�qS r1 r1 )ri r� �defaultr1 r1 r2 r s �c 3 s | ]}t t� |d ��V qd S r- )r� r8 r r0 r1 r2 rk s z generic_repr.<locals>.<genexpr>c S s g | ] }t |��qS r1 �r� )ri �valr1 r1 r2 r ! s z%s=%rz%s(%s)�, )r �to_listr � OrderedDict� enumerater r� r� r� r� r r� r] r� r> rN �zipr~ r8 �itemsr rc ru rT rl )r+ r r r Zpos_argsZkw_argsZvargsr� Zinspr� Z default_len�outputr� Zdefvalr r1 )r r+ r2 � generic_repr� sl � ��� r' c @ s6 e Zd ZdZdZdd� Zdd� Zd dd �Zd d � Zd S )�portable_instancemethodz_Turn an instancemethod into a (parent, name) pair to produce a serializable callable. )r� ro r � __weakref__c C s | j | j| jd�S )N�r� ro r r* rH r1 r1 r2 � __getstate__A s �z$portable_instancemethod.__getstate__c C s& |d | _ |d | _|�dd�| _d S )Nr� ro r r1 )r� ro r7 r )rI �stater1 r1 r2 � __setstate__H s z$portable_instancemethod.__setstate__r1 c C s |j | _|j| _|| _d S r- )r� r� rT ro r )rI �methr r1 r1 r2 r� M s z portable_instancemethod.__init__c O s |� | j� t| j| j�||�S r- )r> r r8 r� ro )rI r� �kwr1 r1 r2 r� R s z portable_instancemethod.__call__N)r1 ) rT rU rV rW rX r+ r- r� r� r1 r1 r1 r2 r( 9 s r( c s� | h� t | j�}|r�|�� }� fdd�|jD �}|D ]}|�|� � �|� q4|jdkst|d�sdq� fdd�t|t �s�|� � n|� |�D �D ]}|�|� � �|� q�qt � �S )a' Return an unordered sequence of all classes related to cls. Traverses diamond hierarchies. Fibs slightly: subclasses of builtin types are not returned. Thus class_hierarchy(class A(object)) returns (A, object), not A plus every class systemwide that derives from object. c 3 s | ]}|� kr|V qd S r- r1 �ri �_�Zhierr1 r2 rk f s z"class_hierarchy.<locals>.<genexpr>r� r^ c s g | ]}|� kr|�qS r1 r1 r0 r2 r1 r2 r o s �z#class_hierarchy.<locals>.<listcomp>) r� �__mro__r[ r� r r\ rU r~ � issubclassr5 r^ )rY �processr� r� r� �sr1 r2 r2 �class_hierarchyW s$ � � r7 c c s@ t | �}|D ].}| jD ]"}||jkr||j| fV q qq dS )z�iterate 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)�dirr3 r6 )rY �keys�keyr� r1 r1 r2 �iterate_attributes} s r; � self.proxyc s< |r |}n$�dkrd�� �fdd�t |�D �}|D �]}z4t||�}t|d�sRW q2t|d|�}ttj|�} W n tk r� Y q2Y nX z2t�| �} t� | d �} t� | d dd� �} W n t k r� d } d } Y nX d t � } |dk r�||ip�i }t | |� z| j || _ W n tk �r$ Y nX t� ||| � q2dS ) z9Automates delegation of __specials__ for a proxying type.N)rX �__del__�__getattribute__Z __metaclass__r+ r- c s6 g | ].}|� d �r|�d �rt� |�s|�kr|�qS )r� )� startswith�endswithr~ �ri r@ ��into_cls�skipr1 r2 r � s �z0monkeypatch_proxied_specials.<locals>.<listcomp>r� r� r r z(self, *args, **kw)z (*args, **kw)z?def %(method)s%(fn_args)s: return %(name)s.%(method)s%(d_args)s)r8 r8 r~ r r� r� r� r r� r r� �localsr� r� �setattr)rC Zfrom_clsrD �onlyro Z from_instanceZdundersr Zmaybe_fnr� r� Zfn_argsZd_args�pyr� r1 rB r2 � monkeypatch_proxied_specials� sF � ��� rI c C s t | d| �t |d|�kS )z;Return True if the two methods are the same implementation.r� )r8 )Zmeth1Zmeth2r1 r1 r2 �methods_equivalent� s �rJ c C sp |s|st d��t|t�r(t| |�r(| S t|p>dd� t|�D ��}tt| ��}tj}t|t�rd|}n|svt� }tj}nt|�}||�|�|�r�| S t| t �s�|tjkr�dp�d}t d| |d� |�f ��G dd � d �}|r�d |j |_ t� } t | �D ]R\} } | |k�rt d | ��t | ��s*t d | | f ��t|| t| �� | �| � q�|| |��rV|S t d d� || � ��dS )a� Ensure basic interface compliance for an instance or dict of callables. Checks that ``obj`` implements public methods of ``cls`` or has members listed in ``methods``. If ``required`` is not supplied, implementing at least one interface method is sufficient. Methods present on ``obj`` that are not in the interface are ignored. If ``obj`` is a dict and ``dict`` does not meet the interface requirements, the keys of the dictionary are inspected. Keys present in ``obj`` that are not in the interface will raise TypeErrors. Raises TypeError if ``obj`` does not meet the interface criteria. In all passing cases, an object with callable members is returned. In the simple case, ``obj`` is returned as-is; if dict processing kicks in then an anonymous class is returned. obj A type, instance, or dictionary of callables. cls Optional, a type. All public methods of cls are considered the interface. An ``obj`` instance of cls will always pass, ignoring ``required``.. methods Optional, a sequence of method names to consider as the interface. required Optional, a sequence of mandatory implementations. If omitted, an ``obj`` that provides at least one interface method is considered sufficient. As a convenience, required may be a type, in which case all public methods of the type are required. z2a class or collection of method names are requiredc S s g | ]}|� d �s|�qS )r1 )r? rA r1 r1 r2 r � s z as_interface.<locals>.<listcomp>zany ofzall ofz %r does not implement %s: %sr c @ s e Zd ZdZdS )z(as_interface.<locals>.AnonymousInterfacezA callable-holding shell.N�rT rU rV rW r1 r1 r1 r2 �AnonymousInterface s rL Z Anonymousz %r: unknown in this interfacez%r=%r is not callablez,dictionary does not contain required keys %sN)r� r4 r5 rZ r8 �operator�ge�gt� intersectionr� rl rT �dictlike_iteritemsr rF � staticmethodr\ ) r+ rY r �requiredZ interfaceZ implementedZcompliesZ qualifierrL �foundr r� r1 r1 r2 � as_interface� sP ! �� ��rU �_GFDzgeneric_fn_descriptor[Any]c @ s� e Zd ZU dZded< ded< ded< d$ddd �d d �Zed d dd d�dd��Zedddd�dd��Zd dddd�dd�Zer�ddd d�dd�Z dd d�d d �Z dd d �d d �Z e ddd d!�d"d#��Z dS )%�generic_fn_descriptorag Descriptor 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. zCallable[..., _T_co]�fgetre rW r; rT N�rX �docc C s || _ |p|j| _|j| _d S r- �rX rW rT �rI rX rZ r1 r1 r2 r� @ s z generic_fn_descriptor.__init__rV rD r �rI r+ rY r, c C s d S r- r1 �rI r+ rY r1 r1 r2 �__get__E s z generic_fn_descriptor.__get__r r! �r+ rY r, c C s d S r- r1 r^ r1 r1 r2 r_ H s zUnion[_GFD, _T_co]c C s t � �d S r- ��NotImplementedErrorr^ r1 r1 r2 r_ K s ��instancerL r, c C s d S r- r1 �rI rd rL r1 r1 r2 �__set__P r� z generic_fn_descriptor.__set__�rd r, c C s d S r- r1 )rI rd r1 r1 r2 � __delete__R r� z generic_fn_descriptor.__delete__r* c C s t � �d S r- ra �rI r+ r1 r1 r2 �_resetT s z generic_fn_descriptor._reset)r+ ro r, c C s t � �d S r- ra �rY r+ ro r1 r1 r2 �resetW s zgeneric_fn_descriptor.reset)N)rT rU rV rW r3 r� r r_ r rf rh rj � classmethodrl r1 r1 r1 r2 rW 1 s rW c @ s e Zd ZdZesdd� ZdS )�_non_memoized_propertyz�a 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 C s |d kr | S | � |�S r- �rX r^ r1 r1 r2 r_ g s z _non_memoized_property.__get__N)rT rU rV rW r r_ r1 r1 r1 r2 rn \ s rn c @ s0 e Zd ZdZesdd� Zdd� Zedd� �ZdS ) �_memoized_propertyz2A read-only @property that is only evaluated once.c C s& |d kr | S | � |� |j| j< }|S r- )rX r6 rT �rI r+ rY �resultr1 r1 r2 r_ r s z_memoized_property.__get__c C s t �|| j� d S r- )rp rl rT ri r1 r1 r2 rj x s z_memoized_property._resetc C s |j �|d � d S r- )r6 r[ rk r1 r1 r2 rl { s z_memoized_property.resetN) rT rU rV rW r r_ rj rm rl r1 r1 r1 r2 rp m s rp r� c s � fdd�}t |� �S )z�Decorate 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 s< �| f|�|�� � fdd�}�j |_ �j|_|| j�j < � S )Nc s � S r- r1 ��ar/ �rr r1 r2 �memo� s z6memoized_instancemethod.<locals>.oneshot.<locals>.memo)rT rW r6 �rI r� r/ rv �r� ru r2 �oneshot� s z(memoized_instancemethod.<locals>.oneshotr )r� ry r1 rx r2 �memoized_instancemethod� s rz c @ s~ e Zd ZU dZesdZe� Zded< dd�dd�Z dd�d d �Z d d dd �dd�Z G dd� de e �Zeddd�dd��ZdS )� HasMemoizedzA mixin class that maintains the names of memoized elements in a collection for easy cache clearing, generative, etc. r1 zFrozenSet[str]�_memoized_keysrD rE c C s | j D ]}| j�|d � qd S r- )r| r6 r[ �rI r� r1 r1 r2 �_reset_memoizations� s z HasMemoized._reset_memoizationsc C s | j D ]}|| jkst�qd S r- )r| r6 rN r} r1 r1 r2 �_assert_no_memoizations� s z#HasMemoized._assert_no_memoizationsr; r )r: rL r, c C s || j |< | j|hO _d S r- )r6 r| )rI r: rL r1 r1 r2 �_set_memoized_attribute� s z#HasMemoized._set_memoized_attributec @ sr e Zd ZU dZded< ded< ded< dddd �d d �Zed d dd d�dd��Zedddd�dd��Zdd� ZdS )z HasMemoized.memoized_attributezTA read-only @property that is only evaluated once. :meta private: �Callable[..., _T]rX re rW r; rT NrY c C s || _ |p|j| _|j| _d S r- r[ r\ r1 r1 r2 r� � s z'HasMemoized.memoized_attribute.__init__r& rD r r] c C s d S r- r1 r^ r1 r1 r2 r_ � s z&HasMemoized.memoized_attribute.__get__r r` c C s d S r- r1 r^ r1 r1 r2 r_ � s c C s8 |d kr | S | � |� |j| j< }| j| jhO _|S r- )rX r6 rT r| rq r1 r1 r2 r_ � s )N)rT rU rV rW r3 r� r r_ r1 r1 r1 r2 �memoized_attribute� s r� r# r� c s" ddddd�� fdd� }t |� �S )zMDecorate a method memoize its return value. :meta private: r )rI r� r/ r, c sN �| f|�|�� � fdd�}�j |_ �j|_|| j�j < | j�j hO _� S )Nc s � S r- r1 rs ru r1 r2 rv � s zBHasMemoized.memoized_instancemethod.<locals>.oneshot.<locals>.memo)rT rW r6 r| rw rx ru r2 ry � s z4HasMemoized.memoized_instancemethod.<locals>.oneshotr )rY r� ry r1 rx r2 rz � s z#HasMemoized.memoized_instancemethodN)rT rU rV rW r rX � frozensetr| r3 r~ r r� �memoized_propertyr r� rm rz r1 r1 r1 r2 r{ � s r{ c @ s, e Zd ZdZdZdd� Zddd�dd �Zd S ) � MemoizedSlotsz�Apply 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__. r1 c C s t |��d S r- )r� )rI r: r1 r1 r2 �_fallback_getattr s z MemoizedSlots._fallback_getattrr; r )r: r, c s� �� d�s�� d�r t���n|t�jd�� ��rRt�d�� ��� }t��|� |S t�jd�� ��r�t�d�� ��� � ��fdd�}� j|_|S ����S d S )NZ_memoized_attr_Z_memoized_method_c s6 �| |�� � fdd�}�j |_ �j|_t��|� � S )Nc s � S r- r1 rs ru r1 r2 rv % s z8MemoizedSlots.__getattr__.<locals>.oneshot.<locals>.memo)rT rW rF )r� r/ rv �r� r: rI ru r2 ry " s z*MemoizedSlots.__getattr__.<locals>.oneshot)r? r� r~ ru r8 rF rW r� )rI r: rL ry r1 r� r2 � __getattr__ s � zMemoizedSlots.__getattr__N)rT rU rV rW rX r� r� r1 r1 r1 r2 r� s r� c C sB t | t�r:| �� �� } | dkr"dS | dkr.dS td| ��t| �S )N)�true�yes�on�y�t�1T)�false�no�offrj �f�0Fz String is not true/false: %r)r4 r; �striprh � ValueErrorrr r0 r1 r1 r2 �asbool4 s r� z!Callable[[str], Union[str, bool]])�textr, c s ddd�� fdd� }|S )zqReturn a callable that will evaluate a string as boolean, or one of a set of "alternate" string values. r; zUnion[str, bool]r* c s | � kr | S t | �S d S r- )r� r0 �r� r1 r2 � bool_or_valueF s z"bool_or_str.<locals>.bool_or_valuer1 )r� r� r1 r� r2 � bool_or_str@ s r� � Optional[int])rL r, c C s | dkr | S t | �S )zCoerce to integer.N)r� )rL r1 r1 r2 �asintO s r� zOptional[Dict[str, Any]]rD )r/ r: rK � flexi_bool�destr, c C sj |dkr | }|| krft |t�r,t | | |�sf| | dk rf|tkrV|rVt| | �||< n|| | �||< dS )z�If '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)r4 r5 rr r� )r/ r: rK r� r� r1 r1 r2 �coerce_kw_typeW s �� � � r� r` c s$ t |�}|ft� fdd�|D �� S )zbProduce a tuple structure that is cacheable using the __dict__ of obj to retrieve values c 3 s& | ] }|� j kr|� j | fV qd S r- �r6 �ri �kr0 r1 r2 rk w s z"constructor_key.<locals>.<genexpr>)r� r� )r+ rY r� r1 r0 r2 �constructor_keyq s �r� )r+ rY r� r/ r, c s0 t |�}|�� fdd�|�|�D �� |||�S )z�Instantiate cls using the __dict__ of obj as constructor arguments. Uses inspect to match the named arguments of ``cls``. c 3 s& | ] }|� j kr|� j | fV qd S r- r� r� r0 r1 r2 rk � s z#constructor_copy.<locals>.<genexpr>)r� r> � difference)r+ rY r� r/ r� r1 r0 r2 �constructor_copy| s �r� zCallable[[], int]rE c s$ t �� �t�d�� � �fdd�} | S )z%Return a threadsafe counter function.r c s$ �� t � �W 5 Q R � S Q R X d S r- )�nextr1 ��counter�lockr1 r2 �_next� s zcounter.<locals>._next)� threading�Lockr� �count)r� r1 r� r2 r� � s r� zOptional[Type[Any]])�specimenr r, c C s� t | d�r*| jdk r$t| jt�r$tS | jS t| t�r8tnt}|| t�rJtS || t�rXtS || t�rftS t | d�rttS t | d�r�tS t | d�r�tS |S dS )z�Given 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__Nr r\ rZ )r~ r� r4 rZ r4 r5 r� r� )r� r Zisar1 r1 r2 �duck_type_collection� s* � r� z'Union[Tuple[Type[Any], ...], Type[Any]])r� �argtypero r, c C s^ t | |�r| S t |t�rBt�d|d�dd� |D ��t| �f ��nt�d||t| �f ��d S )Nz8Argument '%s' is expected to be one of type %s, got '%s'z or c s s | ]}d | V qdS )z'%s'Nr1 )ri rt r1 r1 r2 rk � s z"assert_arg_type.<locals>.<genexpr>z6Argument '%s' is expected to be of type '%s', got '%s')r4 r� r � ArgumentErrorrl r5 )r� r� ro r1 r1 r2 �assert_arg_type� s �� ��r� c s� t � d�rt� �� �S t� dt� dd����dkr>td� ��t � d�r\� �fdd�}|� S t � d �r�t�fd d �� �� D ��S td� ��dS ) z?Return a (key, value) iterator for almost any dict-like object.r% � __getitem__r7 Nz Object '%r' is not dict-like�iterkeysc 3 s, � � � D ] } �d k st�| �| �fV qd S r- )r� rN )r: ��dictlike�getterr1 r2 �iterator� s z$dictlike_iteritems.<locals>.iteratorr9 c 3 s | ]}|� |�fV qd S r- r1 )ri r: )r� r1 r2 rk � s z%dictlike_iteritems.<locals>.<genexpr>)r~ r� r% r8 r� �iterr9 )r� r� r1 r� r2 rQ � s rQ c sH e Zd ZU dZded< dddd�� fdd� Zd dd dd �d d �Z� ZS )� classpropertyaA A decorator that behaves like @property except that operates on classes rather than instances. The decorator is currently special when using the declarative module, but note that the :class:`~.sqlalchemy.ext.declarative.declared_attr` decorator should be used for this purpose with declarative. zCallable[[Any], Any]rX r )rX r� r/ c s t � j|f|�|� |j| _d S r- )�superr� rW )rI rX r� r/ �ru r1 r2 r� � s zclassproperty.__init__NzOptional[type]r` c C s | � |�S r- ro r^ r1 r1 r2 r_ � s zclassproperty.__get__)N)rT rU rV rW r3 r� r_ � __classcell__r1 r1 r� r2 r� � s r� c @ s< e Zd Zdd�dd�Zdddd�dd �Zd d d �d d�ZdS )�hybridpropertyr� r� c C s || _ || _d S r- )r� �clslevel�rI r� r1 r1 r2 r� � s zhybridproperty.__init__r r �rd �ownerr, c C s$ |d kr| � |�}|S | �|�S d S r- �r� r� �rI rd r� Zclsvalr1 r1 r2 r_ � s zhybridproperty.__get__rq zhybridproperty[_T]r� c C s || _ | S r- �r� r� r1 r1 r2 � classlevel s zhybridproperty.classlevelN)rT rU rV r� r_ r� r1 r1 r1 r2 r� � s r� c @ s^ e Zd Zdd�dd�Zdddd�dd �Zddd d �d d �Zddd�dd�Zddd�dd�ZdS )�rw_hybridpropertyr� r� c C s || _ || _d | _d S r- )r� r� �setfnr� r1 r1 r2 r� s zrw_hybridproperty.__init__r r r� c C s$ |d kr| � |�}|S | �|�S d S r- r� r� r1 r1 r2 r_ s zrw_hybridproperty.__get__rD rc c C s | j d k st�| � ||� d S r- )r� rN re r1 r1 r2 rf s zrw_hybridproperty.__set__rq zrw_hybridproperty[_T]r� c C s || _ | S r- )r� r� r1 r1 r2 �setter s zrw_hybridproperty.setterc C s || _ | S r- r� r� r1 r1 r2 r� s z rw_hybridproperty.classlevelN)rT rU rV r� r_ rf r� r� r1 r1 r1 r2 r� s r� c @ s@ e Zd ZdZdd�dd�Zdddd�dd �Zd d d �d d�ZdS )� hybridmethodz/Decorate a function as cls- or instance- level.r� r� c C s | | _ | _|| _d S r- )r� r� r� r� r1 r1 r2 r� ( s zhybridmethod.__init__r r� c C s* |d kr| j �||j�S | j�||�S d S r- )r� r_ ru r� )rI rd r� r1 r1 r2 r_ , s zhybridmethod.__get__rq zhybridmethod[_T]r� c C s || _ | S r- r� r� r1 r1 r2 r� 2 s zhybridmethod.classlevelN)rT rU rV rW r� r_ r� r1 r1 r1 r2 r� % s r� c @ s\ e Zd ZU dZded< i Zded< e�� Zddddd d �d d �Z d d � Z dd� Z dd� Z dS )�symbolaI A constant symbol. >>> symbol('foo') is symbol('foo') True >>> symbol('foo') <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. r; ro zDict[str, symbol]�symbolsNre r� )ro rZ � canonicalr, c C s� | j �� | j�|�}|d krbt|t�s*t�|d kr:t|�}t�t |�}||_ |rV||_ || j|< n |r�||kr�t d|�d|� ���|W 5 Q R � S Q R X d S )Nz#Can't replace canonical symbol for z with new int value ) �_lockr� r7 r4 r; rN �hashr� �__new__r� ro rW r� )rY ro rZ r� r� r1 r1 r2 r� K s �zsymbol.__new__c C s t | jdt| �ffS )Nr< )r� ro r� rH r1 r1 r2 � __reduce__i s zsymbol.__reduce__c C s t | �S r- r rH r1 r1 r2 �__str__l s zsymbol.__str__c C s d| j �d�S )Nzsymbol(�)�ro rH r1 r1 r2 �__repr__o s zsymbol.__repr__)NN) rT rU rV rW r3 r� r� r� r� r� r� r� r� r1 r1 r1 r2 r� 7 s � r� c @ s0 e Zd Zdddddd�dd�Zd d �d d �Zd S )� _IntFlagMetar; zTuple[Type[Any], ...]r� r rD )� classnamer� �dict_r/ r, c K s� g | _ }|�� D ]Z\}}t�d|�r(qt|t�r@t||d�}n|�d�std��nqt | ||� |� |� qt � dd� |D ��| _ d S )Nz^__.*__$)r� r1 z#Expected integer values for IntFlagc S s i | ] }|j |�qS r1 r� )ri r� r1 r1 r2 � <dictcomp>� s z)_IntFlagMeta.__init__.<locals>.<dictcomp>)Z_itemsr% rm �matchr4 r� r� r? r� rF r r Z immutabledict� __members__) rY r� r� r� r/ r% r� �vr� r1 r1 r2 r� t s �z_IntFlagMeta.__init__zIterator[symbol]rE c C s t d��d S )Nz�iter not implemented to ensure compatibility with Python 3.11 IntFlag. Please use __members__. See https://github.com/python/cpython/issues/99304ra rH r1 r1 r2 �__iter__� s �z_IntFlagMeta.__iter__N)rT rU rV r� r� r1 r1 r1 r2 r� s s r� c @ s e Zd ZdZdS )� _FastIntFlagz�An 'IntFlag' copycat that isn't slow when performing bitwise operations. the ``FastIntFlag`` class will return ``enum.IntFlag`` under TYPE_CHECKING and ``_FastIntFlag`` otherwise. NrK r1 r1 r1 r2 r� � s r� )� metaclass)�IntFlag�_EzDict[_E, List[Any]]z Optional[_E])r� �choicesro �resolve_symbol_namesr, c C sn |� � D ]>\}}| |kr | S |r6| |jkr6| S | |kr| S q| dkrTdS t�d|� d| ����dS )aO 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': )r% ro r r� )r� r� ro r� Z enum_value�choicer1 r1 r2 � parse_user_argument_for_enum� s r� rg c C s t | _ t d7 a dS )z�Assign a '_creation_order' sequence to the given instance. This allows multiple instances to be sorted in order of creation (typically within a single thread; the counter is not particularly threadsafe). r N)�_creation_order)rd r1 r1 r2 �set_creation_order� s r� )r� r� r r, c O s> z | ||�W S t k r8 tdt�� dd� � Y nX dS )zXexecutes the given function, catches all exceptions and converts to a warning. z%s('%s') ignoredr r N)rc �warnrF rG )r� r� r r1 r1 r2 �warn_exception� s r� � c C sF z(t | �|kr d| d|� W S | W S W n tk r@ | Y S X d S )Nz%s...r )r r� )rL Zlen_r1 r1 r2 �ellipses_string� s r� c sT e Zd ZU dZded< dddd d�� fdd� Zdd �d d �Zd d d�dd�Z� ZS )�_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; � Sequence[Any])rL �numr� r, c s< || d| }t � �| |�}td|t|�| f �|_|S )Nz6 (this warning may be suppressed after %d occurrences)z%s_%d)r� r� r� r� )rY rL r� r� Z interpolatedrI r� r1 r2 r� � s �z_hash_limit_string.__new__rE c C s | j S r- )r� rH r1 r1 r2 �__hash__ s z_hash_limit_string.__hash__r rr )�otherr, c C s t | �t |�kS r- )r� )rI r� r1 r1 r2 �__eq__ s z_hash_limit_string.__eq__) rT rU rV rW r3 r� r� r� r� r1 r1 r� r2 r� � s r� )�msgr� r, c C s( |rt tj| |d�� n t | tj� dS )zdIssue a warning. If msg is a string, :class:`.exc.SAWarning` is used as the category. )r� N)�_warnings_warnr � SAWarning)r� r� r1 r1 r2 r� s r� r� )r� r� r, c C s |rt | d|�} t| tj� dS )z\Issue a warning with a parameterized string, limiting the number of registrations. � N)r� r� r r� )r� r� r1 r1 r2 � warn_limited s r� z)Dict[CodeType, Tuple[str, Type[Warning]]]� _warning_tagsz Type[Warning]zCallable[[_F], _F])�message�categoryr, c s � �fdd�}|S )Nc s �� ft | j< | S r- )r� r� rx �r� r� r1 r2 �go, s z#tag_method_for_warnings.<locals>.gor1 )r� r� r� r1 r� r2 �tag_method_for_warnings) s r� z&^(?:sqlalchemy\.(?!testing)|alembic\.)zUnion[str, Warning]zOptional[Type[Warning]])r� r� � stacklevelr, c C s� zt �|�}W n& tk r& d}Y n� d}Y n�X d }}|d k r�|sdt�t|j�dd��sdd}|jt kr�d}t |j \}}|p�|}| � d|� d�} |j }|s�|d7 }q>|r>|r>q�q>|d k r�t j | ||d d � nt j | |d d � d S ) Nr FrT r� Tz (r� r )r� ) rF � _getframer� rm r� �_not_sa_pattern� f_globalsr7 �f_coder� �f_back�warningsr� )r� r� r� �frameZstacklevel_foundZwarning_tag_found�_suffixZ _categoryr1 r1 r2 r� 6 s4 � r� r� zCallable[..., Optional[_T]])r� �retry_on_exceptionr, c s$ � g�dddd�� ��fdd� }|S )zNDecorate the given function to be a no-op after it is called exactly once.r z Optional[_T]�r� r/ r, c s@ � }�r<�� � }z || |�W S �r4��d|� � Y nX d S )Nr )r[ �insert)r� r/ Z strong_fnZonce_fn�r� �oncer r1 r2 r� q s zonly_once.<locals>.gor1 )r� r r� r1 r r2 � only_oncei s r z%sqlalchemy/([a-z_]+/){0,2}[a-z_]+\.pyzunit(?:2|test2?/)zre.Pattern[str])�tb�exclude_prefix�exclude_suffixr, c C s` d}t | �d }||kr0|�| | �r0|d7 }q||krP|�| | �rP|d8 }q0| ||d � S )at Chop extraneous lines off beginning and end of a traceback. :param tb: a list of traceback lines as returned by ``traceback.format_stack()`` :param exclude_prefix: a regular expression object matching lines to skip at beginning of ``tb`` :param exclude_suffix: a regular expression object matching lines to skip at end of ``tb`` r r )r �search)r r r r{ �endr1 r1 r2 �chop_traceback� s r c C s$ d| }t � �� }t||� |d S )Nz&def set(obj, value): obj.%s = valuerZ )rE �copyr� )�attrnamer� r� r1 r1 r2 � attrsetter� s r z^__.+__$c s* e Zd ZdZdZdd�� fdd� Z� ZS )� TypingOnlyz�A mixin class that marks a class as 'typing only', meaning it has absolutely no methods, attributes, or runtime functionality whatsoever. r1 rD rE c sB t | jkr4dd� | jD �}|r4td| � d|� d���t� �� d S )Nc S s h | ]}t �|�s|�qS r1 )�_dundersr� �ri ro r1 r1 r2 � <setcomp>� s z/TypingOnly.__init_subclass__.<locals>.<setcomp>zClass z< directly inherits TypingOnly but has additional attributes r� )r r� r6 rN r� �__init_subclass__)rY � remainingr� r1 r2 r � s ��z TypingOnly.__init_subclass__)rT rU rV rW rX r r� r1 r1 r� r2 r � s r c sD e Zd ZU dZded< dd�� fdd� Zeddd �d d ��Z� ZS ) � EnsureKWArga6 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. r; � ensure_kwargrD rE c sf | j }| j}|rX|D ]B}t�||�}|r|| }t�|�}|js| �|�}t| ||� qt � � � d S r- ) r r6 rm r� r r� r� � _wrap_w_kwrF r� r )rY Zfn_regZclsdictr: r@ r� r� �wrappedr� r1 r2 r � s z EnsureKWArg.__init_subclass__rq r� c s dddd�� fdd� }t |� �S )Nr r c s � | � S r- r1 )r� r/ rx r1 r2 �wrap� s z$EnsureKWArg._wrap_w_kw.<locals>.wrapr )rY r� r! r1 rx r2 r � s zEnsureKWArg._wrap_w_kw) rT rU rV rW r3 r rm r r� r1 r1 r� r2 r � s r c C sj t |d�rt| |�S | }|jj|_t |d�r4|j|_t |jd�rT|jjrT|jj|_n|jrb|j|_|S dS )z�Augment functools.update_wrapper() to work with objects with a ``__call__()`` method. :param fn: object with __call__ method rT rU rW N)r~ r ru rT rU r� rW )�wrapperr� �_fr1 r1 r2 � wrap_callable� s r$ c C s� d| kr| � d�S d}g g}d}t| �}||k r�| | }|dkr�|dkr|||d k r|| |d dkr||d �d� |d7 }q�|dN }n*|dkr�|dkr�|�g � n|d �|� |d7 }q(dd� |D �S )a� Parse a dotted identifier with accommodation for quoted names. Includes support for SQL-style double quotes as a literal character. E.g.:: >>> quoted_token_parser("name") ["name"] >>> quoted_token_parser("schema.name") ["schema", "name"] >>> quoted_token_parser('"Schema"."Name"') ['Schema', 'Name'] >>> quoted_token_parser('"Schema"."Name""Foo"') ['Schema', 'Name""Foo'] �"r� r r r c S s g | ]}d � |��qS )r� )rl )ri r� r1 r1 r2 r - s z'quoted_token_parser.<locals>.<listcomp>)r� r r )rL r, rr �idx�lv�charr1 r1 r2 �quoted_token_parser s$ $ r) )�paramsr� r, c s t �� �� � �fdd�}|S )Nc s: | j d k r| j pd}|r0t|�fdd�� D ��}|| _ | S )Nr� c s i | ] }|� �qS r1 r1 )ri �paramr� r1 r2 r� 6 s z8add_parameter_text.<locals>.decorate.<locals>.<dictcomp>)rW �inject_param_text)r� rZ �r* r� r1 r2 r� 3 s z$add_parameter_text.<locals>.decorate)r r! )r* r� r� r1 r- r2 �add_parameter_text0 s r. c C sN | � dd�}t|�dkr | S |\}}|�d�s@|d t�|� S t�| �S d S )N� r rg )r� r r? �textwrap�dedent)r� Z split_text� firstliner r1 r1 r2 �_dedent_docstring= s r3 )� given_doctext� injecttext�posr, c C s� t | pd�}|�d�}t|�dkr,|�d� t�|��d�}|d rP|�dd� dd� t|�D �}|�dd� |t|t|�d � }|d|� | ||d � }d� |�S )Nr� r/ r r c S s g | ]\}}|� � s|�qS r1 )r� )ri r� �liner1 r1 r2 r T s z)inject_docstring_text.<locals>.<listcomp>) r3 r� r r r0 r1 r r# �minrl )r4 r5 r6 �doctext�linesZ injectlinesZblanksZ inject_posr1 r1 r2 �inject_docstring_textI s r; z(\s+):param (.+?):zDict[str, str])r9 � inject_paramsr, c C s t �| �� �}g }d }|�r|�� }t�|�}|d kr�|r�|�d��d�}||kr�dt|�d�� d }|r�t �d|d �} | r�dt| �d�� }||| }nV|r�|� d|dg� d }n<|� � s�|� ||dg� d }n |� d�r�|� ||�� g� q|� |� qd�|�S ) Nr �*rg r z(\s+)\Sr r/ z::)� collections�deque� splitlines�popleft� _param_regr� r� �lstripr rm r] �rstripr@ r rl ) r9 r< Zdoclinesr: Z to_injectr7 r@ r+ �indent�m2r1 r1 r2 r, ` s6 r, )r� r, c C s� t | �dkrdS t | �dk}|r,| dd� n| dd� | dd� } dd� | D �}|r`d�|�S d d�|dd� �|d f S dS ) z�Trims a list of strings from the middle and return a string of up to four elements. Strings greater than 11 characters will be truncatedr Nr� r� r c S s, g | ]$}t |�d kr$d|dd � n|�qS )� z%s..N)r r r1 r1 r2 r � s z$repr_tuple_names.<locals>.<listcomp>r z %s, ..., %s)r rl )r� �flag�resr1 r1 r2 �repr_tuple_names� s ( rJ c C s t rdS | rtd��ndS d S )NTzDcython extensions were expected to be installed, but are not presentF)r � ImportError)Zraise_r1 r1 r2 �has_compiled_ext� s �rL c @ s e Zd Ze�� ZdS )�_MissingN)rT rU rV �enum�auto�Missingr1 r1 r1 r2 rM � s rM )N)FF)T)T)r1 r1 r1 r1 )r1 Nr1 )NNr< N)NNN)TN)N)F)r� )N)Nr )F)�rW � __future__r r> rN � functoolsr r. r� rM rm rF r0 r� r� r �typingr r r r r r r r r r r r r r r r r r r r r� r r Z_has_cyr r r r r! r# r% r& r' r( Zpy310r/ rA rB ra rd rp rw r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r r r r r' r( r7 r; rI rJ rU rV rW rn rp r� Znon_memoized_property�propertyZro_memoized_propertyZro_non_memoized_propertyrz r{ Z!HasMemoized_ro_memoized_attributer� r� r� r� r� r� r� r� r� r� r� rQ r� r� r� r� r� r� r5 r� r� r� Z FastIntFlag�Enumr� r� r� r� r� r� r; r� r� r� r� r3 r� �compiler r� r Z_SQLA_REZ _UNITTEST_REr ZNoneTyper r r r r$ r) r. r3 r; rB r, rJ rL rM rP Z MissingOrr1 r1 r1 r2 �<module> sr ; � G(� � �5 �9�u # � �N & � C V + M. � �#<" �" � 3 � ) , +