
    ,h#                       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r&S(S jr' " S  S\5      r " S! S"\5      r( " S# S$\(5      r) " S% S&\(5      r*g'))    )annotations)Any)List)Optional)Tuple)Union   )_OnConflictIndexElementsT)_OnConflictIndexWhereT)_OnConflictSetT)_OnConflictWhereT   )util)	coercions)roles)schema)_DMLTableArgument)_exclusive_against)_generative)ColumnCollection)ReadOnlyColumnCollectionInsert)ClauseElement)ColumnElement)KeyedColumnElement)
TextClause)alias)Self)r   insertr   c                    [        U 5      $ )a+  Construct a sqlite-specific variant :class:`_sqlite.Insert`
construct.

.. container:: inherited_member

    The :func:`sqlalchemy.dialects.sqlite.insert` function creates
    a :class:`sqlalchemy.dialects.sqlite.Insert`.  This class is based
    on the dialect-agnostic :class:`_sql.Insert` construct which may
    be constructed using the :func:`_sql.insert` function in
    SQLAlchemy Core.

The :class:`_sqlite.Insert` construct includes additional methods
:meth:`_sqlite.Insert.on_conflict_do_update`,
:meth:`_sqlite.Insert.on_conflict_do_nothing`.

r   )tables    V/var/www/auris/envauris/lib/python3.13/site-packages/sqlalchemy/dialects/sqlite/dml.pyr    r    '   s    " %=    c                      \ rS rSrSrSrSr\R                    SS j5       r	\
" SSS0S9r\\    S         SS
 jj5       5       r\\  S     SS jj5       5       rSrg	)r   ;   a#  SQLite-specific implementation of INSERT.

Adds methods for SQLite-specific syntaxes such as ON CONFLICT.

The :class:`_sqlite.Insert` object is created using the
:func:`sqlalchemy.dialects.sqlite.insert` function.

.. versionadded:: 1.4

.. seealso::

    :ref:`sqlite_on_conflict_insert`

sqliteFc                >    [        U R                  SS9R                  $ )aj  Provide the ``excluded`` namespace for an ON CONFLICT statement

SQLite's ON CONFLICT clause allows reference to the row that would
be inserted, known as ``excluded``.  This attribute provides
all columns in this row to be referenceable.

.. tip::  The :attr:`_sqlite.Insert.excluded` attribute is an instance
    of :class:`_expression.ColumnCollection`, which provides an
    interface the same as that of the :attr:`_schema.Table.c`
    collection described at :ref:`metadata_tables_and_columns`.
    With this collection, ordinary names are accessible like attributes
    (e.g. ``stmt.excluded.some_column``), but special names and
    dictionary method names should be accessed using indexed access,
    such as ``stmt.excluded["column name"]`` or
    ``stmt.excluded["values"]``.  See the docstring for
    :class:`_expression.ColumnCollection` for further examples.

excluded)name)r   r"   columns)selfs    r#   r)   Insert.excludedN   s    , TZZj1999r$   _post_values_clausezCThis Insert construct already has an ON CONFLICT clause established)msgsNc                (    [        XX45      U l        U $ )a  
Specifies a DO UPDATE SET action for ON CONFLICT clause.

:param index_elements:
 A sequence consisting of string column names, :class:`_schema.Column`
 objects, or other column expression objects that will be used
 to infer a target index or unique constraint.

:param index_where:
 Additional WHERE criterion that can be used to infer a
 conditional target index.

:param set\_:
 A dictionary or other mapping object
 where the keys are either names of columns in the target table,
 or :class:`_schema.Column` objects or other ORM-mapped columns
 matching that of the target table, and expressions or literals
 as values, specifying the ``SET`` actions to take.

 .. versionadded:: 1.4 The
    :paramref:`_sqlite.Insert.on_conflict_do_update.set_`
    parameter supports :class:`_schema.Column` objects from the target
    :class:`_schema.Table` as keys.

 .. warning:: This dictionary does **not** take into account
    Python-specified default UPDATE values or generation functions,
    e.g. those specified using :paramref:`_schema.Column.onupdate`.
    These values will not be exercised for an ON CONFLICT style of
    UPDATE, unless they are manually specified in the
    :paramref:`.Insert.on_conflict_do_update.set_` dictionary.

