SQLPyHelper 0.1.1__tar.gz → 0.1.2__tar.gz

{sqlpyhelper-0.1.1 → sqlpyhelper-0.1.2}/PKG-INFO

@@ -1,12 +1,15 @@
 Metadata-Version: 2.4
 Name: SQLPyHelper
-Version: 0.1.1
+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.1 → sqlpyhelper-0.1.2}/README.md

@@ -27,9 +27,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
@@ -48,11 +51,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
@@ -97,6 +99,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.1 → sqlpyhelper-0.1.2}/SQLPyHelper.egg-info/PKG-INFO

@@ -1,12 +1,15 @@
 Metadata-Version: 2.4
 Name: SQLPyHelper
-Version: 0.1.1
+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/SQLPyHelper.egg-info/requires.txt

@@ -0,0 +1,19 @@
+psycopg2
+mysql-connector-python
+pyodbc
+cx_Oracle
+python-dotenv
+
+[mysql]
+mysql-connector-python
+
+[oracle]
+cx_Oracle
+
+[postgres]
+psycopg2
+
+[sqlite]
+
+[sqlserver]
+pyodbc

{sqlpyhelper-0.1.1 → sqlpyhelper-0.1.2}/setup.py

@@ -5,7 +5,7 @@ with open("README.md", "r", encoding="utf-8") as f:
 
 setup(
     name='SQLPyHelper',
-    version='0.1.1',
+    version='0.1.2',
     description='A simple SQL database helper package for Python.',
     long_description=long_description,
     long_description_content_type="text/markdown",
@@ -19,10 +19,20 @@ setup(
         'cx_Oracle',
         'python-dotenv'
     ],
+    extras_require={
+        "mysql": ["mysql-connector-python"],
+        "postgres": ["psycopg2"],
+        "oracle": ["cx_Oracle"],
+        "sqlserver": ["pyodbc"],
+        "sqlite": []
+    },
     python_requires=">=3.8",
     classifiers=[
         "Programming Language :: Python :: 3",
-        "License :: OSI Approved :: MIT License",
-        "Operating System :: OS Independent"
+        "Development Status :: 5 - Production/Stable",
+        "Intended Audience :: Developers",
+        "Topic :: Database :: Database Engines/Servers",
+        "Operating System :: OS Independent",
+        "License :: OSI Approved :: MIT License"
     ],
 )

{sqlpyhelper-0.1.1 → sqlpyhelper-0.1.2}/sqlpyhelper/__init__.py

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

{sqlpyhelper-0.1.1 → sqlpyhelper-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.1/SQLPyHelper.egg-info/requires.txt

@@ -1,5 +0,0 @@
-psycopg2
-mysql-connector-python
-pyodbc
-cx_Oracle
-python-dotenv