SQLPyHelper 0.1.8__py3-none-any.whl → 0.2.0__py3-none-any.whl

sqlpyhelper/__init__.py

@@ -1,5 +1,5 @@
 # Match the version in setup.py
-__version__ = "0.1.8"
+__version__ = "0.2.0"
 
 from sqlpyhelper.async_helper import (  # noqa: F401
     AsyncConnectionError,

sqlpyhelper/async_helper.py

@@ -105,7 +105,6 @@ class AsyncSQLPyHelper:
                 import aiosqlite
 
                 self._connection = await aiosqlite.connect(self.database or "")  # type: ignore[arg-type]
-                self._connection.row_factory = aiosqlite.Row
                 logger.info("Connected to SQLite database: %s", self.database)
 
             elif self.db_type == "postgres":

sqlpyhelper/db_helper.py

@@ -80,6 +80,7 @@ class SQLPyHelper:
         self.port: Optional[str] = port or os.getenv("DB_PORT")
         self.oracle_sid: Optional[str] = oracle_sid or os.getenv("ORACLE_SID")
         self.pool: Any = None
+        self._in_transaction: bool = False
 
         if not self.db_type or not self.database:
             raise ValueError("Missing required database configuration.")
@@ -96,6 +97,7 @@ class SQLPyHelper:
                 user=self.user,
                 password=self.password,
                 dbname=self.database,
+                port=self.port,
             )
         elif self.db_type == "mysql":
             import mysql.connector
@@ -142,14 +144,14 @@ class SQLPyHelper:
                 self.cursor.execute(query, params)
             else:
                 self.cursor.execute(query)
-            self.connection.commit()
+            if not self._in_transaction:
+                self.connection.commit()
         except Exception as e:
-            if "server has gone away" in str(
-                e
-            ):  # Example check for MySQL lost connection
+            if "server has gone away" in str(e):
                 self.reconnect()
                 self.cursor.execute(query, params)  # type: ignore[arg-type]
-                self.connection.commit()
+                if not self._in_transaction:
+                    self.connection.commit()
             else:
                 raise QueryError(f"Query failed: {e}") from e
 
@@ -349,6 +351,7 @@ class SQLPyHelper:
                 self.execute_query("BEGIN TRANSACTION")
             elif self.db_type == "oracle":
                 pass  # Oracle starts transactions implicitly on first DML statement
+            self._in_transaction = True
             logger.info("Transaction started on %s database", self.db_type)
         except Exception as e:
             raise QueryError(f"Failed to begin transaction: {e}") from e
@@ -357,6 +360,7 @@ class SQLPyHelper:
         """Commit the current transaction."""
         try:
             self.connection.commit()
+            self._in_transaction = False
             logger.info("Transaction committed on %s database", self.db_type)
         except Exception as e:
             raise QueryError(f"Failed to commit transaction: {e}") from e
@@ -365,6 +369,7 @@ class SQLPyHelper:
         """Roll back the current transaction."""
         try:
             self.connection.rollback()
+            self._in_transaction = False
             logger.info("Transaction rolled back on %s database", self.db_type)
         except Exception as e:
             raise QueryError(f"Failed to rollback transaction: {e}") from e

