SQLPyHelper 0.1.7__py3-none-any.whl → 0.1.9__py3-none-any.whl

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,

sqlpyhelper/async_helper.py

@@ -0,0 +1,598 @@
+"""
+sqlpyhelper.async_helper
+~~~~~~~~~~~~~~~~~~~~~~~~
+Async-native database helper supporting SQLite, PostgreSQL, MySQL,
+SQL Server, and Oracle.
+
+Uses async-native drivers:
+- SQLite:     aiosqlite
+- PostgreSQL: asyncpg
+- MySQL:      aiomysql
+- SQL Server: aioodbc
+- Oracle:     python-oracledb (async mode)
+
+Example usage::
+
+    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())
+"""
+
+import logging
+import os
+from typing import Any, Optional
+
+from dotenv import load_dotenv
+
+load_dotenv()
+
+logger = logging.getLogger("sqlpyhelper.async")
+
+
+class AsyncConnectionError(Exception):
+    """Raised when an async database connection fails."""
+
+
+class AsyncQueryError(Exception):
+    """Raised when an async query fails."""
+
+
+class AsyncSQLPyHelper:
+    """
+    Async-native database helper with a unified API across
+    SQLite, PostgreSQL, MySQL, SQL Server, and Oracle.
+
+    Use as an async context manager::
+
+        async with AsyncSQLPyHelper(db_type="postgres", ...) as db:
+            rows = await db.fetch_all("SELECT * FROM users")
+
+    Or manage the connection lifecycle manually::
+
+        db = AsyncSQLPyHelper(db_type="sqlite", database="my.db")
+        await db.connect()
+        try:
+            rows = await db.fetch_all("SELECT * FROM users")
+        finally:
+            await db.close()
+    """
+
+    def __init__(
+        self,
+        db_type: Optional[str] = None,
+        host: Optional[str] = None,
+        user: Optional[str] = None,
+        password: Optional[str] = None,
+        database: Optional[str] = None,
+        driver: Optional[str] = None,
+        port: Optional[str] = None,
+        oracle_sid: Optional[str] = None,
+    ) -> None:
+        self.db_type: str = (db_type or os.getenv("DB_TYPE") or "").lower()
+        self.host: Optional[str] = host or os.getenv("DB_HOST")
+        self.user: Optional[str] = user or os.getenv("DB_USER")
+        self.password: Optional[str] = password or os.getenv("DB_PASSWORD")
+        self.database: Optional[str] = database or os.getenv("DB_NAME")
+        self.driver: Optional[str] = driver or os.getenv("DB_DRIVER")
+        self.port: Optional[str] = port or os.getenv("DB_PORT")
+        self.oracle_sid: Optional[str] = oracle_sid or os.getenv("ORACLE_SID")
+
+        self._connection: Any = None
+        self._pool: Any = None
+
+        if not self.db_type or not self.database:
+            raise ValueError("Missing required database configuration.")
+
+        if self.db_type not in ("sqlite", "postgres", "mysql", "sqlserver", "oracle"):
+            raise ValueError(f"Unsupported database type: {self.db_type!r}")
+
+    # -----------------------------------------------------------------------
+    # Connection lifecycle
+    # -----------------------------------------------------------------------
+
+    async def connect(self) -> None:
+        """Open the database connection."""
+        try:
+            if self.db_type == "sqlite":
+                import aiosqlite
+
+                self._connection = await aiosqlite.connect(self.database or "")  # type: ignore[arg-type]
+                logger.info("Connected to SQLite database: %s", self.database)
+
+            elif self.db_type == "postgres":
+                import asyncpg
+
+                self._connection = await asyncpg.connect(
+                    host=self.host,
+                    port=int(self.port or 5432),
+                    user=self.user,
+                    password=self.password,
+                    database=self.database,
+                )
+                logger.info("Connected to PostgreSQL database: %s", self.database)
+
+            elif self.db_type == "mysql":
+                import aiomysql
+
+                self._connection = await aiomysql.connect(
+                    host=self.host or "localhost",
+                    port=int(self.port or 3306),
+                    user=self.user,
+                    password=self.password or "",
+                    db=self.database,
+                    autocommit=False,
+                )
+                logger.info("Connected to MySQL database: %s", self.database)
+
+            elif self.db_type == "sqlserver":
+                import aioodbc
+
+                dsn = (
+                    f"DRIVER={self.driver};"
+                    f"SERVER={self.host};"
+                    f"DATABASE={self.database};"
+                    f"UID={self.user};"
+                    f"PWD={self.password}"
+                )
+                self._connection = await aioodbc.connect(dsn=dsn)
+                logger.info("Connected to SQL Server database: %s", self.database)
+
+            elif self.db_type == "oracle":
+                import oracledb
+
+                oracle_port = int(os.getenv("ORACLE_DB_PORT", "1521"))
+                dsn = oracledb.makedsn(
+                    self.host, oracle_port, sid=self.oracle_sid  # type: ignore[arg-type]
+                )
+                self._connection = await oracledb.connect_async(
+                    user=self.user, password=self.password, dsn=dsn
+                )
+                logger.info("Connected to Oracle database: %s", self.oracle_sid)
+
+        except Exception as e:
+            raise AsyncConnectionError(
+                f"Failed to connect to {self.db_type}: {e}"
+            ) from e
+
+    async def close(self) -> None:
+        """Close the database connection."""
+        try:
+            if self._connection is not None:
+                await self._connection.close()
+                self._connection = None
+                logger.info("Closed %s connection", self.db_type)
+        except Exception as e:
+            raise AsyncConnectionError(f"Failed to close connection: {e}") from e
+
+    async def __aenter__(self) -> "AsyncSQLPyHelper":
+        await self.connect()
+        return self
+
+    async def __aexit__(self, exc_type: Any, exc_val: Any, exc_tb: Any) -> bool:
+        await self.close()
+        return False
+
+    # -----------------------------------------------------------------------
+    # Internal helpers
+    # -----------------------------------------------------------------------
+
+    def _check_connection(self) -> None:
+        if self._connection is None:
+            raise AsyncConnectionError(
+                "No active connection. Call connect() or use async with."
+            )
+
+    def _adapt_query(self, query: str, args: tuple) -> tuple[str, tuple]:
+        """
+        Adapt a query and its arguments for the active database driver.
+
+        asyncpg uses $1, $2, ... positional placeholders.
+        aiosqlite and aiomysql use ? and %s respectively.
+        Callers should write queries using $1, $2, ... style and this
+        method will translate as needed.
+        """
+        if not args:
+            return query, args
+
+        if self.db_type == "postgres":
+            # asyncpg natively uses $1, $2 — pass through unchanged
+            return query, args
+
+        elif self.db_type == "sqlite":
+            # Replace $1, $2 with ?
+            import re
+
+            adapted = re.sub(r"\$\d+", "?", query)
+            return adapted, args
+
+        elif self.db_type in ("mysql", "sqlserver"):
+            # Replace $1, $2 with %s
+            import re
+
+            adapted = re.sub(r"\$\d+", "%s", query)
+            return adapted, args
+
+        elif self.db_type == "oracle":
+            # Replace $1, $2 with :1, :2
+            import re
+
+            def replace_placeholder(m: Any) -> str:
+                return f":{m.group(0)[1:]}"
+
+            adapted = re.sub(r"\$(\d+)", replace_placeholder, query)
+            return adapted, args
+
+        return query, args
+
+    # -----------------------------------------------------------------------
+    # Query execution
+    # -----------------------------------------------------------------------
+
+    async def execute(self, query: str, *args: Any) -> None:
+        """
+        Execute a SQL statement (INSERT, UPDATE, DELETE, DDL).
+
+        Use $1, $2, ... for parameterised values::
+
+            await db.execute(
+                "INSERT INTO users (id, name) VALUES ($1, $2)",
+                1, "Alice"
+            )
+
+        Args:
+            query: SQL query string using $1, $2 placeholders.
+            *args: Query parameters.
+
+        Raises:
+            AsyncQueryError: If the query fails.
+        """
+        self._check_connection()
+        adapted_query, adapted_args = self._adapt_query(query, args)
+        try:
+            if self.db_type == "postgres":
+                await self._connection.execute(adapted_query, *adapted_args)
+
+            elif self.db_type == "sqlite":
+                await self._connection.execute(adapted_query, adapted_args)
+                await self._connection.commit()
+
+            elif self.db_type in ("mysql", "sqlserver"):
+                async with self._connection.cursor() as cursor:
+                    await cursor.execute(adapted_query, adapted_args)
+                await self._connection.commit()
+
+            elif self.db_type == "oracle":
+                cursor = self._connection.cursor()
+                await cursor.execute(adapted_query, adapted_args)
+                await self._connection.commit()
+
+            logger.debug("Executed: %s", query)
+
+        except Exception as e:
+            raise AsyncQueryError(f"Query failed: {e}") from e
+
+    async def fetch_one(self, query: str, *args: Any) -> Optional[Any]:
+        """
+        Execute a SELECT query and return a single row, or None.
+
+        Args:
+            query: SQL query string using $1, $2 placeholders.
+            *args: Query parameters.
+
+        Returns:
+            A single row, or None if no rows matched.
+
+        Raises:
+            AsyncQueryError: If the query fails.
+        """
+        self._check_connection()
+        adapted_query, adapted_args = self._adapt_query(query, args)
+        try:
+            if self.db_type == "postgres":
+                return await self._connection.fetchrow(adapted_query, *adapted_args)
+
+            elif self.db_type == "sqlite":
+                async with self._connection.execute(
+                    adapted_query, adapted_args
+                ) as cursor:
+                    return await cursor.fetchone()
+
+            elif self.db_type in ("mysql", "sqlserver"):
+                async with self._connection.cursor() as cursor:
+                    await cursor.execute(adapted_query, adapted_args)
+                    return await cursor.fetchone()
+
+            elif self.db_type == "oracle":
+                cursor = self._connection.cursor()
+                await cursor.execute(adapted_query, adapted_args)
+                return await cursor.fetchone()
+
+            return None
+
+        except Exception as e:
+            raise AsyncQueryError(f"fetch_one failed: {e}") from e
+
+    async def fetch_all(self, query: str, *args: Any) -> list[Any]:
+        """
+        Execute a SELECT query and return all rows.
+
+        Args:
+            query: SQL query string using $1, $2 placeholders.
+            *args: Query parameters.
+
+        Returns:
+            A list of rows (empty list if no rows matched).
+
+        Raises:
+            AsyncQueryError: If the query fails.
+        """
+        self._check_connection()
+        adapted_query, adapted_args = self._adapt_query(query, args)
+        try:
+            if self.db_type == "postgres":
+                return await self._connection.fetch(adapted_query, *adapted_args)
+
+            elif self.db_type == "sqlite":
+                async with self._connection.execute(
+                    adapted_query, adapted_args
+                ) as cursor:
+                    return await cursor.fetchall()
+
+            elif self.db_type in ("mysql", "sqlserver"):
+                async with self._connection.cursor() as cursor:
+                    await cursor.execute(adapted_query, adapted_args)
+                    return await cursor.fetchall()
+
+            elif self.db_type == "oracle":
+                cursor = self._connection.cursor()
+                await cursor.execute(adapted_query, adapted_args)
+                return await cursor.fetchall()
+
+            return []
+
+        except Exception as e:
+            raise AsyncQueryError(f"fetch_all failed: {e}") from e
+
+    async def fetch_val(self, query: str, *args: Any) -> Optional[Any]:
+        """
+        Execute a SELECT query and return a single scalar value.
+
+        Useful for COUNT, SUM, or any query returning one value::
+
+            count = await db.fetch_val("SELECT COUNT(*) FROM users")
+
+        Args:
+            query: SQL query string using $1, $2 placeholders.
+            *args: Query parameters.
+
+        Returns:
+            A single scalar value, or None.
+
+        Raises:
+            AsyncQueryError: If the query fails.
+        """
+        self._check_connection()
+        adapted_query, adapted_args = self._adapt_query(query, args)
+        try:
+            if self.db_type == "postgres":
+                return await self._connection.fetchval(adapted_query, *adapted_args)
+
+            elif self.db_type == "sqlite":
+                async with self._connection.execute(
+                    adapted_query, adapted_args
+                ) as cursor:
+                    row = await cursor.fetchone()
+                    return row[0] if row else None
+
+            elif self.db_type in ("mysql", "sqlserver"):
+                async with self._connection.cursor() as cursor:
+                    await cursor.execute(adapted_query, adapted_args)
+                    row = await cursor.fetchone()
+                    return row[0] if row else None
+
+            elif self.db_type == "oracle":
+                cursor = self._connection.cursor()
+                await cursor.execute(adapted_query, adapted_args)
+                row = await cursor.fetchone()
+                return row[0] if row else None
+
+            return None
+
+        except Exception as e:
+            raise AsyncQueryError(f"fetch_val failed: {e}") from e
+
+    async def execute_many(self, query: str, args_list: list[tuple]) -> None:
+        """
+        Execute a SQL statement multiple times with different parameters.
+        Efficient for bulk inserts::
+
+            await db.execute_many(
+                "INSERT INTO users (id, name) VALUES ($1, $2)",
+                [(1, "Alice"), (2, "Bob"), (3, "Charlie")]
+            )
+
+        Args:
+            query:     SQL query string using $1, $2 placeholders.
+            args_list: List of parameter tuples.
+
+        Raises:
+            AsyncQueryError: If the operation fails.
+        """
+        self._check_connection()
+        if not args_list:
+            return
+        try:
+            if self.db_type == "postgres":
+                await self._connection.executemany(query, args_list)
+
+            elif self.db_type == "sqlite":
+                import re
+
+                adapted = re.sub(r"\$\d+", "?", query)
+                await self._connection.executemany(adapted, args_list)
+                await self._connection.commit()
+
+            elif self.db_type in ("mysql", "sqlserver"):
+                import re
+
+                adapted = re.sub(r"\$\d+", "%s", query)
+                async with self._connection.cursor() as cursor:
+                    await cursor.executemany(adapted, args_list)
+                await self._connection.commit()
+
+            elif self.db_type == "oracle":
+                import re
+
+                def replace_placeholder(m: Any) -> str:
+                    return f":{m.group(1)}"
+
+                adapted = re.sub(r"\$(\d+)", replace_placeholder, query)
+                cursor = self._connection.cursor()
+                await cursor.executemany(adapted, args_list)
+                await self._connection.commit()
+
+            logger.debug("execute_many: %d rows", len(args_list))
+
+        except Exception as e:
+            raise AsyncQueryError(f"execute_many failed: {e}") from e
+
+    # -----------------------------------------------------------------------
+    # Transaction management
+    # -----------------------------------------------------------------------
+
+    async def begin_transaction(self) -> None:
+        """
+        Begin an explicit transaction.
+
+        For PostgreSQL, use the transaction() context manager instead,
+        which is the idiomatic asyncpg approach.
+
+        Raises:
+            AsyncQueryError: If the transaction cannot be started.
+        """
+        self._check_connection()
+        try:
+            if self.db_type == "sqlite":
+                await self._connection.execute("BEGIN")
+            elif self.db_type == "mysql":
+                await self._connection.begin()
+            elif self.db_type == "sqlserver":
+                async with self._connection.cursor() as cursor:
+                    await cursor.execute("BEGIN TRANSACTION")
+            elif self.db_type == "oracle":
+                pass  # Oracle starts transactions implicitly
+            elif self.db_type == "postgres":
+                # asyncpg transactions are managed via connection.transaction()
+                # Calling begin() manually is supported but the context manager
+                # is preferred — see transaction() below
+                self._pg_transaction = self._connection.transaction()
+                await self._pg_transaction.start()
+            logger.info("Transaction started on %s", self.db_type)
+        except Exception as e:
+            raise AsyncQueryError(f"Failed to begin transaction: {e}") from e
+
+    async def commit_transaction(self) -> None:
+        """Commit the current transaction."""
+        self._check_connection()
+        try:
+            if self.db_type == "postgres":
+                await self._pg_transaction.commit()
+            else:
+                await self._connection.commit()
+            logger.info("Transaction committed on %s", self.db_type)
+        except Exception as e:
+            raise AsyncQueryError(f"Failed to commit transaction: {e}") from e
+
+    async def rollback_transaction(self) -> None:
+        """Roll back the current transaction."""
+        self._check_connection()
+        try:
+            if self.db_type == "postgres":
+                await self._pg_transaction.rollback()
+            else:
+                await self._connection.rollback()
+            logger.info("Transaction rolled back on %s", self.db_type)
+        except Exception as e:
+            raise AsyncQueryError(f"Failed to rollback transaction: {e}") from e
+
+    # -----------------------------------------------------------------------
+    # Connection pooling
+    # -----------------------------------------------------------------------
+
+    async def setup_pool(self, min_size: int = 1, max_size: int = 10) -> None:
+        """
+        Set up an async connection pool.
+
+        Supported for PostgreSQL and MySQL only.
+        After calling this, use get_connection_from_pool() to acquire
+        connections.
+
+        Args:
+            min_size: Minimum number of connections in the pool.
+            max_size: Maximum number of connections in the pool.
+
+        Raises:
+            AsyncConnectionError: If pool setup fails or db_type
+                                  does not support pooling.
+        """
+        try:
+            if self.db_type == "postgres":
+                import asyncpg
+
+                self._pool = await asyncpg.create_pool(
+                    host=self.host,
+                    port=int(self.port or 5432),
+                    user=self.user,
+                    password=self.password,
+                    database=self.database,
+                    min_size=min_size,
+                    max_size=max_size,
+                )
+                logger.info(
+                    "PostgreSQL async pool created (min=%d, max=%d)", min_size, max_size
+                )
+
+            elif self.db_type == "mysql":
+                import aiomysql
+
+                self._pool = await aiomysql.create_pool(
+                    host=self.host or "localhost",
+                    port=int(self.port or 3306),
+                    user=self.user,
+                    password=self.password or "",
+                    db=self.database,
+                    minsize=min_size,
+                    maxsize=max_size,
+                )
+                logger.info(
+                    "MySQL async pool created (min=%d, max=%d)", min_size, max_size
+                )
+
+            else:
+                raise AsyncConnectionError(
+                    f"Async connection pooling not supported for {self.db_type!r}. "
+                    "Supported: postgres, mysql."
+                )
+        except AsyncConnectionError:
+            raise
+        except Exception as e:
+            raise AsyncConnectionError(f"Failed to create async pool: {e}") from e
+
+    async def close_pool(self) -> None:
+        """Close the async connection pool."""
+        if self._pool is not None:
+            if self.db_type == "mysql":
+                self._pool.close()
+                await self._pool.wait_closed()
+            else:
+                await self._pool.close()
+            self._pool = None
+            logger.info("Async pool closed for %s", self.db_type)

