ractor-rails-shim 0.2.0 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2f462e8a604fac024cc13b3f1667ec9e9c79207cb675a473e7f2f536e7ac4c8d
-  data.tar.gz: 76652b85a06f3c7e6cc50b7619f4b28c52da420f6f946f09518f01b5143c4094
+  metadata.gz: 515076a823c0767ce28d1bf35545a6ced10f2ef1f628f8e263cde654b58fb899
+  data.tar.gz: df743b8da60645f80569b646301d7d0fd5c197756ffb928921144f7fac161c5e
 SHA512:
-  metadata.gz: 83964fbfa3a113e70ca8bdfd5f6f69ea3598cf028207bb43971a9b6ed135e28f4b2f2a5b1d0bbcdf574a9a12313ff9ab6664182d22b8a3e00ab959105bdb72ce
-  data.tar.gz: be2ef63949ea84ac7f3dfa72a65d57f2687b2b1dc53de6f85a8709d42b84fcec5588f429e298beb8aa76e682b593ebfeb49dd292191cc620bd847b9b84e78c78
+  metadata.gz: c4c6fc83fc7fc61a0fecf603e26e2031d2876f20222c29717cc267fc99acfd7ed4e3e05cd98995099a62807bc37e37f34635c676c334caf2c99cc8d4acc50c0d
+  data.tar.gz: 53bb7cf546753b3bc7c6dc7313dc9b0bbf86b616f1e8f7fc1f0f45d0428988efeee0308bf93c7cf127e9219ebcd747f76340a86b750853a5fad81eaae5da4a0e

data/CHANGELOG.md

@@ -7,6 +7,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Changed
+- Improved the published gem summary and description (gemspec). Metadata-only
+  release — no code changes.
+
 ### Added — ActiveRecord query-path ractor-safety (Blocker 1 deep work)
 - `RactorRailsShim.worker_ar_init(app)` — a shareable Rack middleware that
   calls `init_worker_ar_connections!` on each worker's first request. Kino's

data/README.md

@@ -35,6 +35,19 @@ run a Rails app in Ractor mode is
 developed and tested against a real Rails 8.1 app **served by kino**; that is
 the configuration it is verified against.
 
+**Patched kino:** the shim was validated against a kino build carrying a
+per-ractor env-string cache fix that removes a cross-ractor SIGBUS during
+sustained writes. The patch is published at
+[DDKatch/kino](https://github.com/DDKatch/kino) on the
+`ractor-per-ractor-env-cache` branch. Use that fork (rather than upstream
+`yaroslav/kino`) if you hit write-path crashes. To build it: clone the fork,
+check out that branch, then `asdf local rust 1.85.0 && cargo build --release`
+(the native extension is compiled by the Rails app's `bundle install`).
+
+**Benchmarks:** throughput/latency/memory of this shim + the test app under
+kino `:ractor` vs Puma vs Falcon are documented in
+[ractor-rails-shim-test-app/BENCHMARKS.md](https://github.com/DDKatch/ractor-rails-shim-test-app/blob/main/BENCHMARKS.md).
+
 ## Why
 
 Rails stores global state in class-level instance variables:

data/lib/ractor_rails_shim/check.rb

@@ -15,6 +15,16 @@ module RactorRailsShim
       Finding = Data.define(:owner, :ivar, :value_class, :shareable, :source, :kind)
 
       class << self
+        # Safely derive a value's class name. BasicObject (and its subclasses)
+        # don't define `.class`, so calling it raises NoMethodError — fall back
+        # to "BasicObject" in that case.
+        def safe_class(val)
+          val.class.name || val.class.to_s
+        rescue NoMethodError
+          "BasicObject"
+        end
+        private :safe_class
+
         # Scan all loaded classes/modules and report class ivars AND class
         # variables holding unshareable values. Returns an array of Finding.
         def scan
@@ -49,7 +59,7 @@ module RactorRailsShim
               findings << Finding.new(
                 owner: mod.name,
                 ivar: ivar.to_s,
-                value_class: val.class.name || val.class.to_s,
+                value_class: safe_class(val),
                 shareable: shareable,
                 source: source,
                 kind: :ivar
@@ -82,7 +92,7 @@ module RactorRailsShim
                 findings << Finding.new(
                   owner: mod.name,
                   ivar: cvar.to_s,
-                  value_class: val.class.name || val.class.to_s,
+                  value_class: safe_class(val),
                   shareable: shareable,
                   source: source,
                   kind: :cvar

data/lib/ractor_rails_shim/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module RactorRailsShim
-  VERSION = "0.2.0"
+  VERSION = "0.2.1"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ractor-rails-shim
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.1
 platform: ruby
 authors:
 - dev
@@ -24,15 +24,23 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '7.0'
 description: |
-  Rails stores global state (Rails.application, Rails.cache, Rails.logger,
-  config set via mattr_accessor) in class-level instance variables, which
-  are illegal to read or write from non-main Ractors. This shim reroutes
-  those accessors through ActiveSupport::IsolatedExecutionState (which is
-  already Ractor-safe, being thread-local with per-ractor threads) or
-  Ractor.store_if_absent, so a Rails app can run in Ractor mode.
+  ractor-rails-shim makes a Rails application Ractor-safe, so it can run in
+  Ractor mode — serving requests from worker Ractors that share one frozen
+  app graph, instead of forking N separate processes.
 
-  This is a stopgap: the goal is for Rails to do this upstream, at which
-  point the shim becomes a no-op and can be removed.
+  Rails keeps global state (Rails.application, Rails.cache, Rails.logger,
+  and every config value set via mattr_accessor / class_attribute) in
+  class-level instance variables, which Ruby forbids reading or writing from
+  a non-main Ractor. The shim reroutes those accessors through Ractor-safe
+  storage (ActiveSupport::IsolatedExecutionState, or Ractor.store_if_absent)
+  and patches the handful of raw class-ivar accessors Rails reads
+  per-request.
+
+  It is verified against a real Rails 8.1 app (Devise, Propshaft, Kaminari,
+  PostgreSQL) served by the kino web server in `kino -m ractor` mode.
+
+  This is a stopgap: once Rails supports Ractor mode upstream, this gem
+  becomes a no-op and can be removed.
 email:
 - kachur.daniil@gmail.com
 executables:
@@ -100,5 +108,6 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 rubygems_version: 4.0.10
 specification_version: 4
-summary: Monkey-patch Rails class-level globals to be Ractor-safe
+summary: Make Rails apps Ractor-safe so they can run in Ractor mode (e.g. under the
+  kino web server).
 test_files: []