SQLite-signup 1.0.0__py3-none-any.whl

SQLite_signup/__init__.py

@@ -0,0 +1,13 @@
+from .database import (
+    register_user,
+    delete_user,
+    get_all_users,
+    initialize_database,
+)
+
+__all__ = [
+    "register_user",
+    "delete_user",
+    "get_all_users",
+    "initialize_database",
+]

SQLite_signup/database.py

@@ -0,0 +1,131 @@
+"""
+Module for managing user data persistence using SQLite.
+
+This module provides a robust interface for performing CRUD operations on a 
+user database, ensuring schema integrity and connection safety through 
+context management.
+"""
+
+import sqlite3
+from contextlib import contextmanager
+
+DATABASE_NAME = 'users_database.db'
+
+@contextmanager
+def get_db_connection():
+    """
+    Provides a managed connection to the SQLite database.
+
+    Yields:
+        sqlite3.Connection: An active database connection object.
+
+    Notes:
+        Ensures that the connection is automatically closed after the block 
+        execution, preventing memory leaks and dangling file handles.
+    """
+    conn = sqlite3.connect(DATABASE_NAME)
+    try:
+        yield conn
+    finally:
+        conn.close()
+
+def initialize_database():
+    """
+    Ensures the required schema exists in the database.
+
+    This function acts as a safety check to guarantee the table structure is 
+    present before any data operations occur, eliminating the need for 
+    external migration scripts in simple deployments.
+    """
+    with get_db_connection() as conn:
+        conn.execute('''
+            CREATE TABLE IF NOT EXISTS users (
+                id INTEGER PRIMARY KEY AUTOINCREMENT,
+                first_name TEXT,
+                last_name TEXT,
+                phone TEXT,
+                email TEXT
+            )
+        ''')
+        conn.commit()
+
+def register_user(first_name: str, last_name: str, phone: str, email: str) -> bool:
+    """
+    Persists a new user record into the database.
+
+    Args:
+        first_name (str): User's first name.
+        last_name (str): User's last name.
+        phone (str): Contact phone number.
+        email (str): Contact email address.
+
+    Returns:
+        bool: True if insertion was successful, False otherwise.
+    """
+    try:
+        initialize_database()
+        with get_db_connection() as conn:
+            conn.execute(
+                "INSERT INTO users (first_name, last_name, phone, email) VALUES (?, ?, ?, ?)",
+                (first_name, last_name, phone, email)
+            )
+            conn.commit()
+        return True
+    except sqlite3.Error as e:
+        print(f"Database error during registration: {e}")
+        return False
+
+def delete_user(user_id: int) -> bool:
+    """
+    Removes a user by ID and re-indexes the table to maintain sequential IDs.
+
+    Args:
+        user_id (int): The primary key of the user to remove.
+
+    Returns:
+        bool: True if the user was found and deleted, False otherwise.
+    """
+    try:
+        with get_db_connection() as conn:
+            cursor = conn.cursor()
+            cursor.execute("DELETE FROM users WHERE id = ?", (user_id,))
+            
+            # Verify if the target ID existed before proceeding with re-indexing
+            if cursor.rowcount == 0:
+                return False
+            
+            # Cache remaining records to reconstruct the table without gaps
+            remaining_users = cursor.execute(
+                "SELECT first_name, last_name, phone, email FROM users"
+            ).fetchall()
+            
+            # Clear existing data and reset the auto-increment counter
+            cursor.execute("DELETE FROM users")
+            cursor.execute("DELETE FROM sqlite_sequence WHERE name='users'")
+            
+            # Re-insert records to ensure primary keys remain contiguous
+            cursor.executemany(
+                "INSERT INTO users (first_name, last_name, phone, email) VALUES (?, ?, ?, ?)",
+                remaining_users
+            )
+            conn.commit()
+            return True
+    except sqlite3.Error as e:
+        print(f"Database error during deletion: {e}")
+        return False
+
+def get_all_users() -> list:
+    """
+    Retrieves all user records currently stored in the database.
+
+    Returns:
+        list: A list of tuples containing user data, or an empty list on failure.
+    """
+    try:
+        with get_db_connection() as conn:
+            cursor = conn.cursor()
+            cursor.execute("SELECT * FROM users")
+            return cursor.fetchall()
+    except sqlite3.Error as e:
+        print(f"Database error during retrieval: {e}")
+        return []

sqlite_signup-1.0.0.dist-info/METADATA

@@ -0,0 +1,7 @@
+Metadata-Version: 2.4
+Name: SQLite_signup
+Version: 1.0.0
+Summary: Simple SQLite user management library
+Author: Your Name
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown

sqlite_signup-1.0.0.dist-info/RECORD

@@ -0,0 +1,6 @@
+SQLite_signup/__init__.py,sha256=IUWFJWDReaVs9RjOM2XlxjlWH3210ASOvJ3qyCpAls0,220
+SQLite_signup/database.py,sha256=aJqsrb2_vgWyt6FvYfCCx-48XKOuah3piIiy8tnQa_o,4343
+sqlite_signup-1.0.0.dist-info/METADATA,sha256=Jux5G76OU4_abZ7UU9UgYUPEzzLWFslOK4pDjTRSqzw,193
+sqlite_signup-1.0.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+sqlite_signup-1.0.0.dist-info/top_level.txt,sha256=6ro-6HZrOKOBUynxvc3MgzqYL71SwnpE317XpJIryZE,14
+sqlite_signup-1.0.0.dist-info/RECORD,,

sqlite_signup-1.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

sqlite_signup-1.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+SQLite_signup