
    )f-                       d dl mZ d dlmZ d dlZd dlZd dlZd dlmZ d dlm	Z	 d dlm
Z
 d dlmZ d dlmZ d dlmZ d d	lmZ d d
lmZ d dlmZ d dlmZ d dlmZ d dlmZ d dlmZ d dlmZ d dlmZ d dlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlm Z  ddl!m"Z" ddlm#Z# ddlm$Z$ ddlm%Z% ddlm&Z& dd l'm(Z( ej*                  rdd!lm)Z) dd"lm*Z* dd#lm+Z+ dd$lm,Z, dd%lm-Z- dd&lm.Z. dd'lm/Z/ dd(lm0Z0 dd)lm1Z1 dd*l2m3Z3 dd+l)m4Z4 dd,l)m5Z5 dd-l)m6Z6 dd.l)m7Z7 dd/l)m8Z8 dd0l)m9Z9 dd1l)m:Z: dd2l+m;Z; dd3l,m<Z< dd4l,m=Z= dd5l,m>Z> dd6l,m?Z? dd7l,m@Z@ dd8l,mAZA dd9lmBZB  ed:ej                  ;      ZD ed<e	d=ef   ;      ZE ed>ej                  ;      ZG ed?e;      ZHd@ ZIdA ZJ	 	 	 	 	 	 	 	 ddBZK	 	 	 	 	 	 	 	 ddCZLe	 	 	 	 	 	 	 	 ddD       ZMed=dE	 	 	 	 	 	 	 	 	 ddF       ZMe	 	 	 	 	 	 	 	 ddG       ZMe	 	 	 	 	 	 	 	 ddH       ZMe	 	 	 	 	 	 	 	 ddI       ZMe	 	 	 	 	 	 	 	 ddJ       ZMe	 	 	 	 	 	 	 	 ddK       ZMe	 	 	 	 	 	 	 	 ddL       ZMe	 	 	 	 	 	 	 	 ddM       ZMe	 	 	 	 	 	 	 	 ddN       ZMe	 	 	 	 	 	 	 	 ddO       ZMe	 	 	 	 	 	 	 	 ddP       ZMe	 	 	 	 	 	 	 	 ddQ       ZMed=dR	 	 	 	 	 	 	 	 	 ddS       ZMe	 	 	 	 	 	 	 	 ddT       ZMe	 	 	 	 	 	 	 	 ddU       ZMe	 	 	 	 	 	 	 	 ddV       ZMdddWdWdX	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 ddYZM	 	 	 	 	 	 	 	 ddZZN	 	 	 	 	 	 dd[ZO G d\ d]      ZP G d^ d_      ZQ G d` da      ZR G db dceP      ZS G dd deeP      ZTde$j                  ddf	 	 	 	 	 	 	 	 	 	 	 ddfZV G dg dheP      ZW G di djeP      ZX G dk dleP      ZY G dm dneP      ZZ G do dpeP      Z[ G dq dreP      Z\ G ds dteTeP      Z] G du dve]eP      Z^ G dw dxeP      Z_ G dy dzeTeP      Z` G d{ d|eXeTeP      Za G d} d~eXeP      Zb G d deWeP      Zc G d deSeP      Zd G d deXeP      Ze G d deXeTePej                        Zg G d degeP      Zh G d degeP      Zi G d deSeP      Zj G d deP      Zk G d deReP      Zl G d deQeXeP      Zm G d deQeSeP      Zn G d den      Zo G d deP      Zp G d de]      Zq G d deZeXeP      Zr G d deP      Zs G d deXeP      Zt G d deWeP      Zu G d des      Zv G d deP      Zw G d deP      Zx G d deZeWeP      Zy G d dey      Zz G d dez      Z{ G d deZeWeP      Z| G d deWeP      Z} G d deWeP      Z~i Z ee      D ]P  Z eee      Zej	                  d      sej                  dd      Ze e       v s<  e       e   e      Zeee<   R es/eej                     ZeeeefD ]  Zeeej                  e   <    yy)    )annotationsN)Any)Callable)cast)Dict)Iterable)Iterator)List)NoReturn)Optional)overload)Sequence)Tuple)Type)TYPE_CHECKING)TypeVar)Union   )	operators)roles)visitors)is_from_clause)ExecutableOption)Options)HasCacheKey)	Visitable   )exc)
inspection)util)Literal)elements)lambdas)schema)
selectable)_ColumnExpressionArgument)_ColumnsClauseArgument)_DDLColumnArgument)_DMLTableArgument)_FromClauseArgument)_DMLTableElement)BindParameter)ClauseElement)ColumnClause)ColumnElement)DQLDMLClauseElement)NamedColumn)SQLCoreOperations)Column)_ColumnsClauseElement)_JoinTargetProtocol)
FromClause)HasCTE)
SelectBase)Subquery)_TraverseCallableType_SR)bound_F._StringOnlyR_Tc                b    t        | t        t        j                  f       xr t	        | d       S )zhReturn whether or not the element is a "literal" in the context
    of a SQL expression construct.

    __clause_element__)
