https://github.com/as400jplpc/zig_sqlite
work sqlite
https://github.com/as400jplpc/zig_sqlite
sqlite zig
Last synced: about 1 month ago
JSON representation
work sqlite
- Host: GitHub
- URL: https://github.com/as400jplpc/zig_sqlite
- Owner: AS400JPLPC
- License: other
- Created: 2025-01-02T22:21:54.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2025-01-16T21:16:29.000Z (over 1 year ago)
- Last Synced: 2025-02-22T12:45:51.548Z (over 1 year ago)
- Topics: sqlite, zig
- Language: Zig
- Homepage:
- Size: 127 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# zig-sqlite
zig 0.14.dev
I thank "[nDimensional](https://github.com/nDimensional/zig-sqlite)"
it is on this basis that I undertook to work, it remains simple, it is not a real duplication, because I updated so that it works from zig 0.14.dev.
I added some functions:
```
pub isDir( vdir : []const u8) bool ...
pub isDbxist( vdir : []const u8, fn_file_name:[]const u8) bool ...
pub open(vdir : []const u8, name: []const u8) !Database ...
pub fn open(vdir : []const u8, name: []const u8) !Database ...
pub fn openTmp(tDir: std.fs.Dir, name: []const u8) !Database ...
pub fn cbool(data : i32 ) bool ...
```
**TEST. Testsql.zig** :
a complete test cycle is made available to you
and functional.
Simple, low-level, explicitly-typed SQLite bindings for Zig.
## Table of Contents
- [Usage](#usage)
- [Methods](#methods)
- [Queries](#queries)
- [Notes](#notes)
- [Build options](#build-options)
- [License](#license)
- [Avancement](#avancement
- [Conditionnement](#conditionnement
Then add `sqlite` as an import to your root modules in `build.zig`:
```zig
fn build(b: *std.Build) void {
const app = b.addExecutable(.{ ... });
// ...
const sqlite = b.dependency("sqlite", .{});
app.root_module.addImport("sqlite", sqlite.module("sqlite"));
}
```
## Usage
Open databases using `Database.open` and close them with `db.close()`:
```zig
const sql3 = @import("sqlite");
{
// in-memory database
const db = try sql3.open("sqlite", "db.sqlite");
defer db.close();
}
{
// persistent database
const db = try sql3.Database.open(.{ .path = "path/to/db.sqlite" });
defer db.close();
}
```
Text and blob values must not be retained across steps. **You are responsible for copying them.**
## Notes
Crafting sensible Zig bindings for SQLite involves making tradeoffs between following the Zig philosophy ("deallocation must succeed") and matching the SQLite API, in which closing databases or finalizing statements may return error codes.
This library takes the following approach:
- `Database.close` calls `sqlite3_close_v2` and panics if it returns an error code.
- `Statement.finalize` calls `sqlite3_finalize` and panics if it returns an error code.
- `Statement.step` automatically calls `sqlite3_reset` if `sqlite3_step` returns an error code.
- In SQLite, `sqlite3_reset` returns the error code from the most recent call to `sqlite3_step`. This is handled gracefully.
- `Statement.reset` calls both `sqlite3_reset` and `sqlite3_clear_bindings`, and panics if either return an error code.
These should only result in panic through gross misuse or in extremely unusual situations, e.g. `sqlite3_reset` failing internally. All "normal" errors are faithfully surfaced as Zig errors.
## Build options
```zig
struct {
SQLITE_ENABLE_COLUMN_METADATA: bool = false,
SQLITE_ENABLE_DBSTAT_VTAB: bool = false,
SQLITE_ENABLE_FTS3: bool = false,
SQLITE_ENABLE_FTS4: bool = false,
SQLITE_ENABLE_FTS5: bool = false,
SQLITE_ENABLE_GEOPOLY: bool = false,
SQLITE_ENABLE_ICU: bool = false,
SQLITE_ENABLE_MATH_FUNCTIONS: bool = false,
SQLITE_ENABLE_RBU: bool = false,
SQLITE_ENABLE_RTREE: bool = false,
SQLITE_ENABLE_STAT4: bool = false,
SQLITE_OMIT_DECLTYPE: bool = false,
SQLITE_OMIT_JSON: bool = false,
SQLITE_USE_URI: bool = false,
SQLITE_OMIT_DEPRECATED: bool = false,
}
```
Set these by passing e.g. `-DSQLITE_ENABLE_RTREE` in the CLI, or by setting `.SQLITE_ENABLE_RTREE = true` in the `args` parameter to `std.Build.dependency`. For example:
```zig
pub fn build(b: *std.Build) !void {
// ...
const sqlite = b.dependency("sqlite", .{ .SQLITE_ENABLE_RTREE = true,.SQLITE_OMIT_DEPRECATED = true });
}
```
##Conditionnment
pub const Blob = struct { data: []const u8 };
pub const Text = struct { data: []const u8 };
pub const Numeric = struct { data: []const u8 };
pub const Date = struct { data: []const u8 };
pub const Bool = struct { data: bool};
ex: src-zig/sqlite.zig
libsql/sqlite/sqlite.zig
```
switch (binding.type) {
.int32 => try stmt.bindInt32(idx, @intCast(value)),
.int64 => try stmt.bindInt64(idx, @intCast(value)),
.float64 => try stmt.bindFloat64(idx, @floatCast(value)),
.blob => try stmt.bindBlob(idx, value),
.text => try stmt.bindText(idx, value),
.numeric => try stmt.bindNumeric(idx, value),
.date => try stmt.bindDate(idx, value),
.boolean => try stmt.bindBoolean(idx, value),
}
```
text = null -> ""
date = null -> ""
numeric = null -> ""
example delivery date null = delivery not processed
## Avancement
→ 2025-01-07 01:00 update Implementation of extended procedures of the zig "libsql" lib while respecting the structure of SQLITE3
The Date function is under study.
.