solid-resp-ractor 0.1.3 → 0.1.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 35d18ef0e429d762b4695758fa7981ee08737006462eabb35b65a8d66259c1ba
-  data.tar.gz: 4add467ffb81cf4d6bdef18aaaf5e8d810f3fe9995f41d03ae1f8315b57d4775
+  metadata.gz: e95465d9cdecff50ce715e8150335b5f90da49121a1a047edb433210e308015c
+  data.tar.gz: 1dd82d1a8d80ea412d1ce2257f51b081dc5231718f9aaed71386d739a6bc8ac3
 SHA512:
-  metadata.gz: 244ae341c2eb140844318618cc9ef305019c680b3462155cc2c55728a3ec6662466e9eab9c1e7fbed70a43ab4497bf0c8769b8b348fbf789fbfe231c6aa66730
-  data.tar.gz: 1947979260a1e0fc8003097262910876bb420a520b5b712277497c57ebad90f7d1995a716f938f8f2153a3bbb3b1425edac79720e383a170dd2e90dc8efa8ad8
+  metadata.gz: bd9661ccd7e481088936f7b3425da4bacf8a58754dab3122397bbd003d03c7704fe1e6b813be11575dab60b790548c776ca1e452998c80891b8a967c4ccfa7d2
+  data.tar.gz: 901b266a995302514ebe6f0fb4cdfd0e9641e415b908fb109b249b8ed14e0b0f2fe2572c2e902158d6af9918f50cc1ed725f1a48f1c70c825484578dbbc99a4b

data/CHANGELOG.md

@@ -2,6 +2,17 @@
 
 All notable changes to this project are documented in this file.
 
+## [0.1.4] - 2026-10-01
+
+### Changed
+
+- Reuse a destination String for non-blocking IO reads instead of allocating a
+  chunk-sized String for every socket response.
+- Reduce loopback GET allocation from 16,609.8 to 120.8 bytes per operation
+  and from 6.0 to 4.0 objects per operation in the Ruby 4.0.1 benchmark.
+- Improve loopback GET throughput by 8.18% at eight Ractors while preserving
+  Reader parser-buffer invariants.
+
 ## [0.1.3] - 2026-09-30
 
 ### Changed
