emb 0.2.4 → 0.2.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 361d0b6f4a7719829d4e87426227fc567af79bd16862019754c19977ddd7b11d
-  data.tar.gz: a0d165464592eaf05555ef4c8fd8400be52db48353a5f57d9e13c0e7d9b6c26a
+  metadata.gz: 7fa662777093c5abee44186eba00b90fde9f1d3cd7bafcde73fc88748dd45478
+  data.tar.gz: ba3544c2dc3e1fc875f8d86d3448b8469fd194f2f9f9a12cbf2c8a6a18353ce2
 SHA512:
-  metadata.gz: 39ad4fa8bcf1b35d5162c503c3cafcb8a94194550c370cc5135015e3285e20cead32492ddab35306ac086d8efa51b6ec52a984aeb5e18888391edfd4c10e0d8b
-  data.tar.gz: 86105916d29f1a8386578e15ecfd4965eb7be8aefa00cf59c5160ca93f6bd0653aac71bc762ed10e678c8c7624d1512c9c211e31bd3f22fd127457faec108624
+  metadata.gz: 5091504bd2fc95a74f2f0430b76a2dd029f26c3c514ecf0a1a47e8262bc21374e27786fc4f3b734c79df075d2c33794db90f3c31c5e20d45e7c10ebf99e70eec
+  data.tar.gz: 67fd93e9b4b45e0155d3cb1f9165f31810571d9eac1468e0bdbbfcf8429dc9089335961b7004bafa28176e2297602dbec7fcd4abdc794c15ffd5acb0f8ab024c

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/client.rb

@@ -5,6 +5,8 @@ require 'redis_client'
 
 module Emb
   class Client
+    include Commands
+
     attr_reader :pool
 
     def initialize(pool: nil, batch: nil, **redis_options)
@@ -45,6 +47,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 +70,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')

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/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.5
 platform: ruby
 authors:
 - elcuervo
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-08-26 00:00:00.000000000 Z
+date: 2026-08-31 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: