Frappuccino
Functional Reactive Programming for Ruby.
Installation
Add this line to your application's Gemfile:
gem 'frappuccino'And then execute:
$ bundleOr install it yourself as:
$ git clone https://github.com/steveklabnik/frappuccino
$ cd frappuccino
$ bundle
$ rake installUsage
Basically, this:
require 'frappuccino'
class Button
def push
emit(:pushed) # emit sends a value into the stream
end
end
button = Button.new
stream = Frappuccino::Stream.new(button)
counter = stream
.map {|event| event == :pushed ? 1 : 0 } # convert events to ints
.inject(0) {|sum, n| sum + n } # add them up
counter.now # => 0
button.push
button.push
button.push
counter.now # => 3
button.push
counter.now # => 4You can also map via a hash, if you prefer:
.map(:pushed => 1, :default => 0)You can also register callbacks to a Stream. These will be executed for each event that occurs in the Stream:
stream.on_value do |event|
puts "I got a #{event}!"
endYou can combine two streams together:
merged_stream = stream_one.merge(stream_two)
# or
merged_stream = Frappuccino::Stream.merge(one_stream , other_stream)
# or
merged_stream = Frappuccino::Stream.new(button_one, button_two)You can select events from a stream, too:
stream = Frappuccino::Stream.new(button, something_else)
filtered_stream = stream.select{|event| event == :pushed }
filtered_stream.on_value do |event|
# event will only ever be :pushed
endContributing
- Fork it
- Create your feature branch (
git checkout -b my-new-feature) - Commit your changes (
git commit -am 'Add some feature') - Push to the branch (
git push origin my-new-feature) - Create new Pull Request