sqlmath 0.0.1 → 2021.11.20

package/.npmignore

@@ -0,0 +1,10 @@
+*
+.*
+!.npmignore
+!CHANGELOG.md
+!LICENSE
+!README.md
+
+!_binary_*
+!jslint.mjs
+!sqlmath.mjs

package/CHANGELOG.md

@@ -1,4 +1,55 @@
 # Changelog
+
+# Todo
+- none
+
+# v2021.11.20
+- npm publish v2021.10.20
+- update to jslint v2021.10.20
+- refactor - replace nodejs-buffer-api-calls with DataView / TextDecoder / TextEncoder
+
+# v2021.10.20
+- revamp - update to jslint_ci.sh from 2020.10.2
+
+# v2021.9.9
+- add sql-function slr_ohlcv() with tests
+- update file jslint_ci.sh with chorish shell-functions
+- update function dbOpenAsync with ability to create thread-pool with multiple connections
+
+# v2021.9.8
+- merge files in sqlite-autoconf-3360000 into sqlite3.c, sqlite3_ext.c, sqlite3_shell.c
+
+# v2021.9.4
+- add functions dbGetLastBlob, dbTableInsertAsync
+- merge file sqlmath_napi.c into sqlmath.c
+- merge file test.js into sqlmath.mjs
+- migrate repo to https://github.com/sqlmath/sqlmath
+- migrate to esm and rename sqlmath.js to sqlmath.mjs
+
+# v2021.8.26
+- merge files sqlmath.h and sqlmath_napi.c into sqlmath.c
+- add async functions dbOpen, dbExec, dbClose
+- inline function sqlite3_extension_functions_init without auto_extension
+- disable warnings for all targets except sqlmath.c and sqlmath_napi.c
+- fix build for darwin and win32.
+
+# v2021.8.24
+- add addon functions dbOpen(), dbClose(), dbExec(). but ci works only in linux.
+
+# v2021.8.16
+- add extension-function b64decode()
+- add c-function sqlite3_exec_get_tables().
+- add target_cli.
+- binaries - upload darwin/linux/win32 binaries to gh-pages.
+- begin compiling sqlmath.c.
+- jslint file sqlmath.js.
+- merge file test-old-prepare.db into test-old.js.
+
+# v2021.8.6
+- add coverage testing.
+- add extension-function support.
+- fork repo as sqlmath.
+
 ## 5.0.2
 - build: rebuild binaries before publishing [#1426](https://github.com/mapbox/node-sqlite3/pull/1426)
 
@@ -13,7 +64,7 @@
 
 ## 5.0.0
 - prebuilt: Node 14 support, dropped support for all version of Node < 10 [#1304](https://github.com/mapbox/node-sqlite3/pull/1304)
-- prebuilt: add electron 7.2 [#1324](https://github.com/mapbox/node-sqlite3/pull/1324) 
+- prebuilt: add electron 7.2 [#1324](https://github.com/mapbox/node-sqlite3/pull/1324)
 - napi: refactor codebase to use N-API instead of NAN (+ various improvements) [#1304](https://github.com/mapbox/node-sqlite3/pull/1304)
 - trace: don't require throw to add trace info for verbose [#1317](https://github.com/mapbox/node-sqlite3/pull/1317)
 - ci: remove permission setting [#1319](https://github.com/mapbox/node-sqlite3/pull/1319)
@@ -276,7 +327,7 @@ Released July 14th, 2014
 
 Released Jan 13th, 2014
 
- - updated internal libsqlite3 from 3.7.17 -> 3.8.2 (https://www.sqlite.org/news.html) which includes the next-generation query planner http://www.sqlite.org/queryplanner-ng.html
+ - updated internal libsqlite3 from 3.7.17 -> 3.8.2 (https://www.sqlite.org/news.html) which includes the next-generation query planner https://www.sqlite.org/queryplanner-ng.html
  - improved binary deploy system using https://github.com/springmeyer/node-pre-gyp
  - binary install now supports http proxies
  - source compile now supports freebsd

package/LICENSE

@@ -1,25 +1,19 @@
-Copyright (c) MapBox
-All rights reserved.
+Copyright (c) 2021 Kai Zhu
 
-Redistribution and use in source and binary forms, with or without modification,
-are permitted provided that the following conditions are met:
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
 
-- Redistributions of source code must retain the above copyright notice, this
-  list of conditions and the following disclaimer.
-- Redistributions in binary form must reproduce the above copyright notice, this
-  list of conditions and the following disclaimer in the documentation and/or
-  other materials provided with the distribution.
-- Neither the name "MapBox" nor the names of its contributors may be
-  used to endorse or promote products derived from this software without
-  specific prior written permission.
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
 
-THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
-ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
-WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
-DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR
-ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
-(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
-LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
-ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
-SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,230 +1,29 @@
-Asynchronous, non-blocking [SQLite3](https://sqlite.org/) bindings for [Node.js](http://nodejs.org/).
+# sqlmath - sqlite for data-science
 
-[![NPM](https://nodei.co/npm/sqlite3.png?downloads=true&downloadRank=true)](https://nodei.co/npm/sqlite3/)
 
-[![Build Status](https://travis-ci.org/mapbox/node-sqlite3.svg?branch=master)](https://travis-ci.org/mapbox/node-sqlite3)
-[![Build status](https://ci.appveyor.com/api/projects/status/gvm7ul0hpmdawqom)](https://ci.appveyor.com/project/Mapbox/node-sqlite3)
-[![Coverage Status](https://coveralls.io/repos/mapbox/node-sqlite3/badge.svg?branch=master&service=github)](https://coveralls.io/github/mapbox/node-sqlite3?branch=master)
-[![Dependencies](https://david-dm.org/mapbox/node-sqlite3.svg)](https://david-dm.org/mapbox/node-sqlite3)
-[![FOSSA Status](https://app.fossa.io/api/projects/git%2Bhttps%3A%2F%2Fgithub.com%2Fmapbox%2Fnode-sqlite3.svg?type=shield)](https://app.fossa.io/projects/git%2Bhttps%3A%2F%2Fgithub.com%2Fmapbox%2Fnode-sqlite3?ref=badge_shield)
-[![N-API v3 Badge](https://img.shields.io/badge/N--API-v3-green.svg)](https://nodejs.org/dist/latest/docs/api/n-api.html#n_api_n_api)
+# Status
+| Branch | [master<br>(v2021.11.20)](https://github.com/sqlmath/sqlmath/tree/master) | [beta<br>(Web Demo)](https://github.com/sqlmath/sqlmath/tree/beta) | [alpha<br>(Development)](https://github.com/sqlmath/sqlmath/tree/alpha) |
+|--:|:--:|:--:|:--:|
+| CI | [![ci](https://github.com/sqlmath/sqlmath/actions/workflows/ci.yml/badge.svg?branch=master)](https://github.com/sqlmath/sqlmath/actions?query=branch%3Amaster) | [![ci](https://github.com/sqlmath/sqlmath/actions/workflows/ci.yml/badge.svg?branch=beta)](https://github.com/sqlmath/sqlmath/actions?query=branch%3Abeta) | [![ci](https://github.com/sqlmath/sqlmath/actions/workflows/ci.yml/badge.svg?branch=alpha)](https://github.com/sqlmath/sqlmath/actions?query=branch%3Aalpha) |
+| Coverage | [![coverage](https://sqlmath.github.io/sqlmath/branch-master/.artifact/coverage/coverage_badge.svg)](https://sqlmath.github.io/sqlmath/branch-master/.artifact/coverage/index.html) | [![coverage](https://sqlmath.github.io/sqlmath/branch-beta/.artifact/coverage/coverage_badge.svg)](https://sqlmath.github.io/sqlmath/branch-beta/.artifact/coverage/index.html) | [![coverage](https://sqlmath.github.io/sqlmath/branch-alpha/.artifact/coverage/coverage_badge.svg)](https://sqlmath.github.io/sqlmath/branch-alpha/.artifact/coverage/index.html) |
+| Artifacts | [<img src="asset_image_folder_open_solid.svg" height="30">](https://github.com/sqlmath/sqlmath/tree/gh-pages/branch-master/.artifact) | [<img src="asset_image_folder_open_solid.svg" height="30">](https://github.com/sqlmath/sqlmath/tree/gh-pages/branch-beta/.artifact) | [<img src="asset_image_folder_open_solid.svg" height="30">](https://github.com/sqlmath/sqlmath/tree/gh-pages/branch-alpha/.artifact) |
 
-## Supported platforms
 
-The `sqlite3` module works with:
-* Node.js v11.x, v12.x, v13.x and v14.x.
-* Electron v6.0.x, v6.1.x, v7.0.x, v7.1.x, v8.0.x, v8.1.x and v8.2.x
+<br><br>
+# Table of Contents
 
-Binaries for most Node versions and platforms are provided by default via [node-pre-gyp](https://github.com/mapbox/node-pre-gyp).
+1. [Package Listing](#package-listing)
 
-The `sqlite3` module also works with [node-webkit](https://github.com/rogerwang/node-webkit) if node-webkit contains a supported version of Node.js engine. [(See below.)](#building-for-node-webkit)
+2. [Changelog](#changelog)
 
-SQLite's [SQLCipher extension](https://github.com/sqlcipher/sqlcipher) is also supported. [(See below.)](#building-for-sqlcipher)
 
-# Usage
+<br><br>
+# Package Listing
+![screenshot_package_listing.svg](https://jslint-org.github.io/jslint/branch-beta/.artifact/screenshot_package_listing.svg)
 
-**Note:** the module must be [installed](#installing) before use.
 
-``` js
-var sqlite3 = require('sqlite3').verbose();
-var db = new sqlite3.Database(':memory:');
+<br><br>
+# Changelog
+- [Full CHANGELOG.md](CHANGELOG.md)
 
-db.serialize(function() {
-  db.run("CREATE TABLE lorem (info TEXT)");
-
-  var stmt = db.prepare("INSERT INTO lorem VALUES (?)");
-  for (var i = 0; i < 10; i++) {
-      stmt.run("Ipsum " + i);
-  }
-  stmt.finalize();
-
-  db.each("SELECT rowid AS id, info FROM lorem", function(err, row) {
-      console.log(row.id + ": " + row.info);
-  });
-});
-
-db.close();
-```
-
-# Features
-
- - Straightforward query and parameter binding interface
- - Full Buffer/Blob support
- - Extensive [debugging support](https://github.com/mapbox/node-sqlite3/wiki/Debugging)
- - [Query serialization](https://github.com/mapbox/node-sqlite3/wiki/Control-Flow) API
- - [Extension support](https://github.com/mapbox/node-sqlite3/wiki/Extensions), including bundled support for the [json1 extension](https://www.sqlite.org/json1.html).
- - Big test suite
- - Written in modern C++ and tested for memory leaks
- - Bundles SQLite3 3.32.3 as a fallback if the installing system doesn't include SQLite
-
-# API
-
-See the [API documentation](https://github.com/mapbox/node-sqlite3/wiki) in the wiki.
-
-# Installing
-
-You can use [`npm`](https://github.com/isaacs/npm) to download and install:
-
-* The latest `sqlite3` package: `npm install sqlite3`
-
-* GitHub's `master` branch: `npm install https://github.com/mapbox/node-sqlite3/tarball/master`
-
-The module uses [node-pre-gyp](https://github.com/mapbox/node-pre-gyp) to download a pre-compiled binary for your platform, if it exists. Otherwise, it uses `node-gyp` to build the extension.
-
-It is also possible to make your own build of `sqlite3` from its source instead of its npm package ([see below](#building-from-the-source)).
-
-It is possible to use the installed package in [node-webkit](https://github.com/rogerwang/node-webkit) instead of the vanilla Node.js. See [Building for node-webkit](#building-for-node-webkit) for details.
-
-## Source install
-
-To skip searching for pre-compiled binaries, and force a build from source, use
-
-    npm install --build-from-source
-
-The sqlite3 module depends only on libsqlite3. However, by default, an internal/bundled copy of sqlite will be built and statically linked, so an externally installed sqlite3 is not required.
-
-If you wish to install against an external sqlite then you need to pass the `--sqlite` argument to `npm` wrapper:
-
-    npm install --build-from-source --sqlite=/usr/local
-
-If building against an external sqlite3 make sure to have the development headers available. Mac OS X ships with these by default. If you don't have them installed, install the `-dev` package with your package manager, e.g. `apt-get install libsqlite3-dev` for Debian/Ubuntu. Make sure that you have at least `libsqlite3` >= 3.6.
-
-Note, if building against homebrew-installed sqlite on OS X you can do:
-
-    npm install --build-from-source --sqlite=/usr/local/opt/sqlite/
-
-By default the node-gyp install will use `python` as part of the installation. A
-different python executable can be specified on the command line.
-
-    npm install --build-from-source --python=/usr/bin/python2
-
-This uses the npm_config_python config, so values in .npmrc will be honoured:
-
-    python=/usr/bin/python2
-
-## Custom file header (magic)
-
-The default sqlite file header is "SQLite format 3".  
-You can specify a different magic, though this will make standard tools and libraries unable to work with your files.
-
-
-    npm install --build-from-source --sqlite_magic="MyCustomMagic15"
-
-
-Note that the magic *must* be exactly 15 characters long (16 bytes including null terminator).
-    
-## Building for node-webkit
-
-Because of ABI differences, `sqlite3` must be built in a custom to be used with [node-webkit](https://github.com/rogerwang/node-webkit).
-
-To build node-sqlite3 for node-webkit:
-
-1. Install [`nw-gyp`](https://github.com/rogerwang/nw-gyp) globally: `npm install nw-gyp -g` *(unless already installed)*
-
-2. Build the module with the custom flags of `--runtime`, `--target_arch`, and `--target`:
-
-```sh
-NODE_WEBKIT_VERSION="0.8.6" # see latest version at https://github.com/rogerwang/node-webkit#downloads
-npm install sqlite3 --build-from-source --runtime=node-webkit --target_arch=ia32 --target=$(NODE_WEBKIT_VERSION)
-```
-
-This command internally calls out to [`node-pre-gyp`](https://github.com/mapbox/node-pre-gyp) which itself calls out to [`nw-gyp`](https://github.com/rogerwang/nw-gyp) when the `--runtime=node-webkit` option is passed.
-
-You can also run this command from within a `node-sqlite3` checkout:
-
-```sh
-npm install --build-from-source --runtime=node-webkit --target_arch=ia32 --target=$(NODE_WEBKIT_VERSION)
-```
-
-Remember the following:
-
-* You must provide the right `--target_arch` flag. `ia32` is needed to target 32bit node-webkit builds, while `x64` will target 64bit node-webkit builds (if available for your platform).
-
-* After the `sqlite3` package is built for node-webkit it cannot run in the vanilla Node.js (and vice versa).
-   * For example, `npm test` of the node-webkit's package would fail.
-
-Visit the “[Using Node modules](https://github.com/rogerwang/node-webkit/wiki/Using-Node-modules)” article in the node-webkit's wiki for more details.
-
-## Building for sqlcipher
-
-For instructions for building sqlcipher see
-[Building SQLCipher for node.js](https://coolaj86.com/articles/building-sqlcipher-for-node-js-on-raspberry-pi-2/)
-
-To run node-sqlite3 against sqlcipher you need to compile from source by passing build options like:
-
-    npm install sqlite3 --build-from-source --sqlite_libname=sqlcipher --sqlite=/usr/
-
-    node -e 'require("sqlite3")'
-
-If your sqlcipher is installed in a custom location (if you compiled and installed it yourself),
-you'll also need to to set some environment variables:
-
-### On OS X with Homebrew
-
-Set the location where `brew` installed it:
-
-    export LDFLAGS="-L`brew --prefix`/opt/sqlcipher/lib"
-    export CPPFLAGS="-I`brew --prefix`/opt/sqlcipher/include"
-    npm install sqlite3 --build-from-source --sqlite_libname=sqlcipher --sqlite=`brew --prefix`
-
-    node -e 'require("sqlite3")'
-
-### On most Linuxes (including Raspberry Pi)
-
-Set the location where `make` installed it:
-
-    export LDFLAGS="-L/usr/local/lib"
-    export CPPFLAGS="-I/usr/local/include -I/usr/local/include/sqlcipher"
-    export CXXFLAGS="$CPPFLAGS"
-    npm install sqlite3 --build-from-source --sqlite_libname=sqlcipher --sqlite=/usr/local --verbose
-
-    node -e 'require("sqlite3")'
-
-### Custom builds and Electron
-
-Running sqlite3 through [electron-rebuild](https://github.com/electron/electron-rebuild) does not preserve the sqlcipher extension, so some additional flags are needed to make this build Electron compatible. Your `npm install sqlite3 --build-from-source` command needs these additional flags (be sure to replace the target version with the current Electron version you are working with):
-
-    --runtime=electron --target=1.7.6 --dist-url=https://electronjs.org/headers
-
-In the case of MacOS with Homebrew, the command should look like the following:
-
-    npm install sqlite3 --build-from-source --sqlite_libname=sqlcipher --sqlite=`brew --prefix` --runtime=electron --target=1.7.6 --dist-url=https://electronjs.org/headers
-
-# Testing
-
-[mocha](https://github.com/visionmedia/mocha) is required to run unit tests.
-
-In sqlite3's directory (where its `package.json` resides) run the following:
-
-    npm install mocha
-    npm test
-
-# Contributors
-
-* [Konstantin Käfer](https://github.com/kkaefer)
-* [Dane Springmeyer](https://github.com/springmeyer)
-* [Will White](https://github.com/willwhite)
-* [Orlando Vazquez](https://github.com/orlandov)
-* [Artem Kustikov](https://github.com/artiz)
-* [Eric Fredricksen](https://github.com/grumdrig)
-* [John Wright](https://github.com/mrjjwright)
-* [Ryan Dahl](https://github.com/ry)
-* [Tom MacWright](https://github.com/tmcw)
-* [Carter Thaxton](https://github.com/carter-thaxton)
-* [Audrius Kažukauskas](https://github.com/audriusk)
-* [Johannes Schauer](https://github.com/pyneo)
-* [Mithgol](https://github.com/Mithgol)
-
-# Acknowledgments
-
-Thanks to [Orlando Vazquez](https://github.com/orlandov),
-[Eric Fredricksen](https://github.com/grumdrig) and
-[Ryan Dahl](https://github.com/ry) for their SQLite bindings for node, and to mraleph on Freenode's #v8 for answering questions.
-
-Development of this module is sponsored by [MapBox](https://mapbox.com/).
-
-# License
-
-`node-sqlite3` is [BSD licensed](https://github.com/mapbox/node-sqlite3/raw/master/LICENSE).
-
-[![FOSSA Status](https://app.fossa.io/api/projects/git%2Bhttps%3A%2F%2Fgithub.com%2Fmapbox%2Fnode-sqlite3.svg?type=large)](https://app.fossa.io/projects/git%2Bhttps%3A%2F%2Fgithub.com%2Fmapbox%2Fnode-sqlite3?ref=badge_large)
+![screenshot_changelog.svg](https://jslint-org.github.io/jslint/branch-beta/.artifact/screenshot_changelog.svg)