sqlalchemy-upsert-kit 0.1.1__py3-none-any.whl

sqlalchemy_upsert_kit/vendor/pytest_cov_helper.py

@@ -0,0 +1,148 @@
+# -*- coding: utf-8 -*-
+
+import os
+import sys
+import contextlib
+import subprocess
+from pathlib import Path
+
+__version__ = "0.2.1"
+
+
+@contextlib.contextmanager
+def temp_cwd(path: Path):
+    """
+    Temporarily set the current working directory (CWD) and automatically
+    switch back when it's done.
+    """
+    cwd = os.getcwd()
+    os.chdir(str(path))
+    try:
+        yield path
+    finally:
+        os.chdir(cwd)
+
+
+def run_unit_test(
+    script: str,
+    root_dir: str,
+):
+    """
+    Run ``pytest -s --tb=native /path/to/script.py`` Command.
+
+    :param script: the path to test script
+    :param root_dir: the dir you want to temporarily set as cwd
+    """
+    bin_pytest = Path(sys.executable).parent / "pytest"
+    args = [
+        f"{bin_pytest}",
+        "-s",
+        "--tb=native",
+        script,
+    ]
+    with temp_cwd(Path(root_dir)):
+        subprocess.run(args)
+
+
+def run_cov_test(
+    script: str,
+    module: str,
+    root_dir: str,
+    htmlcov_dir: str,
+    preview: bool = False,
+    is_folder: bool = False,
+):
+    """
+    The pytest-cov plugin gives you the coverage for entire project. What if
+    I want run per-module test independently and get per-module coverage?
+
+    This is a simple wrapper around pytest + coverage cli command. Allow you to run
+    coverage test from Python script and set the code coverage measurement scope.
+
+    Usage example:
+
+    suppose you have a source code folder structure like this::
+
+        /dir_git_repo/
+        /dir_git_repo/my_library
+        /dir_git_repo/my_library/__init__.py
+        /dir_git_repo/my_library/module1.py
+        /dir_git_repo/my_library/module2.py
+
+    In your module 1 unit test script, you can do this:
+
+    .. code-block:: python
+
+        from my_library.module1 import func1, func2
+
+        def test_func1():
+            pass
+
+        def test_func2():
+            pass
+
+        if __name__ == "__main__":
+            from fixa.pytest_cov_helper import run_cov_test
+
+            run_cov_test(
+                script=__file__,
+                module="my_library.module1", # test scope is the module1.py
+                root_dir="/path/to/dir_git_repo",
+                htmlcov_dir="/path/to/dir_git_repo/htmlcov",
+            )
+
+    In your all modules unit test script, you can do this:
+
+    .. code-block:: python
+
+        if __name__ == "__main__":
+            from fixa.pytest_cov_helper import run_cov_test
+
+            run_cov_test(
+                script=__file__,
+                module="my_library", # test scope is the my_library/
+                root_dir="/path/to/dir_git_repo",
+                htmlcov_dir="/path/to/dir_git_repo/htmlcov",
+                is_folder=True, # my_library is a folder
+            )
+
+    :param script: the test script absolute path
+    :param module: the dot notation to the python module you want to calculate
+        coverage
+    :param root_dir: the dir to dump coverage results binary file
+    :param htmlcov_dir: the dir to dump HTML output
+    :param preview: whether to open the HTML output in web browser after the test
+    :param is_folder: whether the module is a folder
+
+    Reference:
+
+    - https://pypi.org/project/pytest-cov/
+    """
+    bin_pytest = Path(sys.executable).parent / "pytest"
+    if is_folder:
+        script = f"{Path(script).parent}"
+    if module.endswith(".py"):  # pragma: no cover
+        module = module[:-3]
+    args = [
+        f"{bin_pytest}",
+        "-s",
+        "--tb=native",
+        f"--rootdir={root_dir}",
+        f"--cov={module}",
+        "--cov-report",
+        "term-missing",
+        "--cov-report",
+        f"html:{htmlcov_dir}",
+        script,
+    ]
+    with temp_cwd(Path(root_dir)):
+        subprocess.run(args)
+    if preview:  # pragma: no cover
+        platform = sys.platform
+        if platform in ["win32", "cygwin"]:
+            open_command = "start"
+        elif platform in ["darwin", "linux"]:
+            open_command = "open"
+        else:
+            raise NotImplementedError
+        subprocess.run([open_command, f"{Path(htmlcov_dir).joinpath('index.html')}"])

