Loomio::Event

Loomio::Event is a simple way to perform pub-sub style events from within your rails app.

Installation

Add this line to your application's Gemfile:

gem 'loomio_event'

And then execute:

$ bundle

Or install it yourself as:

$ gem install event_bus

Usage

Loomio Event caters to a Publish / Subscribe style for rails events. To listen to an event, create an initializer with the following:

Loomio::Event.configure do |config|
  config.listen('my_event_name') { |param| puts param }
end

NB: listen can take multiple event names for the same block, which can take an arbitrary number of params:

config.listen('my_event_name', 'my_other_event_name') { |param1, param2| puts "#{param1}, #{param2}" }

Then, to trigger the event in your application, call broadcast, and pass it your parameters, like so:

Loomio::Event.broadcast('my_event_name', 'Hello, world!')

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/loomio/loomio_event. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.

License

The gem is available as open source under the terms of the MIT License.