o uTh @s6ddlmZddlmZddlmZddlmZddlmZddlmZdd l m Z dd l m Z dd l m Z dd lmZdd lmZddlmZddlmZddlmZddlmZddlmZddlmZddlmZddlmZdZd%ddZ GdddeZGdddeZ!Gd d!d!e!Z"Gd"d#d#e!Z#d$S)&) annotations)Any)_OnConflictIndexElementsT)_OnConflictIndexWhereT)_OnConflictSetT)_OnConflictWhereT)util) coercions)roles)_DMLTableArgument)_exclusive_against) _generative)ColumnCollection)ReadOnlyColumnCollectionInsert) ClauseElement)KeyedColumnElement)alias)Self)rinserttabler returnrcCst|S)aWConstruct 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)rr_/home/air/segue/gemini/back/venv/lib/python3.10/site-packages/sqlalchemy/dialects/sqlite/dml.pyr src@sleZdZdZdZdZejdddZe ddd id Z e e ddddZ e e ddddZ d S)ra?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` sqliteFr6ReadOnlyColumnCollection[str, KeyedColumnElement[Any]]cCst|jddjS)aProvide 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)rrcolumns)selfrrrrGszInsert.excluded_post_values_clausezCThis Insert construct already has an ON CONFLICT clause established)msgsNindex_elementsr index_whererset_rwhererrcCst|||||_|S)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. If present, can be a literal SQL string or an acceptable expression for 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"r%r&r'r(rrron_conflict_do_updategs1zInsert.on_conflict_do_updatecCst|||_|S)a 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"r%r&rrron_conflict_do_nothingszInsert.on_conflict_do_nothing)rrNNNN) r%rr&rr'rr(rrrNN)r%rr&rrr)__name__ __module__ __qualname____doc__stringify_dialect inherit_cacher memoized_propertyrr_on_conflict_exclusiverr+r.rrrrr4s. 4c@s:eZdZUdZded<ded<ded<  d dd d ZdS)OnConflictClauserNoneconstraint_targetrinferred_target_elementsrinferred_target_whereclauseNr%r&cCs4|durd|_||_||_dSd|_|_|_dS)N)r;r<r=r-rrr__init__s  zOnConflictClause.__init__r0)r%rr&r)r1r2r3r5__annotations__r>rrrrr9s r9c@seZdZdZdS)r,r.N)r1r2r3__visit_name__rrrrr,sr,cs,eZdZdZ    d dfd d ZZS)r)r+Nr%rr&rr'rr(rcsbtj||dt|tr|stdnt|trt|}ntddd|D|_||_dS)N)r%r&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 objectcSs"g|] \}}ttj||fqSr)r expectr DMLColumnRole).0keyvaluerrr sz/OnConflictDoUpdate.__init__..) superr> isinstancedict ValueErrorritemsupdate_values_to_setupdate_whereclauser* __class__rrr>s"    zOnConflictDoUpdate.__init__r/)r%rr&rr'rr(r)r1r2r3r@r> __classcell__rrrNrr)sr)N)rr rr)$ __future__rtypingr_typingrrrrr sqlr r sql._typingr sql.baserrrrsql.dmlrStandardInsert sql.elementsrrsql.expressionr util.typingr__all__rr9r,r)rrrrs4