emb 0.1.0 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b4a415f04bd5c26d788aed81f94684054a563b26884c74d8ef7fa7f6eec909c7
-  data.tar.gz: 752cd3992f5cd48f31ec7f6d9387f04f36990532b7d9fbce88098c3a87e8eb9d
+  metadata.gz: cc1be692fe3d651429a292c2e2d0b912aa1bb8af22dbf56b9390d7e8a00fe516
+  data.tar.gz: 433caba4f427a465b9717970884ea64e12c4169fca3f54df8e91858dc1ef21bb
 SHA512:
-  metadata.gz: 7ccade7ad0c808e237a382f4a3172c35ca651b21082135c2a1d4202bdb03acd18c47ff1bcc1a06767a07cf4050d5d3b7fdfd5eaa0789c0bcfd78f24cd31784f1
-  data.tar.gz: d95c5f9c7064ecf7d61d1a81211909152ce8e465cf2c0e0f39d9d1585e7798210b68b6c4a76a450d641201ecafe834c5909d57c489204328a9404e4d014d8991
+  metadata.gz: 553e753f5a90217312bd7f6e2e9240c16747b6fcc01e876cdabdc2b33a2c430cb937cb214926ee8a4d3fb77a66a45439ad6fb6c1be1885617fb0fa68026ee336
+  data.tar.gz: 478a17bbf82026da26580ead85fae29bd6f8b1350bbe841aa32b098ce0845e3005641a80f388fd7912df0ba3e2c9652a98d8dfda8769a8d48c3ceb1d3eed1ae4

data/README.md

@@ -1,45 +1,83 @@
 # emb — Ruby client
 
