Dataflow concurrency for Ruby (inspired by the Oz language)
Switch branches/tags
Nothing to show
Pull request Compare This branch is 2 commits ahead, 48 commits behind larrytheliquid:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


What’s this?

A Ruby library that adds Dataflow variables (inspired by the Oz
language). Dataflow variables have the property that they can only
be bound/assigned to once, or have an equivalent value as an existing
assignment (see “unification”).

Dataflow variables must be declared before they are used, and can be
passed around as data without actually being bound. If the variable
gets used (in this library this means a method call) while being
unbound then the currently executing thread will suspend.

What’s the point?

Ruby is Object Oriented (with the ability to mutate local, instance,
class, and global variables, and even constants), and on top of that
it has powerful reflection and meta-programming abilities. While these
features are useful for certain problems, they are not within the
declarative model. Staying in the declarative model gives one 2 advantages:

  1. It is easy to reason about what the program does
  2. Simple but powerful concurrency is possible

Ruby, like many other OO languages, is facing the hurdles of taking
advantage of the increase of processor cores within a simple parallel
programming model. This library lets you program Ruby in the
declarative concurrent model when you need to take advantage of multiple cores
(assuming a Ruby implementation that uses native threads in one way or

The trick to this kind of programming is binding variables from other
threads. The nice thing is that many existing
libraries/classes/methods can still be used, just avoid
side-effects. Use regular Ruby threading to create threads, use
“local” or “declare” to create new variables, and use “unify” to bind


# Local variables
include Dataflow
local do |x, y, z|
  # notice how the order automatically gets resolved { unify y, x + 2 } { unify z, y + 3 } { unify x, 1 }
  z #=> 6
# Instance variables
class AnimalHouse
  include Dataflow
  declare :small_cat, :big_cat

  def fetch_big_cat { unify big_cat, small_cat.upcase }
    unify small_cat, 'cat'
end #=> 'CAT'
# Data-driven concurrency
include Dataflow

local do |stream, doubles, triples, squares|
  unify stream, { local {|v| v } } { unify doubles, {|n| n*2 } } { unify triples, {|n| n*3 } } { unify squares, {|n| n**2 } } { stream.each {|x| unify x, rand(100) } }

  puts "original: #{stream.inspect}"
  puts "doubles:  #{doubles.inspect}"
  puts "triples:  #{triples.inspect}"
  puts "squares:  #{squares.inspect}"  

Ports using Dataflow

Ports are an extension of the declarative concurrent model to support nondeterministic behavior. They accomplish this through the use of a single state variable. Ports are also inspired by the Oz language.

An Actor class in the style of Erlang message-passing processes is also provided. It makes use of the asynchronous behavior of ports, but otherwise uses no state variables.

Examples using Ports

include Dataflow

local do |port, stream|
  unify port, {port.send 2} {port.send 8} {port.send 1024}
  stream.take(3).sort #=> [2, 8, 1024]

Examples using Actors

include Dataflow

Ping = {
  3.times {
    case receive
    when "Ping"
      puts "Ping"
      Pong.send "Pong"

Pong = {
  3.times {
    case receive
    when "Pong"
      puts "Pong"
      Ping.send "Ping"
} { Ping.send "Ping" }



The basis of dataflow variables around a language is not common among
popular languages and may be confusing to some. For an in-depth
introduction to the Oz language and the techniques used in this
library (including port objects and comparisons to Erlang message passing) see the book Concepts, Techniques, and Models of Computer Programming


larrytheliquid, amiller