ruby-hooks 1.0.0 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: faf3e81331151394f1e31790f945f67194a4477d
-  data.tar.gz: 76c02d07f7f8bbe97b04fb29b2f03bab744dd827
+  metadata.gz: 3d1ab49d7471dbf83250ef6097e8633e42cf5029
+  data.tar.gz: 031177c8eaf440f8f907ab6aa659df19945f277c
 SHA512:
-  metadata.gz: 42d819cf30ef2957b783dfb9fb1a7b29e5c0c66ac3cfabe7bc7810f506d613f56c00e8da885b27db437f73635ed77292a461b4656470f336612e371df23072c0
-  data.tar.gz: 06ec442741c9e8d95221724f2af93dccc9b5b56e4a9579ff35054db4be822ce1c0c6258d0ad64c506582576d782cd79edff49222081b8432206a5206fe5ecd08
+  metadata.gz: f43eaed97d10494d1d899e50dbb5903eaf6aa95508cd10a23201010af5e527f8248ddeeb13a0bb286ee64e5854f644a03cf34b9df39ab6e4b548a2b41180f4a3
+  data.tar.gz: fdcd36619942ba0cd4c35485c9dc1e4ba023e29518dc03b1b7aced17b8eae2a450732c073e0b2cbe660724988aad6fc765972639a22a749f97e2efec6cbeb6e0

data/lib/ruby/hooks/hook.rb

@@ -13,16 +13,29 @@ class Ruby::Hooks::Hook
   include ::Ruby::Hooks::Extensible
 
   # automatically extends Hook instance with given modules
+  #
   # @option options [Array]  :extend array of modules to extend hook instance
   # @option options [Module] :extend module to extend hook instance
   def initialize(options = {})
     @options = options
+    @observer_peers = {}
     add_plugins( :extend, options[:extends])
   end
 
   # allow writign code independent of the internals of Observable
+  #
+  # @return [Array] array of observers defined for the hook
   def observers
     @observer_peers
   end
 
+  # convienience method to set changed state and notify observers in one call
+  #
+  # @param args [Array]     arguments to pass to +notify_observers+
+  # @return     [nil|false] forwards result of +notify_observers+
+  def changed_and_notify(*args)
+    changed
+    notify_observers(*args)
+  end
+
 end

data/lib/ruby/hooks/version.rb

@@ -8,7 +8,7 @@ module Ruby
   # Helpers for multiple publish/subscribe hooks
   module Hooks
     # Rubygems version of Ruby::Hooks
-    VERSION = '1.0.0'
+    VERSION = "1.1.0"
   end
 end
 

data/test/example1_test.rb

@@ -4,8 +4,8 @@ Copyright 2014 Michal Papis <mpapis@gmail.com>
 See the file LICENSE for copying permission.
 =end
 
-require 'test_helper'
-require 'ruby/hooks'
+require "test_helper"
+require "ruby/hooks"
 
 class Test1
   extend Ruby::Hooks::InstanceHooks

data/test/example2_test.rb

@@ -4,8 +4,8 @@ Copyright 2014 Michal Papis <mpapis@gmail.com>
 See the file LICENSE for copying permission.
 =end
 
-require 'test_helper'
-require 'ruby/hooks'
+require "test_helper"
+require "ruby/hooks"
 
 module FindObserver
   def find_observer(*arg)

data/test/ruby/hooks/extensible_test.rb

@@ -4,8 +4,8 @@ Copyright 2014 Michal Papis <mpapis@gmail.com>
 See the file LICENSE for copying permission.
 =end
 
-require 'test_helper'
-require 'ruby/hooks/extensible'
+require "test_helper"
+require "ruby/hooks/extensible"
 
 class ExtensibleTestClass
   include Ruby::Hooks::Extensible

data/test/ruby/hooks/hook_test.rb

@@ -4,14 +4,20 @@ Copyright 2014 Michal Papis <mpapis@gmail.com>
 See the file LICENSE for copying permission.
 =end
 
-require 'test_helper'
-require 'ruby/hooks/hook'
+require "test_helper"
+require "ruby/hooks/hook"
 
 class HookTestClass
   module Extra
     def method_2
     end
   end
+  class Update
+    attr_reader :value
+    def update(value)
+      @value = value
+    end
+  end
 end
 
 describe Ruby::Hooks::Hook do
@@ -19,8 +25,40 @@ describe Ruby::Hooks::Hook do
     Ruby::Hooks::Hook.allocate
   end
 
-  it "extends self" do
+  it "is based on Observable" do
     subject.must_be_kind_of(Observable)
+  end
+
+  it "initializes without params" do
+    subject.send :initialize
+    subject.methods.map(&:to_sym).wont_include :method_2
+  end
+
+  describe "observer interaction" do
+
+    let(:observer) do
+      HookTestClass::Update.new
+    end
+
+    it "gives access to observers" do
+      subject.send :initialize
+      subject.methods.map(&:to_sym).must_include :observers
+      subject.observers.must_be_empty
+      subject.add_observer(observer)
+      subject.observers.must_equal({observer => :update})
+    end
+
+    it "allows fast execution" do
+      subject.send :initialize
+      subject.methods.map(&:to_sym).must_include :changed_and_notify
+      subject.add_observer(observer)
+      subject.changed_and_notify(7)
+      observer.value.must_equal(7)
+    end
+
+  end # context "observer interaction"
+
+  it "extends self" do
     subject.methods.map(&:to_sym).wont_include :method_2
     subject.send :initialize, :extends => HookTestClass::Extra
     subject.methods.map(&:to_sym).must_include :method_2

data/test/ruby/hooks/instance_hooks_test.rb

@@ -4,8 +4,8 @@ Copyright 2014 Michal Papis <mpapis@gmail.com>
 See the file LICENSE for copying permission.
 =end
 
-require 'test_helper'
-require 'ruby/hooks/instance_hooks'
+require "test_helper"
+require "ruby/hooks/instance_hooks"
 
 class InstanceHooksTestClass
   module Extra

data/test/test_helper.rb

@@ -4,7 +4,7 @@ Copyright 2014 Michal Papis <mpapis@gmail.com>
 See the file LICENSE for copying permission.
 =end
 
-require 'rubygems'
+require "rubygems"
 
 if
   RUBY_VERSION == "2.0.0" && # check Gemfile
@@ -22,12 +22,12 @@ then
     add_filter "/test/"
   end
 
-  Coveralls.noisy = true unless ENV['CI']
+  Coveralls.noisy = true unless ENV["CI"]
 end
 
 # Autoload all lib/**/*.rb files so simplecov does not misses anything
 Dir[File.expand_path("../../lib/**/*.rb", __FILE__)].each{|f| require f }
 
-require 'minitest/autorun' unless $0=="-e" # skip in guard
-require 'minitest/unit'
+require "minitest/autorun" unless $0=="-e" # skip in guard
+require "minitest/unit"
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ruby-hooks
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.1.0
 platform: ruby
 authors:
 - Michal Papis
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-10-05 00:00:00.000000000 Z
+date: 2014-10-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
@@ -82,8 +82,8 @@ specification_version: 4
 summary: Helpers for multiple publish/subscribe hooks
 test_files:
 - test/ruby/hooks/extensible_test.rb
-- test/ruby/hooks/hook_test.rb
 - test/ruby/hooks/instance_hooks_test.rb
+- test/ruby/hooks/hook_test.rb
 - test/test_helper.rb
 - test/example2_test.rb
 - test/example1_test.rb