feat: allow URI filenames

See https://www.sqlite.org/uri.html

Author: flavorjones

CHANGELOG.md

@@ -2,6 +2,11 @@
 
 ## next / unreleased
 
+### Added
+
+- URI filenames are now allowed. This allows the injection of some behavior via recognized query parameters. See https://www.sqlite.org/uri.html for more information. #571 @flavorjones
+
+
 ### Improved
 
 - SQL Syntax errors during `Database#prepare` will raise a verbose exception with a multiline message indicating with a "^" exactly where in the statement the error occurred. [#554] @fractaledmind @flavorjones

ext/sqlite3/extconf.rb

@@ -61,7 +61,8 @@ def configure_packaged_libraries
               "-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
-              "-DSQLITE_DEFAULT_WAL_SYNCHRONOUS=1"
+              "-DSQLITE_DEFAULT_WAL_SYNCHRONOUS=1",
+              "-DSQLITE_USE_URI=1"
             ]
             env["CFLAGS"] = [user_cflags, env["CFLAGS"], more_cflags].flatten.join(" ")
             recipe.configure_options += env.select { |k, v| ENV_ALLOWLIST.include?(k) }

test/test_database_uri.rb

@@ -0,0 +1,32 @@
+require "helper"
+require "tempfile"
+require "pathname"
+
+module SQLite3
+  class TestDatabaseURI < SQLite3::TestCase
+    def test_open_absolute_file_uri
+      Tempfile.open "test.db" do |file|
+        assert SQLite3::Database.new("file:#{file.path}")
+      end
+    end
+
+    def test_open_relative_file_uri
+      Dir.mktmpdir do |dir|
+        Dir.chdir dir do
+          assert SQLite3::Database.new("file:test.db")
+          assert_path_exists "test.db"
+        end
+      end
+    end
+
+    def test_open_file_uri_readonly
+      Tempfile.open "test.db" do |file|
+        db = SQLite3::Database.new("file:#{file.path}?mode=ro")
+
+        assert_raise(SQLite3::ReadOnlyException) do
+          db.execute("CREATE TABLE foos (id integer)")
+        end
+      end
+    end
+  end
+end