Ratomic provides mutable data structures for use with Ruby's Ractors. This allows Ruby code to scale beyond the infamous GVL.
If you know Rust and Ruby C-extensions, we need your help! This project is brand new and could use your knowledge! If you don't know Rust or C, consider this a challenge to learn and solve. Read through the issues to find work that sounds interesting to you.
Install the gem and add to the application's Gemfile by executing:
bundle add ratomicTODO: We have not released a gem yet.
Ratomic provides several useful Ractor-safe structures. Note the APIs available are frequently very limited compared to Ruby's broad API.
These structures are designed for use as class-level constants so they can be shared by numerous Ractors.
c = Ratomic::Counter.new
c.read # => 0
c.inc
c.inc(5)
c.dec(1)
c.dec
c.read # => 4A Ractor-safe object pool:
POOL = Ratomic::Pool.new(5, 1.0) { Object.new }
POOL.with do |obj|
# do something with obj
endA Ractor-safe map/hash structure:
HASH = Ratomic::Map.new
HASH["mike"] = 123
HASH["mike"] # => 123
HASH.fetch_and_modify(key) {|value| v + 1 }
HASH.clearA multi-producer, multi-consumer queue.
q = Ratomic::Queue.new
q.push(Object.new)
q.pop # => <Object>