SQLPyHelper 0.1.8__tar.gz → 0.2.0__tar.gz

{sqlpyhelper-0.1.8 → sqlpyhelper-0.2.0}/PKG-INFO

@@ -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.1.8 → sqlpyhelper-0.2.0}/README.md

@@ -29,6 +29,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)
@@ -36,14 +37,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
@@ -142,20 +145,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
@@ -177,6 +210,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.1.8 → sqlpyhelper-0.2.0}/SQLPyHelper.egg-info/PKG-INFO

@@ -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.1.8 → sqlpyhelper-0.2.0}/setup.py

@@ -5,7 +5,7 @@ with open("README.md", "r", encoding="utf-8") as f:
 
 setup(
     name='SQLPyHelper',
-    version='0.1.8',
+    version='0.2.0',
     description='A simple SQL database helper package for Python.',
     long_description=long_description,
     long_description_content_type="text/markdown",

{sqlpyhelper-0.1.8 → sqlpyhelper-0.2.0}/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-0.1.8 → sqlpyhelper-0.2.0}/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-0.1.8 → sqlpyhelper-0.2.0}/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