sqlite3 1.6.4-arm64-darwin → 1.6.5-arm64-darwin

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9747ea02d3715aab26a309b4d8f1d96f98e72b5841fc76f5a751b462bf378e26
-  data.tar.gz: 5fc17752b1a3cc526135acf703efe3ab3ff4f85851c4af1ab7b24e00c0a1da45
+  metadata.gz: 5a81b5b393dfedf69cf524119a7724f94e88447d5ab2e9aa0676631deab7bf2c
+  data.tar.gz: 34308bc4e72d06fa2e0feb8aba55e09e7968dc1e794e89759cf54effb0588fd4
 SHA512:
-  metadata.gz: 5478852a3890270016e13efc061960cf9ca57b985e9994e4c9556405c86bd2f0b81b838e572692dce1efcb4464d4546a3f885a975a5b08451d46b2227bbaf5fd
-  data.tar.gz: 68d175f5ef1afc9d6e2a5aa0d306071a0adf919eff894872d47af83dc7c568453396f05f6dd3fdb9256e400c8ff9afd33b93d17d9f72432183ff6df334448023
+  metadata.gz: 9faa954a3883f8b3fdcb3fbc2e92017856165965f0561702a854fb6062c6dcca259b551fc4c06a901dcceef70e6229b7c4a2e3e5aa85619280e74e87185d8e05
+  data.tar.gz: f7e54dc8771bbde2c91988b3df68b0d81aa1665e5b7d7a98a534fccfd9c84ecbd4ddccab3bd38fee0c2138de877e3da6f7a55bd1d4416d44ef86663b71c76e18

data/CHANGELOG.md

@@ -1,5 +1,12 @@
 # sqlite3-ruby Changelog
 
