ratomic 0.3.1 → 0.3.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bdf323b8b7b61fa10e96f376cf5cf5001b5df0c5155e0a2ab815a86561c2245d
-  data.tar.gz: c5d6536e0ef372bde684f19ca4af1174d1f7ab6a2143270bb884c674ab76fba2
+  metadata.gz: 4f7627c4d9c390e791c1d343633f75fffae6e37830bb480069016c804b895697
+  data.tar.gz: 5323624b8e73447184f3fdd6aba30e5a54b3ac009ccd047b9b69dfccb81e9e2b
 SHA512:
-  metadata.gz: 268606f63d6868b2f1c02421ad27e09d8344c2b404653d2e2e43376db814f9deaafdd608bce146129addd72ba43fc4b534a4a1aca17851c9fec35aad8a781400
-  data.tar.gz: fc604b15381e5ef3bd9a48c4294eefb4dcdfc5c2d6dbdf526ecfe621ce9adcad26db861eba41a33cf1d1dd7388696ea6d2f959dd2992cb77e7f13e108e6f9de0
+  metadata.gz: 313e69785949da363e2c1aced4aae9a7036a1d97f6442cf306de88733c577a18770e5d86af504ee59934ea984a7d733ec84f58e9c4c88c8de4af4ed602145969
+  data.tar.gz: dc7361abcf2ca0d2dcb70f157256a7ac9e76e6d3c1e4f61ca6d94610a602674fbc3b591aac2cfa6ca55ea37e7488b3b2d1223b3de55e86f236117d816a50a42f

data/CHANGELOG.md

@@ -1,5 +1,12 @@
 ## [Unreleased]
 
+## [0.3.2] - 2026-06-06
+
+- Fix `require "ratomic"` for installed gems by resolving the versioned native
+  extension layout.
+- Add a regression test for the packaged gem loader path.
+- Keep the curated RBS signatures packaged with the gem.
+
 ## [0.3.1] - 2026-06-05
 
 - Realign `Counter`, `Map`, and `Queue` return semantics with Ruby conventions.

data/README.md

@@ -12,9 +12,6 @@ Ratomic provides mutable data structures for Ruby Ractors. Its primitives are ba
 Ratomic focuses on practical Ractor-safe primitives with a small API surface, clear
 ownership semantics, and honest documentation about sharp edges.
 
-`Ratomic::Map` is the current priority: a Ruby-facing concurrent Hash powered by
-DashMap, with atomic per-key operations designed for real Ractor workloads.
-
 ## Requirements
 
 - Ruby 4.0 or newer
