Py-SQLite-DB-Connection v1.0.9

Este paquete proporciona una clase Connect para gestionar conexiones y operaciones CRUD en bases de datos SQLite3 de manera sencilla y estandarizada, ahora con la capacidad de crear, modificar y eliminar tablas.

Instalación

Puedes instalar el paquete utilizando pip:

pip install PySQLiteDBConnection

Ejemplo de uso

Importar el paquete

from PySQLiteDBConnection import Connect

Crear una instancia de la clase Connect

database = Connect('path/to/your/database.db')

Establecer conexión a la base de datos

database.connect()

El método connect devuelve un booleano que representa el estado de la operación, en este caso, de la conexión con la base de datos, por lo que también puede guardarse en una variable para usarse más adelante en caso de ser requerido.

connected = database.connect()

Mostrar información sobre la base de datos

print(database)

Leer todos los registros de una tabla

table_data = database.read_table('table_name')

Insertar datos en una tabla

database.insert_into_table('table_name', {
    'column1': 'value1', 
    'column2': 'value2',
})

El método insert_into_table también devuelve un booleano que representa el estado de la operación.

inserted = database.insert_into_table('table_name', {
    'column1': 'value1', 
    'column2': 'value2',
})

Actualizar registros en una tabla

database.update_record('table_name', {'column1': 'new_value'}, {'column2': 'value2'})

El método update_record también devuelve un booleano que representa el estado de la operación.

updated = database.update_record('table_name', {'column1': 'new_value'}, {'column2': 'value2'})

Eliminar registros de una tabla

database.delete_record('table_name', {'column1': 'value1'})

El método delete_record también devuelve un booleano que representa el estado de la operación.

deleted = database.delete_record('table_name', {'column1': 'value1'})

Crear una tabla nueva

database.create_table('users', {
    'id': 'INTEGER PRIMARY KEY',
    'name': 'TEXT',
    'age': 'INTEGER'
})

El método create_table también devuelve un booleano que representa el estado de la operación.

created = database.create_table('users', {
    'id': 'INTEGER PRIMARY KEY',
    'name': 'TEXT',
    'age': 'INTEGER'
})

Agregar una columna nueva a una tabla existente

database.alter_table_add_column('users', 'email', 'TEXT')

El método alter_table_add_column también devuelve un booleano que representa el estado de la operación.

added_column = database.alter_table_add_column('users', 'email', 'TEXT')

Eliminar una tabla

database.drop_table('users')

El método drop_table también devuelve un booleano que representa el estado de la operación.

dropped = database.drop_table('users')

Cerrar la conexión con la base de datos

database.close()

Obtener estado de la conexión con la base de datos

Esta es otra forma de ver el estado de la conexión con la base de datos para el caso de que no se guarde el resultado del método connect.

print(f'Status: {database.get_status()}')

Nuevo en v1.0.9: Parámetro raise_exceptions

Se agregó el parámetro raise_exceptions (por defecto en False) al constructor de la clase Connect para darle la opción al usuario de levantar o no las excepciones que puedan llegar a ocurrir.

database = Connect('path/to/your/database.db', raise_exceptions=True)

Contribución

¡Las contribuciones son bienvenidas! Si encuentras algún error o tienes sugerencias para mejoras, siéntete libre de abrir un issue o enviar un pull request.