sqlitables 0.1.0__py3-none-any.whl

sqlitables/__init__.py

@@ -0,0 +1 @@
+from sqlitables import classes, connection

sqlitables/classes.py

@@ -0,0 +1,58 @@
+import sqlite3
+
+class Column:
+    def __init__(self, name: str, datatype: str):
+        self.name = name
+        self.datatype = datatype
+    def statement(self):
+        statement = f'"{self.name}" {self.datatype}'
+        return statement
+
+class Table:
+    def __init__(self, name: str, columns: list[Column]):
+        self.name = name
+        self.columns = columns
+    def exists(self, cursor: sqlite3.Cursor):
+        sql = f'SELECT name FROM sqlite_master WHERE type="table" AND name="{self.name}";'
+        find = cursor.execute(sql)
+        exists = True if find.fetchone() else False
+        return exists
+    def create(self, cursor: sqlite3.Cursor):
+        sql = f'CREATE TABLE "{self.name}"( '
+        for index, column in enumerate(self.columns):
+            sql += column.statement()
+            if index != len(self.columns) - 1: sql += ', '
+        sql += ');'
+        cursor.execute(sql)
+    def insert(self, values: list[tuple], connection: sqlite3.Connection):
+        sql = f'INSERT INTO "{self.name}" VALUES '
+        for index, value in enumerate(values): # enumerate list
+            sql += '('
+            for tupleindex, field in enumerate(value): # enumerate tuple
+                if type(field) == str:
+                    sql += f'"{field}"'
+                else:
+                    sql += str(field)
+                if tupleindex != len(value) - 1: sql += ', '
+            sql += ')'
+            if index != len(values) - 1: sql += ', '
+        sql += ';'
+        connection.cursor().execute(sql).close()
+        connection.commit()
+    def select(self, select: list[Column] | str, where: str | None, cursor: sqlite3.Cursor):
+        sql = 'SELECT '
+        if type(select) == str:
+            if select == "*":
+                sql += f'* FROM {self.name}'
+            else:
+                raise ValueError('The select parameter can only include a list of Column objects or "*".')
+        else:
+            for index, col in enumerate(select):
+                sql += f'"{col.name}"' # type: ignore ;; reads col a possible string when it is not.
+                if index != len(select) - 1: sql += ', '
+            sql += f' FROM {self.name}'
+        if where:
+            sql += f' WHERE {where}'
+        sql += ";"
+        selection = cursor.execute(sql)
+        return selection.fetchall()

sqlitables/connection.py

@@ -0,0 +1,6 @@
+import sqlite3
+
+def connect(file_path):
+    connection = sqlite3.connect(file_path)
+    cursor = connection.cursor()
+    return connection, cursor

sqlitables-0.1.0.dist-info/METADATA

@@ -0,0 +1,29 @@
+Metadata-Version: 2.4
+Name: sqlitables
+Version: 0.1.0
+Summary: Create and maintain SQLite databases more efficiently using object-oriented concepts
+Project-URL: Repository, https://github.com/MICHI64N/sqlitables
+Project-URL: Changelog, https://github.com/MICHI64N/sqlitables/blob/main/CHANGELOG.md
+Author-email: Samantha Bales <samanthabales2006@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: classes,database,object-oriented,oop,sql,sqlite
+Classifier: Development Status :: 1 - Planning
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Database
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+
+# SQLiTables
+*Create and maintain SQLite databases more efficiently using object-oriented concepts*
+## Resources
+* SQLiTables is built on top of sqlite3, a standard Python module. [Its documentation](https://docs.python.org/3/library/sqlite3.html) may be helpful for using this library.
+## Features
+*This is an early-stage project with limited features.*
+* Connect to the database ([usage](https://github.com/MICHI64N/sqlitables/blob/main/docs/usage.md#connect-to-the-database)).
+* Create a table in the database ([usage](https://github.com/MICHI64N/sqlitables/blob/main/docs/usage.md#create-a-table-in-the-database)).
+* Insert values into a table ([usage](https://github.com/MICHI64N/sqlitables/blob/main/docs/usage.md#insert-values-into-a-table)).
+* Select values from a table ([usage](https://github.com/MICHI64N/sqlitables/blob/main/docs/usage.md#select-values-from-a-table)).

sqlitables-0.1.0.dist-info/RECORD

@@ -0,0 +1,7 @@
+sqlitables/__init__.py,sha256=G3EMZK21hxvn3RkIMrv1HrQ53MpHwuq8GCZTF90mH6M,42
+sqlitables/classes.py,sha256=1A4rHEUCYdESTgY6HOwqeJRhqyh5MaXN0KMEFngnwdU,2323
+sqlitables/connection.py,sha256=RbiQaQrHskG46mtZdfLYNhHI_3UPWYcInvbd-P_Dq8g,146
+sqlitables-0.1.0.dist-info/METADATA,sha256=zYuv-EKzdhIZTojURqmT-ak9uWAlbEnl4r2ykreb8Us,1703
+sqlitables-0.1.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+sqlitables-0.1.0.dist-info/licenses/LICENSE,sha256=MgG-JhWsi6Z2TV6l-TtuW9LnEHo0LJIWtm15BSwkssA,1070
+sqlitables-0.1.0.dist-info/RECORD,,

sqlitables-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.29.0
+Root-Is-Purelib: true
+Tag: py3-none-any

sqlitables-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Samantha Bales
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.