sqlpyhelper/db_helper.py

@@ -96,6 +96,7 @@ class SQLPyHelper:
                 user=self.user,
                 password=self.password,
                 dbname=self.database,
+                port=self.port,
             )
         elif self.db_type == "mysql":
             import mysql.connector

{sqlpyhelper-0.1.7.dist-info → sqlpyhelper-0.1.9.dist-info}/METADATA

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

@@ -0,0 +1,13 @@
+sqlpyhelper/__init__.py,sha256=8oatB3lhbYVLzbkCIDrlE1mTJVljs2GeNuUG34_vYd0,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=SrXro_-ki5AT_Yj6u1k5-aUZYq-d2QXeQPXURXqUMLk,14223
+sqlpyhelper/migration.py,sha256=byAn7ToVgIB8tl1N39DB0MbHigjH2l-qX7QSskgzzTg,11673
+sqlpyhelper/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+sqlpyhelper-0.1.9.dist-info/licenses/LICENSE,sha256=9XzXxZ_8mWFM9-2TlqyE3L69zvRf4VPY_xIzSj5iU-g,1076
+sqlpyhelper-0.1.9.dist-info/METADATA,sha256=TTa0zKb4o_Zuf9x1j63Xg15vE9rUBbgDUnSjJHi0Hq0,11607
+sqlpyhelper-0.1.9.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+sqlpyhelper-0.1.9.dist-info/entry_points.txt,sha256=uAzSqwkAbbJqQUKHlPNwOebTJVA0FqkOvn2CRP6xSz8,52
+sqlpyhelper-0.1.9.dist-info/top_level.txt,sha256=FrLqTmqTGDa8jHnnf2ZVkYO-gFvLXX9QonpUCE6wKGs,12
+sqlpyhelper-0.1.9.dist-info/RECORD,,

sqlpyhelper-0.1.7.dist-info/RECORD

@@ -1,12 +0,0 @@
-sqlpyhelper/__init__.py,sha256=wiwMpojvoi0j_qunbTQgMfyxzzIsHMkmDr1ADLyhvfY,246
-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.7.dist-info/licenses/LICENSE,sha256=9XzXxZ_8mWFM9-2TlqyE3L69zvRf4VPY_xIzSj5iU-g,1076
-sqlpyhelper-0.1.7.dist-info/METADATA,sha256=C2jJX7sEHHqLnQxL5iZxiG8on4xCDHpEu8_8zuaZWlk,9763
-sqlpyhelper-0.1.7.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-sqlpyhelper-0.1.7.dist-info/entry_points.txt,sha256=uAzSqwkAbbJqQUKHlPNwOebTJVA0FqkOvn2CRP6xSz8,52
-sqlpyhelper-0.1.7.dist-info/top_level.txt,sha256=FrLqTmqTGDa8jHnnf2ZVkYO-gFvLXX9QonpUCE6wKGs,12
-sqlpyhelper-0.1.7.dist-info/RECORD,,