SQLPyHelper 0.1.7__tar.gz → 0.1.9__tar.gz

{sqlpyhelper-0.1.7 → sqlpyhelper-0.1.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: SQLPyHelper
-Version: 0.1.7
+Version: 0.1.9
 Summary: A simple SQL database helper package for Python.
 Home-page: https://github.com/adebayopeter/sqlpyhelper
 Author: Adebayo Olaonipekun
@@ -34,11 +34,28 @@ Provides-Extra: sqlserver
 Requires-Dist: pyodbc; extra == "sqlserver"
 Provides-Extra: oracle
 Requires-Dist: oracledb; extra == "oracle"
+Provides-Extra: async-postgres
+Requires-Dist: asyncpg; extra == "async-postgres"
+Provides-Extra: async-mysql
+Requires-Dist: aiomysql; extra == "async-mysql"
+Provides-Extra: async-sqlite
+Requires-Dist: aiosqlite; extra == "async-sqlite"
+Provides-Extra: async-sqlserver
+Requires-Dist: aioodbc; extra == "async-sqlserver"
+Provides-Extra: async-all
+Requires-Dist: asyncpg; extra == "async-all"
+Requires-Dist: aiomysql; extra == "async-all"
+Requires-Dist: aiosqlite; extra == "async-all"
+Requires-Dist: aioodbc; extra == "async-all"
 Provides-Extra: all
 Requires-Dist: psycopg2; extra == "all"
 Requires-Dist: mysql-connector-python; extra == "all"
 Requires-Dist: pyodbc; extra == "all"
 Requires-Dist: oracledb; extra == "all"
+Requires-Dist: asyncpg; extra == "all"
+Requires-Dist: aiomysql; extra == "all"
+Requires-Dist: aiosqlite; extra == "all"
+Requires-Dist: aioodbc; extra == "all"
 Dynamic: author
 Dynamic: author-email
 Dynamic: classifier
@@ -84,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)
@@ -91,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
@@ -197,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
@@ -232,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.7 → sqlpyhelper-0.1.9}/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.7 → sqlpyhelper-0.1.9}/SQLPyHelper.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: SQLPyHelper
-Version: 0.1.7
+Version: 0.1.9
 Summary: A simple SQL database helper package for Python.
 Home-page: https://github.com/adebayopeter/sqlpyhelper
 Author: Adebayo Olaonipekun
@@ -34,11 +34,28 @@ Provides-Extra: sqlserver
 Requires-Dist: pyodbc; extra == "sqlserver"
 Provides-Extra: oracle
 Requires-Dist: oracledb; extra == "oracle"
+Provides-Extra: async-postgres
+Requires-Dist: asyncpg; extra == "async-postgres"
+Provides-Extra: async-mysql
+Requires-Dist: aiomysql; extra == "async-mysql"
+Provides-Extra: async-sqlite
+Requires-Dist: aiosqlite; extra == "async-sqlite"
+Provides-Extra: async-sqlserver
+Requires-Dist: aioodbc; extra == "async-sqlserver"
+Provides-Extra: async-all
+Requires-Dist: asyncpg; extra == "async-all"
+Requires-Dist: aiomysql; extra == "async-all"
+Requires-Dist: aiosqlite; extra == "async-all"
+Requires-Dist: aioodbc; extra == "async-all"
 Provides-Extra: all
 Requires-Dist: psycopg2; extra == "all"
 Requires-Dist: mysql-connector-python; extra == "all"
 Requires-Dist: pyodbc; extra == "all"
 Requires-Dist: oracledb; extra == "all"
+Requires-Dist: asyncpg; extra == "all"
+Requires-Dist: aiomysql; extra == "all"
+Requires-Dist: aiosqlite; extra == "all"
+Requires-Dist: aioodbc; extra == "all"
 Dynamic: author
 Dynamic: author-email
 Dynamic: classifier
@@ -84,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)
@@ -91,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
@@ -197,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
@@ -232,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.7 → sqlpyhelper-0.1.9}/SQLPyHelper.egg-info/SOURCES.txt

@@ -10,10 +10,12 @@ SQLPyHelper.egg-info/entry_points.txt
 SQLPyHelper.egg-info/requires.txt
 SQLPyHelper.egg-info/top_level.txt
 sqlpyhelper/__init__.py
+sqlpyhelper/async_helper.py
 sqlpyhelper/automation_utils.py
 sqlpyhelper/cli.py
 sqlpyhelper/db_helper.py
 sqlpyhelper/migration.py
 sqlpyhelper/py.typed
+test/test_async_helper.py
 test/test_migration.py
 test/test_sqlpyhelper.py

sqlpyhelper-0.1.9/SQLPyHelper.egg-info/requires.txt

@@ -0,0 +1,42 @@
+python-dotenv
+click
+
+[all]
+psycopg2
+mysql-connector-python
+pyodbc
+oracledb
+asyncpg
+aiomysql
+aiosqlite
+aioodbc
+
+[async-all]
+asyncpg
+aiomysql
+aiosqlite
+aioodbc
+
+[async-mysql]
+aiomysql
+
+[async-postgres]
+asyncpg
+
+[async-sqlite]
+aiosqlite
+
+[async-sqlserver]
+aioodbc
+
+[mysql]
+mysql-connector-python
+
+[oracle]
+oracledb
+
+[postgres]
+psycopg2
+
+[sqlserver]
+pyodbc

{sqlpyhelper-0.1.7 → sqlpyhelper-0.1.9}/pyproject.toml

@@ -4,3 +4,6 @@ line-length = 88
 [tool.isort]
 profile = "black"
 line_length = 88
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"

{sqlpyhelper-0.1.7 → sqlpyhelper-0.1.9}/setup.py

@@ -5,7 +5,7 @@ with open("README.md", "r", encoding="utf-8") as f:
 
 setup(
     name='SQLPyHelper',
-    version='0.1.7',
+    version='0.1.9',
     description='A simple SQL database helper package for Python.',
     long_description=long_description,
     long_description_content_type="text/markdown",
@@ -26,11 +26,14 @@ setup(
         "mysql": ["mysql-connector-python"],
         "sqlserver": ["pyodbc"],
         "oracle": ["oracledb"],
+        "async-postgres": ["asyncpg"],
+        "async-mysql": ["aiomysql"],
+        "async-sqlite": ["aiosqlite"],
+        "async-sqlserver": ["aioodbc"],
+        "async-all": ["asyncpg", "aiomysql", "aiosqlite", "aioodbc"],
         "all": [
-            "psycopg2",
-            "mysql-connector-python",
-            "pyodbc",
-            "oracledb",
+            "psycopg2", "mysql-connector-python", "pyodbc", "oracledb",
+            "asyncpg", "aiomysql", "aiosqlite", "aioodbc",
         ],
     },
     keywords=[

{sqlpyhelper-0.1.7 → sqlpyhelper-0.1.9}/sqlpyhelper/__init__.py

@@ -1,6 +1,11 @@
 # Match the version in setup.py
-__version__ = "0.1.7"
+__version__ = "0.1.9"
 
+from sqlpyhelper.async_helper import (  # noqa: F401
+    AsyncConnectionError,
+    AsyncQueryError,
+    AsyncSQLPyHelper,
+)
 from sqlpyhelper.db_helper import (  # noqa: F401
     BackupError,
     ConnectionError,