isinstancer   r$   SchemaEventTargethasattr)elements    U/var/www/html/flask-app/venv/lib/python3.12/site-packages/sqlalchemy/sql/coercions.py_is_literalrG   O   s<     	F,,-  5 g34
45    c                r   t        | t        j                        r%t        | t              s| D ]  }t	        |      r y yt        | t
        t        j                  t        t        t        j                  j                  f       xr3 t        | d       xr$ t        | t               xs t        | t               S )a  Return whether or not the element is a "literal" in the context
    of a SQL expression construct.

    does a deeper more esoteric check than _is_literal.   is used
    for lambda elements that have to distinguish values that would
    be bound vs. not without any context.

    FTrA   )rB   collections_abcr   str_deep_is_literalr   r$   rC   r   r   r    langhelperssymbolrD   type
issubclass)rE   elems     rF   rL   rL   [   s     '?334Z>  	D#D)	  ((  ''	
 		
 	
 !566	
 7D)) 4g{33rH   c                <    t        j                  | d|d|d      S )Nz.. warning:: The z argument to z can be passed as a Python string argument, which will be treated as **trusted SQL text** and rendered as given.  **DO NOT PASS UNTRUSTED INPUT TO THIS PARAMETER**.)r    add_parameter_text)	paramnamemeth_rst	param_rsts      rF   _document_text_coercionrW      s&     "" h	 
 
rH   c                    |rjt        |d   t        t        t        f      rLt	        |      dk(  r>t        |d   t              rt        j                  d|  d| d      t        d|d         S t        d|      S )Nr   r   zThe "z" argument to zt(), when referring to a sequence of items, is now passed as a series of positional elements, rather than as a list. Sequence[_T])rB   listsetdictlenr   ArgumentErrorr   )attrnamefnnameargss      rF   !_expression_collection_was_a_listrb      s}    
 
47T3$563t9>d1gt$##zx 84 4  NDG,,%%rH   c                     y N rolerE   kws      rF   expectri          
 rH   )as_keyc                    y rd   re   )rg   rE   rk   rh   s       rF   ri   ri      s     rH   c                     y rd   re   rf   s      rF   ri   ri      s    
 rH   c                     y rd   re   rf   s      rF   ri   ri      s    
 rH   c                     y rd   re   rf   s      rF   ri   ri      s    
 "rH   c                     y rd   re   rf   s      rF   ri   ri          
 rH   c                     y rd   re   rf   s      rF   ri   ri      s    
 rH   c                     y rd   re   rf   s      rF   ri   ri      s     rH   c                     y rd   re   rf   s      rF   ri   ri      s     rH   c                     y rd   re   rf   s      rF   ri   ri      s    
 rH   c                     y rd   re   rf   s      rF   ri   ri      s    
 rH   c                     y rd   re   rf   s      rF   ri   ri         
 rH   c                     y rd   re   rf   s      rF   ri   ri     rx   rH   )explicit_subqueryc                    y rd   re   )rg   rE   rz   rh   s       rF   ri   ri     s     rH   c                     y rd   re   rf   s      rF   ri   ri   !  s    
  rH   c                     y rd   re   rf   s      rF   ri   ri   )  rq   rH   c                     y rd   re   rf   s      rF   ri   ri   2  rj   rH   F)apply_propagate_attrsargnamepost_inspectdisable_inspectionc          	        | j                   rCt        |      r8t        |d      r,t        j                  || t        j
                  di ||      S t        |    }|}t        |t        j                  t        j                  t        j                  t        j                  f      sd }	|j                  r |j                  |fi |}	n|}d}
|j                   rt        ||       rt        |d      rd}
n:t        |d      r.d}
t#        |dd      s|j%                         }nnt        |d      r.|
s^|j&                  r:|s8t)        j*                  |d      }||r|j,                   	 |j%                         }	|	H |j                  |fd|i|}	n2|}	n/t        |t        j                        r |j2                  di |}	n|}	|Rt4        j6                  rt        |	t8        t:        f      sJ |j<                  st#        |	d	d       r|	j<                  |_        |j>                  |	j@                  jB                  v r$|jD                  r |jD                  |	f||d
|}	|	S  |jF                  ||	fd|i|S # t.        $ r |j1                  ||       Y w xY w)N__code__)r   FrA   Tis_clause_element)raiseerrr   _propagate_attrs)r   original_elementre   )$allows_lambdacallablerD   r#   LambdaElementLambdaOptions_impl_lookuprB   r"   CompilerElementr$   
SchemaItemFetchedValue	PyWrapper_resolve_literal_only_literal_coercion$_skip_clauseelement_for_target_matchgetattrrA   _use_inspectionr   inspect_post_inspectAttributeError_raise_for_expected_sa__py_wrapper_literaltypingr   r2   r-   r   _role_class	__class____mro___post_coercion_implicit_coercions)rg   rE   r   r   r   r   rh   implr   resolvedr   insps               rF   ri   ri   :  s    	
 WGZ($$!!'B'"7	
 	
 D$$		
 %%-t--g<<H& % 99w-G%9:$(!g';<(,%"7,?G")"<"<"> g';< %''0B%--gFD'' ..P'+'>'>'@H #5t55 )0 46 H #	GW..	/27228R8(h):M(JKK$55'($;
 6>5N5N!28--555*t**!1 	H 't''h
07
;=
 	
C  . P 445EwOPs   "I, ,J
Jc                D    |j                  dd        t        | |fddi|S )Nrk   T)popri   rf   s      rF   expect_as_keyr     s)     FF8T$3333rH   c              #     K   |D ]u  }d }d }t        | |      }t        |t              rt        |t              sJ |x}}n.g }|j                  }t	        j
                  |i d|i       |r|d   }||n|}||||f w y w)Ncolumnr   )ri   rB   rK   appendr   traverse)	rg   expressionsexprstrnamer   r   cols
