SQLAZO

"Sqlazo" es un módulo el cual permite gestionar procedimientos básicos en una base de datos con "sqlite3" en PYTHON.

Antes de ejecutar algún comando de este módulo, le recomiendo que revise estos dos módulos antes:
Chromologger
Chromolog

Inicialización

Para iniciar, su uso, iniciaría con una instancia de la clase Database, la cual toma como argumentos los siguientes parámetros:

• name:str: Nombre de la base de datos (Ej: 'test.db').
• check_thread:boolean: Verificar ejecuciones multihilo.

# Ejemplo de inicialización
from sqlazo import Database

db = Database('test.db', False)
# Creará un archivo test.db listo para usar...

Métodos públicos disponibles:

• create_table: Permite crear una tabla en la base de datos conectada.
  • Parámetros:
    • table_name:str: Nombre de la tabla que se quiere crear.
    • cols:list: Una lista de las columnas que contendrá la tabla cada columna (dentro de la lista) debe llevar su configuración.

# Columnas con sus configuraciones
cols = ['id INTEGER PRIMARY KEY', 'name TEXT NOT NULL', 'age INTEGER NOT NULL']
# Ejecutar "consulta" (Crear tabla)
db.create_table('user', cols)

• insert_data: Ejecuta la "consulta" de inserción en la base de datos (Agrega datos).
  • Parámetros:
  • data:list: Datos que a agregar.
  • cols:list: Columnas en las cuales se insertará los datos.
  • table_name:str: Nombre de la tabla con la cual se trabajará.

db.insert_data(['Santiago', 19], ['name', 'age'], 'user')

• get_data_all: Ejecuta la "consulta" para obtener todos los registros de la base de datos.
  • Parámetros:
    • tablename:str: Nombre de la tabla de la cual se obtendrá los registros.

db.get_data_all('user')

• get_data_where: Ejecuta la "consulta" para obtener registros con "consulta personalizada".
  • Parámetros:
    • table_name:str: Nombre de la tabla con la cual se trabajará.
    • condition:str: Condición para los retornos válidos de la "consulta".
    • *args:str: Nombres de las columnas que serán seleccionadas en la "consulta".

# Si el tercer parámetro existe, solo se tomarán esa columnas en la "consulta"
# Retornará los registros que cumplen la condición, y solo retornará la columna "name"
# select name from user where id < 3
db.get_data_where('user', 'id < 3', 'name')

# En caso de no existir los *args, se da por entendido que se seleccionarán todas las columnas
# Retorna los registros válidos a la condición y todas las columnas
# select * from user where id < 3*
db.get_data_where('user', 'id < 3')

• delete_data: Eliminar registros dea base de datos.
  • Parámetros:
    • table:str: Nombre de la tabla con la cual se trabajará.
    • condition:str: Condición que debe cumplir un registro para ser eliminado.

# Eliminar los usuarios menores de edad
db.delete_data('user', 'age < 18')

• close: Cerrar conexión con la base de datos.

# Cerrar conexión con la base de datos
db.close()

Métodos privados 🔏

• __connect: Realizar conexión a la base de datos.
• __commit: "Refrescar" cambios en la base de datos.
• __cursor: Crea un cursor en la conexión a la base de datos, el cual permite "ejecutar consultas".

# Sólo de uso interno

Ejemplo de uso completo:

    # Ejemplo de inicialización
    from sqlazo import Database
    
    db = Database('test.db', False)
    
    # Columnas con sus configuraciones
    cols = ['id INTEGER PRIMARY KEY', 'name TEXT NOT NULL', 'age INTEGER NOT NULL']
    # Ejecutar "consulta" (Crear tabla)
    db.create_table('user', cols)
    db.insert_data(['Santiago', 19], ['name', 'age'], 'user')
    
    dataAll = db.get_data_all('user')
    
    # Si el tercer parámetro existe, solo se tomarán esa columnas en la "consulta"
    # Retornará los registros que cumplen la condición, y solo retornará la columna "name"
    # select name from user where id < 3
    data_where1 = db.get_data_where('user', 'id < 3', 'name')
    
    # En caso de no existir los *args, se da por entendido que se seleccionarán todas las columnas
    # Retorna los registros válidos a la condición y todas las columnas
    # select * from user where id < 3*
    data_where12 = db.get_data_where('user', 'id < 3')
    
    # Eliminar los usuarios menores de edad
    db.delete_data('user', 'age < 18')
    
    # Cerrar conexión con la base de datos
    db.close()