SQLPyHelper 0.1.0__py3-none-any.whl → 0.1.2__py3-none-any.whl

sqlpyhelper/__init__.py

@@ -0,0 +1,2 @@
+# Match the version in setup.py
+__version__ = "0.1.2"

sqlpyhelper/db_helper.py

@@ -1,16 +1,16 @@
-import sqlite3
-import psycopg2
-import mysql.connector
-import pyodbc
-import cx_Oracle
 import csv
-from psycopg2 import pool
 from dotenv import load_dotenv
 import os
 
 load_dotenv()  # Load environment variables from .env file
 
 
+def log_query(query):
+    """Logs queries for debugging purposes."""
+    with open("query_log.txt", "a") as f:
+        f.write(query + "\n")
+
+
 class SQLPyHelper:
     def __init__(self):
         self.db_type = os.getenv("DB_TYPE").lower()
@@ -20,19 +20,25 @@ class SQLPyHelper:
         self.database = os.getenv("DB_NAME")
         self.driver = os.getenv("DB_DRIVER")
         self.oracle_sid = os.getenv("ORACLE_SID")
+        self.pool = None
 
         if self.db_type == "sqlite":
+            import sqlite3
             self.connection = sqlite3.connect(self.database)
         elif self.db_type == "postgres":
+            import psycopg2
             self.connection = psycopg2.connect(host=self.host, user=self.user,
                                                password=self.password, dbname=self.database)
         elif self.db_type == "mysql":
+            import mysql.connector
             self.connection = mysql.connector.connect(host=self.host, user=self.user,
                                                       password=self.password, database=self.database)
         elif self.db_type == "sqlserver":
+            import pyodbc
             self.connection = pyodbc.connect(f"DRIVER={self.driver};SERVER={self.host};DATABASE={self.database};"
                                              f"UID={self.user};PWD={self.password}")
         elif self.db_type == "oracle":
+            import cx_Oracle
             oracle_port = os.getenv("ORACLE_DB_PORT", "1521")  # Default to 1521 if not set
             dsn = cx_Oracle.makedsn(self.host, oracle_port, self.oracle_sid)
             self.connection = cx_Oracle.connect(self.user, self.password, dsn)
@@ -52,10 +58,18 @@ class SQLPyHelper:
         except Exception as e:
             print(f"Error executing query: {e}")
 
+    def fetch_one(self):
+        return self.cursor.fetchone()
+
     def fetch_all(self):
         """Fetches all rows from the last executed query"""
         return self.cursor.fetchall()
 
+    def fetch_by_param(self, table_name, column_name, value):
+        query = f"SELECT * FROM {table_name} WHERE {column_name} = %s"
+        self.cursor.execute(query, (value,))
+        return self.cursor.fetchall()  # Fetch matching rows
+
     def close(self):
         """Closes the connection"""
         self.cursor.close()
@@ -84,11 +98,6 @@ class SQLPyHelper:
         self.cursor.executemany(query, values)
         self.connection.commit()
 
-    def log_query(self, query):
-        """Logs queries for debugging purposes."""
-        with open("query_log.txt", "a") as f:
-            f.write(query + "\n")
-
     def backup_table(self, table_name, backup_file):
         """
         Exports table data into a CSV file.
@@ -110,6 +119,7 @@ class SQLPyHelper:
         Example:
         setup_postgres_pool(min_conn=2, max_conn=10)
         """
