sqlite3 2.8.1-x86_64-linux-gnu → 2.9.0-x86_64-linux-gnu

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9d90e3d8e6faecf06d1443d21e6f974f818946df8cf594f9afe48a020ae6dbd3
-  data.tar.gz: 353af33d469f836b78d396cb03770b19606af83d84bf438644a96b39e6464e56
+  metadata.gz: b5fc03d84c59ef4e6ab770cedce00e047414f82a992a5bc74c4d4bfabe3312ec
+  data.tar.gz: 9a757d35779310313acdeeff5e319c4cf52cedabf434ae664a99f064c0b1a9bc
 SHA512:
-  metadata.gz: 8d6a57ab955088f2dbf75f3a0dc7625ac55c4f1e40af71fb2b119378d10579cee352f490a5e0e0a6f098d7f125714c8d345fdf51a5e7467242450c01bf4a7a43
-  data.tar.gz: 80c29959a2a07ab25a592b7d86d4a09dee9f505789a1389b96fc1e778c9952738c7a68b1ff220c391ec725873abb13a31fe108a7f319bd237f1e7c6f16ee6b39
+  metadata.gz: 1afc9ce8e4a295bdb23fcfcf72dacdca7471470a3c2a6bca05e2db4719afd2a3da39e0f35a98b6463833f0d97f823ddd5f2adddde67ff74135b6657f05947ba4
+  data.tar.gz: 5b1ef3b0d4d901e801d3642cd9cbcee2598f1031d664e97aa5647cc287fc5966bde07f3486e55ad7aadfa6a3534be3e4146e48e9340009fb21db51431ff38063

data/CHANGELOG.md

@@ -1,5 +1,21 @@
 # sqlite3-ruby Changelog
 
+## 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

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/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.8.1"
+  VERSION = "2.9.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: sqlite3
 version: !ruby/object:Gem::Version
-  version: 2.8.1
+  version: 2.9.0
 platform: x86_64-linux-gnu
 authors:
 - Jamis Buck
@@ -50,10 +50,10 @@ files:
 - ext/sqlite3/statement.h
 - ext/sqlite3/timespec.h
 - lib/sqlite3.rb
-- lib/sqlite3/3.1/sqlite3_native.so
 - lib/sqlite3/3.2/sqlite3_native.so
 - lib/sqlite3/3.3/sqlite3_native.so
 - lib/sqlite3/3.4/sqlite3_native.so
+- lib/sqlite3/4.0/sqlite3_native.so
 - lib/sqlite3/constants.rb
 - lib/sqlite3/database.rb
 - lib/sqlite3/errors.rb
@@ -83,17 +83,17 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '3.1'
+      version: '3.2'
   - - "<"
     - !ruby/object:Gem::Version
-      version: 3.5.dev
+      version: 4.1.dev
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: 3.3.22
 requirements: []
-rubygems_version: 3.6.9
+rubygems_version: 4.0.3
 specification_version: 4
 summary: Ruby library to interface with the SQLite3 database engine (http://www.sqlite.org).
 test_files: []