col_appendadd_elements	            rF    expect_col_expression_collectionr     s       5,24,>h$dC((!%%Gh&(D=A[[JhXz,BCa & 2f44!5s   A<A>c                      e Zd ZU dZd ZdZded<   dZdZd Z		 d
	 	 	 	 	 	 	 	 	 ddZ
	 	 	 	 	 d	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 dd	Zy)RoleImpl)r   namer   c                    t               rd   )NotImplementedErrorselfrE   rh   s      rF   r   zRoleImpl._literal_coercion  s    !##rH   Nr   r   Fc                r    || _         |j                  | _        t        |t        j
                        | _        y rd   )r   
_role_namer   rP   r   UsesInspectionr   )r   
role_classs     rF   __init__zRoleImpl.__init__  s,    %))	)*e6J6JKrH   c                *    | j                  |||       y rd   r   r   rE   r   r   rh   s        rF   r   zRoleImpl._implicit_coercions  s     	  '8<rH   c                    |||ur	|d|d}nt        |      }|r| j                  d|d|d}	n| j                  d|d}	|r|	d|z   z  }	t        j                  |	|      |)	Nz object resolved from z objectz expected for argument z; got .z expected, got  )code)reprr   r   r^   )
r   rE   r   r   advicer   errrh   gotmsgs
             rF   r   zRoleImpl._raise_for_expected  sq     HG$;9A7KCw-C		C -1IIs;C3<C$/S8rH   rd   
rE   r   r   r   r   Optional[str]rh   r   returnr   NNNNNrE   r   r   r   r   zOptional[Any]r   r   r   r   r   Optional[Exception]rh   r   r   r   )__name__
__module____qualname__	__slots__r   r   __annotations__r   r   r   r   r   re   rH   rF   r   r     s    :I$ NC!+0(L "&	== = 	=
 = 
= "&"& $"#'99 9  	9
 9 9 !9 9 
9rH   r   c                      e Zd ZdZd Zy)_Deannotatere   c                    ddl m}  ||      S )Nr   )_deep_deannotate)r    r   )r   r   rh   r   s       rF   r   z_Deannotate._post_coercion  s    *))rH   Nr   r   r   r   r   re   rH   rF   r   r   	  s    I*rH   r   c                      e Zd ZdZdZy)_StringOnlyre   TN)r   r   r   r   r   re   rH   rF   r   r     s    I rH   r   c                      e Zd ZdZddZd Zy)_ReturnsStringKeyre   Nc                N    t        |t              r|S | j                  |||       y rd   rB   rK   r   r   s        rF   r   z%_ReturnsStringKey._implicit_coercions  s#    gs#N$$Wgx@rH   c                    |S rd   re   r   s      rF   r   z#_ReturnsStringKey._literal_coercion!      rH   rd   r   r   r   r   r   r   re   rH   rF   r   r     s    IArH   r   c                      e Zd ZdZd ZddZy)_ColumnCoercionsre   c                .    t        j                  d       y )Nz|implicitly coercing SELECT object to scalar subquery; please use the .scalar_subquery() method to produce a scalar subquery.)r    warn)r   s    rF   "_warn_for_scalar_subquery_coercionz3_ColumnCoercions._warn_for_scalar_subquery_coercion(  s    			
rH   Nc                   |}t        |dd      s| j                  |||       y |j                  r | j                          |j	                         S |j
                  rDt        |t        j                        r*| j                          |j                  j	                         S | j                  j                  r|j                  r|S | j                  |||       y )Nr   F)r   r   _is_select_baser   scalar_subquery_is_from_clauserB   r%   r9   rE   r   r   _is_lambda_element)r   rE   r   r   rh   r   s         rF   r   z$_ColumnCoercions._implicit_coercions/  s    "x!4e<$$%5wI%%335++--%%*j))+
 335##3355++0K0KO$$%5wIrH   rd   )r   r   r   r   r   r   re   rH   rF   r   r   %  s    I
JrH   r   c                d     |dt        j                  |       |rd|nd|rd|z  nddz        |)Nzc%(extra)sTextual SQL expression %(expr)r %(argname)sshould be explicitly declared as text(%(expr)r)for argument  z%s )r   r   extra)r    ellipses_string)rE   r   exc_clsr   r   s        rF   _no_text_coercionr   A  sJ     	0 ((19@G5b&+UU]
	
 rH   c                      e Zd ZdZddZy)_NoTextCoercionre   Nc                    t        |t              r1t        t        j                  | j
                        rt        ||       y | j                  ||       y rd   )rB   rK   rP   r"   
TextClauser   r   r   r   rE   r   rh   s       rF   r   z!_NoTextCoercion._literal_coercionV  s@    gs#
!1!1)
 gw/$$Wg6rH   rd   r   r   r   r   r   re   rH   rF   r   r   S  s    I7rH   r   c                  ,    e Zd ZdZdZdZdZddZddZy)_CoerceLiteralsre   FNc                    t        ||      S rd   r   r   rE   r   s      rF   _text_coercionz_CoerceLiterals._text_coercione       '22rH   c                   t        |t              r<| j                  r|dk(  rt        j                  dd      S  | j
                  ||fi |S | j                  rF|t        j                         S |du rt        j                         S |du rt        j                         S | j                  r:t        |t        j                        r t        j                  t        |      d      S | j                  ||       y )N*T)
