sqlite3 2.8.1-x86_64-darwin → 2.9.0-x86_64-darwin

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cd9a6bad52f6776fad7bd8a7734e8fd741513e459e822ca0c3e5035f04082207
-  data.tar.gz: 23918dcccff930a4851dd36f2c50a06d44f4b527b46195d1007d0d74ec3260a5
+  metadata.gz: b035b4f38d5a304b9c70c3c4c03cee849cd0ea38193192408f5dd7bf004b33ec
+  data.tar.gz: 2e45477c7ec983e22cb0e1f7f0efadf2a958737d809ac6cb7058f39983a1ee29
 SHA512:
-  metadata.gz: d73a3ea6e5362f2d225bfb87ce42446caa8205f6936fc9f7552ccf77a03531177a70a912460da70eb79f1d863700dd9349a01748493d77b61f6b3affe2c1df8e
-  data.tar.gz: f51f3f54875ea91deb8448815d6b181aa0ca43c14c60ee559f8c120625ee60e7d939b3a09375673a0c4e49f5ff5c479d84bb354c95e00ef8fcbff59fe2c764e1
+  metadata.gz: 601b8b6bfde26558a21c026ff4eaddbcb955f5008879b5f25fb348f634d4b004a8e726da71d54a5cec4cceaf91884472bedc6b0dda1a12b0a9e2e8dc6e442276
+  data.tar.gz: 666e72bd6b64495891602b1464070f0816589f9eab8760beb724c332a6811875a9569f5d4deb5dcc195b5766dafd9544e55cd7d1459097ed9c89f3b02d8855cd

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-darwin
 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.bundle
 - lib/sqlite3/3.2/sqlite3_native.bundle
 - lib/sqlite3/3.3/sqlite3_native.bundle
 - lib/sqlite3/3.4/sqlite3_native.bundle
+- lib/sqlite3/4.0/sqlite3_native.bundle
 - 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: '0'
 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: []