:param where:
 Optional argument. An expression object representing a ``WHERE``
 clause that restricts the rows affected by ``DO UPDATE SET``. Rows not
 meeting the ``WHERE`` condition will not be updated (effectively a
 ``DO NOTHING`` for those rows).

)OnConflictDoUpdater.   )r,   index_elementsindex_whereset_wheres        r#   on_conflict_do_updateInsert.on_conflict_do_updaten   s    ` $6$
  r$   c                &    [        X5      U l        U $ )am  
Specifies a DO NOTHING action for ON CONFLICT clause.

:param index_elements:
 A sequence consisting of string column names, :class:`_schema.Column`
 objects, or other column expression objects that will be used
 to infer a target index or unique constraint.

:param index_where:
 Additional WHERE criterion that can be used to infer a
 conditional target index.

)OnConflictDoNothingr.   )r,   r2   r3   s      r#   on_conflict_do_nothingInsert.on_conflict_do_nothing   s    * $7$
  r$   )r.   )returnz6ReadOnlyColumnCollection[str, KeyedColumnElement[Any]]NNNN)
r2   r
   r3   r   r4   r   r5   r   r<   r   NN)r2   r
   r3   r   r<   r   )__name__
__module____qualname____firstlineno____doc__stringify_dialectinherit_cacher   memoized_propertyr)   r   _on_conflict_exclusiver   r6   r:   __static_attributes__ r$   r#   r   r   ;   s     !M	:	?: :. 0! $0
  59.2 $#'111 ,1 	1
 !1 
1  1f  59.21 , 
	  r$   c                  F    \ rS rSr% SrS\S'   S\S'     S
   SS jjrS	rg)OnConflictClause   r'   z.Optional[List[Union[str, schema.Column[Any]]]]inferred_target_elementsz/Optional[Union[ColumnElement[Any], TextClause]]inferred_target_whereclauseNc                   Ubk  U Vs/ s H(  n[         R                  " [        R                  U5      PM*     snU l        Ub%  [         R                  " [        R
                  U5      OS U l        g S =U l        U l        g s  snf )N)r   expectr   DDLConstraintColumnRolerM   WhereHavingRolerN   )r,   r2   r3   columns       r#   __init__OnConflictClause.__init__   s    
 % --,F   !>!>G,-D) *	   ))
  , D)0-s   /A>)rM   rN   r>   )r2   r
   r3   r   )r?   r@   rA   rB   rD   __annotations__rT   rH   rI   r$   r#   rK   rK      s<     LL"  59.21 , r$   rK   c                      \ rS rSrSrSrg)r9      r:   rI   N)r?   r@   rA   rB   __visit_name__rH   rI   r$   r#   r9   r9      s    -Nr$   r9   c                  `   ^  \ rS rSr% SrS\S'   S\S'       S	       S
U 4S jjjrSrU =r$ )r1      r6   z0List[Tuple[Union[schema.Column[Any], str], Any]]update_values_to_setzOptional[ColumnElement[Any]]update_whereclausec                  > [         TU ]  UUS9  [        U[        5      (       a  U(       d  [	        S5      eO,[        U[
        5      (       a  [        U5      nO[	        S5      eUR                  5        VVs/ s H,  u  pV[        R                  " [        R                  U5      U4PM.     snnU l        Ub+  [        R                  " [        R                  U5      U l        g S U l        g s  snnf )N)r2   r3   z*set parameter dictionary must not be emptyzqset parameter must be a non-empty dictionary or a ColumnCollection such as the `.c.` collection of a Table object)superrT   
isinstancedict
ValueErrorr   itemsr   rP   r   DMLColumnRoler\   rR   r]   )r,   r2   r3   r4   r5   keyvalue	__class__s          r#   rT   OnConflictDoUpdate.__init__   s     	)# 	 	

 dD!! !MNN .//:D$  #jjl%
*
 e1137?*%
!   U22E: 	  		%
s   73C))r\   r]   r=   )r2   r
   r3   r   r4   r   r5   r   )	r?   r@   rA   rB   rY   rV   rT   rH   __classcell__)rg   s   @r#   r1   r1      sR    ,NJJ44 59.2 $#'
1
 ,
 	

 !
 
r$   r1   N)r"   r   r<   r   )+
__future__r   typingr   r   r   r   r   _typingr
   r   r   r    r   sqlr   r   r   sql._typingr   sql.baser   r   r   r   sql.dmlr   StandardInsertsql.elementsr   r   r   r   sql.expressionr   util.typingr   __all__r    rK   r9   r1   rI   r$   r#   <module>rw      s    #      / , % '     , * # ( 0 / ) ) . & # 
(@^ @F} @.* .%
) %
r$   