sqlite3 1.6.7-arm64-darwin → 1.6.8-arm64-darwin

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 06e7a2b06673d4e82a58a7ae2bae40d71c88bc3febec6a8480ac99210de8eb9c
-  data.tar.gz: be280d7fc48fdf2e576296fdaa47e48c5224936958a8e7cb90445cdbceacce87
+  metadata.gz: 2959790f267545cadbc72d91425cac0f1add9975b21ce7e96fc6e572666091dd
+  data.tar.gz: a85c4ced75677691ab9cfdd6d138c5c01954a16c24ac4add0b0bc49bc469c9a9
 SHA512:
-  metadata.gz: 8db519db54629bea9b1545fc3a9f103878c604fe94d5b9107ebc14f139bc79d1d99fa783a6bc6fc4d50f393f15f669396d0cefbaf5a5a3d8763e13458271995c
-  data.tar.gz: d5545854058bb8ad245bd34b559c56688771138970b55b1c90aab00da4fcb7ef0782413234d83044fe2b75aeff757a5c4d18575831d188e74fd9f0178372c74c
+  metadata.gz: e0f977413f73b8e6aff7c12fd702faf96e30f5423134c27c3f9b531e8452531838c300ceec3abdca86c121ee25ff87281034ea25e6342effc1844291cde6495a
+  data.tar.gz: afed3842c8643342f1ecd000a480924e2bf89a1c672b030a37a98965cbd9d716aa10298f56ef899e5885fcff9f7242e37953cb5e0412e93f28b4433eb89d1319

data/CHANGELOG.md

@@ -1,5 +1,19 @@
 # sqlite3-ruby Changelog
 
