solid-resp-ractor 0.1.1 → 0.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: dd4e364890b8cab1baeeb04fe13d2004c17be84661a4f6c4668e640b8d58f741
-  data.tar.gz: 286b643b1ef850800bd39ef5c61368b86d19e12b1afb15ea4b69bc3d113494d4
+  metadata.gz: 35d18ef0e429d762b4695758fa7981ee08737006462eabb35b65a8d66259c1ba
+  data.tar.gz: 4add467ffb81cf4d6bdef18aaaf5e8d810f3fe9995f41d03ae1f8315b57d4775
 SHA512:
-  metadata.gz: d7eb44bb5526de649fdec95b5ac2cf67e4e86d41da988abcd10ce2d79e881fe1298c3c100d0f66407fb4bcfed6e7c72ff09c5ff5ed81e467d0fce233b1b2d350
-  data.tar.gz: ffad02feae72244c364300b73c805819f516d8b29b9313d0b0e62bc70c2ae2d7e0db5a164d26b6b2145f36c43ffc6bf47c18b6f48c6d5910cfeea38bc5cb81c8
+  metadata.gz: 244ae341c2eb140844318618cc9ef305019c680b3462155cc2c55728a3ec6662466e9eab9c1e7fbed70a43ab4497bf0c8769b8b348fbf789fbfe231c6aa66730
+  data.tar.gz: 1947979260a1e0fc8003097262910876bb420a520b5b712277497c57ebad90f7d1995a716f938f8f2153a3bbb3b1425edac79720e383a170dd2e90dc8efa8ad8

data/CHANGELOG.md

@@ -2,6 +2,24 @@
 
 All notable changes to this project are documented in this file.
 
+## [0.1.3] - 2026-09-30
+
+### Changed
+
+- Use direct socket readiness waits by default while preserving custom selector
+  compatibility.
+- Cache common RESP array and bulk headers and add a fast path for flat Redis
+  commands.
+- Parse RESP type bytes and CRLF terminators without temporary strings.
+- Reduce a representative flat-command encoding benchmark from seven to three
+  allocations per operation while increasing throughput by approximately 40%.
+
+## [0.1.2] - 2026-09-29
+
+### Added
+
+- Add CI, RubyGems version, download count, and RubyDoc badges to the README.
+
 ## [0.1.1] - 2026-09-29
 
 ### Changed
@@ -32,5 +50,7 @@ All notable changes to this project are documented in this file.
   input, and parallel Ractors.
 - Ractor-shareable default encoder with no global mutable state.
 
+[0.1.3]: https://github.com/nicolasva/solid-resp-ractor/compare/v0.1.2...v0.1.3
+[0.1.2]: https://github.com/nicolasva/solid-resp-ractor/compare/v0.1.1...v0.1.2
 [0.1.1]: https://github.com/nicolasva/solid-resp-ractor/compare/v0.1.0...v0.1.1
 [0.1.0]: https://github.com/nicolasva/solid-resp-ractor/releases/tag/v0.1.0

data/README.md

@@ -1,5 +1,10 @@
 # Solid RESP Ractor
 