+## 1.6.5 / 2023-09-08
+
+### Packaging
+
+* Allow setting compiler flags for the sqlite library via a `--with-sqlite-cflags` argument to `extconf.rb`. See [`INSTALLATION.md`](https://github.com/sparklemotion/sqlite3-ruby/blob/master/INSTALLATION.md#controlling-compilation-flags-for-sqlite) for more information. [#401, #402] (@flavorjones)
+
+
 ## 1.6.4 / 2023-08-26
 
 ### Dependencies

data/INSTALLATION.md

@@ -73,6 +73,45 @@ user    0m23.361s
 sys     0m5.839s
 ```
 
+##### Controlling compilation flags for sqlite
+
+Upstream sqlite allows for the setting of some parameters at compile time. If you're an expert and would like to set these, you may do so at gem install time in two different ways ...
+
+**If you're installing the gem using `gem install`** then you can pass in these compile-time flags like this:
+
+``` sh
+gem install sqlite3 --platform=ruby -- \
+  --with-sqlite-cflags="-DSQLITE_DEFAULT_CACHE_SIZE=9999 -DSQLITE_DEFAULT_PAGE_SIZE=4444"
+```
+
+or the equivalent:
+
+``` sh
+CFLAGS="-DSQLITE_DEFAULT_CACHE_SIZE=9999 -DSQLITE_DEFAULT_PAGE_SIZE=4444" \
+  gem install sqlite3 --platform=ruby
+```
+
+**If you're installing the gem using `bundler`** then you should first pin the gem to the "ruby" platform gem, so that you are compiling from source:
+
+``` ruby
+# Gemfile
+gem "sqlite3", force_ruby_platform: true # requires bundler >= 2.3.18
+```
+
+and then set up a bundler config parameter for `build.sqlite3`:
+
+``` sh
+bundle config set build.sqlite3 \
+  "--with-sqlite-cflags='-DSQLITE_DEFAULT_CACHE_SIZE=9999 -DSQLITE_DEFAULT_PAGE_SIZE=4444'"
+```
+
+NOTE the use of single quotes within the double-quoted string to ensure the space between compiler flags is interpreted correctly. The contents of your `.bundle/config` file should look like:
+
+``` yaml
+---
+BUNDLE_BUILD__SQLITE3: "--with-sqlite-cflags='-DSQLITE_DEFAULT_CACHE_SIZE=9999 -DSQLITE_DEFAULT_PAGE_SIZE=4444'"
+```
+
 
 #### System libsqlite3
 
@@ -167,14 +206,14 @@ db.load_extension("/path/to/sqlite/spellfix.o")
 db.execute("CREATE VIRTUAL TABLE demo USING spellfix1;")
 ```
 
-### How do I use an alternative sqlite3 implementation?
+### How do I use my own sqlite3 shared library?
 
-Some packages, like pSQLite Encryption Extension ("SEE"), are intended to be ABI-compatible drop-in replacements for the sqlite3 shared object.
+Some folks have strong opinions about what features they want compiled into sqlite3; or may be using a package like SQLite Encryption Extension ("SEE"). This section will explain how to get your Ruby application to load that specific shared library.
 
 If you've installed your alternative as an autotools-style installation, the directory structure will look like this:
 
 ```
-/opt/see
+/opt/sqlite3
 ├── bin
 │   └── sqlite3
 ├── include
@@ -199,7 +238,7 @@ You can build this gem against that library like this:
 ```
 gem install sqlite3 --platform=ruby -- \
   --enable-system-libraries \
-  --with-opt-dir=/opt/see
+  --with-opt-dir=/opt/sqlite
 ```
 
 Explanation:

data/ext/sqlite3/extconf.rb

@@ -51,12 +51,13 @@ module Sqlite3
         minimal_recipe.tap do |recipe|
           recipe.configure_options += ["--enable-shared=no", "--enable-static=yes"]
           ENV.to_h.tap do |env|
-            additional_cflags = [
+            user_cflags = with_config("sqlite-cflags")
+            more_cflags = [
               "-fPIC", # needed for linking the static library into a shared library
               "-O2", # see https://github.com/sparklemotion/sqlite3-ruby/issues/335 for some benchmarks
               "-fvisibility=hidden", # see https://github.com/rake-compiler/rake-compiler-dock/issues/87
             ]
-            env["CFLAGS"] = [env["CFLAGS"], additional_cflags].flatten.join(" ")
+            env["CFLAGS"] = [user_cflags, env["CFLAGS"], more_cflags].flatten.join(" ")
             recipe.configure_options += env.select { |k,v| ENV_ALLOWLIST.include?(k) }
                                            .map { |key, value| "#{key}=#{value.strip}" }
           end
@@ -234,17 +235,23 @@ module Sqlite3
 
             Flags only used when building and using the packaged libraries:
 
+                --with-sqlite-cflags=CFLAGS
+                    Explicitly pass compiler flags to the sqlite library build. These flags will
+                    appear on the commandline before any flags set in the CFLAGS environment
+                    variable. This is useful for setting compilation options in your project's
+                    bundler config. See INSTALLATION.md for more information.
+
                 --enable-cross-build
                     Enable cross-build mode. (You probably do not want to set this manually.)
 
 
-            Environment variables used for compiling the C extension:
+            Environment variables used for compiling the gem's C extension:
 
                 CC
                     Use this path to invoke the compiler instead of `RbConfig::CONFIG['CC']`
 
 
-            Environment variables passed through to the compilation of packaged libraries:
+            Environment variables passed through to the compilation of sqlite:
 
                 CC
                 CPPFLAGS

data/lib/sqlite3/version.rb

@@ -1,11 +1,11 @@
 module SQLite3
 
-  VERSION = "1.6.4"
+  VERSION = "1.6.5"
 
   module VersionProxy
     MAJOR = 1
     MINOR = 6
-    TINY  = 4
+    TINY  = 5
     BUILD = nil
 
     STRING = [ MAJOR, MINOR, TINY, BUILD ].compact.join( "." )

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: sqlite3
 version: !ruby/object:Gem::Version
-  version: 1.6.4
+  version: 1.6.5
 platform: arm64-darwin
 authors:
 - Jamis Buck
@@ -10,7 +10,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-08-26 00:00:00.000000000 Z
+date: 2023-09-09 00:00:00.000000000 Z
 dependencies: []
 description: |-
   This module allows Ruby programs to interface with the SQLite3