is_literalF)rB   rK   _coerce_starr"   r.   r   _coerce_constsNullFalse_True__coerce_numericsnumbersNumberr   r   s       rF   r   z!_CoerceLiterals._literal_coercionh  s    gs#  W^,,STBB*t**7GBrBB}}&E!((D~~''  Z'..%J((W$GG  '2rH   rd   )	r   r   r   r   r  r  r
  r   r   re   rH   rF   r   r   _  s!    INL33rH   r   c                  $    e Zd ZdZ	 	 ddZddZy)LiteralValueImplTNc                x    t        |      s | j                  |f||d| t        j                  d ||d|      S )N)r   r   T)type_uniqueliteral_execute)rG   r   r"   r,   )r   rE   r   r   r  r  rh   s          rF   r   z$LiteralValueImpl._implicit_coercions  sU     8$$D$$"*G?A %%+
 	
rH   c                    |S rd   re   )r   rE   r   r  rh   s        rF   r   z"LiteralValueImpl._literal_coercion  r   rH   NFNN)r   r   r   r   r   r   re   rH   rF   r  r  }  s      
,rH   r  c                  N     e Zd ZdZ	 	 	 	 	 d	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 d fdZ xZS )_SelectIsNotFromre   c           	         |st        |t        j                        st        |t        j                        rd||j                  n|d}d}nd }t	        |   |f|||||d| J )NzTo create a FROM clause from a z$ object, use the .subquery() method.89ve)r   r   r   r   r   )rB   r   SelectStatementRoler   superr   )	r   rE   r   r   r   r   r   rh   r   s	           rF   r   z$_SelectIsNotFrom._raise_for_expected  s     7E$=$=>(E$=$=>
 *2)=8%%7JM 
 DD#	
	
 	
 	rH   r   r   r   r   r   r   r   __classcell__r   s   @rF   r  r    sq    I
 "&"& $"#'"" "  	"
 " " !" " 
" "rH   r  c                  4    e Zd ZdZ	 d	 	 	 	 	 	 	 	 	 ddZd Zy)HasCacheKeyImplre   Nc                N    t        |t              r|S | j                  |||       y rd   )rB   r   r   r   s        rF   r   z#HasCacheKeyImpl._implicit_coercions  s%     g{+N$$Wgx@rH   c                    |S rd   re   r   s      rF   r   z!HasCacheKeyImpl._literal_coercion  r   rH   rd   r   r   re   rH   rF   r   r     L    I "&	
A
A 
A 	
A
 
A 

ArH   r   c                  4    e Zd ZdZ	 d	 	 	 	 	 	 	 	 	 ddZd Zy)ExecutableOptionImplre   Nc                N    t        |t              r|S | j                  |||       y rd   )rB   r   r   r   s        rF   r   z(ExecutableOptionImpl._implicit_coercions  s&     g/0N$$Wgx@rH   c                    |S rd   re   r   s      rF   r   z&ExecutableOptionImpl._literal_coercion  r   rH   rd   r   r   re   rH   rF   r%  r%    r#  rH   r%  c                  .     e Zd ZdZ	 ddZd fd	Z xZS )ExpressionElementImplre   c                    |$|s"||j                   st        j                         S 	 t        j                  |||d|      S # t        j
                  $ r}| j                  ||       Y d }~y d }~ww xY w)NT)r  _is_crudr   )should_evaluate_noner"   r  r,   r   r^   r   )r   rE   r   r  r   is_crudrh   r   s           rF   r   z'ExpressionElementImpl._literal_coercion  sx     Oe&@&@
 ==?";--'5  $$ ;((c(::;s   A A2A--A2c                    t        |t        j                        rd}nt        |t        j                        rd}nd }t        |   |f|||d|S )NzTTo create a column expression from a VALUES clause, use the .scalar_values() method.z`To create a column expression from a FROM clause row as a whole, use the .table_valued() method.r   r   r   )rB   r%   Valuesr   AnonymizedFromClauseRoler  r   r   rE   r   r   rh   r   r   s         rF   r   z)ExpressionElementImpl._raise_for_expected  si    gz0013  !?!?@> 
 Fw*
$x
JL
 	
rH   NNNFr  )r   r   r   r   r   r   r  r  s   @rF   r)  r)    s    I EJ;(
 
rH   r)  c                  "    e Zd ZdZ	 ddZddZy)BinaryElementImplre   Nc                    	 |j                  |||      S # t        j                  $ r}| j                  ||       Y d }~y d }~ww xY w)N)r  r,  )_bind_paramr   r^   r   )r   rE   r   operatorbindparam_typer   rh   r   s           rF   r   z#BinaryElementImpl._literal_coercion  sK    	7##Hg^#LL   	7$$W#$66	7s    AAAc                    |j                   j                  r5|j                   j                  s|j                  ||n|j                         }|S rd   )rO   _isnull_with_binary_element_type)r   r   r   r:  rh   s        rF   r   z BinaryElementImpl._post_coercion  s@    ==  ):):99"0"<$))H rH   r  rd   )r   r   r   r   r   r   re   rH   rF   r6  r6    s    I EI7rH   r6  c                  @    e Zd ZdZ	 d	 	 	 	 	 	 	 	 	 ddZd Zd Zd Zy)	InElementImplre   Nc                b   |j                   rt        |t        j                        rD|j                  j
                  r.| j                  |        | j                  |j                  fi |S | j                  |        | j                  |j                         fi |S | j                  |||       y rd   )
