sqlite3 2.7.4 → 2.9.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7d468349441f35814be6b404fda4ddc8763d0099fc1e30caa08586a390768be8
-  data.tar.gz: c9194d6bbf26a645122dd88d9834711bdd0d277e9f01cd852e74374bb21e768e
+  metadata.gz: 700911c0444360801adadb3346db78846d6e517a08041f1d9796754406c3ae06
+  data.tar.gz: 5f00a2ebcc84ad8ebf634ef801eae95fb30306ffb2ead031ea4c45cbe0ff89eb
 SHA512:
-  metadata.gz: f708c9cf3efc355f88c2c9760396d7b6e8845855c77d582d65a8e37b79d09d1086e24928072a5663f480378296b891259158fbe9d06ce53c3a95e0daf26eeb99
-  data.tar.gz: baa858442188f4f65c0469747c9f96c4c31bc7058194ad4a670bccecb95a09d5396a5413dc22c0e238fbbd389550a44c13e80b449979c62abad108e62303a023
+  metadata.gz: 8a21c84ae7f12c591826043d86045a9d622cbcaca5f3ff9b95f0b2c7c991c18a673602db20d018e674558e37588cead865083272f253f21f2b8c0dfb1080ceb8
+  data.tar.gz: bbbe81b7dd7eb70f442aab8695d46ee213e6cf92464d7a52711a537112e2bba3b6b1e5dac51c4b6d420fbd400e7dc7f661b7b4521b5f377cbb9160d1e5a396a9

data/CHANGELOG.md

@@ -1,5 +1,46 @@
 # sqlite3-ruby Changelog
 
