dbay

DBay

Table of Contents generated with DocToc

• Under Construction
• Introduction
• Documentation
• Note on Package Structure
  • better-sqlite3 an 'Unsaved' Dependency
• Use npm, Not pnpm
• To Do

Under Construction

DBay is the successor to and a re-write of icql-dba which you'll probably want to use for the time being until this package reaches MVP.

Introduction

DBay provides

• In-Process,
• In-Memory & File-Based
• Relational Data Processing
• for NodeJS
• with SQLite;
• being based on better-sqlite3,
• it works (almost) exclusively in a synchronous fashion.

Documentation

• Dbay object construction

Note on Package Structure

better-sqlite3 an 'Unsaved' Dependency

Since DBay depends on better-sqlite3 with a custom-configured build of the SQLite C engine, it is (for whatever reason) important that better-sqlite3 must not be listed under package.json#dependencies; otherwise, compilation will not work properly. The build script will run npm install better-sqlite3@'^7.4.3' but with an added --no-save flag.

Use npm, Not pnpm

Also, at the time of this writing (2021-09), while the project compiles fine using npm v7.21.1 (on NodeJS v16.9.1 on Linux Mint), but it fails using pnpm v6.14.6 with Unknown options: 'build-from-source', 'sqlite3'. Yarn has not been tried.

Note—These considerations only concern those who wish to fork/clone DBay to work on the code. Those who just want to use DBay as a dependency of their project can both either run npm install dbay or pnpm add dbay, both package managers work fine.

To Do

• [–] port foundational code from hengist &c
• [–] at construction time, allow dbnick when path is given and ram is false