bus 0.0.1 → 0.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 746fd6530bc6f82afc053b09cd9ebd089a7df142
-  data.tar.gz: 997acd122b159aeb6f13a189ed3d368ef671bf1a
+  metadata.gz: fdeaeec0009f535223bb95e159c4d06e14f80e6c
+  data.tar.gz: bf5f15509ce8656a13f0cbc6b828fc0a78c0d0a9
 SHA512:
-  metadata.gz: e9a57a9a0096d57bbdcf7583fbc919375b95425cdbd7118eef7c51391b8199e0af63fe386cd5cc0c51c95cf8e914cee8573d5235d97e4951a29bc5003114793d
-  data.tar.gz: 4a95013e2e893d14fc2476ed4d210275eac2880678cb490aefeb6547d9386a29467506e80f496ceb32604ce4856bdc6514dae7cc0736e4405a10cf31f176dc16
+  metadata.gz: 3a4f387058897f7db471f909c3d2ad94fe702bf737c1da1f0ac9a52b92032f94c0437015c0cadcf3be8ceb7ced78deb97a0f95e9f29870f0fa845f93d34aee39
+  data.tar.gz: 746dcc764ac880ed98da682c9fe6dfdbb113d581b63191bb342ebfed0b1e3912f47e5026250e8391815c035d0f6f7496e724d631f4969412c7cc69fe319af38b

data/.gitignore

@@ -15,3 +15,4 @@ spec/reports
 test/tmp
 test/version_tmp
 tmp
+.idea/

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--format progress

data/README.md

@@ -1,6 +1,6 @@
 # Bus
 
-TODO: Write a gem description
+Extremely lightweight message bus without mixins, globals and mutable state.
 
 ## Installation
 
@@ -18,11 +18,72 @@ Or install it yourself as:
 
 ## Usage
 
-TODO: Write usage instructions here
+```ruby
+# global config or initializer
+bus = Bus.new([
+  DonationReceipt,
+  RealtimeViewerUpdate
+])
+
+
+# controller
+class DonationsController # < ActionController::Base
+  def create
+    listener = bus.
+      on(:donation_created) {|donation| send_user_to_payment_gateway(donation) }.
+      on(:donation_invalid) {|donation| render donation.errors, status: :bad_request }
+
+    # or
+
+    listener = bus.on(
+      donation_created: ->(donation) { send_user_to_payment_gateway(donation) },
+      donation_invalid: ->(donation) { render donation.errors, status: :bad_request }
+    )
+
+    DonationService.new.add_donation(current_user, params[:donation], listener)
+  end
+
+  private
+  def send_user_to_payment_gateway(donation)
+    #...
+  end
+end
+
+
+# service
+class DonationService
+  def initialize(options={})
+    @donation_class = options.fetch(:donation_class) { Donation }
+  end
+
+  def add_donation(donor, donation_attributes, listener)
+    donation = @donation_class.new(donation_attributes.merge(donor: donor))
+    if donation.valid?
+      donation.save!
+      listener.donation_created(donation)
+    else
+      listener.donation_invalid(donation)
+    end
+  end
+end
+
+# listeners
+class DonationReceipt
+  def donation_created(donation)
+    Mailer.delay.send_donation_receipt(donation)
+  end
+end
+
+class RealtimeViewerUpdate
+  def donation_created(donation)
+    #..
+  end
+end
+```
 
 ## Contributing
 
