emb 0.4.0.pre5 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a9b606e95ab03ea635c8ec7acf1aaa0024a4646cb1a8f41d2e3509c8acefedfa
-  data.tar.gz: 78c102fe8b5f547104e5b0e124223f34b4694b19de7c5bccdf2881423fedbbd7
+  metadata.gz: 99633d8ba61adbf0de6c6fb915f2505ac67298d1a30d070808bb443e65c19aed
+  data.tar.gz: 847e2df69be7a2c228faf9207d8f3ca92c7b6e4b93762bb3160db9b0253de9af
 SHA512:
-  metadata.gz: c8cd7137ff7332f70537789a6bd9ddac1cf3d591156c3bf51676e5242236e8aabd247312e1a166a2aa584ad3041d45a3016979b383b640ffc8dbc6ecc2cf8b64
-  data.tar.gz: ef7a6c243c471b0026c4b35b73120e10b38a2384e12de142e5ebef1b3a9c3200a8180bf1b109eb8282114f7546060b43eed1a3a76adc6e8ad14b09d4da3a4b4e
+  metadata.gz: 7c34b36d11f4a3cc86087d6d8d973f4ab791ad3ce02d22031fabce0e3e842a7d73a8bc545b1cb68e8bf56ca67d1e3f63ca6e6e3256b5e14c2d9ffadcdc5b3978
+  data.tar.gz: 6c70ec162e9740745c976cba443ead4d99809c365b4d0729291d56d525d297c76eeb4d057e938febda1f56b066bab1f0859f89de656584f6c975c1f0b2bf054c

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 elcuervo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -70,7 +70,10 @@ Emb::Client.new(pool: 20)  # per-call still wins
 The shipped defaults are benchmark-derived (see `BENCHMARK.md`) with secure-by-default
 network behavior: **eager execution by default** (`lazy: false` — every `Emb[:model][t]`
 sends one `EMB` round trip), pool `5`, pure-Ruby RESP driver, `protocol: 2`,
-`read_timeout`/`write_timeout` both **10s**, and `reconnect_attempts: 0`. Opt into
+`read_timeout`/`write_timeout` both **10s**, and `reconnect_attempts: 0`. `protocol: 2`
+is the only supported value: the gem speaks RESP2 and does not decode the RESP3 maps the
+server emits for `EMB.MODELS`, `EMB.STATS`, `EMB.INFO`, and `CONFIG GET`, so setting any
+other value raises `ArgumentError`. Opt into
 coalescing with `lazy: :multi` or concurrent fan-out with `lazy: :batch` — globally via
 `Emb.configure { |c| c.lazy = :batch }` or per client with `Emb.new(lazy: :batch)`.
 
@@ -215,6 +218,8 @@ Emb.info(:minilm)        # model info
 Emb.stats                # server stats (Hash of key => value)
 Emb.help                 # command reference
 Emb.ping                 # health check
+Emb.ready?               # true only when EMB.READY answers OK (false when not ready or unreachable)
+Emb.ready                # status string: "OK", or the server/connection error text
 ```
 
 These all delegate to a lazily-initialized default client. No explicit `setup` call

data/lib/emb/client.rb

@@ -66,18 +66,14 @@ module Emb
 
     def ready
       send_command('EMB.READY')
-
-      'ready'
-    rescue RedisClient::CommandError => e
+    rescue RedisClient::Error => e
       e.message
     end
 
+    # True only when the server answers EMB.READY with OK; #ready folds any
+    # Redis error (including a refused connection) into a string.
     def ready?
-      ready
-
-      true
-    rescue RedisClient::CommandError
-      false
+      ready == 'OK'
     end
 
     def reset_registry!
@@ -100,12 +96,7 @@ module Emb
       value
     end
 
-    def instance_urls(url)
-      raise ArgumentError, 'url array must not be empty' if url.is_a?(Array) && url.empty?
-
-      url.nil? ? [nil] : Array(url)
-    end
-
+    # Per-call protocol: bypasses Configuration#protocol=, so validate here too.
     def merged_redis_options(opts, cfg, url)
       defaults = cfg.to_h
       keys = defaults.keys - %i[url pool lazy batch_size]
@@ -115,9 +106,16 @@ module Emb
         opts[key] = defaults[key] if opts[key].nil? && !defaults[key].nil?
       end
 
+      Configuration.validate_protocol!(opts[:protocol])
       opts
     end
 
+    def instance_urls(url)
+      raise ArgumentError, 'url array must not be empty' if url.is_a?(Array) && url.empty?
+
+      url.nil? ? [nil] : Array(url)
+    end
+
     def extract_url!(opts, cfg)
       url = opts.delete(:url)
       return url unless url.nil?

data/lib/emb/configuration.rb

@@ -23,6 +23,19 @@ module Emb
       @lazy = value
     end
 
+    # The gem speaks RESP2 only: its models/stats/info/config decoders assume
+    # flat RESP2 arrays, and RESP3 maps would silently return wrong results.
+    def self.validate_protocol!(value)
+      return if value == 2
+
+      raise ArgumentError, "protocol must be 2 (RESP2 only; RESP3 is not decoded), got #{value.inspect}"
+    end
+
+    def protocol=(value)
+      self.class.validate_protocol!(value)
+      @protocol = value
+    end
+
     def initialize
       self.host = 'localhost'
       self.port = 6379

data/lib/emb/proxy.rb

@@ -21,17 +21,9 @@ module Emb
       if @client.lazy?
         return Emb.build_batch_loader(@client, @name, texts.empty? ? text : [text, *texts], format: format)
       end
+      return values_query(text, texts) if format == :values
 
-      if format == :values
-        return values_query(text, texts)
-      end
-
-      set = Array(@client.send_command('EMB', @name.to_s, text, *texts))
-      result = set.map { |entry| entry.unpack('e*') }
-
-      return result.first if result.size == 1
-
-      result
+      unpack_set(@client.send_command('EMB', @name.to_s, text, *texts))
     end
 
     def inspect
@@ -79,8 +71,17 @@ module Emb
 
     private
 
+    # One packed vector for a single text, an array for several; a null slot
+    # (failed/truncated position) maps to nil.
+    def unpack_set(raw)
+      return nil if raw.nil?
+
+      result = Array(raw).map { |entry| entry&.unpack('e*') }
+      result.size == 1 ? result.first : result
+    end
+
     def unpack_embedding(entry)
-      entry.nil? ? nil : entry.unpack('e*')
+      entry&.unpack('e*')
     end
 
     def normalize_format(format)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: emb
 version: !ruby/object:Gem::Version
-  version: 0.4.0.pre5
+  version: 0.4.0
 platform: ruby
 authors:
 - elcuervo
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-09-15 00:00:00.000000000 Z
+date: 2026-09-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: batch-loader
@@ -46,6 +46,7 @@ extensions: []
 extra_rdoc_files: []
 files:
 - Gemfile
+- LICENSE
 - README.md
 - lib/emb.rb
 - lib/emb/batch.rb