emb 0.2.4 → 0.2.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 361d0b6f4a7719829d4e87426227fc567af79bd16862019754c19977ddd7b11d
-  data.tar.gz: a0d165464592eaf05555ef4c8fd8400be52db48353a5f57d9e13c0e7d9b6c26a
+  metadata.gz: 0465face51bde07116c17303587651ae8c947875b9702a587654ead5256c71da
+  data.tar.gz: b0e8cf2d155a51c9b65a2bb006eec6be4d7a60e932301bea426b2ae986a91015
 SHA512:
-  metadata.gz: 39ad4fa8bcf1b35d5162c503c3cafcb8a94194550c370cc5135015e3285e20cead32492ddab35306ac086d8efa51b6ec52a984aeb5e18888391edfd4c10e0d8b
-  data.tar.gz: 86105916d29f1a8386578e15ecfd4965eb7be8aefa00cf59c5160ca93f6bd0653aac71bc762ed10e678c8c7624d1512c9c211e31bd3f22fd127457faec108624
+  metadata.gz: 843e3cdb952a4a1ece48413aad778939d155f4e345c9ebbce3ccd18ce703e53183a099dcae3b815856d062a0d7a80b3d028587704c736402ce659133eb1d7b8a
+  data.tar.gz: 786734c2ac2765bde4810313f998f83550e0823cd47887e16ebf5b2014fe2c865e22b021286187cedaf105d2d5b818c8885d85acceab72ead5e07915da17d9f3

data/README.md

@@ -36,8 +36,6 @@ Emb.setup(host: "localhost", port: 6379)
 Emb.setup
 ```
 
-`Emb.config` is an alias for `Emb.setup`.
-
 ### Configuration sources (priority order)
 
 1. Explicit `url:` or `host:`/`port:` arguments
@@ -160,7 +158,7 @@ Emb.setup
 Emb[:minilm]["hello"]   # proxy access
 Emb.models               # list models
 Emb.info(:minilm)        # model info
-Emb.stats                # server stats
+Emb.stats                # server stats (Hash of key => value)
 Emb.help                 # command reference
 Emb.ping                 # health check
 ```
@@ -169,6 +167,67 @@ These all delegate to a lazily-initialized default client. No explicit `setup` c
 is required for simple cases — the default client connects to `redis://localhost:6379`
 automatically.
 
+## Server info & config
+
+The server exposes Redis-style `INFO` and `CONFIG` commands; the gem wraps them.
+
+### `Emb.stats` — server statistics as a hash
+
+`EMB.STATS` is decoded into a Symbol-keyed Hash with values as the server sent them
+(RESP integers stay Integer, everything else String):
+
+```ruby
+Emb.stats
+# => {uptime_secs: 3, total_requests: 0, active_requests: "0", total_tokens: 0,
+#     total_errors: 0, models_loaded: 1, per_model: "minilm: req=0 avg=0us tok=0 ...",
+#     cache_hits: 0, cache_misses: 0, cache_evictions: 0}
+```
+
+> **Breaking change (gem ≥ next release):** `Emb.stats` used to return the raw
+> RESP array (`["uptime_secs", 3, "total_requests", 0, ...]`). It now returns the
+> Hash above. Callers using `stats.each_slice(2)` or array indexing must migrate.
+
+### `Emb.server_info` — sectioned INFO, parsed
+
+The Redis-style `INFO` reply is parsed into a nested Hash. **No arguments = all
+sections**; pass section names to filter (`:server`, `:cache`, `:keyspace`, `:stats`, `:clients`):
+
+```ruby
+Emb.server_info
+# => {Server: {redis_version: "0.2.4", emb_version: "0.2.4", uptime_secs: "7", ...},
+#     Cache: {cache_hits: 0, cache_misses: 0, cache_hit_rate: "0.0%", ...},
+#     Keyspace: {db0: "model=minilm,keys=0,hits=0,misses=0,hit_rate=0.0%"}, ...}
+
+Emb.server_info(:server, :cache)   # only those two sections
+```
+
+### `Emb.config` — hot config read & change
+
+`Emb.config` is a Hash-like live view of the server's runtime configuration
+(backed by `CONFIG GET` / `CONFIG SET`). **Note:** the former `Emb.config` alias
+for `Emb.setup` is gone — use `Emb.setup` to configure the client.
+
+```ruby
+Emb.config.to_h                          # all parameters
+# => {"cache" => "auto", "cache_file" => "", "cache_save" => "", "listen" => ":6379",
+#     "password" => "", "models" => "minilm,bge", "tls_cert" => "", "tls_key" => ""}
+
+Emb.config['cache']                      # exact key => String value
+# => "auto"
+Emb.config['cache*']                     # glob => Hash of matching parameters
+Emb.config['listen']                     # unknown key => nil
+
+Emb.config['cache'] = '100MB'            # live change; returns "OK"
+Emb.config['cache_file'] = '/var/lib/emb/cache.rdb'
+```
+
+Values are Strings (config is text, not metrics) and round-trip into writers
+unchanged. `cache` resizes immediately, `cache_file`/`cache_save` apply at the
+next snapshot save, `password` affects new connections. Errors surface as
+exceptions (`RedisClient::CommandError`): read-only parameters (`listen`, `tls_*`,
+`models`), invalid values, and `NOAUTH` on password-protected servers are not
+swallowed.
+
 ## Usage
 
 ### Single text

