emb 0.2.2 → 0.2.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ff0fe54e3a671a1df06f90f6da9317e1173f5df811bb5c95d4374de4487fd8fb
-  data.tar.gz: 9f9bfbde342b771c876f6ef8327b672a85c17c82c889f7ca35d3d4bdbe238cf8
+  metadata.gz: 2210ac3c666538429c3d0eccc58c26b94bc87a26f65cd6c3b4ba2f754b5de6fa
+  data.tar.gz: f576b3edf8bec7d38d156b35082e86ac19a80324c0f437e78197f674f0156215
 SHA512:
-  metadata.gz: 0dc5d526c1e0314d7a41c9455fb9129c15f63a61d293eadde62aeb9c9b3f79aa40bad32351564e7b69ec9baf9524d74669129f3f46db8abc7d9eaccb7137145c
-  data.tar.gz: ac676d326318efc040277f7adbd0b8b064d2e563dc2f2516dbe6d6bccb96f9e468a35b0aed937b351af7e53cd87ff63128b5660d90a566201e5b665df5aba600
+  metadata.gz: 3dc881cd39e7dcdf6898afa215d9d852a638a2df020d225056e861b9f79e57f13001a30c0e88b0b1cf0e997328c9682b6d4f2cdfbd97c7795e1adc6a8262a279
+  data.tar.gz: 93aa184f12078697b8f27946567dd3221b99d098f67f207d4cbe3842472583ae76fba8a8aa8bab5a5cba3a432c12eff2a2449d53ff93187a043a6bfd0e864c4d

data/README.md

@@ -44,6 +44,37 @@ Emb.setup
 2. `EMB_URL` environment variable
 3. Default: `redis://localhost:6379`
 
+### Global configuration
+
+Every client (`Emb.setup`, `Emb.new`, and the lazily-created default client) inherits a
+shared global `Emb::Config` value object set with `Emb.configure`. Settings
+resolve in this order — the first one wins:
+
+1. **Explicit per-call option** (`Emb.setup(pool: 10)`)
+2. **`Emb.configure` value**
+3. **Built-in default**
+
+```ruby
+Emb.configure do |c|
+  c.pool = 8
+  c.batch = false   # opt out of lazy batching app-wide
+end
+
+Emb.configuration   # => the shared Emb::Configuration
+Emb::Client.new(pool: 20)  # per-call still wins
+```
+
+`EMB_URL` remains the only environment variable (connection URL fallback, as before);
+`Emb.configure { |c| c.url = ... }` or an explicit `url:` override it.
+
+### Out-of-the-box defaults
+
+The shipped defaults are benchmark-derived (see `BENCHMARK.md`): **lazy batching is on by
+default** (`batch: true` — each embed coalesces into one `EMB.MULTI`), pool `5`, pure-Ruby
+RESP driver, `protocol: 2`, `reconnect_attempts: 3`. To keep the eager behavior (immediate
+`EMB` per call), opt out globally via `Emb.configure { |c| c.batch = false }` or per client
+with `Emb.new(batch: false)`.
+
 ### Connection pool
 
 ```ruby

data/lib/emb/client.rb

@@ -4,21 +4,17 @@ require 'connection_pool'
 require 'redis_client'
 
 module Emb
-  DEFAULTS = { host: 'localhost', port: 6379, pool: 5 }.freeze
-
   class Client
     attr_reader :pool
 
-    def initialize(pool: DEFAULTS[:pool], batch: false, **redis_options)
-      @batch_enabled = batch
-
-      url = extract_url!(redis_options)
-      redis_options[:host] ||= DEFAULTS[:host] unless url
-      redis_options[:port] ||= DEFAULTS[:port] unless url
-      redis_options[:protocol] ||= 2
-      redis_options[:reconnect_attempts] ||= 3
+    def initialize(pool: nil, batch: nil, **redis_options)
+      cfg = Emb.configuration
+      @batch_enabled = batch.nil? ? cfg.batch : batch
+      size = pool.nil? ? cfg.pool : pool
+      url = extract_url!(redis_options, cfg)
+      redis_options = merged_redis_options(redis_options, cfg, url)
 
-      @pool = ConnectionPool.new(size: pool) do
+      @pool = ConnectionPool.new(size: size) do
         RedisClient.new(url: url, **redis_options)
       end
 
@@ -101,9 +97,23 @@ module Emb
 
     private
 
-    def extract_url!(opts)
+    def merged_redis_options(opts, cfg, url)
+      defaults = cfg.to_h
+      keys = defaults.keys - %i[url pool batch]
+      keys -= %i[host port] if url
+
+      keys.each do |key|
+        opts[key] = defaults[key] if opts[key].nil? && !defaults[key].nil?
+      end
+
+      opts
+    end
+
+    def extract_url!(opts, cfg)
       url = opts.delete(:url)
-      url.nil? ? ENV.fetch('EMB_URL', nil) : url
+      return url unless url.nil?
+
+      cfg.url || ENV.fetch('EMB_URL', nil)
     end
   end
 end

data/lib/emb/configuration.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module Emb
+  class Configuration
+    OPTIONS = %i[
+      host port url pool batch driver protocol
+      connect_timeout read_timeout write_timeout reconnect_attempts
+    ].freeze
+
+    attr_accessor(*OPTIONS)
+
+    def initialize
+      self.host = 'localhost'
+      self.port = 6379
+      self.url = nil
+      self.pool = 5
+      self.batch = true
+      self.driver = nil
+      self.protocol = 2
+      self.connect_timeout = nil
+      self.read_timeout = nil
+      self.write_timeout = nil
+      self.reconnect_attempts = 3
+    end
+
+    def to_h
+      OPTIONS.to_h { |key| [key, public_send(key)] }
+    end
+  end
+end

data/lib/emb.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require_relative 'emb/version'
+require_relative 'emb/configuration'
 require_relative 'emb/client'
 require_relative 'emb/proxy'
 require_relative 'emb/multi'
@@ -17,6 +18,15 @@ module Emb
 
     alias config setup
 
+    def configuration
+      @configuration ||= Configuration.new
+    end
+
+    def configure
+      yield configuration if block_given?
+      configuration
+    end
+
     def [](name)    = default_client[name]
     def batch       = default_client.batch
     def models      = default_client.models

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: emb
 version: !ruby/object:Gem::Version
-  version: 0.2.2
+  version: 0.2.3
 platform: ruby
 authors:
 - elcuervo
@@ -64,6 +64,7 @@ files:
 - lib/emb.rb
 - lib/emb/batch.rb
 - lib/emb/client.rb
+- lib/emb/configuration.rb
 - lib/emb/middleware.rb
 - lib/emb/multi.rb
 - lib/emb/proxy.rb