Edit File: langhelpers.cpython-37.pyc
B ��4]� � @ 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&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 �N/opt/alt/python37/lib64/python3.7/site-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 s || _ d S )N)r )�selfr r r r �__init__8 s zsafe_reraise.__init__c C s t �� | _d S )N)�sys�exc_infor )r r r r � __enter__; s zsafe_reraise.__enter__c C sz |d kr0| j \}}}d | _ | jsvt�|||� nFtjsb| j rb| j d rbtd| 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 Zreraiser �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 )N)�lower)�.0�nr r r � <genexpr>T s z(clsname_as_plain_name.<locals>.<genexpr>z ([A-Z][a-z]+))�join�re�findallr# )�clsr r r �clsname_as_plain_nameR s r1 c C sB g }x4| j | j| jfD ] }t|d�r,|�� }|�|� qW t|�S )zrdecode a slice object as sent to __getitem__. takes into account the 2.5 __index__() method, basically. � __index__)�start�stop�step�hasattrr2 �append�tuple)Zslc�retr r r r � decode_sliceX s r: c ' sp t | �} xb|D ]Z� t�� ft�� fdd�td���}x2|D ] }|| kr:| �|� |V P q:W td� ��qW d S )Nc s � t | � S )N)�str)�i)�baser r �<lambda>k � z!_unique_symbols.<locals>.<lambda>i� z&exhausted namespace for symbol base %s)�set� itertools�chainr Zitertools_imap�range�add� NameError)�used�bases�pool�symr )r= r �_unique_symbolsf s rJ c c s. x(|r(|| d @ }| |�V ||N }qW dS )z6Call the given function given each nonzero bit from n.r Nr )�fnr+ �br r r �map_bitsv s rM c s � fdd�}t |� �S )z'A signature-matching decorator factory.c s� t �| �s t �| �s td��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 � �targetrK )rO rK F)�grouped�namezDdef %(name)s(%(args)s): return %(target)s(%(fn)s, %(apply_kw)s) �im_func)�inspect� isfunction�ismethod� Exceptionr �inspect_getfullargspecr8 r# rJ �dictr �format_argspec_plus�_exec_code_in_env�getattr� __defaults__� __wrapped__r )rK �spec�namesZ targ_name�fn_name�metadata�code� decorated)rO r r �decorate� s zdecorator.<locals>.decorate)r )rO rd r )rO r � decorator s re c C s t | |� || S )N)�exec)rb �envr` r r r rZ � s rZ 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 �r�||j_ n||_ | 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 F)rP rQ z5def %(name)s(%(args)s): return cls(%(apply_kw)s) )r0 �symbol� sqlalchemyr �__func__)� isinstance�typer r# �splitr rW rY rj rf r& �rsplitr$ �py2kr6 rl ) rO �locationrK Z callable_�docZ location_namer^ ra rb rg rc r r r �public_factory� s0 rt c @ s. e Zd Zd dd�Zdd� Zdd� Zdd � ZdS ) � PluginLoaderNc C s || _ i | _|| _d S )N)�group�impls�auto_fn)r rv rx r r r r � s zPluginLoader.__init__c C s | j �� d S )N)rw �clear)r r r r ry � s zPluginLoader.clearc C s� || j kr| j | � S | jr:| �|�}|r:|| j |< |� S y dd l}W n tk rZ Y n,X x(|�| j|�D ]}|j| j |< |�� S W t�d| j|f ��d S )Nr zCan't load plugin: %s:%s) rw rx � pkg_resources� ImportError�iter_entry_pointsrv �loadr ZNoSuchModuleError)r rQ �loaderrz �implr r r r} � s zPluginLoader.loadc s � �fdd�}|| j |< d S )Nc s: t �� �} x$� �d�dd � D ]}t| |�} q W t| ��S )Nrh r )r �import_ro r[ )�mod�token)� modulepath�objnamer r r} � s z#PluginLoader.register.<locals>.load)rw )r rQ r� r� r} r )r� r� r �register� s zPluginLoader.register)N)r# r$ r% r ry r} r� r r r r ru � s ru c C sj y t j}W n. tk r8 t�| �}|d t|d �fS X | j}|j}t|j d |� �t|j |@ �fS d S )Nr r ) rS �CO_VARKEYWORDS�AttributeErrorr rW �bool�__code__� co_argcount�list� co_varnames�co_flags)rK Zco_varkeywordsr^ �co�nargsr r r �_inspect_func_args� s r� c C s� |dk}|rt � }| j�dd�}|o<t|tj�o<t|jtj�}|rdt|�\}}|� |� |sd|sddS |rl|r�x | j D ]}t ||�dkrtP qtW |� 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 ) r@ �__dict__�getrm �types� FunctionTyper� �CodeTyper� r � __bases__�get_cls_kwargs�discard)r0 Z_setZtoplevelZctrZhas_initr_ Zhas_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 rW )�funcr r r �get_func_kwargs< s r� Fc 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)�no_self�_is_initrl �__call__)r� zCan't inspect callable: %s)rS � isbuiltin� TypeErrorrT r rW � FullArgSpec�args�varargs�varkw�defaults� kwonlyargs�kwonlydefaults� annotationsrU �__self__rl �isclass�get_callable_argspecr r6 r� )rK r� r� r^ r r r r� G sH r� Tc C s6 t �| �rt �| �}n| }t j|� }|d r:|d d }n|d rPd|d }nd}t �|d |d |d d|d �}d}|d r�|t|d �7 }|d r�|t|d �7 }|d |d }|r�|d| d� }nd}t j||d |d |d d � d �} |�r t|||| d �S t|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. 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 � rN r c S s d| S )N�=r )r r r r r> � r? z%format_argspec_plus.<locals>.<lambda>)� formatvalue)r� �self_arg� apply_pos�apply_kwri )r �callablerW �inspect_formatargspec�lenrX ) rK rP r^ r� r� r� � num_defaultsZ name_argsZdefaulted_valsr� r r r rY } sJ rY c C sV | t jkr|rdpd}n.y t| |d�S tk rD |r<dp>d}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)r )rP z(self, *args, **kwargs)zself, *args, **kwargs)r� r� r� r� )�objectr rY r� rX )�methodrP r� r r r �format_argspec_init� s r� c C sJ y t �| �S tk rD | tjkr2dgdddfS dgdddfS 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) r Nr� �kwargs)r rW r� r� r )r� r r r �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)rm r� � MethodTyper� rl )Z func_or_clsr r r �unbound_method_to_callable� s r� r c sV |dkr�g}n t �|�}t� � g }t �� }d}x�t|�D ]�\}}yt�|j�} W n tk rh w:Y q:X | j rzt | j �p|d} |dkr�| j r�| j }| r�|� | j d| � � q�|� | j dd� � n$|�� fdd�| j d| � D �� | r:|�dd� t| j | d� | j �D �� q:W g } | � �fdd�|D �� |dk �rdt�|��rd| � d d� t�|�D �� xr|�� D ]f\} } | |k�r��qny6t�| � �}|� k �r�|| k�r�| �d | |f � W n tk �r� Y nX �qnW |�r@x`|D ]X\} } y6t�| � �}|� k �r || k�r | �d | |f � W n tk �r8 Y nX �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 )r* �arg)�missingr r � <listcomp>% s z generic_repr.<locals>.<listcomp>c S s g | ]\}}||f�qS r r )r* r� �defaultr r r r� + s c 3 s | ]}t t� |d ��V qd S )N)�reprr[ )r* r� )�objr r r, 3 s z generic_repr.<locals>.<genexpr>c S s g | ] }t |��qS r )r� )r* �valr r r r� 6 s z%s=%rz%s(%s)z, )r �to_listr� � OrderedDict� enumerater rW r r� r� r� r� �extendr� r �zipr6 r[ �itemsr7 rV � __class__r# r- )r� Z additional_kwZ to_inspectZ omit_kwargZpos_argsZkw_argsZvargsr< Zinspr^ Z default_len�outputr� Zdefvalr� r )r� r� r � generic_repr s` 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. )rO rQ r� � __weakref__c C s | j | j| jd�S )N)rO rQ r� )rO rQ r� )r r r r � __getstate__V s z$portable_instancemethod.__getstate__c C s& |d | _ |d | _|�dd�| _d S )NrO rQ r� r )rO rQ r� r� )r �stater r r � __setstate__] s z$portable_instancemethod.__setstate__r c C s |j | _|j| _|| _d S )N)r� rO r# rQ r� )r �methr� r r r r b s z portable_instancemethod.__init__c O s |� | j� t| j| j�||�S )N)r r� r[ rO rQ )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 jrt| tj�rt� S | h� t| j�}x�|�r|�� }t jrbt|tj�rLq*� fdd�|jD �}n� fdd�|jD �}x |D ]}|� |� � � |� q|W t j r�|j dks*t |d�s�q*n|j dks*t |d�s�q*x2� fdd�|�� D �D ]}|� |� � � |� q�W q*W t� �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& | ] }|� krt |tj�s|V qd S )N)rm r� � ClassType)r* �_)�hierr r r, � s z"class_hierarchy.<locals>.<genexpr>c 3 s | ]}|� kr|V qd S )Nr )r* r� )r� r r r, � s �builtins�__subclasses__Z __builtin__c s g | ]}|� kr|�qS r r )r* r� )r� r r r� � s z#class_hierarchy.<locals>.<listcomp>)r rq rm r� r� r� �__mro__�popr� r7 rD r r$ r6 r� )r0 �processr� rG rL �sr )r� r �class_hierarchyl s4 r� c c sF t | �}x8|D ]0}x*| jD ] }||jkr||j| fV P qW qW 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)�dirr� r� )r0 �keys�keyr� r r r �iterate_attributes� s r� � self.proxyc s0 |r |}n$�dkrd�� �fdd�t |�D �}x�|D ]�}y&t||�}t|d�sPw4t|d|�}W n tk rt w4Y nX y2t�|�} t�| d �} t�| d dd� �} W n tk r� d } d } Y nX d t� } |dk r�||ip�i } t� | | � y|j | | _ W n tk �r Y nX t � || | � q4W dS ) z9Automates delegation of __specials__ for a proxying type.N)r' �__del__�__getattribute__Z __metaclass__r� r� c s6 g | ].}|� d �r|�d �rt� |�s|�kr|�qS )�__)� startswith�endswithr6 )r* r )�into_cls�skipr r r� � s z0monkeypatch_proxied_specials.<locals>.<listcomp>r� rR 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� r[ r6 r� r rW r� r� �localsZexec_r\ �setattr)r� Zfrom_clsr� �onlyrQ Z from_instanceZdundersr� rK r^ Zfn_argsZd_args�pyrg r )r� r� r � monkeypatch_proxied_specials� s< r� c C s t | d| �t |d|�kS )z;Return True if the two methods are the same implementation.rl )r[ )Zmeth1Zmeth2r r r �methods_equivalent� s r� c C sx |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 t �}|r�d |j |_ t� } x`t | �D ]T\} } | |k�rt d | ��t�| ��s0t d | | f ��t|| t| �� | �| � q�W || |��r^|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 )r� )r� )r* r r r r r� s z as_interface.<locals>.<listcomp>zany ofzall ofz %r does not implement %s: %sz, 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� Z Anonymousz %r: unknown in this interfacez%r=%r is not callablez,dictionary does not contain required keys %sN)r� rm rn r@ r� �operator�ge�gt� intersectionrX r- r� r# �dictlike_iteritemsr r� r� � staticmethodrD ) r� r0 �methods�requiredZ interfaceZ implementedZcompliesZ qualifierr� �foundr� r r r r � as_interface� sH ! 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 )N)�fgetr& r# )r r� rs r r r r O s zmemoized_property.__init__c C s& |d kr | S | � |� |j| j< }|S )N)r� r� r# )r r� r0 �resultr r r �__get__T s zmemoized_property.__get__c C s t �|| j� d S )N)r� �resetr# )r r� r r r �_resetZ s zmemoized_property._resetc C s |j �|d � d S )N)r� r� )r0 r� rQ r r r r� ] s zmemoized_property.reset)N) r# r$ r% r& r r� r � classmethodr� r r r r r� L s 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 )Nr )�ar� )r� r r �memon s z6memoized_instancemethod.<locals>.oneshot.<locals>.memo)r# r& r� )r r� r� r )rK )r� r �oneshotk s z(memoized_instancemethod.<locals>.oneshot)r )rK r r )rK r �memoized_instancemethodb s r 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 )N)� attributesr� )r r r r r r | s z*group_expirable_memoized_property.__init__c C s& |j }x| jD ]}|�|d� qW dS )z.Expire all memoized properties for *instance*.N)r� r r� )r �instanceZstash� attributer r r �expire_instance� s z1group_expirable_memoized_property.expire_instancec C s | j �|j� t|�S )N)r r7 r# r� )r rK r r r r� � s z*group_expirable_memoized_property.__call__c C s | j �|j� t|�S )N)r r7 r# r )r rK r r r r� � s z(group_expirable_memoized_property.methodN)r )r# r$ r% r& r r r� r� r r r r r y s r 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 |��d S )N)r� )r r� r r r �_fallback_getattr� s z MemoizedSlots._fallback_getattrc s� �� d�rt���npt�d� �rBt�d� �� }t��|� |S t�d� �rzt�d� �� � ��fdd�}� j|_|S ����S d S )NZ _memoizedz_memoized_attr_%sz_memoized_method_%sc s6 �| |�� � fdd�}�j |_ �j|_t��|� � S )Nc s � S )Nr )r r� )r� r r r � s z8MemoizedSlots.__getattr__.<locals>.oneshot.<locals>.memo)r# r& r� )r� r� r )rK r� r )r� r r � s z*MemoizedSlots.__getattr__.<locals>.oneshot)r� r� r6 r[ r� r& r )r r� r r r )rK r� r r � __getattr__� s zMemoizedSlots.__getattr__N)r# r$ r% r& r' r r r r r r r � s r c s � �fdd�}|S )Nc sn �� d�}t�d�|dd� �t� t� |d g�}t||d �}t|| j| � � rjt |d�rj|j � | j� | S )Nrh r ri �__all__) ro r r� r- �globalsr� r[ r� r# r6 r r7 )r� �tokensr� )� add_to_all� modulenamer r rd � s $z dependency_for.<locals>.decorater )r r rd r )r r r �dependency_for� s r 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 sH g | _ x<|D ]4}|�d�}| j �t�d�|dd� �|d �� q W d S )Nrh r ri )� import_depsro r7 r � _importlaterr- )r �deps�depr r r r r � s zdependencies.__init__c C s� | j }t�|�}t|d �}|d dk}x0tt|��D ] }d| |d ||rPdnd < q6W t|dd�}x|D ]}||rzdnd= qlW ||d d d �< t|dd�} d| d |d d � } t| t� �} t |d |�j | _ t | |�S ) Nr )r r0 zimport_deps[%r]r F)rP z!lambda %(args)s: fn(%(apply_kw)s)r� r� )r� r� rR ) r r rW r� rC r� rY �evalr� r[ r\ r ) r rK r r^ Z spec_zeroZhasselfr< Z inner_specZimpnameZ outer_specrb rc r r r r� � s" zdependencies.__call__c C s, x&t tj�D ]}|j�|�r |�� q W d S )N)r� r � _unresolved� _full_pathr� �_resolve)r0 �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 s< |d | }|t jkr t j| S t�| � t j|< }|S d S )Nrh )r �_by_keyr� �__new__)r0 r �addtlr� �impr r r r s z!dependencies._importlater.__new__c C s || _ || _tj�| � d S )N)�_il_path� _il_addtlr r rD )r r r! r r r r s z"dependencies._importlater.__init__c C s | j d | j S )Nrh )r# r$ )r r r r r s z$dependencies._importlater._full_pathc C s, | t jkr td| j| jf ��t| j| j�S )Nz<importlater.resolve_all() hasn't been called (this is %s %s))r r r{ r# r$ r[ �_initial_import)r r r r �module s z dependencies._importlater.modulec C s, t j�| � t�| jt� t� | jg�| _ d S )N) r r r� r r� r# r r� r$ r% )r r r r r & s z"dependencies._importlater._resolvec C s\ |dkrt d| j ��yt| j|�}W n& tk rL td| j|f ��Y nX || j|< |S )Nr& zCould not resolve module %sz Module %s has no attribute '%s')r{ r r[ r& r� r� )r r� �attrr r r r , s z%dependencies._importlater.__getattr__N)r# r$ r% r@ r r r r �propertyr r� r& r r r r r r r s r N) r# r$ r% r& r r� r r r@ r r r� r r r r r r � s r c C sD t | tj�r<| �� �� } | dkr$dS | dkr0dS td| ��t| �S )N)�true�yes�on�y�t�1T)�false�no�offr+ �f�0Fz String is not true/false: %r)rm r � string_types�stripr) � ValueErrorr� )r� r r r �asbool< s r7 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 | � kr | S t | �S d S )N)r7 )r� )�textr r � bool_or_valueN s z"bool_or_str.<locals>.bool_or_valuer )r8 r9 r )r8 r � bool_or_strH s r: c C s | dkr | S t | �S )zCoerce to integer.N)�int)r r r r �asintW s r< c C s^ || krZt |t�r t | | |�sZ| | dk rZ|tkrJ|rJt| | �| |< 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)rm rn r� r7 )r� r� r Z flexi_boolr r r �coerce_kw_type_ s 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 )N)r� )r* �k)r� r r r, y s z#constructor_copy.<locals>.<genexpr>)r� r � difference)r� r0 r� r� r_ r )r� r �constructor_copyp s r@ c s& t j�� �t�d�� � �fdd�} | S )z%Return a threadsafe counter function.r c s �� � zt� �S ��� X d S )N)�acquire�next�releaser )�counter�lockr r �_next� s zcounter.<locals>._next)r � threading�LockrA �count)rF r )rD rE r rD ~ s rD c C s� t | d�r*| jdk r$t| jt�r$tS | jS t| t�r8tp:t}|| 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__Nr7 rD r@ )r6 rJ � issubclassr@ rm rn r� rX )Zspecimenr� Zisar r r �duck_type_collection� s& rL 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'Nr )r* r r r r r, � s z"assert_arg_type.<locals>.<genexpr>z6Argument '%s' is expected to be of type '%s', got '%s')rm r8 r � ArgumentErrorr- rn )r� ZargtyperQ r r r �assert_arg_type� s $rN c s� t jr t� d�rFt� �� �S n(t� d�r0� �� S t� d�rFt� �� �S t� dt� dd����dkrntd� ��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� � iteritems� __getitem__r� Nz Object '%r' is not dict-like�iterkeysc 3 s$ x � � � D ]} | �| �fV q W d S )N)rQ )r� )�dictlike�getterr r �iterator� s z$dictlike_iteritems.<locals>.iteratorr� c 3 s | ]}|� |�fV qd S )Nr )r* r� )rS r r r, � s z%dictlike_iteritems.<locals>.<genexpr>) r r r6 r� r� rO �iterr[ r� r� )rR rT r )rR rS r r� � s r� c s( 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|f|�|� |j| _d S )N)�superrV r r& )r r� r� r� )r� r r r � s zclassproperty.__init__c C s | � |�S )N)r� )�descr r0 r r r r� � s zclassproperty.__get__)r# r$ r% r& r r� � __classcell__r r )r� r rV � s rV c @ s e Zd Zdd� Zdd� ZdS )�hybridpropertyc C s || _ d S )N)r� )r r� r r r r � s zhybridproperty.__init__c C s. |d kr | � |�}| j j|_|S | � |�S d S )N)r� r& )r r �ownerZclsvalr r r r� � s zhybridproperty.__get__N)r# r$ r% r r� r r r r rZ � s rZ c @ s e Zd ZdZdd� Zdd� ZdS )� hybridmethodz/Decorate a function as cls- or instance- level.c C s || _ d S )N)r� )r r� r r r r s zhybridmethod.__init__c C s* |d kr| j �||j�S | j �||�S d S )N)r� r� r� )r r r[ r r r r� s zhybridmethod.__get__N)r# r$ r% r& r r� r r r r r\ � s r\ c @ s. e Zd Zd dd�Zdd� Zdd� Zdd � ZdS ) �_symbolNc C s@ t |tj�st�|dkr t|�}t�t|�}||_|r<||_ |S )z Construct a new named symbol.N) rm r r4 �AssertionError�hashr; r r] rQ r& )r rQ rs � canonical�vr r r r s z_symbol.__new__c C s t | jdt| �ffS )Nr )rj rQ r; )r r r r � __reduce__ s z_symbol.__reduce__c C s t | �S )N)r� )r r r r �__str__ s z_symbol.__str__c C s d| j S )Nz symbol(%r))rQ )r r r r �__repr__ s z_symbol.__repr__)NN)r# r$ r% r rb rc rd r r r r r] s r] rj c @ s( e Zd ZdZi Zej�� Zddd�Z dS )rj 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 sJ | j �� z.| j�|�}|d kr6t|||� | j|< }|S tj �� X d S )N)�_lockrA �symbolsr� r] rj rC )r0 rQ rs r` rI r r r r < s zsymbol.__new__)NN) r# r$ r% r& rf r rG rH re r r r r r rj # 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)r r r r �set_creation_orderJ s rh c O s< y | ||�S t k r6 tdt�� dd� � Y nX dS )zXexecutes the given function, catches all exceptions and converts to a warning. z%s('%s') ignoredr r N)rV r r r )r� r� r� r r r �warn_exceptionW s ri � c C s> y$t | �|kr d| d|� S | S W n tk r8 | S X d S )Nz%s...r )r� r� )r Zlen_r r r �ellipses_stringb s rk 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)rW rl r r_ �_hash)r0 r �numr� Z interpolatedr )r� r r r w s z_hash_limit_string.__new__c C s | j S )N)rm )r r r r �__hash__ s z_hash_limit_string.__hash__c C s t | �t |�kS )N)r_ )r �otherr r r �__eq__� s z_hash_limit_string.__eq__)r# r$ r% r& r ro rq rY r r )r� r rl l s rl 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 )rr N)rl rs r r rt )ru r� r r r � warn_limited� s rw c s | g� � fdd�}|S )zNDecorate the given function to be a no-op after it is called exactly once.c s � r� � � }|| |�S d S )N)r� )r� r� Zonce_fn)�oncer r �go� s zonly_once.<locals>.gor )rK ry r )rx r � only_once� s rz z%sqlalchemy/([a-z_]+/){0,2}[a-z_]+\.pyzunit(?:2|test2?/)c C sh d}t | �d }x"||kr2|�| | �r2|d7 }qW x"||krV|�| | �rV|d8 }q6W | ||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)�tbZexclude_prefixZexclude_suffixr3 �endr r r �chop_traceback� s r~ c C s$ d| }t � �� }t||� |d S )Nz&def set(obj, value): obj.%s = valuer@ )r� �copyrf )�attrnamerb rg r r r � attrsetter� s r� c s( e Zd ZdZ� fdd�Zdd� Z� ZS )�EnsureKWArgTypezYApply translation of functions to accept \**kw arguments if they don't already. c sv | j }|r^xR|D ]J}t�||�}|r|| }t�|�}|js| �|� ||< } t| || � qW tt | �� |||� d S )N) Z ensure_kwargr. �matchr rW r� � _wrap_w_kwr� rW r� r ) r0 ZclsnamerG ZclsdictZfn_regr� r rK r^ �wrapped)r� r r r � s zEnsureKWArgType.__init__c s � fdd�}t |� �S )Nc s � | � S )Nr )r� r� )rK r r �wrap� s z(EnsureKWArgType._wrap_w_kw.<locals>.wrap)r )r rK r� r )rK r r� � s zEnsureKWArgType._wrap_w_kw)r# r$ r% r& r r� rY r r )r� r 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 r# r$ r& N)r6 r r� r# r$ r� r& )�wrapperrK Z_fr r r � wrap_callable� s r� c C s� d| kr| � d�S d}g g}d}t| �}x�||k r�| | }|dkr�|dkr~||d k r~| |d dkr~|d �d� |d7 }q�|dN }n*|dkr�|dkr�|�g � n|d �|� |d7 }q*W 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'] �"rh r r ri c S s g | ]}d � |��qS )� )r- )r* r� r r r r� ' s z'quoted_token_parser.<locals>.<listcomp>)ro r� r7 )r r� r� �idx�lv�charr r r �quoted_token_parser� s$ $ r� c s t �� �� � �fdd�}|S )Nc s: | j d k r| j pd}|r0t|�fdd�� D ��}|| _ | S )Nr� c s i | ] }� |�qS r r )r* �param)r8 r r � <dictcomp>0 s z8add_parameter_text.<locals>.decorate.<locals>.<dictcomp>)r& �inject_param_text)rK rs )�paramsr8 r r rd - s z$add_parameter_text.<locals>.decorate)r r� )r� r8 rd r )r� r8 r �add_parameter_text* s r� c C sN | � dd�}t|�dkr | S |\}}|�d�s@|d t�|� S t�| �S d S )N� r r( )ro r� r� �textwrap�dedent)r8 Z split_text� firstline� remainingr r r �_dedent_docstring7 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 )r5 )r* rn �liner r r r� J s z)inject_docstring_text.<locals>.<listcomp>r ) r� ro r� r� �insertr� �minr� r- )�doctextZ injecttext�pos�linesZ injectlinesZblanksZ inject_posr r r �inject_docstring_textC s r� c C s: | � � }g }d }�x |�r.|�d�}|d kr�t�d|�}|r�|�d�}||kr�dt|�d�� d }|r�t�d|d �} | r�dt| �d�� }||| }n�|�� �d�r�|�d� |�|� |�d� d }nT|� � s�|�|� |�|� |�d� d }n(|� d ��r"|�|� |�|�d�� q|�|� qW d� |�S ) Nr z (\s+):param (?:\\\*\*?)?(.+?):r r( r z(\s+)\Sz:param r� z::) � splitlinesr� r. r� rv r� �lstripr� r7 �rstripr� r- ) r� Z inject_paramsZdoclinesr� Z to_injectr� r r� �indent�m2r r r r� S sB r� )N)FF)T)T)r Nr )NNr� N)NNN)F)T)N)rj )Xr& � functoolsr r rS rA r� r. r r� r� rs r� r r r r r� r r1 r: rJ rM re rZ rt ru r� r� r� r� rY r� r� r� r� r� r� r� r� r� r� r� r r r r r r7 r: r< r= r@ rD rL rN r� r( rV rZ r\ r; r] r# rj rg rh ri rk Z text_typerl r rw rz �compileZ_SQLA_REZ _UNITTEST_REr~ rn ZNoneTyper� r� r� r� r� r� r� r� r r r r �<module> s� . 0* + 6 S H 3 9 V( u ! $ ,