+        from psycopg2 import pool
         self.pool = pool.SimpleConnectionPool(min_conn, max_conn,
                                               host=self.host,
                                               user=self.user,
@@ -123,6 +133,3 @@ class SQLPyHelper:
     def return_connection_to_pool(self, conn):
         """Returns a connection back to the pool."""
         self.pool.putconn(conn)
-
-
-

{sqlpyhelper-0.1.0.dist-info → sqlpyhelper-0.1.2.dist-info}/METADATA

@@ -1,12 +1,15 @@
 Metadata-Version: 2.4
 Name: SQLPyHelper
-Version: 0.1.0
+Version: 0.1.2
 Summary: A simple SQL database helper package for Python.
 Author: Adebayo Olaonipekun
 Author-email: pekunmi@live.com
 Classifier: Programming Language :: Python :: 3
-Classifier: License :: OSI Approved :: MIT License
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Database :: Database Engines/Servers
 Classifier: Operating System :: OS Independent
+Classifier: License :: OSI Approved :: MIT License
 Requires-Python: >=3.8
 Description-Content-Type: text/markdown
 License-File: LICENSE
@@ -15,12 +18,22 @@ Requires-Dist: mysql-connector-python
 Requires-Dist: pyodbc
 Requires-Dist: cx_Oracle
 Requires-Dist: python-dotenv
+Provides-Extra: mysql
+Requires-Dist: mysql-connector-python; extra == "mysql"
+Provides-Extra: postgres
+Requires-Dist: psycopg2; extra == "postgres"
+Provides-Extra: oracle
+Requires-Dist: cx_Oracle; extra == "oracle"
+Provides-Extra: sqlserver
+Requires-Dist: pyodbc; extra == "sqlserver"
+Provides-Extra: sqlite
 Dynamic: author
 Dynamic: author-email
 Dynamic: classifier
 Dynamic: description
 Dynamic: description-content-type
 Dynamic: license-file
+Dynamic: provides-extra
 Dynamic: requires-dist
 Dynamic: requires-python
 Dynamic: summary
@@ -54,9 +67,12 @@ A Python library for simplified database interactions across **SQLite, PostgreSQ
 
 ---
 ## 📦 Installation
+#### Install via PyPI:
 ```sh
 pip install sqlpyhelper
 ```
+📌 Package on PyPI: [SQLPyHelper on PyPI](https://pypi.org/project/SQLPyHelper/)
+
 Or, if working from source:
 ```sh
 git clone https://github.com/adebayopeter/sqlpyhelper.git
@@ -75,11 +91,10 @@ DB_TYPE=postgres
 DB_HOST=localhost
 DB_USER=your_user
 DB_PASSWORD=your_secure_password
-DB_NAME=test_db
-DB_PORT=5432
+DB_NAME=database_name
 DB_DRIVER={ODBC Driver 17 for SQL Server}
 ORACLE_SID=XE
-ORACLE_PORT=1521
+ORACLE_DB_PORT=1521
 ```
 ### Loading `.env` in Code
 ```pycon
@@ -124,6 +139,16 @@ db.execute_query("SELECT * FROM customers")
 print(db.fetch_all())
 db.close()
 ```
+```pycon
+db = SQLPyHelper()
+
+# Fetch rows where customer_id = 3
+customers = db.fetch_by_param("customers", "id", 3)
+print(customers)
+
+db.close()
+```
+
 ### SQL Server Example
 ```pycon
 db = SQLPyHelper()

sqlpyhelper-0.1.2.dist-info/RECORD

@@ -0,0 +1,7 @@
+sqlpyhelper/__init__.py,sha256=kJA4mgypZmLd3SnwwTNkVwB0yIJ8PKP4h9cjOCIPfTA,54
+sqlpyhelper/db_helper.py,sha256=TT93q3f1EVjkgUSXA4iXCy9Uw5gdGuRbqH-Wl-8OjeI,5269
+sqlpyhelper-0.1.2.dist-info/licenses/LICENSE,sha256=9XzXxZ_8mWFM9-2TlqyE3L69zvRf4VPY_xIzSj5iU-g,1076
+sqlpyhelper-0.1.2.dist-info/METADATA,sha256=ATC92p-IcBVUFEBHKXqqMBkYC524FsdQpxDVBmhQ3JI,5954
+sqlpyhelper-0.1.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+sqlpyhelper-0.1.2.dist-info/top_level.txt,sha256=FrLqTmqTGDa8jHnnf2ZVkYO-gFvLXX9QonpUCE6wKGs,12
+sqlpyhelper-0.1.2.dist-info/RECORD,,

sqlpyhelper-0.1.0.dist-info/RECORD

@@ -1,7 +0,0 @@
-sqlpyhelper/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-sqlpyhelper/db_helper.py,sha256=9z2WjA7tQaNZ1fd1TYZZAooJS2N8szescOtTMNDTCgE,4896
-sqlpyhelper-0.1.0.dist-info/licenses/LICENSE,sha256=9XzXxZ_8mWFM9-2TlqyE3L69zvRf4VPY_xIzSj5iU-g,1076
-sqlpyhelper-0.1.0.dist-info/METADATA,sha256=YTa0XzA-AliUNOIlRKZBolekfrTcXaVIpS6NRDea8dI,5211
-sqlpyhelper-0.1.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-sqlpyhelper-0.1.0.dist-info/top_level.txt,sha256=FrLqTmqTGDa8jHnnf2ZVkYO-gFvLXX9QonpUCE6wKGs,12
-sqlpyhelper-0.1.0.dist-info/RECORD,,