{sqlpyhelper-0.1.8.dist-info → sqlpyhelper-0.2.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: SQLPyHelper
-Version: 0.1.8
+Version: 0.2.0
 Summary: A simple SQL database helper package for Python.
 Home-page: https://github.com/adebayopeter/sqlpyhelper
 Author: Adebayo Olaonipekun
@@ -101,6 +101,7 @@ with SQLPyHelper(db_type="postgres", host="localhost", user="user",
   - [MySQL Example](#mysql-example)
   - [SQL Server Example](#sql-server-example)
   - [Oracle Example](#oracle-example)
+  - [Async Example (FastAPI / asyncio)](#async-example-fastapi--asyncio)
 - [📂 Project Structure](#-project-structure)
 - [📌 Available Methods in SQLPyHelper](#-available-methods-in-sqlpyhelper)
 - [🌍 Contributing](#-contributing)
@@ -108,14 +109,16 @@ with SQLPyHelper(db_type="postgres", host="localhost", user="user",
 
 ---
 
-## 🚀 Features in v0.1.4
-- Unified connection pooling for multiple databases. 
-- Automatic reconnection for lost connections. 
-- Transaction support (BEGIN, ROLLBACK, COMMIT). 
-- Secure parameterized queries to prevent SQL injection. 
-- Bulk insertion & dynamic table creation. 
-- Logging & error handling for better debugging. 
+## 🚀 Features in v0.1.8
+- Unified connection pooling for multiple databases.
+- Automatic reconnection for lost connections.
+- Transaction support (BEGIN, ROLLBACK, COMMIT).
+- Secure parameterized queries to prevent SQL injection.
+- Bulk insertion & dynamic table creation.
+- Logging & error handling for better debugging.
 - CSV export & database backups.
+- **Cross-database migration** — copy tables between any two supported databases.
+- **Async support** — `AsyncSQLPyHelper` for FastAPI and asyncio applications.
 
 ---
 ## 📦 Installation
@@ -214,20 +217,50 @@ db.setup_connection_pool(min_conn=2, max_conn=10)  # Enable pooling for better p
 conn = db.get_connection_from_pool()
 db.return_connection_to_pool(conn)
 ```
+### Async Example (FastAPI / asyncio)
+```python
+import asyncio
+from sqlpyhelper.async_helper import AsyncSQLPyHelper
+
+async def main():
+    async with AsyncSQLPyHelper(db_type="sqlite", database="my.db") as db:
+        await db.execute(
+            "CREATE TABLE IF NOT EXISTS users (id INTEGER, name TEXT)"
+        )
+        await db.execute(
+            "INSERT INTO users VALUES ($1, $2)", 1, "Alice"
+        )
+        rows = await db.fetch_all("SELECT * FROM users")
+        print(rows)
+
+asyncio.run(main())
+```
 
 ## 📂 Project Structure
 ```
 📦 SQLPyHelper/
-├─ sqlpyhelper/
-│  ├─ __init__.py
-│  └─ db_helper.py
-├─ tests/
-│  └─ test_sqlpyhelper.py
-├─ .env_example
-├─ .gitignore
-├─ setup.py
-├─ README.md
-└─ requirements.txt
+├─ sqlpyhelper/
+│  ├─ __init__.py
+│  ├─ db_helper.py
+│  ├─ async_helper.py
+│  ├─ automation_utils.py
+│  ├─ cli.py
+│  └─ migration.py
+├─ test/
+│  ├─ test_sqlpyhelper.py
+│  ├─ test_async_helper.py
+│  └─ test_migration.py
+├─ docs/
+├─ .env_example
+├─ .gitignore
+├─ setup.py
+├─ setup.cfg
+├─ pyproject.toml
+├─ CHANGELOG.md
+├─ CONTRIBUTING.md
+├─ pre-commit.sh
+├─ README.md
+└─ requirements.txt
 ```
 ---
 ## 📌 Available Methods in SQLPyHelper
@@ -249,6 +282,7 @@ db.return_connection_to_pool(conn)
 | `commit_transaction()` | Commits the current transaction. |
 | `close()` | Closes the database connection safely. |
 | `__enter__` / `__exit__()` | Use as a context manager — connection closes automatically. |
+| `AsyncSQLPyHelper` | Async-native class for FastAPI/asyncio — see [Async docs](https://sqlpyhelper.readthedocs.io/en/latest/async.html). |
 
 ---
 ## 🌍 Contributing

sqlpyhelper-0.2.0.dist-info/RECORD

@@ -0,0 +1,13 @@
+sqlpyhelper/__init__.py,sha256=zxVPeEAfG2pTAxvjU6D_U6x4ef4YMg4NqNFr-6SoSK0,370
+sqlpyhelper/async_helper.py,sha256=beq0wKxDl7Qv-CW_qA1-h_DPhDpC1CQHdstnKO-4FSI,21473
+sqlpyhelper/automation_utils.py,sha256=pC6pH6bJ-k8iPVeHJ4gUiwEe822dasmKg53ya9bMxyE,5381
+sqlpyhelper/cli.py,sha256=yj0kWJu3oh_JLnmi0L7a5ing2_0x4CQGOKSOhZLAtoY,5646
+sqlpyhelper/db_helper.py,sha256=zRZGidneQspAhYekD7ACvn9nim3ylYav_ObbCLxRXaM,14409
+sqlpyhelper/migration.py,sha256=byAn7ToVgIB8tl1N39DB0MbHigjH2l-qX7QSskgzzTg,11673
+sqlpyhelper/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+sqlpyhelper-0.2.0.dist-info/licenses/LICENSE,sha256=9XzXxZ_8mWFM9-2TlqyE3L69zvRf4VPY_xIzSj5iU-g,1076
+sqlpyhelper-0.2.0.dist-info/METADATA,sha256=mI3df5g2wPddtecAYNcq95ipzwoXyHA15b2UhAuj300,11607
+sqlpyhelper-0.2.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+sqlpyhelper-0.2.0.dist-info/entry_points.txt,sha256=uAzSqwkAbbJqQUKHlPNwOebTJVA0FqkOvn2CRP6xSz8,52
+sqlpyhelper-0.2.0.dist-info/top_level.txt,sha256=FrLqTmqTGDa8jHnnf2ZVkYO-gFvLXX9QonpUCE6wKGs,12
+sqlpyhelper-0.2.0.dist-info/RECORD,,

sqlpyhelper-0.1.8.dist-info/RECORD

@@ -1,13 +0,0 @@
-sqlpyhelper/__init__.py,sha256=UN7k9UyQVsxtFLDH496vDYQdGOIa525T4lGvVXjRM8s,370
-sqlpyhelper/async_helper.py,sha256=_R01cUZSj_q9QH4pGT30gh56GJGSfgi0hIhgDJqmyYw,21534
-sqlpyhelper/automation_utils.py,sha256=pC6pH6bJ-k8iPVeHJ4gUiwEe822dasmKg53ya9bMxyE,5381
-sqlpyhelper/cli.py,sha256=yj0kWJu3oh_JLnmi0L7a5ing2_0x4CQGOKSOhZLAtoY,5646
-sqlpyhelper/db_helper.py,sha256=4DbdBVo86zz1d0hNHtSc4b3Tks7bJGTMTyabsydQyOE,14191
-sqlpyhelper/migration.py,sha256=byAn7ToVgIB8tl1N39DB0MbHigjH2l-qX7QSskgzzTg,11673
-sqlpyhelper/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-sqlpyhelper-0.1.8.dist-info/licenses/LICENSE,sha256=9XzXxZ_8mWFM9-2TlqyE3L69zvRf4VPY_xIzSj5iU-g,1076
-sqlpyhelper-0.1.8.dist-info/METADATA,sha256=l-kKKsEjezQU1GjTsXHFeRpDAjiPfK-5AIlepQ396Wk,10450
-sqlpyhelper-0.1.8.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-sqlpyhelper-0.1.8.dist-info/entry_points.txt,sha256=uAzSqwkAbbJqQUKHlPNwOebTJVA0FqkOvn2CRP6xSz8,52
-sqlpyhelper-0.1.8.dist-info/top_level.txt,sha256=FrLqTmqTGDa8jHnnf2ZVkYO-gFvLXX9QonpUCE6wKGs,12
-sqlpyhelper-0.1.8.dist-info/RECORD,,