+[![Build Status](https://github.com/nicolasva/solid-resp-ractor/actions/workflows/ci.yml/badge.svg)](https://github.com/nicolasva/solid-resp-ractor/actions/workflows/ci.yml)
+[![Gem Version](https://badge.fury.io/rb/solid-resp-ractor.svg)](https://rubygems.org/gems/solid-resp-ractor)
+[![Downloads](https://img.shields.io/gem/dt/solid-resp-ractor?style=flat)](https://rubygems.org/gems/solid-resp-ractor)
+[![Documentation Status](https://img.shields.io/badge/docs-RubyDoc.info-blue.svg)](https://www.rubydoc.info/gems/solid-resp-ractor)
+
 `solid-resp-ractor` is a dependency-free RESP2/RESP3 codec for Ruby. It keeps
 protocol parsing independent from Redis client behavior and provides explicit
 extension points for transports, event loops, error hierarchies, value

data/lib/solid_resp_ractor/encoder.rb

@@ -20,6 +20,12 @@ module SolidRespRactor
 
   class Encoder
     CRLF = "\r\n"
+    BULK_HEADERS = Ractor.make_shareable(
+      Array.new(1_025) { |length| "$#{length}#{CRLF}".freeze },
+    )
+    ARRAY_HEADERS = Ractor.make_shareable(
+      Array.new(129) { |length| "*#{length}#{CRLF}".freeze },
+    )
 
     attr_reader :argument_encoder
 
@@ -30,6 +36,10 @@ module SolidRespRactor
     end
 
     def encode(command)
+      unless @expand_arrays && command.any? { |argument| argument.is_a?(Array) }
+        return encode_flat(command)
+      end
+
       length = command.sum { |argument| expanded?(argument) ? argument.length : 1 }
       raise ArgumentError, "RESP command cannot be empty" if length.zero?
 
@@ -44,6 +54,19 @@ module SolidRespRactor
 
     private
 
+    def encode_flat(command)
+      length = command.length
+      raise ArgumentError, "RESP command cannot be empty" if length.zero?
+
+      command.each_with_object(+array_header(length)) do |argument, buffer|
+        append_argument(buffer, argument)
+      end
+    end
+
+    def array_header(length)
+      ARRAY_HEADERS[length] || "*#{length}#{CRLF}"
+    end
+
     def expanded?(argument)
       @expand_arrays && argument.is_a?(Array)
     end
@@ -54,7 +77,11 @@ module SolidRespRactor
         raise TypeError, "argument encoder must return a String, got #{value.class}"
       end
 
-      buffer << "$#{value.bytesize}#{CRLF}#{value}#{CRLF}"
+      buffer << bulk_header(value.bytesize) << value << CRLF
+    end
+
+    def bulk_header(length)
+      BULK_HEADERS[length] || "$#{length}#{CRLF}"
     end
   end
 

data/lib/solid_resp_ractor/reader.rb

@@ -61,7 +61,7 @@ module SolidRespRactor
       if @read_depth > @limits.max_nesting_depth
         raise ProtocolError, "RESP nesting exceeds #{@limits.max_nesting_depth}"
       end
-      value = read_type(read_bytes(1))
+      value = read_type(read_byte)
       raise @captured_error if top_level && exception && @captured_error
 
       value
@@ -75,22 +75,22 @@ module SolidRespRactor
 
     def read_type(type)
       case type
-      when "+" then handle(:simple_string, read_line)
-      when "-" then error_response(read_line, blob: false)
-      when ":" then handle(:integer, parse_integer(read_line))
-      when "$" then read_blob
-      when "*" then read_array
-      when "_" then read_null
-      when "#" then read_boolean
-      when "," then handle(:double, parse_float(read_line))
-      when "(" then handle(:big_number, parse_integer(read_line))
-      when "%" then read_map
-      when "~" then read_collection(:set)
-      when ">" then read_collection(:push)
-      when "=" then read_verbatim
-      when "!" then error_response(read_sized_string(streamed: true), blob: true)
-      when "|" then read_attribute
-      else raise ProtocolError, "Unknown RESP type byte: #{type.inspect}"
+      when 43 then handle(:simple_string, read_line)
+      when 45 then error_response(read_line, blob: false)
+      when 58 then handle(:integer, parse_integer(read_line))
+      when 36 then read_blob
+      when 42 then read_array
+      when 95 then read_null
+      when 35 then read_boolean
+      when 44 then handle(:double, parse_float(read_line))
+      when 40 then handle(:big_number, parse_integer(read_line))
+      when 37 then read_map
+      when 126 then read_collection(:set)
+      when 62 then read_collection(:push)
+      when 61 then read_verbatim
+      when 33 then error_response(read_sized_string(streamed: true), blob: true)
+      when 124 then read_attribute
+      else raise ProtocolError, "Unknown RESP type byte: #{type.chr.inspect}"
       end
     end
 
@@ -143,7 +143,7 @@ module SolidRespRactor
     def read_streamed_collection
       values = []
       loop do
-        type = read_bytes(1)
+        type = read_byte
         break if aggregate_end?(type)
 
         values << read_type(type)
@@ -156,7 +156,7 @@ module SolidRespRactor
       {}.tap do |result|
         count = 0
         loop do
-          type = read_bytes(1)
+          type = read_byte
           break if aggregate_end?(type)
 
           key = read_type(type)
@@ -168,7 +168,7 @@ module SolidRespRactor
     end
 
     def aggregate_end?(type)
-      return false unless type == "."
+      return false unless type == 46
 
       value = read_line
       raise ProtocolError, "RESP aggregate terminator must not contain data" unless value.empty?
@@ -215,8 +215,10 @@ module SolidRespRactor
     def read_chunked_string
       buffer = +""
       loop do
-        type = read_bytes(1)
-        raise ProtocolError, "Expected RESP chunk, got #{type.inspect}" unless type == ";"
+        type = read_byte
+        unless type == 59
+          raise ProtocolError, "Expected RESP chunk, got #{type.chr.inspect}"
+        end
 
         length = read_length
         break if length.zero?
@@ -229,9 +231,7 @@ module SolidRespRactor
 
     def read_sized_value(length)
       value = read_bytes(length)
-      actual = read_bytes(2)
-      raise ProtocolError, "Expected CRLF, got #{actual.inspect}" unless actual == CRLF
-
+      read_crlf
       value
     end
 
@@ -289,6 +289,26 @@ module SolidRespRactor
       value
     end
 
+    def read_byte
+      fill_buffer while available_bytes < 1
+      value = @buffer.getbyte(@offset)
+      @offset += 1
+      clear_consumed_buffer
+      value
+    end
+
+    def read_crlf
+      fill_buffer while available_bytes < 2
+      unless @buffer.getbyte(@offset) == 13 &&
+          @buffer.getbyte(@offset + 1) == 10
+        actual = @buffer.byteslice(@offset, 2)
+        raise ProtocolError, "Expected CRLF, got #{actual.inspect}"
+      end
+
+      @offset += 2
+      clear_consumed_buffer
+    end
+
     def fill_buffer
       compact_buffer
       chunk = @source.read(timeout: @read_timeout)

data/lib/solid_resp_ractor/source.rb

@@ -18,6 +18,18 @@ module SolidRespRactor
       def call(readers, writers, timeout)
         IO.select(readers, writers, nil, timeout)
       end
+
+      def wait(io, event, timeout)
+        if event == :read && io.respond_to?(:wait_readable)
+          io.wait_readable(timeout)
+        elsif event == :write && io.respond_to?(:wait_writable)
+          io.wait_writable(timeout)
+        else
+          readers = event == :read ? [io] : nil
+          writers = event == :write ? [io] : nil
+          call(readers, writers, timeout)
+        end
+      end
     end
   end
 
@@ -50,9 +62,8 @@ module SolidRespRactor
           raise_timeout(timeout) if remaining && remaining <= 0
 
           selectable = @io.respond_to?(:to_io) ? @io.to_io : @io
-          readers = chunk == :wait_readable ? [selectable] : nil
-          writers = chunk == :wait_writable ? [selectable] : nil
-          raise_timeout(timeout) unless @selector.call(readers, writers, remaining)
+          event = chunk == :wait_readable ? :read : :write
+          raise_timeout(timeout) unless wait(selectable, event, remaining)
         end
       rescue IOError, SystemCallError => error
         raise ConnectionError, error.message, cause: error
@@ -61,7 +72,7 @@ module SolidRespRactor
       def wait_readable(timeout)
         return true unless @io.respond_to?(:to_io)
 
-        !@selector.call([@io.to_io], nil, timeout).nil?
+        !wait(@io.to_io, :read, timeout).nil?
       rescue IOError, SystemCallError => error
         raise ConnectionError, error.message, cause: error
       end
@@ -72,6 +83,14 @@ module SolidRespRactor
         @io.read(@chunk_size)
       end
 
+      def wait(io, event, timeout)
+        return @selector.wait(io, event, timeout) if @selector.respond_to?(:wait)
+
+        readers = event == :read ? [io] : nil
+        writers = event == :write ? [io] : nil
+        @selector.call(readers, writers, timeout)
+      end
+
       def raise_timeout(timeout)
         raise TimeoutError, "RESP read timed out after #{timeout}s"
       end

data/lib/solid_resp_ractor/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module SolidRespRactor
-  VERSION = "0.1.1"
+  VERSION = "0.1.3"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: solid-resp-ractor
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.3
 platform: ruby
 authors:
 - Nicolas Vandenbogaerde