data/lib/emb/batch.rb

@@ -7,18 +7,24 @@ module Emb
 
   BATCH_BLOCK = lambda do |items, loader, _args|
     items.group_by(&:first).each do |client, client_items|
-      pairs = client_items.flat_map { |_, model, text| Array(text).flat_map { |t| [model.to_s, t] } }
-      results = Array(client.send_command('EMB.MULTI', *pairs))
-
-      offset = 0
-      client_items.each do |item|
-        _, _, text = item
-        texts = Array(text)
-        values = results[offset, texts.size].map { |entry| entry&.unpack('e*') }
-        offset += texts.size
-
-        # eager Proxy#[] shape: vector for a single text, vectors for many
-        loader.call(item, values.size == 1 ? values.first : values)
+      chunk = client.respond_to?(:batch_size) && client.batch_size ? client.batch_size : Emb.configuration.batch_size
+
+      # Chunk at batch_size pairs per EMB.MULTI so a single command stays well
+      # under the server's max_pairs cap and within client read timeouts.
+      client_items.each_slice(chunk) do |slice|
+        pairs = slice.flat_map { |_, model, text| Array(text).flat_map { |t| [model.to_s, t] } }
+        results = Array(client.send_command('EMB.MULTI', *pairs))
+
+        offset = 0
+        slice.each do |item|
+          _, _, text = item
+          texts = Array(text)
+          values = results[offset, texts.size].map { |entry| entry&.unpack('e*') }
+          offset += texts.size
+
+          # eager Proxy#[] shape: vector for a single text, vectors for many
+          loader.call(item, values.size == 1 ? values.first : values)
+        end
       end
     end
   end

data/lib/emb/client.rb

@@ -5,11 +5,14 @@ require 'redis_client'
 
 module Emb
   class Client
-    attr_reader :pool
+    include Commands
+
+    attr_reader :pool, :batch_size
 
     def initialize(pool: nil, batch: nil, **redis_options)
       cfg = Emb.configuration
       @batch_enabled = batch.nil? ? cfg.batch : batch
+      @batch_size = redis_options.delete(:batch_size) || cfg.batch_size
       size = pool.nil? ? cfg.pool : pool
       url = extract_url!(redis_options, cfg)
       redis_options = merged_redis_options(redis_options, cfg, url)
@@ -45,6 +48,11 @@ module Emb
       @batch_enabled
     end
 
+    # Live view of the server's runtime configuration (CONFIG GET/SET).
+    def config
+      @config ||= RuntimeConfig.new(self)
+    end
+
     def models
       raw = send_command('EMB.MODELS')
       return [] if raw.nil?
@@ -63,8 +71,6 @@ module Emb
         .to_h { |k, v| [k.to_sym, v] }
     end
 
-    def stats = send_command('EMB.STATS')
-
     def help = send_command('EMB.HELP')
 
     def ping = send_command('PING')
@@ -99,7 +105,7 @@ module Emb
 
     def merged_redis_options(opts, cfg, url)
       defaults = cfg.to_h
-      keys = defaults.keys - %i[url pool batch]
+      keys = defaults.keys - %i[url pool batch batch_size]
       keys -= %i[host port] if url
 
       keys.each do |key|

data/lib/emb/commands.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+module Emb
+  # Server-status and runtime-config command wrappers. They only depend on
+  # #send_command, so they live in this module (included into Emb::Client)
+  # rather than growing the client class.
+  module Commands
+    # EMB.STATS as a Symbol-keyed Hash. No client-side type layer: values are
+    # exactly what the RESP decoder returned (Integer where the server sends
+    # RESP integers, String otherwise).
+    def stats
+      raw = send_command('EMB.STATS')
+      raw.each_slice(2).to_h { |key, value| [key.to_sym, value] }
+    end
+
+    # Server-wide INFO (the Redis-style sectioned command). No sections =
+    # all sections; any number of sections filter the reply.
+    def server_info(*sections)
+      parse_info(send_command('INFO', *sections.map(&:to_s)))
+    end
+
+    private
+
+    # Parse Redis INFO section text into a nested Hash:
+    #   {Server: {redis_version: "0.2.4", uptime_secs: "7"}, Cache: {…}, …}
+    # Section names and keys are Symbols; values pass through as the server
+    # sent them. Lines that don't fit the grammar are ignored.
+    def parse_info(text)
+      sections = {}
+      current = nil
+
+      text.split("\r\n").each do |line|
+        if line.start_with?('# ')
+          current = line[2..].to_sym
+          sections[current] ||= {}
+        elsif current && line.include?(':')
+          key, value = line.split(':', 2)
+          sections[current][key.to_sym] = value
+        end
+      end
+
+      sections
+    end
+  end
+end

