sqlalchemy-upsert-kit 0.1.1__tar.gz

sqlalchemy_upsert_kit-0.1.1/AUTHORS.rst

@@ -0,0 +1,15 @@
+.. _about_author:
+
+About the Author
+------------------------------------------------------------------------------
+::
+
+   (\ (\
+   ( -.-)o
+   o_(")(")
+
+**Sanhe Hu** is a seasoned software engineer with a deep passion for Python development since 2010. As an author and maintainer of `150+ open-source Python projects <https://pypi.org/user/machugwu/>`_, with over `15 million monthly downloads <https://github.com/MacHu-GWU>`_, I bring a wealth of experience to the table. As a Senior Solution Architect and Subject Matter Expert in AI, Data, Amazon Web Services, Cloud Engineering, DevOps, I thrive on helping clients with platform design, enterprise architecture, and strategic roadmaps.
+
+Talk is cheap, show me the code:
+
+- My Github: https://github.com/MacHu-GWU

sqlalchemy_upsert_kit-0.1.1/LICENSE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Sanhe Hu <husanhe@email.com>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

sqlalchemy_upsert_kit-0.1.1/PKG-INFO

@@ -0,0 +1,119 @@
+Metadata-Version: 2.3
+Name: sqlalchemy_upsert_kit
+Version: 0.1.1
+Summary: High-performance SQLAlchemy bulk upsert operations using temporary table staging - 20x faster than row-by-row approaches.
+License: MIT
+Author: Sanhe Hu
+Author-email: husanhe@email.com
+Maintainer: Sanhe Hu
+Maintainer-email: husanhe@email.com
+Requires-Python: >=3.9,<4.0
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Provides-Extra: auto
+Provides-Extra: dev
+Provides-Extra: doc
+Provides-Extra: test
+Requires-Dist: Sphinx (>=7.4.7,<8.0.0) ; extra == "doc"
+Requires-Dist: build (>=1.2.1,<2.0.0) ; extra == "dev"
+Requires-Dist: docfly (==3.0.0) ; extra == "doc"
+Requires-Dist: furo (==2024.8.6) ; extra == "doc"
+Requires-Dist: ipython (>=8.18.1,<8.19.0) ; extra == "doc"
+Requires-Dist: nbsphinx (>=0.8.12,<1.0.0) ; extra == "doc"
+Requires-Dist: prettytable (>=3.0.0,<4.0.0) ; extra == "test"
+Requires-Dist: pygments (>=2.18.0,<3.0.0) ; extra == "doc"
+Requires-Dist: pytest (>=8.2.2,<9.0.0) ; extra == "test"
+Requires-Dist: pytest-cov (>=6.0.0,<7.0.0) ; extra == "test"
+Requires-Dist: rich (>=13.8.1,<14.0.0) ; extra == "dev"
+Requires-Dist: rstobj (==1.2.1) ; extra == "doc"
+Requires-Dist: sphinx-copybutton (>=0.5.2,<1.0.0) ; extra == "doc"
+Requires-Dist: sphinx-design (>=0.6.1,<1.0.0) ; extra == "doc"
+Requires-Dist: sphinx-jinja (>=2.0.2,<3.0.0) ; extra == "doc"
+Requires-Dist: sqlalchemy (>=2.0.0,<3.0.0)
+Requires-Dist: twine (>=6.0.0,<7.0.0) ; extra == "dev"
+Requires-Dist: wheel (>=0.45.0,<1.0.0) ; extra == "dev"
+Project-URL: Changelog, https://github.com/MacHu-GWU/sqlalchemy_upsert_kit-project/blob/main/release-history.rst
+Project-URL: Documentation, https://sqlalchemy-upsert-kit.readthedocs.io/en/latest/
+Project-URL: Download, https://pypi.org/pypi/sqlalchemy-upsert-kit#files
+Project-URL: Homepage, https://github.com/MacHu-GWU/sqlalchemy_upsert_kit-project
+Project-URL: Issues, https://github.com/MacHu-GWU/sqlalchemy_upsert_kit-project/issues
+Project-URL: Repository, https://github.com/MacHu-GWU/sqlalchemy_upsert_kit-project
+Description-Content-Type: text/x-rst
+
+
+.. image:: https://readthedocs.org/projects/sqlalchemy-upsert-kit/badge/?version=latest
+    :target: https://sqlalchemy-upsert-kit.readthedocs.io/en/latest/
+    :alt: Documentation Status
+
+.. image:: https://github.com/MacHu-GWU/sqlalchemy_upsert_kit-project/actions/workflows/main.yml/badge.svg
+    :target: https://github.com/MacHu-GWU/sqlalchemy_upsert_kit-project/actions?query=workflow:CI
+
+.. image:: https://codecov.io/gh/MacHu-GWU/sqlalchemy_upsert_kit-project/branch/main/graph/badge.svg
+    :target: https://codecov.io/gh/MacHu-GWU/sqlalchemy_upsert_kit-project
+
+.. image:: https://img.shields.io/pypi/v/sqlalchemy-upsert-kit.svg
+    :target: https://pypi.python.org/pypi/sqlalchemy-upsert-kit
+
+.. image:: https://img.shields.io/pypi/l/sqlalchemy-upsert-kit.svg
+    :target: https://pypi.python.org/pypi/sqlalchemy-upsert-kit
+
+.. image:: https://img.shields.io/pypi/pyversions/sqlalchemy-upsert-kit.svg
+    :target: https://pypi.python.org/pypi/sqlalchemy-upsert-kit
+
+.. image:: https://img.shields.io/badge/✍️_Release_History!--None.svg?style=social&logo=github
+    :target: https://github.com/MacHu-GWU/sqlalchemy_upsert_kit-project/blob/main/release-history.rst
+
+.. image:: https://img.shields.io/badge/⭐_Star_me_on_GitHub!--None.svg?style=social&logo=github
+    :target: https://github.com/MacHu-GWU/sqlalchemy_upsert_kit-project
+
+------
+
+.. image:: https://img.shields.io/badge/Link-API-blue.svg
+    :target: https://sqlalchemy-upsert-kit.readthedocs.io/en/latest/py-modindex.html
+
+.. image:: https://img.shields.io/badge/Link-Install-blue.svg
+    :target: `install`_
+
+.. image:: https://img.shields.io/badge/Link-GitHub-blue.svg
+    :target: https://github.com/MacHu-GWU/sqlalchemy_upsert_kit-project
+
+.. image:: https://img.shields.io/badge/Link-Submit_Issue-blue.svg
+    :target: https://github.com/MacHu-GWU/sqlalchemy_upsert_kit-project/issues
+
+.. image:: https://img.shields.io/badge/Link-Request_Feature-blue.svg
+    :target: https://github.com/MacHu-GWU/sqlalchemy_upsert_kit-project/issues
+
+.. image:: https://img.shields.io/badge/Link-Download-blue.svg
+    :target: https://pypi.org/pypi/sqlalchemy-upsert-kit#files
+
+
+Welcome to ``sqlalchemy_upsert_kit`` Documentation
+==============================================================================
+.. image:: https://sqlalchemy-upsert-kit.readthedocs.io/en/latest/_static/sqlalchemy_upsert_kit-logo.png
+    :target: https://sqlalchemy-upsert-kit.readthedocs.io/en/latest/
+
+``sqlalchemy_upsert_kit`` provides high-performance bulk upsert operations for SQLAlchemy applications using temporary table staging. It offers three optimized strategies: ``insert_or_ignore`` for conflict-free insertion, ``insert_or_replace`` for complete record replacement, and ``insert_or_merge`` for selective column updates while preserving existing data. Each strategy leverages efficient SQL JOIN operations and temporary tables to achieve ~20x performance improvements over traditional row-by-row upserts, making it ideal for ETL processes, data synchronization, and bulk data operations where speed and reliability are critical.
+
+
+.. _install:
+
+Install
+------------------------------------------------------------------------------
+
+``sqlalchemy_upsert_kit`` is released on PyPI, so all you need is to:
+
+.. code-block:: console
+
+    $ pip install sqlalchemy-upsert-kit
+
+To upgrade to latest version:
+
+.. code-block:: console
+
+    $ pip install --upgrade sqlalchemy-upsert-kit
+

sqlalchemy_upsert_kit-0.1.1/README.rst

@@ -0,0 +1,71 @@
+
+.. image:: https://readthedocs.org/projects/sqlalchemy-upsert-kit/badge/?version=latest
+    :target: https://sqlalchemy-upsert-kit.readthedocs.io/en/latest/
+    :alt: Documentation Status
+
+.. image:: https://github.com/MacHu-GWU/sqlalchemy_upsert_kit-project/actions/workflows/main.yml/badge.svg
+    :target: https://github.com/MacHu-GWU/sqlalchemy_upsert_kit-project/actions?query=workflow:CI
+
+.. image:: https://codecov.io/gh/MacHu-GWU/sqlalchemy_upsert_kit-project/branch/main/graph/badge.svg
+    :target: https://codecov.io/gh/MacHu-GWU/sqlalchemy_upsert_kit-project
+
+.. image:: https://img.shields.io/pypi/v/sqlalchemy-upsert-kit.svg
+    :target: https://pypi.python.org/pypi/sqlalchemy-upsert-kit
+
+.. image:: https://img.shields.io/pypi/l/sqlalchemy-upsert-kit.svg
+    :target: https://pypi.python.org/pypi/sqlalchemy-upsert-kit
+
+.. image:: https://img.shields.io/pypi/pyversions/sqlalchemy-upsert-kit.svg
+    :target: https://pypi.python.org/pypi/sqlalchemy-upsert-kit
+
+.. image:: https://img.shields.io/badge/✍️_Release_History!--None.svg?style=social&logo=github
+    :target: https://github.com/MacHu-GWU/sqlalchemy_upsert_kit-project/blob/main/release-history.rst
+
+.. image:: https://img.shields.io/badge/⭐_Star_me_on_GitHub!--None.svg?style=social&logo=github
+    :target: https://github.com/MacHu-GWU/sqlalchemy_upsert_kit-project
+
+------
+
+.. image:: https://img.shields.io/badge/Link-API-blue.svg
+    :target: https://sqlalchemy-upsert-kit.readthedocs.io/en/latest/py-modindex.html
+
+.. image:: https://img.shields.io/badge/Link-Install-blue.svg
+    :target: `install`_
+
+.. image:: https://img.shields.io/badge/Link-GitHub-blue.svg
+    :target: https://github.com/MacHu-GWU/sqlalchemy_upsert_kit-project
+
+.. image:: https://img.shields.io/badge/Link-Submit_Issue-blue.svg
+    :target: https://github.com/MacHu-GWU/sqlalchemy_upsert_kit-project/issues
+
+.. image:: https://img.shields.io/badge/Link-Request_Feature-blue.svg
+    :target: https://github.com/MacHu-GWU/sqlalchemy_upsert_kit-project/issues
+
+.. image:: https://img.shields.io/badge/Link-Download-blue.svg
+    :target: https://pypi.org/pypi/sqlalchemy-upsert-kit#files
+
+
+Welcome to ``sqlalchemy_upsert_kit`` Documentation
+==============================================================================
+.. image:: https://sqlalchemy-upsert-kit.readthedocs.io/en/latest/_static/sqlalchemy_upsert_kit-logo.png
+    :target: https://sqlalchemy-upsert-kit.readthedocs.io/en/latest/
+
+``sqlalchemy_upsert_kit`` provides high-performance bulk upsert operations for SQLAlchemy applications using temporary table staging. It offers three optimized strategies: ``insert_or_ignore`` for conflict-free insertion, ``insert_or_replace`` for complete record replacement, and ``insert_or_merge`` for selective column updates while preserving existing data. Each strategy leverages efficient SQL JOIN operations and temporary tables to achieve ~20x performance improvements over traditional row-by-row upserts, making it ideal for ETL processes, data synchronization, and bulk data operations where speed and reliability are critical.
+
+
+.. _install:
+
+Install
+------------------------------------------------------------------------------
+
+``sqlalchemy_upsert_kit`` is released on PyPI, so all you need is to:
+
+.. code-block:: console
+
+    $ pip install sqlalchemy-upsert-kit
+
+To upgrade to latest version:
+
+.. code-block:: console
+
+    $ pip install --upgrade sqlalchemy-upsert-kit

sqlalchemy_upsert_kit-0.1.1/pyproject.toml

@@ -0,0 +1,151 @@
+# ==============================================================================
+# The [project] table defined by Official python.org
+#
+# Read: https://packaging.python.org/en/latest/guides/writing-pyproject-toml/
+# ==============================================================================
+[project]
+name = "sqlalchemy_upsert_kit"
+# Increment version before each release - follow `semantic versioning <https://semver.org/>`_
+# Currently, poetry 2.1.X doesn't support dynamic versioning
+# (Read https://packaging.python.org/en/latest/guides/writing-pyproject-toml/#version)
+# So this value has to be aligned with the one in ``sqlalchemy_upsert_kit/_version.py``
+version = "0.1.1"
+description = "High-performance SQLAlchemy bulk upsert operations using temporary table staging - 20x faster than row-by-row approaches."
+# Read https://dev-exp-share.readthedocs.io/en/latest/search.html?q=Pick+An+Open+Source+License+For+Python+Project&check_keywords=yes&area=default
+# To pick a license and update the ``license``, ``classifier`` field in ``pyproject.toml``
+# And also update the ``LICENSE.txt`` file in the git repo.
+license = "MIT"
+license-files = ["LICENSE.txt", "AUTHORS.rst"]
+authors = [
+    { name = "Sanhe Hu", email = "husanhe@email.com" },
+]
+maintainers = [
+    { name = "Sanhe Hu", email = "husanhe@email.com" },
+]
+keywords = []
+readme = "README.rst"
+requires-python = ">=3.9,<4.0"
+# Full list of classifiers: https://pypi.org/classifiers/
+classifier = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Natural Language :: English",
+    "Operating System :: Microsoft :: Windows",
+    "Operating System :: MacOS",
+    "Operating System :: Unix",
+    # Note: classfier like "Programming Language :: Python :: 3 :: Only",
+    # "Programming Language :: Python :: 3.X" is no longer needed,
+    # because we have ``requires-python`` field.
+]
+
+# ------------------------------------------------------------------------------
+# Core Dependencies
+# ------------------------------------------------------------------------------
+dependencies = [
+    "sqlalchemy>=2.0.0,<3.0.0",
+]
+
+# ------------------------------------------------------------------------------
+# Optional dependency that can be used in ``pip install ${your_project_name}[${feature_name}]``
+# Sometime this is also called "extras"
+# Read: https://packaging.python.org/en/latest/guides/writing-pyproject-toml/#dependencies-optional-dependencies
+#
+# IMPORTANT: all optional dependencies has to be compatible with the "requires-python" field
+# ------------------------------------------------------------------------------
+[project.optional-dependencies]
+
+# ------------------------------------------------------------------------------
+# Local Development dependenceies
+# ------------------------------------------------------------------------------
+dev = [
+    "twine>=6.0.0,<7.0.0", # distribute package to PyPI
+    "wheel>=0.45.0,<1.0.0", # build wheel package
+    "build>=1.2.1,<2.0.0", # build source distribution
+    "rich>=13.8.1,<14.0.0", # pretty print
+]
+
+# ------------------------------------------------------------------------------
+# (Unit/Coverage/Integration/Load) Test dependenceies
+# ------------------------------------------------------------------------------
+test = [
+    "pytest>=8.2.2,<9.0.0", # Testing framework
+    "pytest-cov>=6.0.0,<7.0.0", # Coverage reporting
+    "prettytable>=3.0.0,<4.0.0", # Pretty print table in terminal
+]
+
+# ------------------------------------------------------------------------------
+# Documentation build dependenceies
+# ------------------------------------------------------------------------------
+doc = [
+    "Sphinx>=7.4.7,<8.0.0",
+    "sphinx-copybutton>=0.5.2,<1.0.0", # add copy button to code block
+    "sphinx-design>=0.6.1,<1.0.0", # add additional design pattern to sphinx
+    "sphinx-jinja>=2.0.2,<3.0.0", # enable jinja syntax in reStructuredText
+    "furo==2024.8.6", # the furo sphinx theme
+    "pygments>=2.18.0,<3.0.0", # syntax highlight
+    "ipython>=8.18.1,<8.19.0", # interactive Python
+    "nbsphinx>=0.8.12,<1.0.0", # add jupyter notebook in sphinx doc
+    "rstobj==1.2.1", # generate reStructuredText from Python code
+    "docfly==3.0.0", # automaticall generate .. toctree directives and API reference doc
+]
+
+# ------------------------------------------------------------------------------
+# Automation (devops) dependenceies
+# ------------------------------------------------------------------------------
+auto = [
+]
+
+# Quick Links
+[project.urls]
+Homepage = "https://github.com/MacHu-GWU/sqlalchemy_upsert_kit-project"
+Documentation = "https://sqlalchemy-upsert-kit.readthedocs.io/en/latest/"
+Repository = "https://github.com/MacHu-GWU/sqlalchemy_upsert_kit-project"
+Issues = "https://github.com/MacHu-GWU/sqlalchemy_upsert_kit-project/issues"
+Changelog = "https://github.com/MacHu-GWU/sqlalchemy_upsert_kit-project/blob/main/release-history.rst"
+Download = "https://pypi.org/pypi/sqlalchemy-upsert-kit#files"
+
+# For command line interface, read: https://packaging.python.org/en/latest/guides/writing-pyproject-toml/#creating-executable-scripts
+[project.scripts]
+
+[tool.poetry.requires-plugins]
+poetry-plugin-export = ">=1.9.0,<2.0.0"
+
+[tool.poetry]
+# Files to include in the package distribution
+packages = [
+    { include = "sqlalchemy_upsert_kit", from = ".", to = "." }
+]
+# Files to exclude from the package
+exclude = [
+    "sqlalchemy_upsert_kit/tests/*",
+    "sqlalchemy_upsert_kit/docs/*",
+    "**/*.pyc",
+    "**/*.pyo",
+]
+
+# python workflow tool config
+[tool.pywf]
+# The specific python version you use for local development
+dev_python = "3.11.8"
+# --- github.com
+github_account = "MacHu-GWU"
+# Create GitHub token in https://github.com/settings/tokens and put the token in
+# ``${HOME}/home_secret.json``
+github_token_field = "providers.github.accounts.sh.users.sh.secrets.dev.value"
+# --- codecov.io (for code coverage test report)
+codecov_account = "MacHu-GWU"
+# Create Codecov token in https://app.codecov.io/account/gh/${codecov_account}/access
+# and put the token in ``${HOME}/home_secret.json``
+codecov_token_field = "providers.codecov_io.accounts.sh.users.sh.secrets.dev.value"
+# --- readthedocs.org (for documentation hosting)
+# Create Readthedocs token in https://app.readthedocs.org/accounts/tokens/
+# and put the token at ``${HOME}/home_secret.json``
+readthedocs_token_field = "providers.readthedocs.accounts.sh.users.sh.secrets.dev.value"
+# Readthedocs project name, usually it is the same as your project name
+readthedocs_project_name = "sqlalchemy_upsert_kit"
+
+# Read: https://packaging.python.org/en/latest/guides/writing-pyproject-toml/#declaring-the-build-backend
+[build-system]
+requires = ["poetry-core>=2.0.0"]
+build-backend = "poetry.core.masonry.api"

sqlalchemy_upsert_kit-0.1.1/sqlalchemy_upsert_kit/__init__.py

@@ -0,0 +1,9 @@
+# -*- coding: utf-8 -*-
+
+from ._version import __version__
+from ._version import __short_description__
+from ._version import __license__
+from ._version import __author__
+from ._version import __author_email__
+from ._version import __maintainer__
+from ._version import __maintainer_email__

sqlalchemy_upsert_kit-0.1.1/sqlalchemy_upsert_kit/_version.py

@@ -0,0 +1,15 @@
+#!/usr/bin/env python
+# This file is automatically generated by pywf script
+# based on the content in pyproject.toml file
+
+__version__ = "0.1.1"
+__short_description__ = "High-performance SQLAlchemy bulk upsert operations using temporary table staging - 20x faster than row-by-row approaches."
+__license__ = "MIT"
+__author__ = "Sanhe Hu"
+__author_email__ = "husanhe@email.com"
+__maintainer__ = "Sanhe Hu"
+__maintainer_email__ = "husanhe@email.com"
+
+# run this script to print out the version number
+if __name__ == "__main__":  # pragma: no cover
+    print(__version__)

sqlalchemy_upsert_kit-0.1.1/sqlalchemy_upsert_kit/api.py

@@ -0,0 +1,3 @@
+# -*- coding: utf-8 -*-
+
+from .sqlite import api as sqlite

sqlalchemy_upsert_kit-0.1.1/sqlalchemy_upsert_kit/exc.py

@@ -0,0 +1,13 @@
+# -*- coding: utf-8 -*-
+
+
+class UpsertTestError(Exception):
+    """
+    Custom exception raised during testing to simulate failures.
+
+    This exception is used exclusively for testing error handling and cleanup
+    behavior in upsert operations. It allows tests to inject failures at specific
+    points in the operation flow to verify proper rollback and cleanup.
+
+    :param message: Descriptive error message indicating where the failure occurred
+    """

sqlalchemy_upsert_kit-0.1.1/sqlalchemy_upsert_kit/paths.py

@@ -0,0 +1,33 @@
+# -*- coding: utf-8 -*-
+
+from pathlib import Path
+
+dir_here = Path(__file__).absolute().parent
+dir_package = dir_here
+PACKAGE_NAME = dir_package.name
+
+dir_project_root = dir_package.parent
+
+# ------------------------------------------------------------------------------
+# Virtual Environment Related
+# ------------------------------------------------------------------------------
+dir_venv = dir_project_root / ".venv"
+dir_venv_bin = dir_venv / "bin"
+
+# virtualenv executable paths
+bin_pytest = dir_venv_bin / "pytest"
+
+# ------------------------------------------------------------------------------
+# Test Related
+# ------------------------------------------------------------------------------
+dir_htmlcov = dir_project_root / "htmlcov"
+path_cov_index_html = dir_htmlcov / "index.html"
+dir_unit_test = dir_project_root / "tests"
+dir_int_test = dir_project_root / "tests_int"
+dir_load_test = dir_project_root / "tests_load"
+
+# ------------------------------------------------------------------------------
+# Doc Related
+# ------------------------------------------------------------------------------
+dir_docs_source = dir_project_root / "docs" / "source"
+dir_docs_build_html = dir_project_root / "docs" / "build" / "html"

sqlalchemy_upsert_kit-0.1.1/sqlalchemy_upsert_kit/sqlite/__init__.py

@@ -0,0 +1,34 @@
+# -*- coding: utf-8 -*-
+
+"""
+High-Performance SQLAlchemy Bulk Operations Module for Sqlite
+
+This module provides optimized bulk operations for SQLAlchemy using temporary tables.
+These methods are specifically designed for large datasets and offer
+superior performance compared to traditional row-by-row operations.
+
+
+Implementation Notes
+------------------------------------------------------------------------------
+**Temporary Table Strategy**:
+    All bulk operations use temporary tables as staging areas to achieve optimal
+    performance. Temporary tables are created with unique names to avoid conflicts
+    in concurrent environments. Comprehensive cleanup ensures no temporary tables
+    are left behind, even when errors occur.
+
+**SQLite DDL Behavior**:
+    SQLite DDL operations (CREATE/DROP TABLE) are not transactional and commit
+    immediately. The cleanup logic accounts for this by using fresh connections
+    when necessary to avoid database locks during error scenarios.
+
+**Testing Infrastructure**:
+    Functions include boolean parameters prefixed with ``_raise_on_`` that are
+    exclusively for testing purposes. These parameters inject controlled failures
+    at specific points in the operation flow to verify error handling and cleanup
+    behavior. These parameters should never be used in production code.
+"""
+
+from .insert_or_ignore import insert_or_ignore
+from .insert_or_replace import insert_or_replace
+
+__all__ = ["insert_or_ignore", "insert_or_replace"]

sqlalchemy_upsert_kit-0.1.1/sqlalchemy_upsert_kit/sqlite/api.py

@@ -0,0 +1,5 @@
+# -*- coding: utf-8 -*-
+
+from .insert_or_ignore import insert_or_ignore
+from .insert_or_replace import insert_or_replace
+from .insert_or_merge import insert_or_merge