r   rB   r%   AliasrE   r   _warn_for_implicit_coercionr   selectr   r   s        rF   r   z!InElementImpl._implicit_coercions)  s     ##8Z%5%56$$4400:*t**8+;+;BrBB00:*t**8??+<CCC$$Wgx@rH   c                \    t        j                  d|j                  j                  z         y )Nz_Coercing %s object into a select() for use in IN(); please pass a select() construct explicitly)r    r   r   r   )r   rQ   s     rF   rB  z)InElementImpl._warn_for_implicit_coercion=  s%    		:~~&&(	
rH   c           	        t        j                  |      ri }t        |      }|D ][  }t        |      s4t	        |t
        j                        s | j                  |fi | <|||<   B|Et        j                         ||<   ] |r9t        j                  |D cg c]  }||v r||   n|j                  ||       c} S |j                  ||d      S  | j                  |fi | y c c}w )NT)	expanding)r    is_non_string_iterablerZ   rG   rB   r   ColumnOperatorsr   r"   r  
ClauseListr8  )r   rE   r   r9  rh   non_literal_expressionsos          rF   r   zInElementImpl._literal_coercionD  s   &&w/  $ 7mG A"1~%a)B)BC000?B? 67/2Y19+A.A '** ")   !$;; 4A6!%!1!1(A!>?	 	 '''T'JJ %D$$W33s   "C&c                   |j                   r|j                         S t        |t        j                        r,t        |j                        dk(  rJ |j                  |      S t        |t        j                        r"|j                  d      }d|_
        ||_        |S t        |t        j                        r|j                         S |S )Nr   )againstT)maintain_key)r   r   rB   r"   rI  r]   clauses
self_groupr,   _clonerF  	expand_opr%   r1  scalar_values)r   rE   r   r9  rh   s        rF   r   zInElementImpl._post_coercionf  s    "" **,,!4!457??+q00%%h%77!7!78nn$n7G $G (GN!2!23((**NrH   rd   r   )r   r   r   r   r   rB  r   r   re   rH   rF   r?  r?  &  sW    I "&	AA A 	A
 A 
A(
 4DrH   r?  c                  &    e Zd ZdZdZ	 ddZddZy)OnClauseImplre   TNc                &    | j                  |       y rd   r   )r   rE   r   r  r   r.  rh   s          rF   r   zOnClauseImpl._literal_coercion  s     	  )rH   c                >    t        |t        j                        r|S |S rd   )rB   r   JoinTargetRole)r   r   r   rh   s       rF   r   zOnClauseImpl._post_coercion  s      &(<(<=##rH   r4  rd   )r   r   r   r   r  r   r   re   rH   rF   rU  rU  {  s    IN EJ*
rH   rU  c                      e Zd ZdZdZddZy)WhereHavingImplre   TNc                    t        ||      S rd   r   r   s      rF   r   zWhereHavingImpl._text_coercion  r  rH   rd   r   r   r   r   r  r   re   rH   rF   rZ  rZ    s    IN3rH   rZ  c                      e Zd ZdZdZddZy)StatementOptionImplre   TNc                ,    t        j                  |      S rd   r"   r   r   s      rF   r   z"StatementOptionImpl._text_coercion  s    ""7++rH   rd   r\  re   rH   rF   r^  r^    s    IN,rH   r^  c                      e Zd ZdZy)ColumnArgumentImplre   Nr   r   r   r   re   rH   rF   rb  rb        IrH   rb  c                      e Zd ZdZy)ColumnArgumentOrKeyImplre   Nrc  re   rH   rF   rf  rf    rd  rH   rf  c                      e Zd ZdZddZy)StrAsPlainColumnImplre   Nc                ,    t        j                  |      S rd   )r"   r.   r   s      rF   r   z#StrAsPlainColumnImpl._text_coercion  s    $$W--rH   rd   )r   r   r   r   r   re   rH   rF   rh  rh    s    I.rH   rh  c                      e Zd ZdZdZddZy)ByOfImplre   TNc                ,    t        j                  |      S rd   )r"   _textual_label_referencer   s      rF   r   zByOfImpl._text_coercion  s    0099rH   rd   r\  re   rH   rF   rk  rk    s    IN:rH   rk  c                      e Zd ZdZd Zy)OrderByImplre   c                t    t        || j                        r!|j                  t        j                  |      S |S rd   )rB   r   _order_by_label_elementr"   _label_reference)r   r   rh   s      rF   r   zOrderByImpl._post_coercion  s4    x!1!1200<,,X66OrH   Nr   re   rH   rF   ro  ro    s    IrH   ro  c                  .    e Zd ZdZ	 d	 	 	 	 	 	 	 	 	 ddZy)GroupByImplre   Nc                T    t        |      rt        j                  |j                   S |S rd   )r   r"   rI  cr   s        rF   r   zGroupByImpl._implicit_coercions  s&     (#&&

33OrH   rd   r   r   r   r   r   r   re   rH   rF   rt  rt    sA    I "&	

 
 	

 
 

rH   rt  c                      e Zd ZdZddZy)DMLColumnImplre   c                "    |r|j                   S |S rd   )key)r   rE   rk   rh   s       rF   r   zDMLColumnImpl._post_coercion  s    ;;NrH   NFr   re   rH   rF   ry  ry    s    IrH   ry  c                      e Zd ZdZddZy)ConstExprImplre   Nc                    |t        j                         S |du rt        j                         S |du rt        j                         S | j	                  ||       y NFT)r"   r  r  r	  r   r   s       rF   r   zConstExprImpl._literal_coercion  sL    ?==?"??$$_>>##$$Wg6rH   rd   r   re   rH   rF   r~  r~    s    I7rH   r~  c                  6    e Zd ZdZ	 d	 	 	 	 	 	 	 	 	 ddZddZy)TruncatedLabelImplre   Nc                N    t        |t              r|S | j                  |||       y rd   r   r   s        rF   r   z&TruncatedLabelImpl._implicit_coercions  s%     gs#O$$Wgx@rH   c                d    t        |t        j                        r|S t        j                  |      S )zcoerce the given value to :class:`._truncated_label`.

        Existing :class:`._truncated_label` and
        :class:`._anonymous_label` objects are passed
        unchanged.
        )rB   r"   _truncated_labelr   s       rF   r   z$TruncatedLabelImpl._literal_coercion  s*     gx889N,,W55rH   rd   r   r   re   rH   rF   r  r    sL    I "&	
A
A 
A 	
A
 
A 

A6rH   r  c                      e Zd ZdZdZddZy)DDLExpressionImplre   TNc                ,    t        j                  |      S rd   r`  r   s      rF   r   z DDLExpressionImpl._text_coercion  s    
 ""7++rH   rd   r\  re   rH   rF   r  r    s    IN,rH   r  c                      e Zd ZdZy)DDLConstraintColumnImplre   Nrc  re   rH   rF   r  r    rd  rH   r  c                      e Zd ZdZy)DDLReferredColumnImplre   Nrc  re   rH   rF   r  r    rd  rH   r  c                  4    e Zd ZdZ	 d	 	 	 	 	 	 	 	 	 ddZd Zy)LimitOffsetImplre   Nc                0    |y | j                  |||       y rd   r   r   s        rF   r   z#LimitOffsetImpl._implicit_coercions$  s     $$Wgx@rH   c                d    |y t        j                  |      }t        j                  |||d      S )NT)r  r  )r    asintr%   _OffsetLimitParam)r   rE   r   r  rh   values         rF   r   z!LimitOffsetImpl._literal_coercion0  s4    ?JJw'E//e5 rH   rd   r   r   re   rH   rF   r  r  !  sL    I "&	
A
A 
A 	
A
 
A 

ArH   r  c                  :     e Zd ZdZ	 d	 	 	 	 	 	 	 	 	 d fdZ xZS )LabeledColumnExprImplre   c                    t        |t        j                        r|j                  d       S t	        |   ||fd|i|}t        |t        j                        r|j                  d       S | j                  |||       y Nr   )rB   r   ExpressionElementRolelabelr  r   r   )r   rE   r   r   rh   newr   s         rF   r   z)LabeledColumnExprImpl._implicit_coercions=  sz     h ; ;<>>$'''-+268C #u::;yy&(('8DrH   rd   r   )r   r   r   r   r   r  r  s   @rF   r  r  :  sN    I "&	EE E 	E
 E 
E ErH   r  c                  t     e Zd ZdZdZdZdZ ej                  dej                        Z
	 d fd	ZddZ xZS )ColumnsClauseImplre   Tz^\w\S*$c                    |s,t        |t              rddj                  d |D               d}t        |   |f|||d|S )NzDid you mean to say select(z, c              3  2   K   | ]  }t        |        y wrd   )r   ).0es     rF   	<genexpr>z8ColumnsClauseImpl._raise_for_expected.<locals>.<genexpr>_  s     6T!W6s   z)?r0  )rB   rZ   joinr  r   )r   rE   r   r   r   rh   r   s         rF   r   z%ColumnsClauseImpl._raise_for_expectedY  s`     *Wd3-996g667r; 
 w*
$x
JL
 	
rH   c                    t        |      }| j                  j                  |       }t        j                  dt        j                  |      |rd|nd|rdnddz        )NzTextual column expression %(column)r %(argname)sshould be explicitly declared with text(%(column)r), or use %(literal_column)s(%(column)r) for more specificityr   r   literal_columnr   )r   r   r  )rK   _guess_straight_columnmatchr   r^   r    r   )r   rE   r   guess_is_literals       rF   r   z ColumnsClauseImpl._text_coercionf  si    g,#::@@II#
 ..w7=D9"(8$h		

 	
rH   )NNNrd   )r   r   r   r   r  r
  r  recompileIr  r   r   r  r  s   @rF   r  r  P  s?    INL'RZZ
BDD9 <@

rH   r  c                      e Zd ZdZy)ReturnsRowsImplre   Nrc  re   rH   rF   r  r  y  rd  rH   r  c                  B     e Zd ZdZddZ	 d	 	 	 	 	 	 	 	 	 d fdZ xZS )StatementImplre   c                    ||urt        |t              s	 |j                   |S |S # t        $ r t	        j
                  d|z  d       Y |S w xY w)Na  Object %r should not be used directly in a SQL statement context, such as passing to methods such as session.execute().  This usage will be disallowed in a future release.  Please use Core select() / update() / delete() etc. with Session.execute() and other statement execution methods.1.4)rB   rK   _execute_on_connectionr   r    warn_deprecated)r   r   r   r   rh   s        rF   r   zStatementImpl._post_coercion  sj    ++Jc5

 77 x " 
$$ "22 	 
s   & "AAc                F    |j                   r|S t        |   ||fd|i|S r  )r   r  r   )r   rE   r   r   rh   r   s        rF   r   z!StatementImpl._implicit_coercions  s:     &&O7.+268 rH   rd   r   )r   r   r   r   r   r   r  r  s   @rF   r  r  }  sL    I4 "&	  	
  
 rH   r  c                  .    e Zd ZdZ	 d	 	 	 	 	 	 	 	 	 ddZy)SelectStatementImplre   Nc                b    |j                   r|j                         S | j                  |||       y rd   )_is_text_clausecolumnsr   r   s        rF   r   z'SelectStatementImpl._implicit_coercions  s.     ####%%$$Wgx@rH   rd   r   rw  re   rH   rF   r  r    sG    I "&	
A
A 
A 	
A
 
A 

ArH   r  c                      e Zd ZdZy)
HasCTEImplre   Nrc  re   rH   rF   r  r    rd  rH   r  c                      e Zd ZdZy)	IsCTEImplre   Nrc  re   rH   rF   r  r    rd  rH   r  c                  @    e Zd ZdZdZddZ	 	 d	 	 	 	 	 	 	 	 	 	 	 ddZy)	JoinTargetImplre   TNc                (    | j                  ||       y rd   r   r   s       rF   r   z JoinTargetImpl._literal_coercion  s      '2rH   c                    t        |t        j                        r|S |r%|j                  rt	        j
                  dd       |S | j                  |||       y NzImplicit coercion of SELECT and textual SELECT constructs into FROM clauses is deprecated; please call .subquery() on any Core select or ORM Query object in order to produce a subquery object.r  )version)rB   r   rX  r   r    r  r   )r   rE   r   r   legacyrh   s         rF   r   z"JoinTargetImpl._implicit_coercions  sW     gu334 N00  6  O$$Wgx@rH   rd   r  )rE   r   r   r   r   r   r  boolrh   r   r   r   )r   r   r   r   r   r   r   re   rH   rF   r  r    s`    I+/(3 "&AA A 	A
 A A 
ArH   r  c                  B    e Zd ZdZ	 	 	 d	 	 	 	 	 	 	 	 	 	 	 	 	 ddZddZy)FromClauseImplre   Nc                    |j                   r8|r|j                         S |r#t        j                  dd       |j                  S y |j
                  r|S | j                  |||       y r  )r   subqueryr    r  _implicit_subqueryr  r   r   rE   r   r   rz   allow_selectrh   s          rF   r   z"FromClauseImpl._implicit_coercions  so     ## ((**$$: "  222  %%O$$Wgx@rH   c                *    |r|j                         S |S rd   )_deannotate)r   rE   