data/lib/emb/configuration.rb

@@ -3,7 +3,7 @@
 module Emb
   class Configuration
     OPTIONS = %i[
-      host port url pool batch driver protocol
+      host port url pool batch batch_size driver protocol
       connect_timeout read_timeout write_timeout reconnect_attempts
     ].freeze
 
@@ -15,6 +15,7 @@ module Emb
       self.url = nil
       self.pool = 5
       self.batch = true
+      self.batch_size = 512
       self.driver = nil
       self.protocol = 2
       self.connect_timeout = nil

data/lib/emb/multi.rb

@@ -12,11 +12,17 @@ module Emb
     end
 
     def run
-      args = @pairs.flat_map { |pair| [pair[:model].to_s, pair[:text]] }
+      chunk = @client.respond_to?(:batch_size) && @client.batch_size ? @client.batch_size : Emb.configuration.batch_size
 
-      @client
-        .send_command('EMB.MULTI', *args)
-        .map { |entry| entry.unpack('e*') }
+      # Chunk at batch_size pairs per EMB.MULTI so a single command stays well
+      # under the server's max_pairs cap and within client read timeouts.
+      @pairs.each_slice(chunk).flat_map do |slice|
+        args = slice.flat_map { |pair| [pair[:model].to_s, pair[:text]] }
+
+        @client
+          .send_command('EMB.MULTI', *args)
+          .map { |entry| entry&.unpack('e*') }
+      end
     end
 
     class PairCollector

data/lib/emb/runtime_config.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+module Emb
+  # Hash-like live view of the server's runtime configuration, backed by
+  # CONFIG GET / CONFIG SET.
+  #
+  #   config.to_h           # => { "cache" => "auto", "listen" => ":6379", … }
+  #   config['cache']       # => "auto"          (scalar for an exact key)
+  #   config['cache*']      # => { "cache" => …, "cache_file" => … }  (glob)
+  #   config['cache_file'] = '/var/lib/emb/cache.rdb'   # => "OK"
+  #
+  # Values are Strings (config is text, not metrics) and round-trip into
+  # writers unchanged. Server errors (unknown/read-only parameter, invalid
+  # value, NOAUTH) raise RedisClient::CommandError.
+  class RuntimeConfig
+    def initialize(client)
+      @client = client
+    end
+
+    # All parameters as a String-keyed Hash (CONFIG GET).
+    def to_h
+      pairs(@client.send_command('CONFIG', 'GET'))
+    end
+
+    # Read one parameter or a glob. An exact key returns its String value
+    # (nil when the server has no such parameter); a glob that matches
+    # several parameters returns a Hash.
+    def [](key)
+      key = key.to_s
+      map = pairs(@client.send_command('CONFIG', 'GET', key))
+      return map[key] if map.key?(key)
+
+      map.empty? ? nil : map
+    end
+
+    # Write one parameter (CONFIG SET). Returns the server's reply ("OK").
+    def []=(key, value)
+      @client.send_command('CONFIG', 'SET', key.to_s, value.to_s)
+    end
+
+    private
+
+    def pairs(raw)
+      raw.each_slice(2).to_h { |k, v| [k, v] }
+    end
+  end
+end

data/lib/emb.rb

@@ -2,6 +2,8 @@
 
 require_relative 'emb/version'
 require_relative 'emb/configuration'
+require_relative 'emb/commands'
+require_relative 'emb/runtime_config'
 require_relative 'emb/client'
 require_relative 'emb/proxy'
 require_relative 'emb/multi'
@@ -16,8 +18,6 @@ module Emb
       @default_client = Client.new(...)
     end
 
-    alias config setup
-
     def configuration
       @configuration ||= Configuration.new
     end
@@ -32,6 +32,8 @@ module Emb
     def models      = default_client.models
     def info(name)  = default_client.info(name)
     def stats       = default_client.stats
+    def server_info(*sections)  = default_client.server_info(*sections)
+    def config                  = default_client.config
     def help        = default_client.help
     def ping        = default_client.ping
     def ready       = default_client.ready

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: emb
 version: !ruby/object:Gem::Version
-  version: 0.2.4
+  version: 0.2.6
 platform: ruby
 authors:
 - elcuervo
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-08-26 00:00:00.000000000 Z
+date: 2026-09-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: batch-loader
@@ -64,10 +64,12 @@ files:
 - lib/emb.rb
 - lib/emb/batch.rb
 - lib/emb/client.rb
+- lib/emb/commands.rb
 - lib/emb/configuration.rb
 - lib/emb/middleware.rb
 - lib/emb/multi.rb
 - lib/emb/proxy.rb
+- lib/emb/runtime_config.rb
 - lib/emb/version.rb
 homepage: https://github.com/elcuervo/emb
 licenses: