shouter 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: f01d5e611309eff3f12fc296e56ba81bbf46a71c
-  data.tar.gz: 312e00888703e49abc114f2840a8503c3162bdef
+  metadata.gz: e691c8ec76258396c97ae227875d55e77dbf8635
+  data.tar.gz: 820d5e90db24d53f64d0c25799bad6e67f7882b3
 SHA512:
-  metadata.gz: 636653c15d3730feb4d45f944e4f0d3f161cb5c6bc6d5edabf78247b69e77f9539222df61ed074b225797eadb4f84b3783aee7d6033836b833ec0d0ac8da48f9
-  data.tar.gz: a55ead88d51bef5703734ee883834c6ca9bde9c9a1d3367292c3414e125c1f0dbb60a9c7d1bb7e5f4eaf50a2e07d0698e6ddc87b3374868d262112ad3a07d591
+  metadata.gz: 42071e236df2752dab9146506f476b617f1ee74948247a1fc272c359c8b5e46e55998546a808beba4339545d907f0b87f6099dc3ec336a57e79eaf31d8fa7718
+  data.tar.gz: 7dc791ab3bbffd37dcf122343e49e44d694fde4ecbf38491893d388281c9d6c4f7cfa5db6480da73e5d6cc901a3ac9f4df164debdca10ee6650267dca0140526

data/README.md

@@ -1,6 +1,6 @@
 # Shouter
-[![Build Status](https://travis-ci.org/wizardone/bouncer.svg?branch=master)](https://travis-ci.org/wizardone/bouncer)
-[![codecov](https://codecov.io/gh/wizardone/bouncer/branch/master/graph/badge.svg)](https://codecov.io/gh/wizardone/bouncer)
+[![Build Status](https://travis-ci.org/wizardone/shouter.svg?branch=master)](https://travis-ci.org/wizardone/shouter)
+[![codecov](https://codecov.io/gh/wizardone/shouter/branch/master/graph/badge.svg)](https://codecov.io/gh/wizardone/shouter)
 
 `Shouter` is a very simple and lightweight publish/subscription DSL for
 Ruby applications.
@@ -71,6 +71,28 @@ A.publish(:my_scope, :on_change) do
 end
 ```
 
+To unsubscribe single or multiple objects you can call the `unsubscribe` method
+```ruby
+A.unsubscribe(Listener1, Listener2)
+```
+
+Since version `1.0.1`:
+
+Alternatively you can pass the callback option when subscribing.
+It accepts a callable object:
+```ruby
+subscribe(Listener.new, for: :my_scope, callback: ->() { perform_async })
+```
+
+You can now add a `guard` clause which will stop the execution of events
+unless it returns `true`. Guard clauses accept callable objects
+```ruby
+subscribe(Listener.new, for: :my_scope, guard: Proc.new { some_listener.respond_to?(:my_method) })
+```
+
+
+The `clear` method removes all listeners from the store.
+
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.

data/lib/shouter.rb

@@ -1,4 +1,6 @@
 require 'shouter/version'
+require 'shouter/hook'
+require 'shouter/guard'
 require 'shouter/listener'
 require 'shouter/store'
 

data/lib/shouter/guard.rb

@@ -0,0 +1,11 @@
+module Shouter
+  class Guard
+
+    class << self
+      def call(guard)
+        return true unless guard
+        guard.call
+      end
+    end
+  end
+end

data/lib/shouter/hook.rb

@@ -0,0 +1,11 @@
+module Shouter
+  class Hook
+
+    class << self
+      def call(callback)
+        # TODO: remove redundant ifs
+        callback.call if callback.is_a?(Proc)
+      end
+    end
+  end
+end

data/lib/shouter/listener.rb

@@ -16,12 +16,40 @@ module Shouter
       @options = options
     end
 
+    def notify(event, args, &block)
+      return unless object.respond_to?(event)
+      if fire_guard!
+        object.public_send(event, *args)
+        fire_hook!(callback || block)
+
+        Store.unregister(object) if single?
+      end
+    end
+
     def for?(scope)
       options[:scope] == scope
     end
 
+    private
+
+    def fire_hook!(callback)
+      Shouter::Hook.(callback)
+    end
+
+    def fire_guard!
+      Shouter::Guard.(guard)
+    end
+
+    def callback
+      options[:callback]
+    end
+
     def single?
       options[:single] == true
     end
+
+    def guard
+      options[:guard]
+    end
   end
 end

data/lib/shouter/store.rb

@@ -33,15 +33,11 @@ module Shouter
         end
       end
 
-      def notify(scope, event, args)
+      def notify(scope, event, args, &block)
         return if listeners.empty?
 
         listeners.select { |listener| listener.for?(scope) }.each do |listener|
-          klass = listener.object
-          klass.public_send(event, *args) if klass.respond_to?(event)
-          # Serves as callback
-          yield if block_given?
-          unregister(klass) if listener.single?
+          listener.notify(event, args, &block)
         end
       end
 

data/lib/shouter/version.rb

@@ -1,3 +1,3 @@
 module Shouter
-  VERSION = "0.1.0"
+  VERSION = "0.1.1"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: shouter
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - Stefan Slaveykov
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2017-01-10 00:00:00.000000000 Z
+date: 2017-06-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -70,6 +70,8 @@ files:
 - bin/console
 - bin/setup
 - lib/shouter.rb
+- lib/shouter/guard.rb
+- lib/shouter/hook.rb
 - lib/shouter/listener.rb
 - lib/shouter/store.rb
 - lib/shouter/version.rb
@@ -94,7 +96,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.5.1
+rubygems_version: 2.6.8
 signing_key: 
 specification_version: 4
 summary: Small publish/subscription based system in Ruby