-1. Fork it ( http://github.com/<my-github-username>/bus/fork )
+1. Fork it ( http://github.com/minio-sk/bus/fork )
 2. Create your feature branch (`git checkout -b my-new-feature`)
 3. Commit your changes (`git commit -am 'Add some feature'`)
 4. Push to the branch (`git push origin my-new-feature`)

data/Rakefile

@@ -1 +1,6 @@
-require "bundler/gem_tasks"
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new('spec')
+
+task :default => :spec

data/bus.gemspec

@@ -10,7 +10,7 @@ Gem::Specification.new do |spec|
   spec.email         = ["johno@jsmf.net"]
   spec.summary       = %q{Lightweight message bus without mixins, globals or mutable state.}
   spec.description   = %q{}
-  spec.homepage      = ""
+  spec.homepage      = "http://github.com/minio-sk/bus"
   spec.license       = "MIT"
 
   spec.files         = `git ls-files`.split($/)
@@ -20,4 +20,5 @@ Gem::Specification.new do |spec|
 
   spec.add_development_dependency "bundler", "~> 1.5"
   spec.add_development_dependency "rake"
+  spec.add_development_dependency "rspec"
 end

data/lib/bus.rb

@@ -1,5 +1,39 @@
-require "bus/version"
+require 'bus/version'
 
-module Bus
-  # Your code goes here...
+class Bus
+  def initialize(listeners = [])
+    @listeners = listeners
+  end
+
+  def attach(listener)
+    self.class.new(@listeners + [listener])
+  end
+
+  def on(event_or_hash, &block)
+    listeners = block_given? ? [CallableListener.new(event_or_hash, block)] : build_listeners_from_hash(event_or_hash)
+    self.class.new(@listeners + listeners)
+  end
+
+  def method_missing(method_name, *args)
+    @listeners.each do |listener|
+      listener.public_send(method_name, *args) if listener.respond_to?(method_name)
+    end
+  end
+
+  private
+  def build_listeners_from_hash(event_or_hash)
+    event_or_hash.map do |event, callable|
+      CallableListener.new(event, callable)
+    end
+  end
+
+  class CallableListener < Struct.new(:event, :callable)
+    def method_missing(_, *args)
+      callable.call(*args)
+    end
+
+    def respond_to?(method_name)
+      event == method_name
+    end
+  end
 end

data/lib/bus/version.rb

@@ -1,3 +1,3 @@
-module Bus
-  VERSION = "0.0.1"
+class Bus
+  VERSION = '0.0.2'
 end

data/spec/bus_spec.rb

@@ -0,0 +1,59 @@
+require 'spec_helper'
+require 'bus'
+
+describe Bus do
+  let (:listener) { double }
+
+  it 'calls attached listener' do
+    bus = described_class.new.attach(listener)
+
+    expect(listener).to receive(:event_fired)
+
+    bus.event_fired
+  end
+
+  it 'calls attached listener with params' do
+    bus = subject.attach(listener)
+
+    expect(listener).to receive(:event_fired).with(1, 2, 3)
+
+    bus.event_fired(1, 2, 3)
+  end
+
+  it 'does not call listener if it does not respond to event' do
+    listener = double(respond_to?: false)
+    bus = subject.attach(listener)
+
+    expect(listener).not_to receive(:event_fired)
+
+    bus.event_fired
+  end
+
+  it 'calls multiple listeners' do
+    listener1 = double
+    listener2 = double
+
+    bus = subject.attach(listener1).attach(listener2)
+
+    expect(listener1).to receive(:event_fired)
+    expect(listener2).to receive(:event_fired)
+
+    bus.event_fired
+  end
+
+  it 'calls lightweight listener defined from hash' do
+    bus = subject.on(event_fired: listener) # event_fired: ->(args) { do stuff }
+
+    expect(listener).to receive(:call).with(:args)
+
+    bus.event_fired(:args)
+  end
+
+  it 'calls lightweight listener defined from block' do
+    bus = subject.on(:event_fired) {|args| listener.call(args)} # event_fired { do stuff }
+
+    expect(listener).to receive(:call).with(:args)
+
+    bus.event_fired(:args)
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,23 @@
+# This file was generated by the `rspec --init` command. Conventionally, all
+# specs live under a `spec` directory, which RSpec adds to the `$LOAD_PATH`.
+# Require this file using `require "spec_helper"` to ensure that it is only
+# loaded once.
+#
+# See http://rubydoc.info/gems/rspec-core/RSpec/Core/Configuration
+RSpec.configure do |config|
+  # Limit the spec run to only specs with the focus metadata. If no specs have
+  # the filtering metadata and `run_all_when_everything_filtered = true` then
+  # all specs will run.
+  #config.filter_run :focus
+
+  # Run all specs when none match the provided filter. This works well in
+  # conjunction with `config.filter_run :focus`, as it will run the entire
+  # suite when no specs have `:filter` metadata.
+  #config.run_all_when_everything_filtered = true
+
+  # Run specs in random order to surface order dependencies. If you find an
+  # order dependency and want to debug it, you can fix the order by providing
+  # the seed, which is printed after each run.
+  #     --seed 1234
+  #config.order = 'random'
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: bus
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.2
 platform: ruby
 authors:
 - Jan Suchal
@@ -38,6 +38,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description: ''
 email:
 - johno@jsmf.net
@@ -46,6 +60,7 @@ extensions: []
 extra_rdoc_files: []
 files:
 - ".gitignore"
+- ".rspec"
 - Gemfile
 - LICENSE.txt
 - README.md
@@ -53,7 +68,9 @@ files:
 - bus.gemspec
 - lib/bus.rb
 - lib/bus/version.rb
-homepage: ''
+- spec/bus_spec.rb
+- spec/spec_helper.rb
+homepage: http://github.com/minio-sk/bus
 licenses:
 - MIT
 metadata: {}
@@ -77,4 +94,6 @@ rubygems_version: 2.2.1
 signing_key: 
 specification_version: 4
 summary: Lightweight message bus without mixins, globals or mutable state.
-test_files: []
+test_files:
+- spec/bus_spec.rb
+- spec/spec_helper.rb