deannotaterh   s       rF   r   zFromClauseImpl._post_coercion   s    &&((NrH   r  rE   r   r   r   r   r   rz   r  r  r  rh   r   r   r   r|  )r   r   r   r   r   r   re   rH   rF   r  r    sh    I "&"'!AA A 	A
  A A A 
A4rH   r  c                  :    e Zd ZdZ	 	 	 d	 	 	 	 	 	 	 	 	 	 	 	 	 ddZy)StrictFromClauseImplre   Nc                    |j                   r%|r#t        j                  dd       |j                  S | j	                  |||       y r  )r   r    r  r  r   r  s          rF   r   z(StrictFromClauseImpl._implicit_coercions
  sG     ##  #  ...$$Wgx@rH   )NFFr  rw  re   rH   rF   r  r    sc    I "&"'"AA A 	A
  A A A 
ArH   r  c                      e Zd ZdZddZy)AnonymizedFromClauseImplre   Nc                .    |J |j                  |      S )N)flat)_anonymous_fromclause)r   rE   r  r   rh   s        rF   r   z'AnonymizedFromClauseImpl._post_coercion#  s    |,,$,77rH   )FNr   re   rH   rF   r  r     s    I8rH   r  c                      e Zd ZdZd Zy)DMLTableImplre   c                @    d|j                   v r|j                   d   S |S )N	dml_table)_annotationsr   s      rF   r   zDMLTableImpl._post_coercion,  s&    '...''44NrH   Nr   re   rH   rF   r  r  )  s    IrH   r  c                  .    e Zd ZdZ	 d	 	 	 	 	 	 	 	 	 ddZy)DMLSelectImplre   Nc                    |j                   rLt        |t        j                        r"|j                  j
                  r|j                  S |j                         S | j                  |||       y rd   )r   rB   r%   rA  rE   r   rC  r   r   s        rF   r   z!DMLSelectImpl._implicit_coercions6  sW     ##8Z%5%56$$44'''(($$Wgx@rH   rd   r   rw  re   rH   rF   r  r  3  sG    I "&	AA A 	A
 A 
