@comdec_/node_sqlite3 v1.1.1

Node SQLite3

Summary

• Node SQLite3
  • Summary
  • Introduction
  • Requirement
  • Installation
  • QuickStart
    • Connecting
    • Running SQL
    • Adding arguments
    • Running multiple queries
    • Running SQL files
  • Contribution and issues
    • Contributors

Introduction

Node SQLite is a small NodeJS package to create simple SQLite3 bindings using the pyhton standard libray.
It allow you to run easly SQL queries and mutation with one single async function. Like so :

const sqlite = require("node_sqlite3");

const connection = new sqlite.Connection("path/to/db/file");
const { rows } = await connection.runSql("SELECT * FROM mytable WHERE test > 1");

Requirement

• You have to install python3.8 or higher
• You have to install nodejs v16.8.0 or higher

Installation

npm i @comdec_/node_sqlite3
# You can either install the package with npm or yarn
yarn add @comdec_/node_sqlite3

Then import the module at the top of your file :

const sqlite = require("@comdec_/node_sqlite3");

QuickStart

Connecting

You can connect to your databae simply by importing the package and instantiating the connection :

const sqlite = require("@comdec_/node_sqlite3");

const connection = new sqlite.Connection("path/to/db/file");

Running SQL

Then, using this connection, you can run queries and mutations using the runSql function :

const { rows } = await connection.runSql("SELECT * FROM mytable WHERE test > 1");

This function is async and takes as parameter a string, witch represents your query or your mutation. It will return a Promise witch contain a QueryResponse.

The response can either contain an error, nothing or an Array of rows, witch you can access with the rows attribute of QueryResponse.

Adding arguments

You can aslo add argument to your query/mutation. To do so, simply add an array with these arguments, the function will automatically replace each "?" with the corresponding index argument :

// This is equal to run this : INSERT INTO users(name, email, phone) VALUES ("John Doe", "example@domain.com", "+33 6 12 34 56 78");
await connection.runSql(
  "INSERT INTO users(name, email, phone) VALUES (?, ?, ?);", 
  ["John Doe", "example@domain.com", "+33 6 12 34 56 78"]
);

Running multiple queries

Running the same query or mutation multiple times with differents armuments is sometimes boring, but you can use the Connection#runMany method to be more efficient :

// This is equal to run this : INSERT INTO users(name, email, phone) VALUES ("John Doe", "example@domain.com", "+33 6 12 34 56 78");
await connection.runMany(
  "INSERT INTO users(name, id) VALUES (?, ?);", 
  [
    ["John Doe", 1],
    ["John Doe", 2],
    ["John Doe", 3]
  ]
);

console.log((await connection.runSql("SELECT * FROM users")).toString());
// .---------------.
// |   name   | id |
// |----------|----|
// | John Doe |  1 |
// | John Doe |  2 |
// | John Doe |  3 |
// '---------------'

The method return an array witch contain all of the QueryResponse of each SQL mutation/query.

Running SQL files

You can also run entire SQL files : index.js :

await connection.runSql("CREATE TABLE IF NOT EXISTS users (name VARCHAR(40), id INT);")
await connection.runFile('./test.sql');
  
console.log((await connection.runSql("SELECT * FROM users")).toString());

test.sql :

INSERT INTO users(name, id) VALUES ("John Doe", 3);

INSERT INTO users(name, id) VALUES ("John Doe", 4);

INSERT INTO users(name, id) VALUES (
  "John Doe", 5
);

This will print

.---------------.
|   name   | id |
|----------|----|
| John Doe |  3 |
| John Doe |  4 |
| John Doe |  5 |
'---------------'

The method takes as argument the file path (relative or absolute) witch represents the location of the file you want to execute and return an array witch contain all of the QueryResponse of each SQL mutation/query.

Contribution and issues

If you encounter an issue or want to ask for a feature, feel free to create an issue

If you want to contribute, you can create some pull requests to fix issues, all the help is welcome !

Contributors