sqlalchemy_upsert_kit-0.1.1.dist-info/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.dist-info/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.dist-info/METADATA

@@ -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.dist-info/RECORD

@@ -0,0 +1,19 @@
+sqlalchemy_upsert_kit/__init__.py,sha256=91jqwa6UIinipz7S0hF5_qpjjB9MUONExbvbLt7UTys,289
+sqlalchemy_upsert_kit/_version.py,sha256=P4PUbSbDBSFuAsxGoCW3y9fB7gt2D1K03MlkhIvg0vI,568
+sqlalchemy_upsert_kit/api.py,sha256=v8H6ctTExDFcXeYKYPCSOU-rpZkQAvjEWTNsaXTELWk,59
+sqlalchemy_upsert_kit/exc.py,sha256=bERofark5mlacbuWLq1nCkJmjRiOzKM_sYqlzztWLZM,459
+sqlalchemy_upsert_kit/paths.py,sha256=JH9o7s__FexYpUMuwV7SArCUCdatooOQA1gUYtBm7UY,1226
+sqlalchemy_upsert_kit/sqlite/__init__.py,sha256=ALdw6W36ti0qIHhyD7vMCV9WE9cyDlOdhFrxqnnP8IA,1488
+sqlalchemy_upsert_kit/sqlite/api.py,sha256=q5gTmoHNg_G_FZYVBFuK7yNEnYB6fUlR5Fs-BIeg5fA,166
+sqlalchemy_upsert_kit/sqlite/executor.py,sha256=1BuQSFIK-5X0CYwRIJhsZBoMbMaRar1rTwomu0cqd6s,22437
+sqlalchemy_upsert_kit/sqlite/insert_or_ignore.py,sha256=sUhjJxbkVGGlym_Qmy6dOOb25w3fhZt2mT3yuJHQ6sk,5976
+sqlalchemy_upsert_kit/sqlite/insert_or_merge.py,sha256=m7QCOMHG47_rN1XOmkTu5qNB4yYDnXvK7Cb6SrM-QTY,10632
+sqlalchemy_upsert_kit/sqlite/insert_or_replace.py,sha256=wHz_-5sJjPi_nHkuZ8oetfUWu196C0YSWxlA34FJJMg,7086
+sqlalchemy_upsert_kit/utils.py,sha256=OeVaSUgalT9YSW8Sp8YmeLB3yYPQ8M2RbbKDkkYCsTA,2887
+sqlalchemy_upsert_kit/vendor/__init__.py,sha256=O9CT1B2F-cVB8elT0EoCJbgkcffjvlmqteqavs4giDg,25
+sqlalchemy_upsert_kit/vendor/pytest_cov_helper.py,sha256=H2BJtFq3bwJHZtt-bxZ1yF9LnXHVDRZZ0NH-OvkRJdE,4063
+sqlalchemy_upsert_kit-0.1.1.dist-info/AUTHORS.rst,sha256=oo38V9AD_y57Ac69mKmiItWquV29SRi2aTCdKQo531A,767
+sqlalchemy_upsert_kit-0.1.1.dist-info/LICENSE.txt,sha256=Vc2EgX0hR-6Qw_RxS1IR-2qllqh4PiqSWFvrdnqZSDU,1084
+sqlalchemy_upsert_kit-0.1.1.dist-info/METADATA,sha256=FcmOtb8ug1KSQkXYAkAhzciMgBCkSodZ2QN9WF76c_g,5798
+sqlalchemy_upsert_kit-0.1.1.dist-info/WHEEL,sha256=XbeZDeTWKc1w7CSIyre5aMDU_-PohRwTQceYnisIYYY,88
+sqlalchemy_upsert_kit-0.1.1.dist-info/RECORD,,

sqlalchemy_upsert_kit-0.1.1.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: poetry-core 2.1.1
+Root-Is-Purelib: true
+Tag: py3-none-any