tobox 0.4.0 → 0.4.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f162a3a57381f1e5e15ddb1034e82bdd7fcddc720f6fa38264351c6e04407aa9
-  data.tar.gz: 7b4ca98af244fff5ee76eb38141047b1c97ee40dd79c942cdb0e82480b8f8439
+  metadata.gz: 4960d6151461ab6e051605687d99cc69089e498aaea66d97416b92158e48cc4e
+  data.tar.gz: e3f2e0a6408696ff1852a484101ca6fa95e5e5e713d1ccb0b829040bb0a748ad
 SHA512:
-  metadata.gz: 673ead552e6419b25e876e13134fc4b9b04f9505544f04f572570c2bc8d7495f8e5e511047d4545c4bd6ff03a3b0e472c65ec69b8a40ffe355931e3bdb907a4d
-  data.tar.gz: 52ba20bddfaaafb13555fc4e72860feea2bb9377480191dcce5be291d136831559f3579467fc44f032cd94ac833094938264a193af558a334b51d2b6550801bd
+  metadata.gz: ac5d961bc737299d4cd1e3d353955f97b12d984e4b3378b56dbeaf84c5d969ed3b6c02902c70b7ed0fd14230696d44992012d35053565988349b13405f6144ef
+  data.tar.gz: 3a921e5ca3f42fa47f8485a0a9bf44c42c31f0f767cfafc81ef1af6d6e43ac83966baffcb20ff28df9c90abb8a4c16e6829c4e9aa9e86ca009ab4fde38a92bd1

data/CHANGELOG.md

@@ -1,5 +1,20 @@
 ## [Unreleased]
 
+## [0.4.1] - 2023-05-24
+
+### Features
+
+#### `on_database_connect`
+
+this adds an extension point for internal sequel database objects, in cases where some tweaks are required (such as in the case of, when using database SSL proxies, setting connection validators).
+
+```ruby
+# tobox.rb
+on_database_connect do |db|
+  db.extension(:connection_validator)
+end
+```
+
 ## [0.4.0] - 2023-05-19
 
 ### Features

data/README.md

@@ -268,6 +268,20 @@ callback executed when an exception was raised in the worker, before processing
 on_error_worker { |exception| Sentry.capture_exception(exception) }
 ```
 
+### `on_database_connect { |db| }`
+
+Callback executed right after initializing the `sequel` database object. This can be used, for example, to load database-level extensions and plugins, and set parameters (such as connection pool tweaks). This callback will also be used by plugins which instantiate its own separate database objects (such as in the case of the [stats](#stats) plugin).
+
+This callback won't be executed if the database object is created outside of `tobox` configuration parameters.
+
+
+```ruby
+on_database_connect do |db|
+  db.extension(:connection_validator)
+  db.pool.connection_validation_timeout = -1
+end
+```
+
 ### `message_to_arguments { |event| }`
 
 if exposing raw data to the `on` handlers is not what you'd want, you can always override the behaviour by providing an alternative "before/after fetcher" implementation.

data/lib/tobox/configuration.rb

@@ -63,7 +63,9 @@ module Tobox
       @database = if @config[:database_uri]
                     database_opts = {}
                     database_opts[:max_connections] = @config[:concurrency] if @config[:worker] == :thread
-                    Sequel.connect(@config[:database_uri].to_s, database_opts)
+                    db = Sequel.connect(@config[:database_uri].to_s, database_opts)
+                    Array(@lifecycle_events[:database_connect]).each { |cb| cb.call(db) }
+                    db
                   else
                     Sequel::DATABASES.first
                   end
@@ -116,6 +118,11 @@ module Tobox
       self
     end
 
+    def on_database_connect(&callback)
+      (@lifecycle_events[:database_connect] ||= []) << callback
+      self
+    end
+
     def message_to_arguments(&callback)
       @arguments_handler = callback
       self

data/lib/tobox/plugins/stats.rb

@@ -35,6 +35,8 @@ module Tobox
           @max_attempts = config[:max_attempts]
 
           @db = Sequel.connect(config.database.opts.merge(single_threaded: true))
+          Array(config.lifecycle_events[:database_connect]).each { |cb| cb.call(@db) }
+
           @outbox_table = config[:table]
           @outbox_ds = @db[@outbox_table]
 

data/lib/tobox/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Tobox
-  VERSION = "0.4.0"
+  VERSION = "0.4.1"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tobox
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.4.1
 platform: ruby
 authors:
 - HoneyryderChuck
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2023-05-19 00:00:00.000000000 Z
+date: 2023-05-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: sequel