ArH   r  c                  $     e Zd ZdZd fd	Z xZS )CompoundElementImplre   c                    t        |t        j                        r|j                  rd}nd}nd }t	        |   |f|||d|S )NzFUse the plain select() object without calling .subquery() or .alias().z9To SELECT from any FROM clause, use the .select() method.r0  )rB   r   FromClauseRole_is_subqueryr  r   r3  s         rF   r   z'CompoundElementImpl._raise_for_expectedL  sa    gu334##7  P  Fw*
$x
JL
 	
rH   r  r  r  s   @rF   r  r  I  s    I
 
rH   r  RoleImpl)rT   rK   rU   rK   rV   rK   r   zCallable[[_F], _F])r_   rK   r`   rK   ra   z+Union[Sequence[_T], Sequence[Sequence[_T]]]r   rY   )rg   zType[roles.TruncatedLabelRole]rE   r   rh   r   r   rK   )
rg   Type[roles.DMLColumnRole]rE   r   rk   Literal[True]rh   r   r   rK   )rg   zType[roles.LiteralValueRole]rE   r   rh   r   r   zBindParameter[Any])rg   z!Type[roles.DDLReferredColumnRole]rE   r   rh   r   r   zColumn[Any])rg   #Type[roles.DDLConstraintColumnRole]rE   r   rh   r   r   zUnion[Column[Any], str])rg   zType[roles.StatementOptionRole]rE   r   rh   r   r   r0   )rg   z&Type[roles.LabeledColumnExprRole[Any]]rE   _ColumnExpressionArgument[_T]rh   r   r   zNamedColumn[_T])rg   zgUnion[Type[roles.ExpressionElementRole[Any]], Type[roles.LimitOffsetRole], Type[roles.WhereHavingRole]]rE   r  rh   r   r   zColumnElement[_T])rg   zUnion[Type[roles.ExpressionElementRole[Any]], Type[roles.LimitOffsetRole], Type[roles.WhereHavingRole], Type[roles.OnClauseRole], Type[roles.ColumnArgumentRole]]rE   r   rh   r   r   zColumnElement[Any])rg   zType[roles.DMLTableRole]rE   r)   rh   r   r   r+   )rg   zType[roles.HasCTERole]rE   r7   rh   r   r   r7   )rg   zType[roles.SelectStatementRole]rE   r8   rh   r   r   r8   )rg   Type[roles.FromClauseRole]rE   r*   rh   r   r   r6   )
rg   r  rE   r8   rz   r  rh   r   r   r9   )rg   zType[roles.ColumnsClauseRole]rE   z_ColumnsClauseArgument[Any]rh   r   r   r4   )rg   zType[roles.JoinTargetRole]rE   r5   rh   r   r   r5   )rg   	Type[_SR]rE   r   rh   r   r   r   )rg   r  rE   r   r   zOptional[ClauseElement]r   r   r   r  r   r  rh   r   r   r   )rg   r  rE   r   rh   r   r   rK   )rg   r  r   zIterable[_DDLColumnArgument]r   zwIterator[Tuple[Union[str, Column[Any]], Optional[ColumnClause[Any]], Optional[str], Optional[Union[Column[Any], str]]]])rE   r   r   r   r   zType[exc.SQLAlchemyError]r   r   r   r   r   r   )
__future__r   collections.abcabcrJ   r  r  r   r   r   r   r   r   r	   r
   r   r   r   r   r   r   r   r   r   r   r   r   r   _typingr   baser   r   	cache_keyr   r   r   r   r    util.typingr!   r"   r#   r$   r%   r&   r'   r(   r)   r*   dmlr+   r,   r-   r.   r/   r0   r1   r2   r3   r4   r5   r6   r7   r8   r9   r:   SQLRoler;   r=   
StringRoler>   r?   rG   rL   rW   rb   ri   r   r   r   r   r   r   r   r^   r   r   r   r  r  r   r%  r)  r6  r?  rU  rZ  r^  rb  rf  rh  ByOfRolerk  ro  rt  ry  r~  r  r  r  r  r  r  r  r  r  r  r  r  r  r  r  r  r  r  r  r   dirr   r   clsendswithreplaceglobalsr   r  ee_implintr  rK   floatpy_typere   rH   rF   <module>r     sW	   # )  	                      # "  "     !	2/+*,%''&'-%+1/&"&$/e5==)T#s(+,~U-=-=>T	5#L!.1 &&& 6& 	&$ 

(  		 
 

  	
# 	
  	 
 

&  	 
 

+  	 
 
"
-"" " 	" 
" 

)  	 
 

0*  	 
 
 +   
 


 
 
 
 

 

"  	 
 

   	 
 

)  	 
 

$   	 
 

 (+	
$ %	
   
 
 
' (    	  
  

$   	 
 

  		 
 6:!$q

q
q
 3	q

 q
 q
 q
 q
 	q
h4
#4.149<445
-5-55<39 39l* *! !
 
Jx J< "),):):# ' 	
 
 $	7h 	73h 3<x :%x %Ph &8 &(
,h (
V-x &RH Rj#X *3o'7 3,/8 ,( / .?H .: 0(ENN :
(H 
(H  %x 7H 76h 6:
,_h 
,k+<h 3 h 2E1 E,&
(/8 &
Rh %OX %PA/8 A   #AX #AL!% !HA> A283 8#_h AOX A,
/8 
*  J %D
%
C}}V||FF+79"79T?3'D $L% 5667GsE* E=DU009:E rH   