Dashboard
PHP:
8.2.30
OS:
Linux
User:
dh_nv8b2m
/
/
usr
/
local
/
lib
/
python3.10
/
dist-packages
/
sqlalchemy
/
util
/
__pycache__
📤 Upload
📝 New File
📁 New Folder
Close
Editing: langhelpers.cpython-310.pyc
o [�h� � @ s$ d Z ddlmZ ddlZddlZddlZddlZddlZddlZddl Z ddl Z ddl Z ddl m Z ddl mZ ddl mZ d d � ZG d d � d e�Zd d� Zdd� Zdd� Zdd� Zdd� Zdd� Zdd� ZG dd � d e�Zd d � Zd�d d �Z d!d"� Z d�d$d%�Z d�d'd(�Z d�d)d*�Z d+d,� Z!d-d.� Z"d�d0d1�Z#G d2d3� d3e�Z$d4d5� Z%d6d7� Z& 8 d�d9d:�Z'd;d<� Z(d�d=d>�Z)G d?d@� d@e�Z*dAdB� Z+G dCdD� dDe�Z,G dEdF� dFe�Z-d�dGdH�Z.G dIdJ� dJe�Z/dKdL� Z0dMdN� Z1dOdP� Z2d�dQdR�Z3dSdT� Z4dUdV� Z5d�dWdX�Z6dYdZ� Z7d[d\� Z8G d]d^� d^e9�Z:G d_d`� d`e�Z;G dadb� dbe�Z<G dcdd� dde=�Z>dee>_?G dfde� dee�Z@daAdgdh� ZBdidj� ZCd�dldm�ZDG dndo� doejE�ZFdpdq� ZGdrds� ZHdtdu� ZIe�Jdv�ZKe�Jdw�ZLeLeKfdxdy�ZMeNd�ZOdzd{� ZPG d|d}� d}eN�ZQd~d� ZRd�d�� ZSd�d�� ZTd�d�� ZUd�d�� ZVd�d�� ZWdS )�z�Routines to help with the creation, loading and introspection of modules, classes, hierarchies, attributes, functions, and methods. � ��update_wrapperN� )� _collections)�compat� )�excc C s* t jr| �d�} t�� }|�| � |�� S )Nzutf-8)r �py3k�encode�hashlib�md5�update� hexdigest)�x�m� r �F/usr/local/lib/python3.10/dist-packages/sqlalchemy/util/langhelpers.py�md5_hex s r c @ s. e Zd ZdZdZd dd�Zdd� Zdd � Zd S ) � safe_reraiseaK 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() )� warn_only� _exc_infoFc C � || _ d S �N)r )�selfr r r r �__init__8 � zsafe_reraise.__init__c C s t �� | _d S r )�sys�exc_infor �r r r r � __enter__; � zsafe_reraise.__enter__c C s� |d u r| j \}}}d | _ | jst�|||� d S d S tjs4| j r4| j d r4td| j d | j d f � d | _ t�|||� d S )Nr zfAn exception has occurred during handling of a previous exception. The previous exception is: %s %s r )r r r �reraiser �warn)r �type_�value� traceback�exc_type� exc_value�exc_tbr r r �__exit__> s ���zsafe_reraise.__exit__N�F)�__name__� __module__� __qualname__�__doc__� __slots__r r r) r r r r r $ s r c C s d� dd� t�d| j�D ��S )N� c s s � | ]}|� � V qd S r )�lower)�.0�nr r r � <genexpr>S s � �z(clsname_as_plain_name.<locals>.<genexpr>z ([A-Z][a-z]+))�join�re�findallr+ )�clsr r r �clsname_as_plain_nameR s �r9 c C s> g }| j | j| jfD ]}t|d�r|�� }|�|� q t|�S )zrdecode a slice object as sent to __getitem__. takes into account the 2.5 __index__() method, basically. � __index__)�start�stop�step�hasattrr: �append�tuple)�slc�retr r r r � decode_sliceX s rC c ' sl � t | �} |D ],� t�� ft�� fdd�td���}|D ]}|| vr,| �|� |V nq td� ��qd S )Nc s � t | � S r )�str)�i��baser r �<lambda>k s z!_unique_symbols.<locals>.<lambda>i� z&exhausted namespace for symbol base %s)�set� itertools�chainr �itertools_imap�range�add� NameError)�used�bases�pool�symr rF r �_unique_symbolsf s �� � ��rT c c s2 � |r|| d @ }| |�V ||N }|sdS dS )z6Call the given function given each nonzero bit from n.r Nr )�fnr3 �br r r �map_bitsv s � �rW c � � fdd�}t |� �S )z'A signature-matching decorator factory.c s� t �| �st �| �std��t�| �}t|d �|dd� | jf }t|dd�\}}t ||d�}|� t |dd �� | j|d < d | }t ||� || i| j�}t | d | �j|_| |_t|| �S ) Nznot a decoratable functionr r � �targetrU )rZ rU F��grouped�namezDdef %(name)s(%(args)s): return %(target)s(%(fn)s, %(apply_kw)s) �im_func)�inspect� isfunction�ismethod� Exceptionr �inspect_getfullargspecr@ r+ rT �dictr �format_argspec_plus�_exec_code_in_env�getattr� __defaults__� __wrapped__r )rU �spec�names� targ_name�fn_name�metadata�code� decorated�rZ r r �decorate� s$ ��� zdecorator.<locals>.decorater )rZ rr r rq r � decorator s rs c C s t | |� || S r )�exec)ro �envrm r r r rf � s rf c C s� t | t�r| j}| }d| j|f }n| }}d| }|�d�d }t�|�}|d d= t|dd�}||d< d | }|td �} t || � | | } |j | _ d |� dd �d | _ tj s^t|d �rd||j_ | S ||_ | S )z�Produce a wrapping function for the given cls or classmethod. Rationale here is so that the __init__ method of the class can serve as documentation for the function. z�Construct a new :class:`.%s` object. This constructor is mirrored as a public API function; see :func:`~%s` for a full usage and argument description.zJThis function is mirrored; see :func:`~%s` for a description of arguments.�.���r Fr[ r] z5def %(name)s(%(args)s): return cls(%(apply_kw)s) )r8 �symbol� sqlalchemyr �__func__)� isinstance�typer r+ �splitr rc re rx rt r. �rsplitr, �py2kr> rz ) rZ �locationrU � callable_�doc� location_namerj rn ro ru rp r r r �public_factory� s> ���� �� �r� c @ �. e Zd Zd dd�Zdd� Zdd� Zdd � ZdS ) � PluginLoaderNc C s || _ i | _|| _d S r )�group�impls�auto_fn)r r� r� r r r r � s zPluginLoader.__init__c C s | j �� d S r )r� �clearr r r r r� � r zPluginLoader.clearc C s� || j v r | j | � S | jr | �|�}|r || j |< |� S zdd l}W n ty, Y nw |�| j|�D ] }|j| j |< |�� S t�d| j|f ��)Nr zCan't load plugin: %s:%s) r� r� � pkg_resources� ImportError�iter_entry_pointsr� �loadr �NoSuchModuleError)r r] �loaderr� �implr r r r� � s$ � �zPluginLoader.loadc s � �fdd�}|| j |< d S )Nc s6 t �� �} � �d�dd � D ]}t| |�} qt| ��S )Nrv r )r �import_r} rg )�mod�token�� modulepath�objnamer r r� � s z#PluginLoader.register.<locals>.load)r� )r r] r� r� r� r r� r �register� s zPluginLoader.registerr )r+ r, r- r r� r� r� r r r r r� � s r� c C sh zt j}W n ty t�| �}|d t|d �f Y S w | j}|j}t|j d |� �t|j |@ �fS )Nr r ) r_ �CO_VARKEYWORDS�AttributeErrorr rc �bool�__code__� co_argcount�list� co_varnames�co_flags)rU �co_varkeywordsrj �co�nargsr r r �_inspect_func_args� s � �r� c C s� |du }|r t � }| j�dd�}|o t|tj�o t|jtj�}|r2t|�\}}|� |� |s2|s2dS |r6|rE| j D ] }t ||�du rD nq9|� 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 Fr ) rI �__dict__�getr{ �types� FunctionTyper� �CodeTyper� r � __bases__�get_cls_kwargs�discard)r8 �_set�toplevel�ctr�has_initrk �has_kw�cr r r r� s* � � � r� 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 rc ��funcr r r �get_func_kwargs< s r� Fc C s0 t �| �r td| ��t �| �r4|r/|r/t�| �}t�|jdd� |j|j |j |j |j |j �S t�| �S t �| �rb|r\|s@| jr\t�| j�}t�|jdd� |j|j |j |j |j |j �S t�| j�S t �| �rot| j|dd�S t| d�rzt�| j�S t| d�r�t �| j�r�t| j|d�S td | ��td | ��) 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)�no_self�_is_initrz �__call__)r� zCan't inspect callable: %s)r_ � isbuiltin� TypeErrorr` r rc � FullArgSpec�args�varargs�varkw�defaults� kwonlyargs�kwonlydefaults� annotationsra �__self__rz �isclass�get_callable_argspecr r> r� )rU r� r� rj r r r r� G sN � � � r� Tc C s0 t �| �r t �| �}n| }t j|� }|d r |d d }n |d r(d|d }nd}t �|d |d |d d|d �}d}|d rI|t|d �7 }|d rU|t|d �7 }|d |d }|rh|d| d� }nd}t j||d |d |d d � d �} |r�t|||| d �S t|dd � ||dd � | dd � d �S )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. Example:: >>> format_argspec_plus(lambda self, a, b, c=3, **d: 123) {'args': '(self, a, b, c=3, **d)', 'self_arg': 'self', 'apply_kw': '(self, a, b, c=c, **d)', 'apply_pos': '(self, a, b, c, **d)'} r r z%s[0]Nr � rY r c S s d| S )N�=r )r r r r rH � s z%format_argspec_plus.<locals>.<lambda>)� formatvalue)r� �self_arg� apply_pos�apply_kwrw )r �callablerc �inspect_formatargspec�lenrd ) rU r\ rj r� r� r� � num_defaults� name_args�defaulted_valsr� r r r re } sR ��� �re c C sV | t ju r |r dp d}nzt| |d�W S ty" |r dp d}Y nw 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)r r[ z(self, *args, **kwargs)zself, *args, **kwargs)r� r� r� r� )�objectr re r� rd )�methodr\ r� r r r �format_argspec_init� s ���r� c C sJ zt �| �W S ty$ | tju rdgdddf Y S dgdddf Y S w )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) r Nr� �kwargs)r rc r� r� r )r� r r r �getargspec_init� s �r� c C s t | tj�r | js | jS | S )zSAdjust the incoming callable such that a 'self' argument is not required. )r{ r� � MethodTyper� rz )� func_or_clsr r r �unbound_method_to_callable� s r� r c s( |du r�g}nt �|�}t� � g }t �� }d}t|�D ]k\}}zt�|j�} W n ty1 Y q w | j r:t | j �p;d} |dkr_| j rF| j }| rT|� | j d| � � n |� | j dd� � n|�� fdd�| j d| � D �� | r�|�dd� t| j | d� | j �D �� q g } | � �fdd�|D �� |dur�t�|�r�| � d d� t�|�D �� |�� D ]+\} } | |v r�q�zt�| � �}|� ur�|| kr�| �d | |f � W q� ty� Y q�w |�r |D ]'\} } zt�| � �}|� ur�|| kr�| �d | |f � W q� t�y Y q�w 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 r r �r2 �arg)�missingr r � <listcomp>% � z generic_repr.<locals>.<listcomp>c S s g | ]\}}||f�qS r r )r2 r� �defaultr r r r� * s ��c 3 s � | ] }t t� |d ��V qd S r )�reprrg r� ��objr r r4 3 s � z generic_repr.<locals>.<genexpr>c S s g | ]}t |��qS r �r� )r2 �valr r r r� 6 r� z%s=%rz%s(%s)�, )r �to_listr� � OrderedDict� enumerater rc r r� r� r� r� �extendr� r �zipr> rg �itemsr? rb � __class__r+ r5 )r� � additional_kw� to_inspect� omit_kwarg�pos_args�kw_args�vargsrE �insprj � default_len�outputr� �defvalr� r )r� r� r � generic_repr st � ����� � � ��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. )rZ r] r� � __weakref__c C s | j | j| jd�S )N�rZ r] r� r� r r r r � __getstate__V s �z$portable_instancemethod.__getstate__c C s& |d | _ |d | _|�dd�| _d S )NrZ r] r� r )rZ r] r� r� )r �stater r r � __setstate__] s z$portable_instancemethod.__setstate__r c C s |j | _|j| _|| _d S r )r� rZ r+ r] r� )r �methr� r r r r b s z portable_instancemethod.__init__c O s$ |� | j� t| j| j�|i |��S r )r r� rg rZ r] )r r� �kwr r r r� g s z portable_instancemethod.__call__N�r ) r+ r, r- r. r/ r� r� r r� r r r r r� N s r� c s t jr t| tj�r t� S | h� t| j�}|r||�� }t jr/t|tj�r$q� fdd�|jD �}n � fdd�|jD �}|D ] }|� |� � � |� q;t j rW|j dksUt |d�sVqn |j dksat |d�sbq� fdd�|�� D �D ] }|� |� � � |� qm|st� �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. Old-style classes are discarded and hierarchies rooted on them will not be descended. c 3 s( � | ]}|� vrt |tj�s|V qd S r )r{ r� � ClassType�r2 �_��hierr r r4 � s � ��z"class_hierarchy.<locals>.<genexpr>c 3 s � | ] }|� vr|V qd S r r r r r r r4 � � � �builtins�__subclasses__� __builtin__c s g | ]}|� vr|�qS r r r r r r r� � s z#class_hierarchy.<locals>.<listcomp>)r r r{ r� r r� �__mro__�popr� r? rN r r, r> r )r8 �processr� rQ rV �sr r r �class_hierarchyl s< � � � � r c c sB � t | �}|D ]}| jD ]}||jv r ||j| fV nq qdS )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)�dirr r� )r8 �keys�keyr� r r r �iterate_attributes� s � ���r � self.proxyc s$ |r|}n�du r d�� �fdd�t |�D �}|D ]v}zt||�}t|d�s(W qt|d|�}W n ty8 Y qw zt�|�} t�| d �} t�| d dd� �} W n ty_ d } d } Y nw d t� } |durm||ipni } t� | | � z|j | | _ W n ty� Y nw t � || | � qdS ) z9Automates delegation of __specials__ for a proxying type.N)r/ �__del__�__getattribute__� __metaclass__r� r� c s6 g | ]}|� d �r|�d �rt� |�s|�vr|�qS )�__)� startswith�endswithr> �r2 r ��into_cls�skipr r 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) r rg r> r� r rc r� r� �locals�exec_rh �setattr)r �from_clsr �onlyr] � from_instance�dundersr� rU rj �fn_args�d_args�pyru r r r � monkeypatch_proxied_specials� sJ � � ��� ��r( c C s t | d| �t |d|�u S )z;Return True if the two methods are the same implementation.rz )rg )�meth1�meth2r r r �methods_equivalent� s �r+ c C sj |s|st d��t|t�rt| |�r| S t|p dd� t|�D ��}tt| ��}tj}t|t�r2|}n |s;t� }tj}nt|�}||�|�|�rI| S t| t �sc|tju rUdpVd}t d| |d� |�f ��G dd � d t �}|rsd |j |_ t� } t | �D ](\} } | |vr�t d | ��t�| �s�t d | | f ��t|| t| �� | �| � qz|| |�r�|S t d d� || � ��)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 )r )r r r r r 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)r+ r, r- r. r r r r �AnonymousInterface4 s r, � Anonymousz %r: unknown in this interfacez%r=%r is not callablez,dictionary does not contain required keys %s)r� r{ r| rI r �operator�ge�gt� intersectionrd r5 r� r+ �dictlike_iteritemsr r� r � staticmethodrN ) r� r8 �methods�required� interface� implemented�complies� qualifierr, �foundr� r� r r r � as_interface� sP ! �� ��r; c @ s6 e Zd ZdZd dd�Zdd� Zdd� Zed d � �ZdS ) �memoized_propertyz2A read-only @property that is only evaluated once.Nc C s || _ |p|j| _|j| _d S r )�fgetr. r+ )r r= r� r r r r O s zmemoized_property.__init__c C s& |d u r| S | � |� |j| j< }|S r )r= r� r+ )r r� r8 �resultr r r �__get__T s zmemoized_property.__get__c C s t �|| j� d S r )r< �resetr+ )r r� r r r �_resetZ s zmemoized_property._resetc C s |j �|d � d S r )r� r )r8 r� r] r r r r@ ] s zmemoized_property.resetr ) r+ r, r- r. r r? rA � classmethodr@ r r r r r< L s r< c rX )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 sB �| g|�R i |��� � fdd�}�j |_ �j|_|| j�j < � S )Nc � � S r r ��ar� �r> r r �memon � z6memoized_instancemethod.<locals>.oneshot.<locals>.memo)r+ r. r� )r r� r� rG �rU rF r �oneshotk s z(memoized_instancemethod.<locals>.oneshotr )rU rJ r rI r �memoized_instancemethodb s rK c @ s2 e Zd ZdZd dd�Zdd� Zdd� Zd d � Zd S ) �!group_expirable_memoized_propertyz?A family of @memoized_properties that can be expired in tandem.r c C s g | _ |r | j �|� d S d S r )� attributesr� )r rM r r r r | s �z*group_expirable_memoized_property.__init__c C s" |j }| jD ]}|�|d� qdS )z.Expire all memoized properties for *instance*.N)r� rM r )r �instance�stash� attributer r r �expire_instance� s �z1group_expirable_memoized_property.expire_instancec C � | j �|j� t|�S r )rM r? r+ r< �r rU r r r r� � � z*group_expirable_memoized_property.__call__c C rR r )rM r? r+ rK rS r r r r� � rT z(group_expirable_memoized_property.methodNr )r+ r, r- r. r rQ r� r� r r r r rL y s rL c @ s$ e Zd ZdZdZdd� Zdd� ZdS )� 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__. r c C s t |��r )r� )r r r r r �_fallback_getattr� � z MemoizedSlots._fallback_getattrc s� �� d�r t���t�d� �r t�d� �� }t��|� |S t�d� �r<t�d� �� � ��fdd�}� j|_|S ����S )N� _memoizedz_memoized_attr_%sz_memoized_method_%sc s: �| i |��� � fdd�}�j |_ �j|_t��|� � S )Nc rC r r rD rF r r rG � rH z8MemoizedSlots.__getattr__.<locals>.oneshot.<locals>.memo)r+ r. r )r� r� rG �rU r r rF r rJ � s z*MemoizedSlots.__getattr__.<locals>.oneshot)r r� r> rg r r. rV )r r r$ rJ r rY r � __getattr__� s zMemoizedSlots.__getattr__N)r+ r, r- r. r/ rV rZ r r r r rU � s rU c s � �fdd�}|S )Nc sn �� d�}t�d�|dd� �t� t� |d g�}t||d �}t|| j| � � r5t |d�r5|j � | j� | S )Nrv r rw �__all__) r} r r� r5 �globalsr rg r r+ r> r[ r? )r� �tokensr� �� add_to_all� modulenamer r rr � s �z dependency_for.<locals>.decorater )r` r_ rr r r^ r �dependency_for� s ra c @ sF e Zd ZdZdd� Zdd� Zedd� �Ze� Z i Z G dd � d e �Z d S ) � dependenciesa� Apply imported dependencies as arguments to a function. E.g.:: @util.dependencies( "sqlalchemy.sql.widget", "sqlalchemy.engine.default" ); def some_func(self, widget, default, arg1, arg2, **kw): # ... Rationale is so that the impact of a dependency cycle can be associated directly with the few functions that cause the cycle, and not pollute the module-level namespace. c G sD g | _ |D ]}|�d�}| j �t�d�|dd� �|d �� qd S )Nrv r rw )� import_depsr} r? rb � _importlaterr5 )r �deps�depr] r r r r � s ��zdependencies.__init__c C s� | j }t�|�}t|d �}|d dv }tt|��D ]}d| |d ||r'dnd < qt|dd�}|D ] }||r:dnd= q3||d d d �< t|dd�} d| d |d d � } t| t� �} t |d |�j | _ t | |�S ) Nr )r r8 zimport_deps[%r]r Fr[ z!lambda %(args)s: fn(%(apply_kw)s)r� r� )r� r� r^ ) rc r rc r� rM r� re �evalr rg rh r ) r rU rc rj � spec_zero�hasselfrE � inner_spec�impname� outer_specro rp r r r r� � s$ � zdependencies.__call__c C s( t tj�D ] }|j�|�r|�� qd S r )r� rb � _unresolved� _full_pathr �_resolve)r8 �pathr r r r � resolve_all� s ��zdependencies.resolve_allc @ sN e Zd Ze� Zi Zdd� Zdd� Zedd� �Z e dd� �Z d d � Z d d � Z d S )zdependencies._importlaterc C s8 |d | }|t jv rt j| S t�| � t j|< }|S �Nrv )rb �_by_keyr� �__new__)r8 rp �addtlr �impr r r rt s z!dependencies._importlater.__new__c C s || _ || _tj�| � d S r )�_il_path� _il_addtlrb rm rN )r rp ru r r r r s z"dependencies._importlater.__init__c C s | j d | j S rr )rw rx r r r r rn s z$dependencies._importlater._full_pathc C s, | t jv rtd| j| jf ��t| j| j�S )Nz<importlater.resolve_all() hasn't been called (this is %s %s))rb rm r� rw rx rg �_initial_importr r r r �module s ��z dependencies._importlater.modulec C s, t j�| � t�| jt� t� | jg�| _ d S r ) rb rm r� r r� rw r\ r rx ry r r r r ro & s �z"dependencies._importlater._resolvec C sV |dkr t d| j ��zt| j|�}W n ty# td| j|f ��w || j|< |S )Nrz zCould not resolve module %sz Module %s has no attribute '%s')r� rn rg rz r� r� )r r �attrr r r rZ , s � �� z%dependencies._importlater.__getattr__N)r+ r, r- rI rm rs rt r �propertyrn r< rz ro rZ r r r r rd s rd N) r+ r, r- r. r r� rB rq rI rm rs r� rd r r r r rb � s rb c C sD t | tj�r | �� �� } | dv rdS | dv rdS td| ��t| �S )N)�true�yes�on�y�t�1T)�false�no�offr3 �f�0Fz String is not true/false: %r)r{ r � string_types�stripr1 � ValueErrorr� r� r r r �asbool< s r� c s � fdd�}|S )zqReturn a callable that will evaluate a string as boolean, or one of a set of "alternate" string values. c s | � v r| S t | �S r )r� r� ��textr r � bool_or_valueN s z"bool_or_str.<locals>.bool_or_valuer )r� r� r r� r � bool_or_strH s r� c C s | du r| S t | �S )zCoerce to integer.N)�int)r$ r r r �asintW s r� c C sx |du r| }|| v r6t |t�rt | | |�s:| | dur8|tu r,|r,t| | �||< dS || | �||< dS dS dS 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)r{ r| r� r� )r� r r# � flexi_bool�destr r r �coerce_kw_type_ s � � ��r� c s4 t |�}|�� fdd�|�|�D �� ||i |��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 v r|� j | fV qd S r )r� )r2 �kr� r r r4 { s � �z#constructor_copy.<locals>.<genexpr>)r� r � difference)r� r8 r� r� rk r r� r �constructor_copys s �r� c s& t j�� �t�d�� � �fdd�} | S )z%Return a threadsafe counter function.r c s& �� � z t� �W ��� S ��� w r )�acquire�next�releaser ��counter�lockr r �_next� s zcounter.<locals>._next)r � threading�LockrJ �count)r� r r� r r� � s r� c C s� t | d�r| jdurt| jt�rtS | jS t| t�r tp t}|| t�r%tS || t�r,tS || t�r3tS t | d�r:tS t | d�rAtS t | d�rHtS |S )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? rN rI )r> r� � issubclassrI r{ r| r� rd )�specimenr� �isar r r �duck_type_collection� s( � r� c C sX t | |�r| S t |t�r t�d|d�dd� |D ��t| �f ��t�d||t| �f ��)Nz8Argument '%s' is expected to be one of type %s, got '%s'z or c s s � | ]}d | V qdS )z'%s'Nr )r2 rE r r r r4 � s � z"assert_arg_type.<locals>.<genexpr>z6Argument '%s' is expected to be of type '%s', got '%s')r{ r@ r � ArgumentErrorr5 r| )r� �argtyper] r r r �assert_arg_type� s �� ��r� c s� t jrt� d�rt� �� �S nt� d�r� �� S t� d�r#t� �� �S t� dt� dd����du r7td� ��t� d�rF� �fdd �}|� S t� d �rXt�fd d �� � � D ��S td� ��) z?Return a (key, value) iterator for almost any dict-like object.r� � iteritems� __getitem__r� Nz Object '%r' is not dict-like�iterkeysc 3 s" � � � � D ] } | �| �fV qd S r )r� )r ��dictlike�getterr r �iterator� s � �z$dictlike_iteritems.<locals>.iteratorr c 3 s � | ] }|� |�fV qd S r r )r2 r )r� r r r4 � r z%dictlike_iteritems.<locals>.<genexpr>) r r r> r� r� r� �iterrg r� r )r� r� r r� r r2 � s" � r2 c �( e Zd ZdZ� fdd�Zdd� 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. c s* t t| �j|g|�R i |�� |j| _d S r )�superr� r r. )r r= r� r� �r� r r r � s zclassproperty.__init__c C s | � |�S r )r= )�descr r8 r r r r? � r zclassproperty.__get__)r+ r, r- r. r r? � __classcell__r r r� r r� � s r� c @ s e Zd Zdd� Zdd� ZdS )�hybridpropertyc C r r r� �r r� r r r r � r zhybridproperty.__init__c C s* |d u r| � |�}| j j|_|S | � |�S r )r� r. )r rN �owner�clsvalr r r r? � s zhybridproperty.__get__N)r+ r, r- r r? r r r r r� � s r� c @ s e Zd ZdZdd� Zdd� ZdS )� hybridmethodz/Decorate a function as cls- or instance- level.c C r r r� r� r r r r r zhybridmethod.__init__c C s& |d u r | j �||j�S | j �||�S r )r� r? r� )r rN r� r r r r? s zhybridmethod.__get__N)r+ r, r- r. r r? r r r r r� s r� c @ r� ) �_symbolNc C s@ t |tj�sJ �|du rt|�}t�t|�}||_|r ||_|S )z Construct a new named symbol.N) r{ r r� �hashr� rt r� r] r. )r r] r� � canonical�vr r r rt s z_symbol.__new__c C s t | jdt| �ffS )Nr )rx r] r� r r r r � __reduce__ s z_symbol.__reduce__c C s t | �S r r� r r r r �__str__ rW z_symbol.__str__c C s d| j S )Nz symbol(%r))r] r r r r �__repr__ r z_symbol.__repr__�NN)r+ r, r- rt r� r� r� r r r r r� s r� rx c @ s8 e Zd ZdZi Zej�� Zddd�Z e d dd��Z dS ) rx a� 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. The optional ``doc`` argument assigns to ``__doc__``. This is strictly so that Sphinx autoattr picks up the docstring we want (it doesn't appear to pick up the in-module docstring if the datamember is in a different module - autoattribute also blows up completely). If Sphinx fixes/improves this then we would no longer need ``doc`` here. Nc C sR | j �� z | j�|�}|d u rt|||� | j|< }|W tj �� S tj �� w r )�_lockr� �symbolsr� r� rx r� )r8 r] r� r� rS r r r rt ? s zsymbol.__new__Fc C sf |� � D ] \}}||u r| S |r||jkr| S ||v r#| S q|du r*dS t�d||f ��)a� Given a user parameter, parse the parameter into a chosen symbol. The user argument can be a string name that matches the name of a symbol, or the symbol object itself, or any number of alternate choices such as True/False/ None etc. :param arg: the user argument. :param choices: dictionary of symbol object to list of possible entries. :param name: name of the argument. Used in an :class:`.ArgumentError` that is raised if the parameter doesn't match any available argument. :param resolve_symbol_names: include the name of each symbol as a valid entry. NzInvalid value for '%s': %r)r� r] r r� )r8 r� �choicesr] �resolve_symbol_namesrS �choicer r r �parse_user_argumentI s �zsymbol.parse_user_argumentr� r* ) r+ r, r- r. r� r r� r� r� rt rB r� r r r r rx & s �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)rN r r r �set_creation_orderp s r� c O s> z| |i |��W S t y tdt�� dd� � Y dS w )zXexecutes the given function, catches all exceptions and converts to a warning. z%s('%s') ignoredr r N)rb r" r r )r� r� r� r r r �warn_exception} s �r� � c C s< zt | �|krd| d|� W S | W S ty | Y S w )Nz%s...r )r� r� )r$ �len_r r r �ellipses_string� s �r� c s0 e Zd ZdZ� fdd�Zdd� Zdd� 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, c s@ || d| }t t| ��| |�}td|t|�| f �|_|S )Nz6 (this warning may be suppressed after %d occurrences)z%s_%d)r� r� rt r� �_hash)r8 r$ �numr� � interpolatedr r� r r rt � s �z_hash_limit_string.__new__c C s | j S r )r� r r r r �__hash__� s z_hash_limit_string.__hash__c C s t | �t |�kS r )r� )r �otherr r r �__eq__� s z_hash_limit_string.__eq__)r+ r, r- r. rt r� r� r� r r r� r r� � s r� c C s t j| tjdd� dS )zdIssue a warning. If msg is a string, :class:`.exc.SAWarning` is used as the category. r �� stacklevelN)�warningsr" r � SAWarning)�msgr r r r" � s r" c C s& |rt | d|�} tj| tjdd� dS )z\Issue a warning with a parameterized string, limiting the number of registrations. � r r� N)r� r� r" r r� )r� r� r r r � warn_limited� s r� c s � g�� ��fdd�}|S )zNDecorate the given function to be a no-op after it is called exactly once.c s> � }�r �� � }z|| i |��W S �r ��d|� � d S )Nr )r �insert)r� r� � strong_fn�once_fn�rU �once�retry_on_exceptionr r �go� s �zonly_once.<locals>.gor )rU r� r� r r� r � only_once� s r� z%sqlalchemy/([a-z_]+/){0,2}[a-z_]+\.pyzunit(?:2|test2?/)c C s� d}t | �d }||kr"|�| | �r"|d7 }||kr"|�| | �s||kr<|�| | �r<|d8 }||kr<|�| | �s-| ||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)�tb�exclude_prefix�exclude_suffixr; �endr r r �chop_traceback� s ��r� c C s$ d| }t � �� }t||� |d S )Nz&def set(obj, value): obj.%s = valuerI )r �copyrt )�attrnamero ru r r r � attrsetter� s r� c r� )�EnsureKWArgTypezYApply translation of functions to accept \**kw arguments if they don't already. c sr | j }|r-|D ]%}t�||�}|r,|| }t�|�}|js,| �|� ||< } t| || � qtt | �� |||� d S r ) � ensure_kwargr6 �matchr rc r� � _wrap_w_kwr r� r� r ) r8 �clsnamerQ �clsdict�fn_regr r rU rj �wrappedr� r r r s �zEnsureKWArgType.__init__c s � fdd�}t |� �S )Nc s � | � S r r )r� r� rI r r �wrap rW z(EnsureKWArgType._wrap_w_kw.<locals>.wrapr )r rU r� r rI r r� s zEnsureKWArgType._wrap_w_kw)r+ r, r- r. r r� r� r r r� r r� � s r� c C sh t |d�r t| |�S | }|jj|_t |d�r|j|_t |jd�r+|jjr+|jj|_|S |jr2|j|_|S )z�Augment functools.update_wrapper() to work with objects with a ``__call__()`` method. :param fn: object with __call__ method r+ r, r. )r> r r� r+ r, r� r. )�wrapperrU �_fr r r � wrap_callable s �r� c C s� d| vr | � d�S d}g g}d}t| �}||k r`| | }|dkrC|dkr>||d k r>| |d dkr>|d �d� |d7 }n|dN }n|dkrQ|dkrQ|�g � n|d �|� |d7 }||k sdd� |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'] �"rv r r rw c S s g | ]}d � |��qS )� )r5 )r2 r� r r r r� U s z'quoted_token_parser.<locals>.<listcomp>)r} r� r? )r$ r� r> �idx�lv�charr r r �quoted_token_parser, s& $ �r c s t �� �� � �fdd�}|S )Nc s: | j d ur| j p d}|rt|�fdd�� D ��}|| _ | S )Nr� c s i | ]}|� �qS r r )r2 �paramr� r r � <dictcomp>^ s z8add_parameter_text.<locals>.decorate.<locals>.<dictcomp>)r. �inject_param_text)rU r� ��paramsr� r r rr [ s z$add_parameter_text.<locals>.decorate)r r� )r r� rr r r r �add_parameter_textX s r c C sJ | � dd�}t|�dkr| S |\}}|�d�s |d t�|� S t�| �S )N� r r0 )r} r� r �textwrap�dedent)r� � split_text� firstline� remainingr r r �_dedent_docstringe s r c C s� t | pd�} | �d�}t�|��d�}|d r |�dd� dd� t|�D �}|�dd� |t|t|�d � }|d|� | ||d � }d�|�S )Nr� r r c S s g | ] \}}|� � s|�qS r )r� )r2 r� �liner r r r� x s z)inject_docstring_text.<locals>.<listcomp>r ) r r} r r r� r� �minr� r5 )�doctext� injecttext�pos�lines� injectlines�blanks� inject_posr r r �inject_docstring_textq s r c C s2 | � � }g }d }|r�|�d�}|d u rKt�d|�}|rJ|�d�}||v rJdt|�d�� d }|rDt�d|d �} | rDdt| �d�� }||| }nB|�� �d�rd|�d� |�|� |�d� d }n)|� � sz|�|� |�|� |�d� d }n|� d �r�|�|� |�|�d�� q|�|� |s d� |�S ) Nr z (\s+):param (?:\\\*\*?)?(.+?):r r0 r z(\s+)\Sz:param r z::) � splitlinesr r6 r� r� r� �lstripr r? �rstripr r5 ) r � inject_params�doclinesr � to_injectr r r �indent�m2r r r r � sH � � � &r r )FF)T)r Nr )NNr N)NNNr* )TN)r� )Xr. � functoolsr r r_ rJ r. r6 r r r� r� r� r r r r r� r r9 rC rT rW rs rf r� r� r� r� r� r� re r� r� r� r� r� r r r( r+ r; r< rK rL rU ra rb r� r� r� r� r� r� r� r� r2 r| r� r� r� r� r� r+ rx r� r� r� r� � text_typer� r" r� r� �compile�_SQLA_RE� _UNITTEST_REr� r| �NoneTyper� r� r� r r r r r r r r r �<module> s� . 0* + 6 S H 3 �? V (u ! G ,
Save
Cancel