Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/janet-lang/sqlite3
Bindings to sqlite for the Janet language.
https://github.com/janet-lang/sqlite3
Last synced: 2 months ago
JSON representation
Bindings to sqlite for the Janet language.
- Host: GitHub
- URL: https://github.com/janet-lang/sqlite3
- Owner: janet-lang
- License: mit
- Created: 2018-12-25T20:41:35.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2024-02-15T09:33:19.000Z (11 months ago)
- Last Synced: 2024-08-05T04:02:48.970Z (5 months ago)
- Language: C
- Size: 5.13 MB
- Stars: 42
- Watchers: 6
- Forks: 13
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-janet - sqlite3
README
# SQLite bindings
This native module proves sqlite bindings for janet.
## Install
```
jpm install sqlite3
```
## Building
To build, use the `jpm` tool and make sure you have janet installed.
```
jpm build
```
## Using the System's SQLite library
Usually, a Linux system has a package for SQLite installed globally.
This packages will usually have many plugins for SQlite enabled (e.g
JSON1, FTS3 etc.). The [Debian package][1] or [Gentoo ebuild][2] are good examples.
This package allows one to use it instead of the SQLite sources included with the package.
To do this use:
```
export JANET_SYSTEM_SQLITE=1
jpm build
```
Note, if you intead to install the package globally, use:
```
sudo -E jpm build
```
## Update the embedded SQLite version
You can use the jpm rule to update the version of SQLite included.
```
jpm run update-sqlite3
```
You can find the latest version https://sqlite.org/index.html.
## Example Usage
Next, enter the repl and create a database and a table.
By default, the generated module will be in the build folder.
```
janet:1:> (import build/sqlite3 :as sql)
nil
janet:2:> (def db (sql/open "test.db"))
janet:3:> (sql/eval db `CREATE TABLE customers(id INTEGER PRIMARY KEY, name TEXT);`)
@[]
janet:4:> (sql/eval db `INSERT INTO customers VALUES(:id, :name);` {:name "John" :id 12345})
@[]
janet:5:> (sql/eval db `SELECT * FROM customers;`)
@[{"id" 12345 "name" "John"}]
```
Load and use SQLite extensions.
```
janet:6:> (sql/allow-loading-extensions db)
false
janet:7:> (sql/load-extension db "/tmp/base64")
error: not authorized
in sqlite3/load-extension
in _thunk [janet] (tailcall) on line 4, column 1
janet:8:> (sql/allow-loading-extensions db true)
true
janet:9:> (sql/load-extension db "/tmp/base64")
"/tmp/base64"
janet:10:> (sql/eval db "select base64('YWJjMTIz') as b64")
@[{:b64 @"abc123"}]
```
Finally, close the database connection when done with it.
```
janet:11:> (sql/close db)
nil
```
[1]: https://git.launchpad.net/ubuntu/+source/sqlite3/tree/debian/rules?h=debian/sid#n41
[2]: https://github.com/gentoo/gentoo/blob/653b190ffe5f4433112ad6786d1bfd2e26143711/dev-db/sqlite/sqlite-3.34.0.ebuild