+## 2.9.3 / 2026-04-15
+
+- Vendored sqlite is updated to [v3.53.0](https://www.sqlite.org/releaselog/3_53_0.html) (from v3.51.3). #696 @flavorjones
+
+
+## 2.9.2 / 2026-03-15
+
+- Vendored sqlite is updated to [v3.51.3](https://www.sqlite.org/releaselog/3_51_3.html) (from v3.51.2). #688 @flavorjones
+
+
+## 2.9.1 / 2026-02-28
+
+- Vendored sqlite is updated to [v3.51.2](https://www.sqlite.org/releaselog/3_51_2.html) (from v3.51.1). #683 @flavorjones
+
+## 2.9.0 / 2025-12-27
+
+### Ruby
+
+- Introduce native gem packages for Ruby 4.0. @flavorjones
+- Drop support for Ruby 3.1. @flavorjones
+
+### Added
+
+- Introduce `Statement#named_params` to introspect on a parameterized SQL statement. #627 #642 @captn3m0
+
+### Improved
+
+- Small improvements to docstrings and comments. @flavorjones @houyuanjie
+
+
+## 2.8.1 / 2025-11-29
+
+- Vendored sqlite is updated to [v3.51.1](https://www.sqlite.org/releaselog/3_51_1.html) (from v3.51.0). #659 @flavorjones
+- Precompiled native gems are built with rake-compiler-dock v1.10.0 (previously v1.9.1).
+
+
+## 2.8.0 / 2025-11-05
+
+- Vendored sqlite is updated to [v3.51.0](https://www.sqlite.org/releaselog/3_51_0.html) (from v3.50.4). #652 @flavorjones
+
+
 ## 2.7.4 / 2025-09-19
 
 - Vendored sqlite is updated to [v3.50.4](https://www.sqlite.org/releaselog/3_50_4.html) (from v3.50.3). #644 @flavorjones

data/CONTRIBUTING.md

@@ -47,14 +47,19 @@ Update `/dependencies.yml` to reflect:
 
 A quick checklist to cutting a release of the sqlite3 gem:
 
-- [ ] make sure CI is green!
-- bump the version
-  - [ ] update `CHANGELOG.md` and `lib/sqlite3/version.rb`
-  - [ ] create a git tag using a format that matches the pattern `v\d+\.\d+\.\d+`, e.g. `v1.3.13`
-- build the native gems
-  - [ ] run `bin/build-gems` and make sure it completes and all the tests pass
-- push
-  - [ ] `git push && git push --tags`
-  - [ ] `for g in gems/*.gem ; do gem push $g ; done`
-- announce
-  - [ ] create a release at https://github.com/sparklemotion/sqlite3-ruby/releases and include sha2 checksums
+Prep
+- [ ] Make sure CI is green!
+- [ ] Update `CHANGELOG.md` and `lib/sqlite3/version.rb`
+- [ ] Create a git tag using a format that matches the pattern `v\d+\.\d+\.\d+`, e.g. `v1.3.13`
+- [ ] `git push && git push --tags`
+
+Automated build and release
+- [ ] Run workflow https://github.com/sparklemotion/sqlite3-ruby/actions/workflows/release.yml
+- [ ] Copy checksums from the push job
+
+Manual build and release
+- [ ] Run `bin/build-gems` and make sure it completes and all the tests pass
+- [ ] `for g in gems/*.gem ; do gem push $g ; done`
+
+Post-release
+- [ ] Create a release at https://github.com/sparklemotion/sqlite3-ruby/releases and include sha2 checksums

data/FAQ.md

@@ -122,15 +122,17 @@ Placeholders in an SQL statement take any of the following formats:
 * `?`
 * `?_nnn_`
 * `:_word_`
+* `$_word_`
+* `@_word_`
 
 
-Where _n_ is an integer, and _word_ is an alpha-numeric identifier (or
-number). When the placeholder is associated with a number, that number
-identifies the index of the bind variable to replace it with. When it
-is an identifier, it identifies the name of the corresponding bind
-variable. (In the instance of the first format--a single question
-mark--the placeholder is assigned a number one greater than the last
-index used, or 1 if it is the first.)
+Where _n_ is an integer, and _word_ is an alpha-numeric identifier(or number).
+When the placeholder is associated with a number (only in case of `?_nnn_`),
+that number identifies the index of the bind variable to replace it with.
+When it is an identifier, it identifies the name of the corresponding bind
+variable. (In the instance of the first format--a single question mark--the
+placeholder is assigned a number one greater than the last index used, or 1
+if it is the first.)
 
 
 For example, here is a query using these placeholder formats:

data/INSTALLATION.md

@@ -7,7 +7,7 @@ This document will help you install the `sqlite3` ruby gem. It also contains ins
 
 ### Native Gems (recommended)
 
-In v2.0.0 and later, native (precompiled) gems are available for recent Ruby versions on these platforms:
+In v2.5.0 and later, native (precompiled) gems are available for recent Ruby versions on these platforms:
 
 - `aarch64-linux-gnu` (requires: glibc >= 2.29)
 - `aarch64-linux-musl`
@@ -15,30 +15,30 @@ In v2.0.0 and later, native (precompiled) gems are available for recent Ruby ver
 - `arm-linux-musl`
 - `arm64-darwin`
 - `x64-mingw-ucrt`
-- `x86-linux-gnu` (requires: glibc >= 2.17)
+- `x86-linux-gnu` (requires: glibc >= 2.29)
 - `x86-linux-musl`
 - `x86_64-darwin`
-- `x86_64-linux-gnu` (requires: glibc >= 2.17)
+- `x86_64-linux-gnu` (requires: glibc >= 2.29)
 - `x86_64-linux-musl`
 
 ⚠ Musl linux users should update to Bundler >= 2.5.6 to avoid https://github.com/rubygems/rubygems/issues/7432
 
 If you are using one of these Ruby versions on one of these platforms, the native gem is the recommended way to install sqlite3-ruby.
 
-For example, on a linux system running Ruby 3.1:
+For example, on a linux system running Ruby 3.4:
 
 ``` text
 $ ruby -v
-ruby 3.1.2p20 (2022-04-12 revision 4491bb740a) [x86_64-linux]
+ruby 3.4.7 (2025-10-08 revision 7a5688e2a2) +PRISM [x86_64-linux]
 
 $ time gem install sqlite3
-Fetching sqlite3-1.5.0-x86_64-linux.gem
-Successfully installed sqlite3-1.5.0-x86_64-linux
+Fetching sqlite3-2.8.1-x86_64-linux-gnu.gem
+Successfully installed sqlite3-2.8.1-x86_64-linux-gnu
 1 gem installed
 
-real    0m4.274s
-user    0m0.734s
-sys     0m0.165s
+real    0m1.273s
+user    0m0.496s
+sys     0m0.078s
 ```
 
 #### Avoiding the precompiled native gem

data/dependencies.yml

@@ -1,13 +1,13 @@
 sqlite3:
   # checksum verified by first checking the published sha3(256) checksum against https://sqlite.org/download.html:
-  # 330bb88febc08814d49406391891eddac59e5f812e87b83c27ab172687554375
+  # 60c4b08c6729761e488d185e0d52411da10b14c72b53ada6936dc5eea225cefe
   #
-  # $ sha3sum -a 256 ports/archives/sqlite-autoconf-3500400.tar.gz
-  # 330bb88febc08814d49406391891eddac59e5f812e87b83c27ab172687554375  ports/archives/sqlite-autoconf-3500400.tar.gz
+  # $ sha3sum -a 256 ports/archives/sqlite-autoconf-3530000.tar.gz
+  # 60c4b08c6729761e488d185e0d52411da10b14c72b53ada6936dc5eea225cefe  ports/archives/sqlite-autoconf-3530000.tar.gz
   #
-  # $ sha256sum ports/archives/sqlite-autoconf-3500400.tar.gz
-  # a3db587a1b92ee5ddac2f66b3edb41b26f9c867275782d46c3a088977d6a5b18  ports/archives/sqlite-autoconf-3500400.tar.gz
-  version: "3.50.4"
+  # $ sha256sum ports/archives/sqlite-autoconf-3530000.tar.gz
+  # 851e9b38192fe2ceaa65e0baa665e7fa06230c3d9bd1a6a9662d02380d73365a  ports/archives/sqlite-autoconf-3530000.tar.gz
+  version: "3.53.0"
   files:
-    - url: "https://sqlite.org/2025/sqlite-autoconf-3500400.tar.gz"
-      sha256: "a3db587a1b92ee5ddac2f66b3edb41b26f9c867275782d46c3a088977d6a5b18"
+    - url: "https://sqlite.org/2026/sqlite-autoconf-3530000.tar.gz"
+      sha256: "851e9b38192fe2ceaa65e0baa665e7fa06230c3d9bd1a6a9662d02380d73365a"

data/ext/sqlite3/statement.c

@@ -460,6 +460,40 @@ bind_parameter_count(VALUE self)
     return INT2NUM(sqlite3_bind_parameter_count(ctx->st));
 }
 
+/** call-seq: stmt.named_params
+ *
+ * Return the list of named parameters in the statement.
+ * This returns a frozen array of strings (without the leading prefix character).
+ * The values of this list can be used to bind parameters
+ * to the statement using bind_param. Positional (?NNN) and anonymous (?)
+ * parameters are excluded.
+ *
+ */
+static VALUE
+named_params(VALUE self)
+{
+    sqlite3StmtRubyPtr ctx;
+    TypedData_Get_Struct(self, sqlite3StmtRuby, &statement_type, ctx);
+
+    REQUIRE_LIVE_DB(ctx);
+    REQUIRE_OPEN_STMT(ctx);
+
+    int param_count = sqlite3_bind_parameter_count(ctx->st);
+    VALUE params = rb_ary_new2(param_count);
+
+    // The first host parameter has an index of 1, not 0.
+    for (int i = 1; i <= param_count; i++) {
+        const char *name = sqlite3_bind_parameter_name(ctx->st, i);
+        // We ignore positional and anonymous parameters, and also null values, since there can be
+        // gaps in the list.
+        if (name && *name != '?') {
+            VALUE param = interned_utf8_cstr(name + 1);
+            rb_ary_push(params, param);
+        }
+    }
+    return rb_obj_freeze(params);
+}
+
 enum stmt_stat_sym {
     stmt_stat_sym_fullscan_steps,
     stmt_stat_sym_sorts,
@@ -594,7 +628,7 @@ stat_for(VALUE self, VALUE key)
 }
 
 #ifdef SQLITE_STMTSTATUS_MEMUSED
-/* call-seq: stmt.memory_used
+/* call-seq: stmt.memused
  *
  * Return the approximate number of bytes of heap memory used to store the prepared statement
  */
@@ -689,6 +723,7 @@ init_sqlite3_statement(void)
     rb_define_method(cSqlite3Statement, "column_name", column_name, 1);
     rb_define_method(cSqlite3Statement, "column_decltype", column_decltype, 1);
     rb_define_method(cSqlite3Statement, "bind_parameter_count", bind_parameter_count, 0);
+    rb_define_method(cSqlite3Statement, "named_params", named_params, 0);
     rb_define_method(cSqlite3Statement, "sql", get_sql, 0);
     rb_define_method(cSqlite3Statement, "expanded_sql", get_expanded_sql, 0);
 #ifdef HAVE_SQLITE3_COLUMN_DATABASE_NAME

data/lib/sqlite3/version.rb

@@ -1,4 +1,4 @@
 module SQLite3
   # (String) the version of the sqlite3 gem, e.g. "2.1.1"
-  VERSION = "2.7.4"
+  VERSION = "2.9.3"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: sqlite3
 version: !ruby/object:Gem::Version
-  version: 2.7.4
+  version: 2.9.3
 platform: ruby
 authors:
 - Jamis Buck
@@ -75,7 +75,7 @@ files:
 - lib/sqlite3/value.rb
 - lib/sqlite3/version.rb
 - lib/sqlite3/version_info.rb
-- ports/archives/sqlite-autoconf-3500400.tar.gz
+- ports/archives/sqlite-autoconf-3530000.tar.gz
 homepage: https://github.com/sparklemotion/sqlite3-ruby
 licenses:
 - BSD-3-Clause
@@ -96,14 +96,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '3.1'
+      version: '3.2'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.9
+rubygems_version: 4.0.6
 specification_version: 4
 summary: Ruby library to interface with the SQLite3 database engine (http://www.sqlite.org).
 test_files: []