riverqueue 0.16.0 → 0.16.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 70cd35bf366c6911d61d8adf29777d699b4dd24c8641eeae53d520c2719a573f
-  data.tar.gz: bf715e145cd3a1f6bc089cd5796d3e02313e89a72c52cbd8868c8e6866905b23
+  metadata.gz: e49226e1e557c7e5560d30616e5297f943b632cca65369169086f84ee5e507d9
+  data.tar.gz: 3e0a98d8c1efb5687fe34f76af27d36d7b0117c1e572fb36a0d4457bd53d36b6
 SHA512:
-  metadata.gz: e46f580c619455d5d15fbb9e7e0e1295b2d82f1e72fa395aac9648aa8066031a965a0bf2651630a1efa93b289235296717af90aee9ed5bc7caf54b51cea25376
-  data.tar.gz: 6470ef7fdd259235f4de8c34e8098b629934908202ce2f8f455357fb335504af66980780befe160fd45420afef3a034937cbfb59ffda40adfd639354a217d51c
+  metadata.gz: d4f2d7c811449d299dfc3599dee25eb0f70d19e95d715966ee075bc5eaac514cb44f7eb7419072b181cc7719594bb8344168ddc4f3b1a7eba2f025b7bc505d6a
+  data.tar.gz: 06ab9c8b0d08d82473ddda057d2e91167c7f8f979f73097c68565115e644110867b1665a6b1ec89672dd3a3b00377b698227bbb6c3abdd93aba301ebee830da9

data/CHANGELOG.md

@@ -7,6 +7,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.16.1] - 2026-11-09
+
+### Fixed
+
+- Accept `sqlite:` and `sqlite://` URLs with both Active Record and Sequel, including `:memory:` databases, while preserving the `sqlite3:` aliases. [PR #1588](https://github.com/riverqueue/river/pull/1588).
+- Reject empty SQLite paths in commands that connect to a database; bare prefixes remain valid for offline migration SQL export. [PR #1588](https://github.com/riverqueue/river/pull/1588).
+
 ## [0.16.0] - 2026-11-04
 
 ### Added
@@ -15,8 +22,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Fixed
 
-- Reduce database overhead in the Active Record and Sequel drivers: use `RETURNING` to avoid redundant row fetches, claim batches and clean up finalized jobs in one statement, and omit unnecessary transactions. Return Active Record connections to the pool after operations and avoid allocating models for job reads. Avoid slow Postgres fetching-index scans for updates and deletes targeting a job by ID when state statistics are stale. [PR #1574](https://github.com/riverqueue/river/pull/1574).
-- Prevent ordinary job wakeups from interrupting maintenance error backoff and causing rapid retries during persistent failures. [PR #1574](https://github.com/riverqueue/river/pull/1574).
+- Reduce database overhead in the Active Record and Sequel drivers: use `RETURNING` to avoid redundant row fetches, claim batches and clean up finalized jobs in one statement, and omit unnecessary transactions. Return Active Record connections to the pool after operations and avoid allocating models for job reads. Avoid slow Postgres fetching-index scans for updates and deletes targeting a job by ID when state statistics are stale. Thanks [@jpcamara](https://github.com/jpcamara) for the original performance investigation and proposed fixes in [PR #1566](https://github.com/riverqueue/river/pull/1566). [PR #1574](https://github.com/riverqueue/river/pull/1574).
+- Prevent ordinary job wakeups from interrupting maintenance error backoff and causing rapid retries during persistent failures. Thanks [@jpcamara](https://github.com/jpcamara) for the original proposed fix in [PR #1566](https://github.com/riverqueue/river/pull/1566). [PR #1574](https://github.com/riverqueue/river/pull/1574).
 - Enforce the 32 MiB encoded UTF-8 JSON limit for `Job#output=`, preserving previous output when validation fails. [PR #1569](https://github.com/riverqueue/river/pull/1569).
 
 ## [0.15.0] - 2026-10-30

data/docs/migrations.md

@@ -18,12 +18,14 @@ Create the database first, then run:
 bundle exec river migrate-status --database-url postgres://localhost/my_app
 bundle exec river migrate-up --database-url postgres://localhost/my_app
 
-# SQLite, using Sequel:
+# SQLite, using either driver:
 bundle exec river migrate-up --database-url sqlite://storage/river.sqlite3
 ```
 
-`DATABASE_URL` supplies the URL when `--database-url` is omitted. ActiveRecord
-uses `sqlite3:` URLs instead of Sequel's `sqlite:` URLs. To target an existing
+`DATABASE_URL` supplies the URL when `--database-url` is omitted. Both drivers
+accept `sqlite://path`, `sqlite:path`, and the `sqlite3:` aliases. For an in-memory
+database, use `sqlite::memory:` or `sqlite://:memory:`. See the shared
+[SQLite URL reference](../../docs/sqlite-urls.md) for path handling. To target an existing
 Postgres schema, pass `--schema jobs`; otherwise the connection's current
 schema is used. Schema names must be simple SQL identifiers. SQLite always
 uses its main schema.
@@ -91,7 +93,7 @@ migration-tracking table and can usually be omitted with another framework.
 Preserve version boundaries and apply each migration in its own transaction.
 
 Export defaults to Postgres and ignores `DATABASE_URL`. Use
-`--database-url sqlite://` (or `sqlite3://`) to select SQLite SQL; the URL is only
+`--database-url sqlite:` or `sqlite://` (including the `sqlite3:` aliases) to select SQLite SQL; the URL is only
 a dialect hint. `--schema jobs` qualifies Postgres objects with that schema.
 Without it, objects are unqualified. Schema placeholders are always substituted.
 

data/lib/migration_cli.rb

@@ -56,16 +56,32 @@ module River
         raise ArgumentError, "down migrations may delete data; pass --yes to confirm"
       end
 
-      adapter = detect_driver
+      sqlite_path = url.sub(/\Asqlite3?:/i, "").delete_prefix("//") if url.match?(/\Asqlite3?:/i)
+      raise ArgumentError, "SQLite database URL needs a path or `:memory:`" if sqlite_path == ""
 
+      adapter = detect_driver
       if adapter == "activerecord"
         require "riverqueue-activerecord"
         active_record_base = Object.const_get("ActiveRecord::Base")
-        active_record_base.establish_connection(url)
+        connection = if sqlite_path == ":memory:"
+          {adapter: "sqlite3", database: sqlite_path}
+        elsif sqlite_path
+          "sqlite3:#{sqlite_path}"
+        else
+          url
+        end
+        active_record_base.establish_connection(connection)
         driver = River::Driver.const_get(:ActiveRecord).new
       else
         require "riverqueue-sequel"
-        database = Object.const_get(:Sequel).connect(url)
+        connection = if sqlite_path == ":memory:"
+          {adapter: "sqlite", database: sqlite_path}
+        elsif sqlite_path
+          "sqlite://#{sqlite_path}"
+        else
+          url
+        end
+        database = Object.const_get(:Sequel).connect(connection)
         driver = River::Driver.const_get(:Sequel).new(database)
       end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: riverqueue
 version: !ruby/object:Gem::Version
-  version: 0.16.0
+  version: 0.16.1
 platform: ruby
 authors:
 - Blake Gentry