@@ -41,6 +38,8 @@ API documentation is published to GitHub Pages:
 
 - [mperham.github.io/ratomic](https://mperham.github.io/ratomic/)
 
+RBS signatures are included under `sig/` for downstream type checking.
+
 ## Examples And Benchmarks
 
 - [`redis_poc`](./redis_poc) contains local Redis scripts that exercise
@@ -84,9 +83,10 @@ counter.zero? # => false
 
 ### `Ratomic::Map`
 
-`Ratomic::Map` is a Ractor-safe concurrent Hash backed by Rust's DashMap. It is
-not a full `Hash` replacement; iteration and arbitrary mutable object borrowing
-are intentionally absent.
+`Ratomic::Map` is the primary Ractor-safe concurrent Hash primitive in Ratomic.
+It is backed by Rust's DashMap and provides atomic per-key operations for real
+Ractor workloads. It is not a full `Hash` replacement; iteration and arbitrary
+mutable object borrowing are intentionally absent.
 
 ```ruby
 OFFSETS = Ratomic::Map.new
@@ -226,12 +226,16 @@ Please read the [Code of Conduct](./CODE_OF_CONDUCT.md) before contributing.
 After changing code, run:
 
 ```bash
-rake
+bundle exec rake
 ```
 
 This compiles the Rust code and runs the test suite. The test suite writes a
 SimpleCov report to `coverage/index.html` for the Ruby wrapper paths.
 
+If you change the public Ruby API, update the curated RBS signatures under
+`sig/ratomic.rbs` and run `bundle exec rake rbs:validate` before release or
+review.
+
 ## Thanks
 
 [Ilya Bylich](https://github.com/iliabylich) wrote and documented his original

data/lib/ratomic/version.rb

@@ -2,5 +2,5 @@
 
 module Ratomic
   # Current gem version string.
-  VERSION = "0.3.1"
+  VERSION = "0.3.2"
 end

data/lib/ratomic.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require "rbconfig"
+
 # Ratomic provides mutable data structures for Ruby Ractors. Its primitives
 # are backed by native Rust concurrency libraries so Ruby code can share useful
 # state across Ractors without falling back to one global lock. Pool uses Ruby
@@ -9,9 +11,23 @@
 module Ratomic
   # Base error class for Ratomic-specific failures.
   class Error < StandardError; end
+
+  def self.load_native_extension
+    ruby_version = RbConfig::CONFIG.fetch("ruby_version")
+    versioned_native = File.join("ratomic", ruby_version, "ratomic")
+    versioned_path = File.join(__dir__, "ratomic", ruby_version)
+
+    if File.exist?(File.join(versioned_path, "ratomic.so")) ||
+       File.exist?(File.join(versioned_path, "ratomic.bundle"))
+      require versioned_native
+    else
+      require "ratomic/ratomic"
+    end
+  end
+  private_class_method :load_native_extension
 end
 
-require "ratomic/ratomic"
+Ratomic.send(:load_native_extension)
 require "ratomic/version"
 
 require "ratomic/undefined"

data/ratomic.gemspec

@@ -32,6 +32,7 @@ Gem::Specification.new do |spec|
     "ratomic.gemspec"
   ] + Dir[
     "lib/**/*.rb",
+    "sig/**/*.rbs",
     "ext/ratomic/Cargo.toml",
     "ext/ratomic/build.rs",
     "ext/ratomic/extconf.rb",

data/sig/ratomic.rbs

@@ -0,0 +1,73 @@
+module Ratomic
+  class Error < ::StandardError
+  end
+
+  class Undefined
+    def inspect: () -> String
+  end
+
+  VERSION: String
+  UNDEFINED: Undefined
+
+  class Counter
+    def self.new: () -> Counter
+
+    def read: () -> Integer
+    def value: () -> Integer
+    def to_i: () -> Integer
+    def zero?: () -> bool
+    def increment: (Numeric amt) -> Integer
+    def decrement: (Numeric amt) -> Integer
+  end
+
+  class Map
+    def self.new: () -> Map
+
+    def get: (untyped key) -> untyped
+    def []: (untyped key) -> untyped
+    def set: (untyped key, untyped value) -> untyped
+    def []=: (untyped key, untyped value) -> untyped
+    def key?: (untyped key) -> bool
+    def include?: (untyped key) -> bool
+    def member?: (untyped key) -> bool
+    def delete: (untyped key) -> untyped
+    def clear: () -> self
+    def size: () -> Integer
+    def length: () -> Integer
+    def empty?: () -> bool
+
+    def fetch: (untyped key) { (untyped) -> untyped } -> untyped
+             | (untyped key, untyped default) -> untyped
+             | (untyped key) -> untyped
+
+    def fetch_and_modify: (untyped key) { (untyped) -> untyped } -> void
+    def compute: (untyped key) { (untyped?) -> untyped } -> untyped
+    def fetch_or_store: (untyped key) { () -> untyped } -> untyped
+    def upsert: (untyped key, untyped initial) { (untyped?) -> untyped } -> untyped
+    def increment: (untyped key, ?Numeric by) -> Numeric
+    def decrement: (untyped key, ?Numeric by) -> Numeric
+    def append: (untyped key, untyped value) -> Array[untyped]
+    def add_to_set: (untyped key, untyped value) -> ::Set[untyped]
+  end
+
+  class Queue
+    def self.new: (Integer capacity) -> Queue
+
+    def push: (untyped item) -> self
+    def <<: (untyped item) -> self
+    def pop: () -> untyped
+    def peek: () -> untyped
+    def empty?: () -> bool
+    def size: () -> Integer
+    def length: () -> Integer
+  end
+
+  class Pool
+    def self.new: (?Integer size, ?(Numeric | nil) timeout) { () -> untyped } -> Pool
+
+    def checkout: () -> untyped
+    def checkin: (untyped object) -> nil
+    def close: () -> nil
+    def with: () { (untyped object) -> untyped } -> untyped
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ratomic
 version: !ruby/object:Gem::Version
-  version: 0.3.1
+  version: 0.3.2
 platform: ruby
 authors:
 - Mike Perham
@@ -56,6 +56,7 @@ files:
 - lib/ratomic/undefined.rb
 - lib/ratomic/version.rb
 - ratomic.gemspec
+- sig/ratomic.rbs
 homepage: https://mperham.github.io/ratomic
 licenses:
 - MIT