Merge remote-tracking branch 'upstream/main' into feature/node-sqlite

Author: Comamoca

.github/workflows/test.yml

@@ -14,8 +14,8 @@ jobs:
       - uses: actions/checkout@v3
       - uses: erlef/setup-beam@v1
         with:
-          otp-version: "25.2"
-          gleam-version: "1.4.0"
+          otp-version: "28"
+          gleam-version: "1.13.0"
           rebar3-version: "3"
       - uses: denoland/setup-deno@v1
         with:

CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## v1.0.3 - 2025-10-21
+
+- Remove version specifier for Deno `x/sqlite` import.
+
 ## v1.0.2 - 2025-07-01
 
 - Updated for latest `gleam_stdlib`.
@@ -39,7 +43,7 @@
 
 ## v0.5.0 - 2023-01-08
 
-- This library now works on JavaScript with the Deno runtime. 
+- This library now works on JavaScript with the Deno runtime.
 - The `status` function has been removed.
 
 ## v0.4.0 - 2023-01-02

gleam.toml

@@ -1,5 +1,5 @@
 name = "sqlight"
-version = "1.0.2"
+version = "1.0.3"
 licences = ["Apache-2.0"]
 description = "Use SQLite from Gleam!"
 

src/sqlight.gleam

@@ -19,7 +19,7 @@ pub type Error {
     code: ErrorCode,
     message: String,
     /// If the most recent error references a specific token in the input SQL,
-    /// this is the byte offset of the start of that token. 
+    /// this is the byte offset of the start of that token.
     /// If the most recent error does not reference a specific token, this is -1.
     offset: Int,
   )
@@ -320,15 +320,15 @@ fn close_(a: Connection) -> Result(Nil, Error)
 /// ```gleam
 /// let assert Ok(conn) = open("file:data.sqlite3")
 /// ```
-/// 
+///
 /// ## Opens "data.db" in read only mode with a private cache
-/// 
+///
 /// ```gleam
 /// let assert Ok(conn) = open("file:data.db?mode=ro&cache=private")
 /// ```
-/// 
-/// Opens a shared memory database named memdb1 with a shared cache. 
-/// 
+///
+/// Opens a shared memory database named memdb1 with a shared cache.
+///
 /// ```gleam
 /// let assert Ok(conn) = open("file:memdb1?mode=memory&cache=shared")
 /// ```
@@ -347,7 +347,7 @@ pub fn close(connection: Connection) -> Result(Nil, Error) {
   close_(connection)
 }
 
-/// Open a connection to a SQLite database and execute a function with it,.try
+/// Open a connection to a SQLite database and execute a function with it, then
 /// close the connection.
 ///
 /// This function works well with a `use` expression to automatically close the
@@ -371,10 +371,21 @@ pub fn with_connection(path: String, f: fn(Connection) -> a) -> a {
   value
 }
 
+/// Execute one or more SQL statements without returning the results.
+///
 pub fn exec(sql: String, on connection: Connection) -> Result(Nil, Error) {
   exec_(sql, connection)
 }
 
+/// Execute a sql statement and try to decode the result.
+///
+/// ## Running multiple queries
+///
+/// SQLite's `query` function will only run a single SQL query. If you have
+/// multiple queries in the string only the first one will be executed, and the
+/// others discarded.
+/// Use `exec` if you want to run run multiple queries in a single function call.
+///
 pub fn query(
   sql: String,
   on connection: Connection,