+## 1.6.8 / 2023-11-01
+
+### Dependencies
+
+- Vendored sqlite is updated to [v3.44.0](https://sqlite.org/releaselog/3_44_0.html). @flavorjones
+- rake-compiler-dock updated to v1.3.1 for precompiled native gems. @flavorjones
+
+
+### Added
+
+- `SQLite3::Database.open` now returns the block result. Previously this returned the Database object. [#415] @toy
+- Documentation improvement in `lib/sqlite3/database.rb`. [#421] @szTheory
+
+
 ## 1.6.7 / 2023-10-10
 
 ### Dependencies

data/Gemfile

@@ -4,8 +4,7 @@ gemspec
 
 gem("minitest", "5.20.0")
 gem("rake-compiler", "1.2.5")
-gem("rake-compiler-dock", "1.3.0")
+gem("rake-compiler-dock", "1.3.1")
 gem("rdoc", "6.5.0")
-gem("psych", "5.1.0")
 
 gem("ruby_memcheck", "2.2.0") if Gem::Platform.local.os == "linux"

data/dependencies.yml

@@ -1,15 +1,14 @@
 # TODO: stop using symbols here once we no longer support Ruby 2.7 and can rely on symbolize_names
 :sqlite3:
   # checksum verified by first checking the published sha3(256) checksum against https://sqlite.org/download.html:
-  # a7463a45ed58849200858e514b79f7e5f5d69850047897c5b659a78a0bc75cc1
+  # 6869046465eae886f1a9f2c8debeeba44d34328693aa77a5bd4a3cfed93d6556
   #
-  # $ sha3sum -a 256 ports/archives/sqlite-autoconf-3430200.tar.gz
-  # a7463a45ed58849200858e514b79f7e5f5d69850047897c5b659a78a0bc75cc1  ports/archives/sqlite-autoconf-3430200.tar.gz
+  # $ sha3sum -a 256 ports/archives/sqlite-autoconf-3440000.tar.gz
+  # 6869046465eae886f1a9f2c8debeeba44d34328693aa77a5bd4a3cfed93d6556  ports/archives/sqlite-autoconf-3440000.tar.gz
   #
-  # $ sha256sum ports/archives/sqlite-autoconf-3430200.tar.gz
-  # 6d422b6f62c4de2ca80d61860e3a3fb693554d2f75bb1aaca743ccc4d6f609f0  ports/archives/sqlite-autoconf-3430200.tar.gz
-  #
-  :version: "3.43.2"
+  # $ sha256sum ports/archives/sqlite-autoconf-3440000.tar.gz
+  # b9cd386e7cd22af6e0d2a0f06d0404951e1bef109e42ea06cc0450e10cd15550  ports/archives/sqlite-autoconf-3440000.tar.gz
+  :version: "3.44.0"
   :files:
-    - :url: "https://sqlite.org/2023/sqlite-autoconf-3430200.tar.gz"
-      :sha256: "6d422b6f62c4de2ca80d61860e3a3fb693554d2f75bb1aaca743ccc4d6f609f0"
+    - :url: "https://sqlite.org/2023/sqlite-autoconf-3440000.tar.gz"
+      :sha256: "b9cd386e7cd22af6e0d2a0f06d0404951e1bef109e42ea06cc0450e10cd15550"

data/lib/sqlite3/database.rb

@@ -18,7 +18,7 @@ module SQLite3
   #     end
   #   end
   #
-  # It wraps the lower-level methods provides by the selected driver, and
+  # It wraps the lower-level methods provided by the selected driver, and
   # includes the Pragmas module for access to various pragma convenience
   # methods.
   #
@@ -39,7 +39,22 @@ module SQLite3
 
     class << self
 
-      alias :open :new
+      # Without block works exactly as new.
+      # With block, like new closes the database at the end, but unlike new
+      # returns the result of the block instead of the database instance.
+      def open( *args )
+        database = new(*args)
+
+        if block_given?
+          begin
+            yield database
+          ensure
+            database.close
+          end
+        else
+          database
+        end
+      end
 
       # Quotes the given string, making it safe to use in an SQL statement.
       # It replaces all instances of the single-quote character with two

data/lib/sqlite3/version.rb

@@ -1,11 +1,11 @@
 module SQLite3
 
-  VERSION = "1.6.7"
+  VERSION = "1.6.8"
 
   module VersionProxy
     MAJOR = 1
     MINOR = 6
-    TINY  = 7
+    TINY  = 8
     BUILD = nil
 
     STRING = [ MAJOR, MINOR, TINY, BUILD ].compact.join( "." )

data/test/test_database.rb

@@ -198,11 +198,25 @@ module SQLite3
 
     def test_new
       db = SQLite3::Database.new(':memory:')
-      assert db
+      assert_instance_of(SQLite3::Database, db)
     ensure
       db.close if db
     end
 
+    def test_open
+      db = SQLite3::Database.open(':memory:')
+      assert_instance_of(SQLite3::Database, db)
+    ensure
+      db.close if db
+    end
+
+    def test_open_returns_block_result
+      result = SQLite3::Database.open(':memory:') do |db|
+        :foo
+      end
+      assert_equal :foo, result
+    end
+
     def test_new_yields_self
       thing = nil
       SQLite3::Database.new(':memory:') do |db|
@@ -211,6 +225,14 @@ module SQLite3
       assert_instance_of(SQLite3::Database, thing)
     end
 
+    def test_open_yields_self
+      thing = nil
+      SQLite3::Database.open(':memory:') do |db|
+        thing = db
+      end
+      assert_instance_of(SQLite3::Database, thing)
+    end
+
     def test_new_with_options
       # determine if Ruby is running on Big Endian platform
       utf16 = ([1].pack("I") == [1].pack("N")) ? "UTF-16BE" : "UTF-16LE"
@@ -221,7 +243,7 @@ module SQLite3
         db = SQLite3::Database.new(Iconv.conv(utf16, 'UTF-8', ':memory:'),
                                    :utf16 => true)
       end
-      assert db
+      assert_instance_of(SQLite3::Database, db)
     ensure
       db.close if db
     end
@@ -241,6 +263,15 @@ module SQLite3
       assert thing.closed?
     end
 
+    def test_open_with_block_closes_self
+      thing = nil
+      SQLite3::Database.open(':memory:') do |db|
+        thing = db
+        assert !thing.closed?
+      end
+      assert thing.closed?
+    end
+
     def test_block_closes_self_even_raised
       thing = nil
       begin
@@ -253,6 +284,18 @@ module SQLite3
       assert thing.closed?
     end
 
+    def test_open_with_block_closes_self_even_raised
+      thing = nil
+      begin
+        SQLite3::Database.open(':memory:') do |db|
+          thing = db
+          raise
+        end
+      rescue
+      end
+      assert thing.closed?
+    end
+
     def test_prepare
       db = SQLite3::Database.new(':memory:')
       stmt = db.prepare('select "hello world"')

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: sqlite3
 version: !ruby/object:Gem::Version
-  version: 1.6.7
+  version: 1.6.8
 platform: arm64-darwin
 authors:
 - Jamis Buck
@@ -11,7 +11,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-10-10 00:00:00.000000000 Z
+date: 2023-11-01 00:00:00.000000000 Z
 dependencies: []
 description: |
   Ruby library to interface with the SQLite3 database engine (http://www.sqlite.org). Precompiled