@@ -50,6 +61,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.4]: https://github.com/nicolasva/solid-resp-ractor/compare/v0.1.3...v0.1.4
 [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

data/README.md

@@ -272,6 +272,89 @@ after at least 16 KiB have been consumed and that prefix occupies at least half
 of the buffer. This avoids copying a large unread suffix after small fragmented
 reads while still releasing consumed data during long-lived streams.
 
+## Reader benchmark
+
+Encoding, Reader-only, TCP, allocation, and Ractor-scaling benchmarks live in
+the separate `benchmark_solid_resp_ractor` sibling bundle so benchmark tooling
+and generated reports remain outside the gem.
+
+Run the complete matrix from the sibling checkout:
+
+```sh
+cd ../benchmark_solid_resp_ractor
+RBENV_VERSION=4.0.1 \
+BENCHMARK_OUTPUT=results/ruby-4.0.1-reader.md \
+bundle exec rake
+```
+
+### Current baseline
+
+**Environment:** Ruby 4.0.1 (arm64-darwin25); solid-resp-ractor 0.1.3;
+Redis 8.10.0. Values are medians of three runs with one second of warmup and
+three seconds of measurement per row. Pipeline metrics are amortized per
+command. Reader-only rows consume an in-memory repeating 16 KiB source.
+Reader + TCP rows use an isolated loopback Redis server. Allocation metrics
+are measured separately in one Ractor with GC disabled, then repeated across
+the scaling rows; Redis allocations are excluded.
+
+| Ractors | Layer | Operation | ops/s | Scaling efficiency | alloc/op | bytes/op |
+|---:|---|---|---:|---:|---:|---:|
+| 1 | Encode | GET | 1,261,840 | 100.0% | 2.0 | 104.8 |
+| 2 | Encode | GET | 2,298,471 | 91.1% | 2.0 | 104.8 |
+| 4 | Encode | GET | 3,898,679 | 77.2% | 2.0 | 104.8 |
+| 8 | Encode | GET | 5,234,281 | 51.9% | 2.0 | 104.8 |
+| 1 | Encode | SET | 974,781 | 100.0% | 2.0 | 104.8 |
+| 2 | Encode | SET | 1,797,823 | 92.2% | 2.0 | 104.8 |
+| 4 | Encode | SET | 3,249,650 | 83.3% | 2.0 | 104.8 |
+| 8 | Encode | SET | 4,470,244 | 57.3% | 2.0 | 104.8 |
+| 1 | Encode | pipeline 50 | 1,345,762 | 100.0% | 2.0 | 145.8 |
+| 2 | Encode | pipeline 50 | 2,482,408 | 92.2% | 2.0 | 145.8 |
+| 4 | Encode | pipeline 50 | 4,250,421 | 79.0% | 2.0 | 145.8 |
+| 8 | Encode | pipeline 50 | 5,779,732 | 53.7% | 2.0 | 145.8 |
+| 1 | Reader | +OK | 1,690,247 | 100.0% | 2.0 | 40.8 |
+| 2 | Reader | +OK | 3,197,883 | 94.6% | 2.0 | 40.8 |
+| 4 | Reader | +OK | 5,788,420 | 85.6% | 2.0 | 40.8 |
+| 8 | Reader | +OK | 8,029,110 | 59.4% | 2.0 | 40.8 |
+| 1 | Reader | integer | 1,562,655 | 100.0% | 2.0 | 40.8 |
+| 2 | Reader | integer | 2,968,526 | 95.0% | 2.0 | 40.8 |
+| 4 | Reader | integer | 5,459,562 | 87.3% | 2.0 | 40.8 |
+| 8 | Reader | integer | 7,423,102 | 59.4% | 2.0 | 40.8 |
+| 1 | Reader | bulk 16 B | 787,426 | 100.0% | 3.0 | 120.8 |
+| 2 | Reader | bulk 16 B | 1,533,310 | 97.4% | 3.0 | 120.8 |
+| 4 | Reader | bulk 16 B | 2,796,102 | 88.8% | 3.0 | 120.8 |
+| 8 | Reader | bulk 16 B | 4,090,043 | 64.9% | 3.0 | 120.8 |
+| 1 | Reader | bulk 1 KiB | 709,062 | 100.0% | 3.0 | 1,105.8 |
+| 2 | Reader | bulk 1 KiB | 1,225,199 | 86.4% | 3.0 | 1,105.8 |
+| 4 | Reader | bulk 1 KiB | 2,055,006 | 72.5% | 3.0 | 1,105.8 |
+| 8 | Reader | bulk 1 KiB | 2,597,586 | 45.8% | 3.0 | 1,105.8 |
+| 1 | Reader | array 50 | 32,877 | 100.0% | 103.0 | 2,680.8 |
+| 2 | Reader | array 50 | 60,955 | 92.7% | 103.0 | 2,680.8 |
+| 4 | Reader | array 50 | 115,104 | 87.5% | 103.0 | 2,680.8 |
+| 8 | Reader | array 50 | 185,791 | 70.6% | 103.0 | 2,680.8 |
+| 1 | Reader | nested RESP3 | 87,279 | 100.0% | 34.0 | 1,080.9 |
+| 2 | Reader | nested RESP3 | 166,456 | 95.4% | 34.0 | 1,080.9 |
+| 4 | Reader | nested RESP3 | 302,211 | 86.6% | 34.0 | 1,080.9 |
+| 8 | Reader | nested RESP3 | 433,100 | 62.0% | 34.0 | 1,080.9 |
+| 1 | Reader + TCP | GET | 40,173 | 100.0% | 4.0 | 120.8 |
+| 2 | Reader + TCP | GET | 66,235 | 82.4% | 4.0 | 120.8 |
+| 4 | Reader + TCP | GET | 89,146 | 55.5% | 4.0 | 120.8 |
+| 8 | Reader + TCP | GET | 102,060 | 31.8% | 4.0 | 120.8 |
+| 1 | Reader + TCP | pipeline 50 | 473,123 | 100.0% | 3.0 | 120.0 |
+| 2 | Reader + TCP | pipeline 50 | 878,582 | 92.8% | 3.0 | 120.0 |
+| 4 | Reader + TCP | pipeline 50 | 1,478,781 | 78.1% | 3.0 | 120.0 |
+| 8 | Reader + TCP | pipeline 50 | 2,044,122 | 54.0% | 3.0 | 120.0 |
+
+Pure bulk decoding represents roughly 5.1% of the service time of a
+non-pipelined loopback GET, but about 60% of an amortized pipeline command.
+These are directional ratios rather than profiler attribution.
+
+Reusing the destination String passed to `read_nonblock` reduced GET
+allocation from 16,609.8 to 120.8 bytes/op (-99.27%) and from 6.0 to 4.0
+objects/op. GET throughput changed by -0.68% at 1R and improved by 8.18% at
+8R. Pipeline allocation fell from 472.3 to 120.0 bytes/op (-74.59%), while
+throughput improved by 2.23% at 8R. The allocation improvement is structural
+and does not require changing Reader parser invariants.
+
 ## Development
 
 ```sh

data/lib/solid_resp_ractor/source.rb

@@ -47,6 +47,7 @@ module SolidRespRactor
 
         @selector = selector
         @clock = clock
+        @read_buffer = +""
       end
 
       def read(timeout:)
@@ -54,7 +55,11 @@ module SolidRespRactor
 
         deadline = nil
         loop do
-          chunk = @io.read_nonblock(@chunk_size, exception: false)
+          chunk = @io.read_nonblock(
+            @chunk_size,
+            @read_buffer,
+            exception: false,
+          )
           return chunk unless chunk == :wait_readable || chunk == :wait_writable
 
           deadline ||= @clock.now + timeout if timeout

data/lib/solid_resp_ractor/version.rb

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

metadata

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