La función insert() permite insertar registros en una base de datos SQLite de forma estructurada, segura y eficiente.

Es el núcleo de inserción del sistema y sirve como base para:

• PanCakesORM.insert()
• CoffeeShop.i() (modo declarativo)

Firma de la función

insert(
    db_path: str,
    params: list
)

Funcionamiento general

El flujo interno es:

1. Validación de tipos (db_path, params)
2. Validación de estructura de cada entrada
3. Construcción de sentencias INSERT INTO
4. Generación dinámica de placeholders (?)
5. Ejecución con executemany()
6. Retorno True si la operación es exitosa

Parámetros

db_path

Ruta al archivo SQLite.