
    ,hڞ                       S SK Jr  S SKJr  S SKrS SKrS SKrS SKJr  S SKJ	r	  S SKJ
r
  S SKJr  S SKJr  S SKJr  S S	KJr  S S
KJr  S SKJr  S SKJr  S SKJr  S SKJr  S SKJr  S SKJr  S SKJr  S SKJr  SSKJr  SSKJr  SSKJr  SSKJr  SSKJr  SSK J!r!  SSKJ"r"  SSKJ#r#  SSKJ$r$  SSKJ%r%  SSK&J'r'  \R*                  (       a  SS KJ(r(  SS!KJ)r)  SS"KJ*r*  SS#KJ+r+  SS$KJ,r,  SS%KJ-r-  SS&KJ.r.  SS'KJ/r/  SS(KJ0r0  SS)K1J2r2  SS*K(J3r3  SS+K(J4r4  SS,K(J5r5  SS-K(J6r6  SS.K(J7r7  SS/K(J8r8  SS0K(J9r9  SS1K*J:r:  SS2K+J;r;  SS3K+J<r<  SS4K+J=r=  SS5K+J>r>  SS6K+J?r?  SS7K+J@r@  SS8KJArA  \" S9\R                  S:9rC\" S;\	S<\4   S:9rD\" S=\R                  S:9rF\" S>\S:9rGSS? jrHS@ rI        SSA jrJ        SSB jrK\        SSC j5       rL\S<SD.         SSE jj5       rL\        SSF j5       rL\        SSG j5       rL\        SSH j5       rL\        SSI j5       rL\        SSJ j5       rL\        SSK j5       rL\        SSL j5       rL\        SSM j5       rL\        SSN j5       rL\        SSO j5       rL\        SSP j5       rL\S<SQ.         SSR jj5       rL\        SSS j5       rL\        SST j5       rL\        SSU j5       rLSSSVSVSW.               SSX jjrL        SSY jrM      SSZ jrN " S[ S\5      rO " S] S^5      rP " S_ S`5      rQ " Sa Sb\O5      rR " Sc Sd\O5      rSS\#R                  SS4           SSe jjrU " Sf Sg\O5      rV " Sh Si\O5      rW " Sj Sk\O5      rX " Sl Sm\O5      rY " Sn So\O5      rZ " Sp Sq\O5      r[ " Sr Ss\S\O5      r\ " St Su\\\O5      r] " Sv Sw\O5      r^ " Sx Sy\S\O5      r_ " Sz S{\W\S\O5      r` " S| S}\W\O5      ra " S~ S\V\O5      rb " S S\R\O5      rc " S S\W\O5      rd " S S\W\S\O\R                  5      rf " S S\f\O5      rg " S S\f\O5      rh " S S\R\O5      ri " S S\O5      rj " S S\Q\O5      rk " S S\P\W\O5      rl " S S\P\R\O5      rm " S S\m5      rn " S S\O5      ro " S S\\5      rp " S S\Y\W\O5      rq " S S\O5      rr " S S\W\O5      rs " S S\V\O5      rt " S S\r5      ru " S S\O5      rv " S S\O5      rw " S S\Y\V\O5      rx " S S\x5      ry " S S\y5      rz " S S\Y\V\O5      r{ " S S\V\O5      r| " S S\V\O5      r}0 r~\" \5       HZ  r\" \\5      r\GR                  S5      (       d  M%  \GR	                  SS5      r\\" 5       ;   d  ME  \" 5       \   " \5      r\\~\'   M\     \(       d1  \~\GR                     r\\\\4 H  r\\~\GR                  \   '   M     gg)    )annotationsN)Any)Callable)cast)Dict)Iterable)Iterator)List)NoReturn)Optional)overload)Sequence)Tuple)Type)TYPE_CHECKING)TypeVar)Union   )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)NamedColumn)SQLCoreOperations)
TextClause)Column)_ColumnsClauseElement)_JoinTargetProtocol)
FromClause)HasCTE)
SelectBase)Subquery)_TraverseCallableType_SR)bound_F._StringOnlyR_Tc                |    [        U [        [        R                  45      (       + =(       a    [	        U S5      (       + $ )z`Return whether or not the element is a "literal" in the context
of a SQL expression construct.

__clause_element__)
isinstancer   r#   SchemaEventTargethasattr)elements    P/var/www/auris/envauris/lib/python3.13/site-packages/sqlalchemy/sql/coercions.py_is_literalrF   N   s<     	F,,-  5 g34
45    c                   [        U [        R                  5      (       a1  [        U [        5      (       d  U  H  n[	        U5      (       a  M    g   g[        U [
        [        R                  [        [        [        R                  R                  45      (       + =(       aI    [        U S5      (       + =(       a1    [        U [        5      (       + =(       d    [        U [        5      (       + $ )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.

FTr@   )rA   collections_abcr   str_deep_is_literalr   r#   rB   r   r   r   langhelperssymbolrC   type
issubclass)rD   elems     rE   rK   rK   Z   s     '?3344Z> > D#D))   ((  ''	
 		
 	
 !566	
 7D)) 4g{33rG   c                B    [         R                  " U SU< SU< S35      $ )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      rE   _document_text_coercionrV      s&     "" h	 
 
rG   c                   U(       av  [        US   [        [        [        45      (       aS  [	        U5      S:X  aD  [        US   [        5      (       a  [
        R                  " SU  SU S35      e[        SUS   5      $ [        SU5      $ )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])rA   listsetdictlenr   ArgumentErrorr   )attrnamefnnameargss      rE   !_expression_collection_was_a_listra      s    
 
47T3$5663t9>d1gt$$##zx 84 4  NDG,,%%rG   c                    g N rolerD   kws      rE   expectrh          
 rG   as_keyc                   g rc   rd   )rf   rD   rk   rg   s       rE   rh   rh      s     rG   c                    g rc   rd   re   s      rE   rh   rh      s    
 rG   c                    g rc   rd   re   s      rE   rh   rh          
 "rG   c                    g rc   rd   re   s      rE   rh   rh      ro   rG   c                    g rc   rd   re   s      rE   rh   rh      s    
 -0rG   c                    g rc   rd   re   s      rE   rh   rh      s    
 rG   c                    g rc   rd   re   s      rE   rh   rh      s     rG   c                    g rc   rd   re   s      rE   rh   rh      s     rG   c                    g rc   rd   re   s      rE   rh   rh      s    
 rG   c                    g rc   rd   re   s      rE   rh   rh      s    
 rG   c                    g rc   rd   re   s      rE   rh   rh         
 rG   c                    g rc   rd   re   s      rE   rh   rh     rx   rG   )explicit_subqueryc                   g rc   rd   )rf   rD   rz   rg   s       rE   rh   rh     s     rG   c                    g rc   rd   re   s      rE   rh   rh      s    
  rG   c                    g rc   rd   re   s      rE   rh   rh   (  s    
 rG   c                    g rc   rd   re   s      rE   rh   rh   1  ri   rG   F)apply_propagate_attrsargnamepost_inspectdisable_inspectionc          	        U R                   (       aL  [        U5      (       a<  [        US5      (       a+  [        R                  " UU [        R
                  " S0 UD6US9$ [        U    nUn[        U[        R                  [        R                  [        R                  [        R                  45      (       Gd"  S n	UR                  (       a  UR                  " U40 UD6n	GO.UnSn
UR                   (       a$  [        X5      (       a  [        US5      (       a  Sn
OJ[        US5      (       a9  Sn
[#        USS5      (       d  UR%                  5       nOO[        US5      (       a  M9  U
(       dm  UR&                  (       aC  U(       d<  [(        R*                  " USS9nUb$  U(       a  UR,                     UR%                  5       n	U	c  UR                  " U4SU0UD6n	O7Un	O4[        U[        R                  5      (       a  UR2                  " S0 UD6n	OUn	Ubf  [4        R6                  (       a  [        U	[8        [:        45      (       d   eUR<                  (       d#  [#        U	S	S 5      (       a  U	R<                  Ul        UR>                  U	R@                  RB                  ;   a)  URD                  (       a  URD                  " U	4UUS
.UD6n	U	$ URF                  " X4SU0UD6$ ! [.         a    UR1                  X5         GN9f = f)N__code__)r   Fr@   Tis_clause_element)raiseerrr   _propagate_attrs)r   original_elementrd   )$allows_lambdacallablerC   r"   LambdaElementLambdaOptions_impl_lookuprA   r!   CompilerElementr#   
SchemaItemFetchedValue	PyWrapper_resolve_literal_only_literal_coercion$_skip_clauseelement_for_target_matchgetattrr@   _use_inspectionr   inspect_post_inspectAttributeError_raise_for_expected_sa__py_wrapper_literaltypingr   r0   r,   r   _role_class	__class____mro___post_coercion_implicit_coercions)rf   rD   r   r   r   r   rg   implr   resolvedr   insps               rE   rh   rh   9  s    	
 WGZ(($$!!'B'"7	
 	
 D$$		
  %%--g<<H& % 99w--G%9::$(!g';<<(,%"7,?GG")"<"<"> g';<< %''0B%--gFD'' ..P'+'>'>'@H ##55 )0 46 H #	GW..	/	/228R8(h):M(JKKKK$55'($;
 ;
 6>5N5N!28--555**!1 	H ''
07
;=
 	
C  . P 445EOPs   -K K76K7c                B    UR                  SS 5        [        X4SS0UD6$ )Nrk   T)poprh   re   s      rE   expect_as_keyr     s'     FF8T$3333rG   c              #    #    U H  nS nS n[        X5      n[        U[        5      (       a  [        U[        5      (       d   eU=p5O4/ nUR                  n[        R
                  " U0 SU05        U(       a  US   nUb  UOUnXTX84v   M     g 7f)Ncolumnr   )rh   rA   rJ   appendr   traverse)	rf   expressionsexprstrnamer   r   cols
col_appendadd_elements	            rE    expect_col_expression_collectionr     s      ,24,>h$$dC((((!%%Gh&(D=A[[JhXz,BCa & 2f44! s   BBc                      \ rS rSr% SrS rSrS\S'   SrSr	S r
 S         SS	 jjr  SSSSS
.               SS jjjrSrg)RoleImpli  )r   namer   c                    [        5       erc   )NotImplementedErrorselfrD   rg   s      rE   r   RoleImpl._literal_coercion  s    !##rG   Nr   r   Fc                p    Xl         UR                  U l        [        U[        R
                  5      U l        g rc   )r   
_role_namer   rO   r   UsesInspectionr   )r   
role_classs     rE   __init__RoleImpl.__init__  s*    %))	)*e6J6JKrG   c                (    U R                  XU5        g rc   r   r   rD   r   r   rg   s        rE   r   RoleImpl._implicit_coercions  s     	  8<rG   advicecodeerrc                   Ub  X1La  U< SU< S3nO[        U5      nU(       a  U R                  < SU< SU< S3n	OU R                  < SU< S3n	U(       a  U	SU-   -  n	[        R                  " XS9Ue)	Nz object resolved from z objectz expected for argument z; got .z expected, got  )r   )reprr   r   r]   )
r   rD   r   r   r   r   r   rg   gotmsgs
             rE   r   RoleImpl._raise_for_expected  sm     H$;9A7KCw-C		C -1IIs;C3<C/S8rG   )r   r   r   rc   
rD   r   r   r   r   Optional[str]rg   r   returnr   NNrD   r   r   r   r   zOptional[Any]r   r   r   r   r   Optional[Exception]rg   r   r   r   )__name__
__module____qualname____firstlineno__	__slots__r   r   __annotations__r   r   r   r   r   __static_attributes__rd   rG   rE   r   r     s    :I$ NC!+0(L "&	== = 	=
 = 
= "&"&	9 !%"#'99 9  	9 9 9 !9 9 
9 9rG   r   c                      \ rS rSrSrS rSrg)_Deannotatei	  rd   c                    SSK Jn  U" U5      $ )Nr   )_deep_deannotate)r   r   )r   r   rg   r   s       rE   r   _Deannotate._post_coercion  s    *))rG   Nr   r   r   r   r   r   r   rd   rG   rE   r   r   	  s    I*rG   r   c                      \ rS rSrSrSrSrg)_StringOnlyi  rd   TN)r   r   r   r   r   r   r   rd   rG   rE   r   r     s    I rG   r   c                  (    \ rS rSrSrSS jrS rSrg)_ReturnsStringKeyi  rd   Nc                V    [        U[        5      (       a  U$ U R                  XU5        g rc   rA   rJ   r   r   s        rE   r   %_ReturnsStringKey._implicit_coercions  s$    gs##N$$Wx@rG   c                    U$ rc   rd   r   s      rE   r   #_ReturnsStringKey._literal_coercion!      rG   rc   r   r   r   r   r   r   r   r   rd   rG   rE   r   r     s    IArG   r   c                  (    \ rS rSrSrS rSS jrSrg)_ColumnCoercionsi%  rd   c                0    [         R                  " S5        g )Nz|implicitly coercing SELECT object to scalar subquery; please use the .scalar_subquery() method to produce a scalar subquery.)r   warn)r   s    rE   "_warn_for_scalar_subquery_coercion3_ColumnCoercions._warn_for_scalar_subquery_coercion(  s    			
rG   Nc                   Un[        USS5      (       d  U R                  XSU5        g UR                  (       a   U R                  5         UR	                  5       $ UR
                  (       aI  [        U[        R                  5      (       a*  U R                  5         UR                  R	                  5       $ U R                  R                  (       a  UR                  (       a  U$ U R                  XSU5        g )Nr   F)r   r   _is_select_baser   scalar_subquery_is_from_clauserA   r$   r8   rD   r   r   _is_lambda_element)r   rD   r   r   rg   r   s         rE   r   $_ColumnCoercions._implicit_coercions/  s    "x!4e<<$$%5I%%335++--%%*j))+
 +
 335##3355++0K0KO$$%5IrG   rc   )r   r   r   r   r   r   r   r   rd   rG   rE   r   r   %  s    I
JrG   r   c                |    U" S[         R                  " U 5      U(       a  SU< 3OSU(       a  SU-  OSS.-  5      Ue)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)rD   r   exc_clsr   r   s        rE   _no_text_coercionr   A  sJ     	0 ((19@G5b&+UU]
	
 rG   c                  &    \ rS rSrSrSS.S jrSrg)_NoTextCoercioniS  rd   Nr   c                   [        U[        5      (       a5  [        [        R                  U R
                  5      (       a  [        X5        g U R                  X5        g rc   )rA   rJ   rO   r!   r1   r   r   r   r   rD   r   rg   s       rE   r   !_NoTextCoercion._literal_coercionV  sD    gs##
!1!1)
 )
 g/$$W6rG   r   r   r   r   r   r   r   rd   rG   rE   r  r  S  s    I48 7 7rG   r  c                  <    \ rS rSrSrSrSrSrSS jrSS.S jr	Sr
g)	_CoerceLiteralsi_  rd   FNc                    [        X5      $ rc   r   r   rD   r   s      rE   _text_coercion_CoerceLiterals._text_coercione       22rG   r  c               $   [        U[        5      (       a?  U R                  (       a  US:X  a  [        R                  " SSS9$ U R
                  " X40 UD6$ U R                  (       aL  Uc  [        R                  " 5       $ USL a  [        R                  " 5       $ USL a  [        R                  " 5       $ U R                  (       a=  [        U[        R                  5      (       a  [        R                  " [        U5      SS9$ U R                  X5        g )N*T)
is_literalF)rA   rJ   _coerce_starr!   r-   r  _coerce_constsNullFalse_True__coerce_numericsnumbersNumberr   r  s       rE   r   !_CoerceLiterals._literal_coercionh  s    gs##  W^,,STBB**7BrBB}}&E!((D~~''  Z'..%J%J((W$GG  2rG   rc   )r   r   r   r   r   r  r  r  r  r   r   rd   rG   rE   r	  r	  _  s+    INL3 59 3 3rG   r	  c                  4    \ rS rSrSr S	SSS.S jjrS rSrg)
LiteralValueImpli}  TNF)type_literal_executec               |    [        U5      (       d  U R                  " U4X#S.UD6  [        R                  " S UUSUS9$ )N)r   r   T)r  uniquer  )rF   r   r!   r+   )r   rD   r   r   r  r  rg   s          rE   r   $LiteralValueImpl._implicit_coercions  sT     8$$$$"*?A %%+
 	
rG   c                    U$ rc   rd   r   s      rE   r   "LiteralValueImpl._literal_coercion  r   rG   rd   rc   )r   r   r   r   r   r   r   r   rd   rG   rE   r  r  }  s$      	
 
.rG   r  c                  b   ^  \ rS rSrSr  SSSSS.               SU 4S jjjjrSrU =r$ )_SelectIsNotFromi  rd   Nr   c          	        > U(       d  [        U[        R                  5      (       d  [        U[        R                  5      (       a  SUb  UR                  OU< S3nSnOS n[        TU ]  " U4UUUUUS.UD6   e)NzTo create a FROM clause from a z$ object, use the .subquery() method.89ve)r   r   r   r   r   )rA   r   SelectStatementRoler   superr   )	r   rD   r   r   r   r   r   rg   r   s	           rE   r   $_SelectIsNotFrom._raise_for_expected  s     7E$=$=>>(E$=$=>>
 *2)=8%%7JM 
 DD#	
	
 	
 	urG   r   r   r   r   r   r   r   r   r   __classcell__r   s   @rE   r&  r&    sx    I
 "&"&	# !%"#'## #  	# # # !# # 
# #rG   r&  c                  @    \ rS rSrSr S         SS jjrS rSrg)HasCacheKeyImpli  rd   Nc                V    [        U[        5      (       a  U$ U R                  XU5        g rc   )rA   r   r   r   s        rE   r   #HasCacheKeyImpl._implicit_coercions  s&     g{++N$$Wx@rG   c                    U$ rc   rd   r   s      rE   r   !HasCacheKeyImpl._literal_coercion  r   rG   rc   r   r   rd   rG   rE   r0  r0    L    I "&	
A
A 
A 	
A
 
A 

ArG   r0  c                  @    \ rS rSrSr S         SS jjrS rSrg)ExecutableOptionImpli  rd   Nc                V    [        U[        5      (       a  U$ U R                  XU5        g rc   )rA   r   r   r   s        rE   r   (ExecutableOptionImpl._implicit_coercions  s'     g/00N$$Wx@rG   c                    U$ rc   rd   r   s      rE   r   &ExecutableOptionImpl._literal_coercion  r   rG   rc   r   r   rd   rG   rE   r7  r7    r5  rG   r7  c                  B   ^  \ rS rSrSrSSSS.S jrSU 4S jjrSrU =r$ )	ExpressionElementImpli  rd   NF)r   r  is_crudc                   Uc0  U(       d)  Ub  UR                   (       d  [        R                  " 5       $  [        R                  " X!USUS9$ ! [        R
                   a  nU R                  XS9   S nAg S nAff = f)NT)r!  _is_crudr   )should_evaluate_noner!   r  r+   r   r]   r   )r   rD   r   r  r>  rg   r   s          rE   r   'ExpressionElementImpl._literal_coercion  sq     Oe&@&@
 ==?";--5  $$ ;(((:;s   A A9 A44A9c                   > [        U[        R                  5      (       a  SnO$[        U[        R                  5      (       a  SnOS n[
        TU ]  " U4X#US.UD6$ )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   )rA   r$   Valuesr   AnonymizedFromClauseRoler*  r   r   rD   r   r   rg   r   r   s         rE   r   )ExpressionElementImpl._raise_for_expected  sm    gz00113  !?!?@@> 
 Fw*
$
JL
 	
rG   r   )	r   r   r   r   r   r   r   r   r-  r.  s   @rE   r=  r=    s     I  $4;(
 
rG   r=  c                  6    \ rS rSrSrSSS.S jrSS.S jrSrg)BinaryElementImpli  rd   N)bindparam_typer   c                    UR                  X1US9$ ! [        R                   a  nU R                  XS9   S nAg S nAff = f)N)r  rA  )_bind_paramr   r]   r   )r   rD   r   operatorrL  r   rg   r   s           rE   r   #BinaryElementImpl._literal_coercion  sD    	7##H^#LL   	7$$W$6	7s    ?:?)rL  c                   UR                   R                  (       a;  UR                   R                  (       d   UR                  Ub  UOUR                   5      nU$ rc   )rN   _isnull_with_binary_element_type)r   r   r   rL  rg   s        rE   r    BinaryElementImpl._post_coercion'  s@    ==  ):):99"0"<$))H rG   )r   r   r   r   r   r   r   r   rd   rG   rE   rK  rK    s%    I 7 @D  rG   rK  c                  v    \ rS rSrSr S	         S
S jjrS r\R                  " S5      S 5       r	S r
Srg)InElementImpli/  rd   Nc                ~   UR                   (       a  [        U[        R                  5      (       aI  UR                  R
                  (       a.  U R                  U5        U R                  " UR                  40 UD6$ U R                  U5        U R                  " UR                  5       40 UD6$ U R                  XU5        g rc   )
r   rA   r$   AliasrD   r   _warn_for_implicit_coercionr   selectr   r   s        rE   r   !InElementImpl._implicit_coercions2  s     ##8Z%5%566$$4400:**8+;+;BrBB00:**8??+<CCC$$Wx@rG   c                ^    [         R                  " SUR                  R                  -  5        g )Nz_Coercing %s object into a select() for use in IN(); please pass a select() construct explicitly)r   r   r   r   )r   rP   s     rE   rY  )InElementImpl._warn_for_implicit_coercionF  s%    		:~~&&(	
rG   zsqlalchemy.sql.elementsc          	        [         R                  " U5      (       a  0 n[        U5      nU Hr  n[        U5      (       a  M  [	        U[         R
                  R                  R                  5      (       d&  [        US5      (       d  U R                  " U40 UD6  Mn  XeU'   Mt     U(       a<  [        R                  " U Vs/ s H  nXe;   a  XV   OUR                  X65      PM     sn6 $ UR                  X1SS9$ U R                  " U40 UD6  g s  snf )Nr@   T)	expanding)r   is_non_string_iterablerY   rF   rA   	preloadedsql_elementsr.   rC   r   r!   
ClauseListrN  )r   rD   r   rO  rg   non_literal_expressionsos          rE   r   InElementImpl._literal_coercionM  s   &&w//  $ 7mG"1~~%4>>66DD %a)=>>00?B? 672  '** ") ")A  !; 46!%!1!1(!>? ")	 	 ''T'JJ $$W33s   <$Dc                  UR                   (       a  UR                  5       $ [        U[        R                  5      (       a*  [        UR                  5      S:X  a   eUR                  US9$ [        U[        R                  5      (       a  UR                  SS9nSUl
        X1l        U$ [        U[        R                  5      (       a  UR                  5       $ U$ )Nr   )againstT)maintain_key)r   r   rA   r!   rc  r\   clauses
self_groupr+   _cloner_  	expand_opr$   rF  scalar_values)r   rD   r   rO  rg   s        rE   r   InElementImpl._post_coercionp  s    "" **,,!4!4557??+q000%%h%77!7!788nn$n7G $G (N!2!233((**NrG   rc   r   )r   r   r   r   r   r   rY  r   preload_moduler   r   r   rd   rG   rE   rV  rV  /  sr    I "&	AA A 	A
 A 
A(
 
23 4 4 4DrG   rV  c                  0    \ rS rSrSrSrS rSS.S jrSrg)OnClauseImpli  rd   Tc                &    U R                  U5        g rc   r   r   s      rE   r   OnClauseImpl._literal_coercion  s      )rG   N)r   c               H    [        U[        R                  5      (       a  U$ U$ rc   )rA   r   JoinTargetRole)r   r   r   rg   s       rE   r   OnClauseImpl._post_coercion  s#     &(<(<==##rG   )	r   r   r   r   r   r  r   r   r   rd   rG   rE   rr  rr    s!    IN* <@  rG   rr  c                  &    \ rS rSrSrSrSS jrSrg)WhereHavingImpli  rd   TNc                    [        X5      $ rc   r  r  s      rE   r  WhereHavingImpl._text_coercion  r  rG   rc   r   r   r   r   r   r  r  r   rd   rG   rE   ry  ry    s    IN3rG   ry  c                  &    \ rS rSrSrSrSS jrSrg)StatementOptionImpli  rd   TNc                .    [         R                  " U5      $ rc   r!   r1   r  s      rE   r  "StatementOptionImpl._text_coercion  s    ""7++rG   rc   r|  rd   rG   rE   r~  r~    s    IN,rG   r~  c                      \ rS rSrSrSrg)ColumnArgumentImpli  rd   Nr   r   r   r   r   r   rd   rG   rE   r  r        IrG   r  c                      \ rS rSrSrSrg)ColumnArgumentOrKeyImpli  rd   Nr  rd   rG   rE   r  r    r  rG   r  c                  "    \ rS rSrSrSS jrSrg)StrAsPlainColumnImpli  rd   Nc                .    [         R                  " U5      $ rc   )r!   r-   r  s      rE   r  #StrAsPlainColumnImpl._text_coercion  s    $$W--rG   rc   )r   r   r   r   r   r  r   rd   rG   rE   r  r    s    I.rG   r  c                  &    \ rS rSrSrSrSS jrSrg)ByOfImpli  rd   TNc                .    [         R                  " U5      $ rc   )r!   _textual_label_referencer  s      rE   r  ByOfImpl._text_coercion  s    0099rG   rc   r|  rd   rG   rE   r  r    s    IN:rG   r  c                      \ rS rSrSrS rSrg)OrderByImpli  rd   c                    [        XR                  5      (       a#  UR                  b  [        R                  " U5      $ U$ rc   )rA   r   _order_by_label_elementr!   _label_reference)r   r   rg   s      rE   r   OrderByImpl._post_coercion  s5    x!1!12200<,,X66OrG   Nr   rd   rG   rE   r  r    s    IrG   r  c                  :    \ rS rSrSr S         SS jjrSrg)GroupByImpli  rd   Nc                `    [        U5      (       a  [        R                  " UR                  6 $ U$ rc   )r   r!   rc  cr   s        rE   r   GroupByImpl._implicit_coercions  s)     (##&&

33OrG   rc   r   r   r   r   r   r   r   r   rd   rG   rE   r  r    sF    I "&	

 
 	

 
 

 
rG   r  c                  &    \ rS rSrSrSS.S jrSrg)DMLColumnImpli  rd   Frj   c               ,    U(       a  UR                   $ U$ rc   )key)r   rD   rk   rg   s       rE   r   DMLColumnImpl._post_coercion  s    ;;NrG   Nr   rd   rG   rE   r  r    s    I05  rG   r  c                  &    \ rS rSrSrSS.S jrSrg)ConstExprImpli  rd   Nr  c                   Uc  [         R                  " 5       $ USL a  [         R                  " 5       $ USL a  [         R                  " 5       $ U R	                  X5        g )NFT)r!   r  r  r  r   r  s       rE   r   ConstExprImpl._literal_coercion  sJ    ?==?"??$$_>>##$$W6rG   r  rd   rG   rE   r  r    s    I48 7 7rG   r  c                  @    \ rS rSrSr S         SS jjrS rSrg)TruncatedLabelImpli  rd   Nc                V    [        U[        5      (       a  U$ U R                  XU5        g rc   r   r   s        rE   r   &TruncatedLabelImpl._implicit_coercions  s&     gs##O$$Wx@rG   c                p    [        U[        R                  5      (       a  U$ [        R                  " U5      $ )zcoerce the given value to :class:`._truncated_label`.

Existing :class:`._truncated_label` and
:class:`._anonymous_label` objects are passed
unchanged.
)rA   r!   _truncated_labelr   s      rE   r   $TruncatedLabelImpl._literal_coercion  s-     gx8899N,,W55rG   rc   r   r   rd   rG   rE   r  r    sL    I "&	
A
A 
A 	
A
 
A 

A6rG   r  c                  &    \ rS rSrSrSrSS jrSrg)DDLExpressionImpli  rd   TNc                .    [         R                  " U5      $ rc   r  r  s      rE   r   DDLExpressionImpl._text_coercion  s    
 ""7++rG   rc   r|  rd   rG   rE   r  r    s    IN,rG   r  c                      \ rS rSrSrSrg)DDLConstraintColumnImpli!  rd   Nr  rd   rG   rE   r  r  !  r  rG   r  c                      \ rS rSrSrSrg)DDLReferredColumnImpli%  rd   Nr  rd   rG   rE   r  r  %  r  rG   r  c                  @    \ rS rSrSr S         SS jjrS rSrg)LimitOffsetImpli)  rd   Nc                0    Uc  g U R                  XU5        g rc   r   r   s        rE   r   #LimitOffsetImpl._implicit_coercions,  s     $$Wx@rG   c               b    Uc  g [         R                  " U5      n[        R                  " X%USS9$ )NT)r  r!  )r   asintr$   _OffsetLimitParam)r   rD   r   r  rg   values         rE   r   !LimitOffsetImpl._literal_coercion8  s4     ?JJw'E//5 rG   rc   r   r   rd   rG   rE   r  r  )  sL    I "&	
A
A 
A 	
A
 
A 

A	rG   r  c                  H   ^  \ rS rSrSr S         SU 4S jjjrSrU =r$ )LabeledColumnExprImpliD  rd   c                  > [        U[        R                  5      (       a  UR                  S 5      $ [        TU ]  " X4SU0UD6n[        U[        R                  5      (       a  UR                  S 5      $ U R                  XU5        g Nr   )rA   r   ExpressionElementRolelabelr*  r   r   )r   rD   r   r   rg   newr   s         rE   r   )LabeledColumnExprImpl._implicit_coercionsG  s|     h ; ;<<>>$'''-+268C #u::;;yy&((8DrG   rc   r   )r   r   r   r   r   r   r   r-  r.  s   @rE   r  r  D  sN    I "&	EE E 	E
 E 
E ErG   r  c                     ^  \ rS rSrSrSrSrSr\R                  " S\R                  5      r S	SS.U 4S jjjrS
S jrSrU =r$ )ColumnsClauseImpliZ  rd   Tz^\w\S*$N)r   c                  > U(       d1  [        U[        5      (       a  SSR                  S U 5       5       S3n[        TU ]  " U4X#US.UD6$ )NzDid you mean to say select(z, c              3  8   #    U  H  n[        U5      v   M     g 7frc   )r   ).0es     rE   	<genexpr>8ColumnsClauseImpl._raise_for_expected.<locals>.<genexpr>i  s     6gT!WWgs   z)?rE  )rA   rY   joinr*  r   )r   rD   r   r   r   rg   r   s         rE   r   %ColumnsClauseImpl._raise_for_expectedc  sa     *Wd33-996g667r; 
 w*
$
JL
 	
rG   c                    [        U5      nU R                  R                  U5      (       + n[        R                  " S[
        R                  " U5      U(       a  SU< 3OSU(       a  SOSS.-  5      e)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  )rJ   _guess_straight_columnmatchr   r]   r   r   )r   rD   r   guess_is_literals       rE   r   ColumnsClauseImpl._text_coercionp  si    g,#::@@II#
 ..w7=D9"(8$h		

 	
rG   r   rc   )r   r   r   r   r   r  r  r  recompileIr  r   r  r   r-  r.  s   @rE   r  r  Z  sN    INLZZ
BDD9 /3
>B
 

 
rG   r  c                      \ rS rSrSrSrg)ReturnsRowsImpli  rd   Nr  rd   rG   rE   r  r    r  rG   r  c                  V   ^  \ rS rSrSrSS.S jr S         SU 4S jjjrSrU =r$ )	StatementImpli  rd   Nr  c                   XLa$  [        U[        5      (       d   UR                    U$ U$ ! [         a    [        R
                  " SU-  S5         U$ f = f)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)rA   rJ   _execute_on_connectionr   r   warn_deprecated)r   r   r   r   rg   s        rE   r   StatementImpl._post_coercion  sn     +Jc5
 5

 77 x " 
$$ "22 	 
s   + $AAc                P   > UR                   (       a  U$ [        TU ]  " X4SU0UD6$ r  )r   r*  r   )r   rD   r   r   rg   r   s        rE   r   !StatementImpl._implicit_coercions  s8     &&O7.+268 rG   rc   r   )	r   r   r   r   r   r   r   r   r-  r.  s   @rE   r  r    sQ    I 6:8 "&	  	
  
 rG   r  c                  :    \ rS rSrSr S         SS jjrSrg)SelectStatementImpli  rd   Nc                j    UR                   (       a  UR                  5       $ U R                  XU5        g rc   )_is_text_clausecolumnsr   r   s        rE   r   'SelectStatementImpl._implicit_coercions  s,     ####%%$$Wx@rG   rc   r   r  rd   rG   rE   r  r    sM    I "&	
A
A 
A 	
A
 
A 

A 
ArG   r  c                      \ rS rSrSrSrg)
HasCTEImpli  rd   Nr  rd   rG   rE   r  r    r  rG   r  c                      \ rS rSrSrSrg)	IsCTEImpli  rd   Nr  rd   rG   rE   r  r    r  rG   r  c                  X    \ rS rSrSrSrSS.S jr S
SS.           SS	 jjjrSrg)JoinTargetImpli  rd   TNr  c               &    U R                  X5        g rc   r   r  s       rE   r    JoinTargetImpl._literal_coercion  s      2rG   F)legacyc                   [        U[        R                  5      (       a  U$ U(       a(  UR                  (       a  [        R
                  " SSS9  U$ U R                  XU5        g 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)rA   r   rv  r   r   r  r   )r   rD   r   r   r  rg   s         rE   r   "JoinTargetImpl._implicit_coercions  sX     gu3344 N00  6  O$$Wx@rG   rc   )rD   r   r   r   r   r   r  boolrg   r   r   r   )	r   r   r   r   r   r   r   r   r   rd   rG   rE   r  r    sq    I+/(48 3 "&	A AA A 	A A A 
A ArG   r  c                  Z    \ rS rSrSr S
SSS.             SS jjjrSS.S	 jrSrg)FromClauseImpli  rd   NFT)rz   allow_selectc                   UR                   (       a@  U(       a  UR                  5       $ U(       a!  [        R                  " SSS9  UR                  $ g UR
                  (       a  U$ U R                  XU5        g r  )r   subqueryr   r  _implicit_subqueryr  r   )r   rD   r   r   rz   r  rg   s          rE   r   "FromClauseImpl._implicit_coercions  sm     ## ((**$$: "  222  %%O$$Wx@rG   )
deannotatec               4    U(       a  UR                  5       $ U$ rc   )_deannotate)r   rD   r  rg   s       rE   r   FromClauseImpl._post_coercion  s    &&((NrG   rc   )rD   r   r   r   r   r   rz   r  r  r  rg   r   r   r   )r   r   r   r   r   r   r   r   rd   rG   rE   r  r    sz    I "&	A #(!AA A 	A  A A A 
A6 5:  rG   r  c                  F    \ rS rSrSr SSS.           SS jjjrSrg)	StrictFromClauseImpli  rd   NF)r  c                   UR                   (       a(  U(       a!  [        R                  " SSS9  UR                  $ U R	                  XU5        g r  )r   r   r  r  r   )r   rD   r   r   r  rg   s         rE   r   (StrictFromClauseImpl._implicit_coercions  sE     ##  #  ...$$Wx@rG   rc   )rD   r   r   r   r   r   r  r  rg   r   r   r   r  rd   rG   rE   r  r    sc    I "&	A #AA A 	A A A 
A ArG   r  c                  (    \ rS rSrSrSSS.S jrSrg)AnonymizedFromClauseImpli.  rd   FN)flatr   c               *    Ub   eUR                  US9$ )N)r	  )_anonymous_fromclause)r   rD   r	  r   rg   s        rE   r   'AnonymizedFromClauseImpl._post_coercion1  s     ||,,$,77rG   r   rd   rG   rE   r  r  .  s    I.3$ 8 8rG   r  c                      \ rS rSrSrS rSrg)DMLTableImpli7  rd   c                D    SUR                   ;   a  UR                   S   $ U$ )N	dml_table)_annotationsr   s      rE   r   DMLTableImpl._post_coercion:  s&    '...''44NrG   Nr   rd   rG   rE   r  r  7  s    IrG   r  c                  :    \ rS rSrSr S         SS jjrSrg)DMLSelectImpliA  rd   Nc                    UR                   (       aV  [        U[        R                  5      (       a'  UR                  R
                  (       a  UR                  $ UR                  5       $ U R                  XU5        g rc   )r   rA   r$   rX  rD   r   rZ  r   r   s        rE   r   !DMLSelectImpl._implicit_coercionsD  sX     ##8Z%5%566$$44'''(($$Wx@rG   rc   r   r  rd   rG   rE   r  r  A  sM    I "&	AA A 	A
 A 
A ArG   r  c                  0   ^  \ rS rSrSrSU 4S jjrSrU =r$ )CompoundElementImpliW  rd   c                   > [        U[        R                  5      (       a  UR                  (       a  SnOSnOS n[        TU ]  " U4X#US.UD6$ )NzFUse the plain select() object without calling .subquery() or .alias().z9To SELECT from any FROM clause, use the .select() method.rE  )rA   r   FromClauseRole_is_subqueryr*  r   rH  s         rE   r   'CompoundElementImpl._raise_for_expectedZ  sb    gu3344##7  P  Fw*
$
JL
 	
rG   r   r,  r.  s   @rE   r  r  W  s    I
 
rG   r  RoleImpl)rD   r   r   r  )rS   rJ   rT   rJ   rU   rJ   r   zCallable[[_F], _F])r^   rJ   r_   rJ   r`   z+Union[Sequence[_T], Sequence[Sequence[_T]]]r   rX   )rf   zType[roles.TruncatedLabelRole]rD   r   rg   r   r   rJ   )
rf   Type[roles.DMLColumnRole]rD   r   rk   Literal[True]rg   r   r   rJ   )rf   zType[roles.LiteralValueRole]rD   r   rg   r   r   zBindParameter[Any])rf   z!Type[roles.DDLReferredColumnRole]rD   r   rg   r   r   Union[Column[Any], str])rf   #Type[roles.DDLConstraintColumnRole]rD   r   rg   r   r   r!  )rf   zType[roles.StatementOptionRole]rD   r   rg   r   r   z%Union[ColumnElement[Any], TextClause])rf   z&Type[roles.LabeledColumnExprRole[Any]]rD   _ColumnExpressionArgument[_T]rg   r   r   zNamedColumn[_T])rf   zgUnion[Type[roles.ExpressionElementRole[Any]], Type[roles.LimitOffsetRole], Type[roles.WhereHavingRole]]rD   r#  rg   r   r   zColumnElement[_T])rf   zUnion[Type[roles.ExpressionElementRole[Any]], Type[roles.LimitOffsetRole], Type[roles.WhereHavingRole], Type[roles.OnClauseRole], Type[roles.ColumnArgumentRole]]rD   r   rg   r   r   zColumnElement[Any])rf   zType[roles.DMLTableRole]rD   r(   rg   r   r   r*   )rf   zType[roles.HasCTERole]rD   r6   rg   r   r   r6   )rf   zType[roles.SelectStatementRole]rD   r7   rg   r   r   r7   )rf   Type[roles.FromClauseRole]rD   r)   rg   r   r   r5   )
rf   r$  rD   r7   rz   r   rg   r   r   r8   )rf   zType[roles.ColumnsClauseRole]rD   z_ColumnsClauseArgument[Any]rg   r   r   r3   )rf   zType[roles.JoinTargetRole]rD   r4   rg   r   r   r4   )rf   	Type[_SR]rD   r   rg   r   r   r   )rf   r%  rD   r   r   zOptional[ClauseElement]r   r   r   r  r   r  rg   r   r   r   )rf   r  rD   r   rg   r   r   rJ   )rf   r"  r   zIterable[_DDLColumnArgument]r   zwIterator[Tuple[Union[str, Column[Any]], Optional[ColumnClause[Any]], Optional[str], Optional[Union[Column[Any], str]]]])rD   r   r   r   r   zType[exc.SQLAlchemyError]r   r   r   r   r   r   )
__future__r   collections.abcabcrI   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.   r/   r0   r1   r2   r3   r4   r5   r6   r7   r8   r9   SQLRoler:   r<   
StringRoler=   r>   rF   rK   rV   ra   rh   r   r   r   r   r   r   r   r]   r   r  r	  r  r&  r0  r7  r=  rK  rV  rr  ry  r~  r  r  r  ByOfRoler  r  r  r  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  rJ   floatpy_typerd   rG   rE   <module>r:     sI	   # )  	                     # "  "     !	2/+*,%''&'%+$1/&"&$/e5==)T#s(+,~U-=-=>T	5#L!.1 &&& 6& 	&$ 

(  		 
 

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

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

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

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