https://github.com/olliNiinivaara/SQLiteral
A higher level SQLite API
https://github.com/olliNiinivaara/SQLiteral
Last synced: 22 days ago
JSON representation
A higher level SQLite API
- Host: GitHub
- URL: https://github.com/olliNiinivaara/SQLiteral
- Owner: olliNiinivaara
- License: mit
- Created: 2020-04-14T16:27:36.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2025-02-13T12:11:49.000Z (4 months ago)
- Last Synced: 2025-02-13T13:26:04.122Z (4 months ago)
- Language: Nim
- Homepage:
- Size: 178 KB
- Stars: 50
- Watchers: 9
- Forks: 7
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-nim - SQLiteral - A high level SQLite API for Nim. (Data / Database)
README
# SQLiteral
A high level SQLite API for Nim
Supports multi-threading, prepared statements, proper typing,
zero-copy data paths, debugging, optimizing, backups, and more...
## Documentation
http://olliNiinivaara.github.io/SQLiteral/
## 5.0.1 Release notes (2025-02-13)
* `withRow` template fix by removing a superfluous `dirty` pragma
## 5.0.0 Release notes (2024-12-22)
* statements from more than one enum list can be used
* a statement is prepared automatically on first use
* all used statements are finalized automatically on close
* only the Nim default memory managers (ARC and ORC family) are supported
* errors that are not sqlite errors are logged with error code 10000
* failing to close raises an SQLError
* json_extract, json_patch, json_valid, and json_tree procs removed as too high level (esp. now that multiple statement lists are supported)
## Example
```nim
import sqliteral
const Schema = "CREATE TABLE IF NOT EXISTS Example(string TEXT NOT NULL)"
type SqlStatements = enum
Upsert = """INSERT INTO Example(rowid, string) VALUES(1, ?)
ON CONFLICT(rowid) DO UPDATE SET string = ?"""
SelectAll = "SELECT string FROM Example"
var db: SQLiteral
proc operate(i: string) =
let view: DbValue = i.toDb(3, 7) # zero-copy view into string
db.transaction: db.exec(Upsert, view, view)
for row in db.rows(SelectAll): echo row.getCString(0)
db.openDatabase("example.db", Schema)
var input = "012INPUT89"
operate(input)
db.close()
```