-Thin Ruby wrapper for [emb](https://github.com/elcuervo/emb), a Redis-compatible embedding server.
+[![emb gem](https://img.shields.io/gem/v/emb?logo=rubygems&color=red&label=emb)](https://rubygems.org/gems/emb)
 
-## Usage
+Thin Ruby wrapper for [emb](https://github.com/elcuervo/emb), a Redis-compatible embedding server. Auto-decodes float32 binary responses to Ruby arrays.
+
+## Installation
+
+Add to your Gemfile:
+
+```ruby
+gem "emb"
+```
+
+Or install globally:
+
+```bash
+gem install emb
+```
+
+## Setup
+
+Configure the connection pool (defaults shown):
 
 ```ruby
 require "emb"
 
 Emb.setup(host: "localhost", port: 6379, pool: 5)
+```
+
+`Emb.config` is an alias for `Emb.setup`.
 
-Emb[:minilm]["hello world"]
-# → raw float32 bytes
+## Usage
+
+### Single text
+
+```ruby
+result = Emb[:minilm]["hello world"]
+# => [0.0123, -0.0456, 0.0789, ...]  (384 floats)
+```
+
+### Multiple texts
+
+```ruby
+results = Emb[:minilm]["hello", "world"]
+# => [[0.0123, ...], [-0.0456, ...]]
+```
 
-Emb.models
-# → [{name: "minilm", dim: 384, status: "ready"}, ...]
+### Multi-model queries
 
-Emb.info(:minilm)
-# → {dim: 384, workers: 10, ...}
+Send texts to different models in one round trip:
 
+```ruby
 Emb.multi do |m|
   m[:minilm]["hello"]
   m[:bge]["world"]
 end
-# → EMB.MULTI minilm "hello" bge "world"
+# => EMB.MULTI minilm "hello" bge "world"
 ```
 
-## Testing end to end
+### Commands
 
-### Prerequisites
+```ruby
+Emb.models   # => [{name: "minilm", dim: 384, status: "ready"}, ...]
+Emb.info(:minilm)  # => {dim: 384, workers: 10, requests: 42, ...}
+Emb.stats    # => server statistics hash
+Emb.help     # => command reference string
+Emb.ping     # => "PONG"
+```
 
-- An `emb` binary built from the repo root (`just build` or `go build`)
-- Ruby 3.3+ with bundler
+## Testing end to end
 
-### Running tests
+Start the emb server, then run the test suite:
 
 ```bash
-# From the repo root, start the emb server:
+# From the repo root:
 ./bin/emb -config test-two-models.yaml &
 
-# From gems/emb/, run the test suite:
+# From gems/emb/:
 bundle exec rake
 ```
 
-This starts the full test suite against a real running `emb` server. Tests cover all commands: `EMB`, `EMB.MODELS`, `EMB.INFO`, `EMB.HELP`, `PING`, and `EMB.MULTI`.
+Tests cover all commands: `EMB`, `EMB.MODELS`, `EMB.INFO`, `EMB.HELP`, `PING`, and `EMB.MULTI`.

data/lib/emb/client.rb

@@ -6,7 +6,7 @@ require "redis_client"
 module Emb
   @pool = nil
 
-  DEFAULTS = {host: "localhost", port: 6379, pool: 5}.freeze
+  DEFAULTS = { host: "localhost", port: 6379, pool: 5 }.freeze
 
   class << self
     def setup(host: DEFAULTS[:host], port: DEFAULTS[:port], pool: DEFAULTS[:pool])
@@ -14,6 +14,7 @@ module Emb
         RedisClient.new(host: host, port: port, protocol: 2, reconnect_attempts: 3)
       end
     end
+
     alias_method :config, :setup
 
     def send_command(*args)

data/lib/emb/multi.rb

@@ -12,6 +12,7 @@ module Emb
 
     def run
       args = @pairs.flat_map { |pair| [pair[:model].to_s, pair[:text]] }
+
       Emb.send_command("EMB.MULTI", *args)
     end
 
@@ -22,7 +23,8 @@ module Emb
       end
 
       def [](text)
-        @pairs << {model: @model, text: text}
+        @pairs << {
+           model: @model, text: text }
       end
     end
   end
@@ -30,7 +32,9 @@ module Emb
   class << self
     def multi
       mp = MultiProxy.new
+
       yield mp
+
       mp.run
     end
   end

data/lib/emb/proxy.rb

@@ -21,7 +21,12 @@ module Emb
     end
 
     def [](text, *texts)
-      Emb.send_command("EMB", @name.to_s, text, *texts)
+      set = Array(Emb.send_command("EMB", @name.to_s, text, *texts))
+      result = set.map { |entry| entry.unpack("e*") }
+
+      return result.first if result.size == 1
+
+      result
     end
 
     def inspect

data/lib/emb/version.rb

@@ -1,10 +1,5 @@
 # frozen_string_literal: true
 
 module Emb
-  VERSION =
-    begin
-      File.read(File.expand_path('../../../../VERSION', __dir__)).strip
-    rescue Errno::ENOENT
-      Gem::Specification.find_by_name("emb").version.to_s
-    end
+  VERSION = Gem.loaded_specs['emb'].version.to_s
 end

data/lib/emb.rb

@@ -9,8 +9,12 @@ module Emb
   class << self
     def models
       raw = send_command("EMB.MODELS")
+
       return [] if raw.nil?
-      raw.map { |name, dim, status| {name: name, dim: dim.to_i, status: status} }
+
+      raw.map do |name, dim, status|
+        { name: name, dim: dim.to_i, status: status }
+      end
     end
 
     def info(name)
@@ -18,7 +22,9 @@ module Emb
 
       return {} if raw.nil?
 
-      raw.each_slice(2).map { |k, v| [k.to_sym, v] }.to_h
+      raw
+        .each_slice(2)
+        .to_h { |k, v| [k.to_sym, v] }
     end
 
     def stats = send_command("EMB.STATS")

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: emb
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.2
 platform: ruby
 authors:
 - elcuervo
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-07-01 00:00:00.000000000 Z
+date: 2026-07-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: connection_pool