heed 0.0.7 → 0.0.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 0345d1edb02b2cf539eec0ab3dd83d53b64ae55b
-  data.tar.gz: 6e49bd332ad4e1e77980a745ec3fa369fe2e263f
+  metadata.gz: 9aa08585301fcc08e8968c5773f0e7c4ecadc65d
+  data.tar.gz: 3f0cea242cd9ac55909ed9b67c6bb2be83c82a2e
 SHA512:
-  metadata.gz: 4ed74d4af4b784f28e102e3f9828aec13772078d5e4a2555019c1476385a6ecb85e8a9651f4b1b9060dd662673e419ebf60c3ff9ea8460101a45340f1093e03b
-  data.tar.gz: b5f84d357dad9563f3eca222f0dbcca63096dffea597640e4779f0ea2a16b11e8539b38a1e2b07b40bd531e73eccff6360ec0b871744f3a822b50cfaa305d069
+  metadata.gz: b2a21bc055d7676ea2c7a658ce6d58e2c5d77830653e47338a794d4046f68483dcd7116bb209bffe886fb51d471a0235bee393aeeab2420ab83f68f74025071b
+  data.tar.gz: d6aaf0eff296699a569f32536a8c3dcf490689519f78d926cad5ba217a803dac3f2adf34fa7ef38a3a96aef7fc2a605890ff32f50bfba5a43d5db95bf0843a03

data/History.md

@@ -1,5 +1,9 @@
 # History
 
+## 0.0.8
+
+* #hearken becomes #heed, with more functional semantics
+
 ## 0.0.7
 
 * Change gem name to 'heed'

data/README.md

@@ -30,7 +30,7 @@ started with a tell-dont-ask style, in rails controllers for example.  For more
 
 ## Usage
 
-### Create a listener
+### `hark`: create a listener
 
 To create a listener object use `hark`.
 
@@ -107,7 +107,7 @@ Turn any object into a listener, adding new methods as we go
 
 Now, when listener is sent #created, all create handlers are called.
 
-### Sugar: `Kernel#hearken`
+### `heed` call a message with an ad-hoc listener
 
 Because of the precedence of the block operator, constructing ad-hoc listeners requires
 you to insert some parens, which might be seen as unsightly, e.g:
@@ -117,9 +117,9 @@ you to insert some parens, which might be seen as unsightly, e.g:
       on.invalid_item {|item| redirect_to item, error: "Item not evaluable" }
     end))
 
-You may use Kernerl#hearken to create an ad-hoc listener using a passed block as follows
+You may use #heed to create an ad-hoc listener using a passed block as follows
 
-    seller.hearken :request_valuation, item do |on|
+    heed seller, :request_valuation, item do |on|
       on.valuation_requested {|valuation| redirect_to valuation}
       on.invalid_item {|item| redirect_to item, error: "Item not evaluable" }
     end
@@ -127,7 +127,7 @@ You may use Kernerl#hearken to create an ad-hoc listener using a passed block as
 If you want to combine listeners with an ad-hoc block, you may pass a 0-arity block that is
 yielded as the listener
 
-    seller.hearken :request_valuation, item do
+    heed seller, :request_valuation, item do
       hark valuation_notifier do |on|
         on.valuation_requested {|valuation| redirect_to valuation}
         on.invalid_item {|item| redirect_to item, error: "Item not evaluable" }

data/lib/hark/core_ext.rb

@@ -3,8 +3,8 @@ module Kernel
     Hark.from *args, &block
   end
 
-  def hearken method, *args, &block
+  def heed object, *args, &block
     listener = (block.arity == 1) ? hark(&block) : block.call
-    send method, *args + [listener]
+    object.send *args + [listener]
   end
 end

data/lib/hark/version.rb

@@ -1,3 +1,3 @@
 module Hark
-  VERSION = "0.0.7"
+  VERSION = "0.0.8"
 end

data/spec/hark_spec.rb

@@ -136,7 +136,7 @@ describe Hark do
     it { listener.foo.should == [false] }
   end
 
-  describe "#hearken :method" do
+  describe "Kernel#heed object, :method" do
     let(:object) do
       Object.new.tap do |obj|
         class << obj
@@ -150,7 +150,7 @@ describe Hark do
 
     context "with 1 arity block" do
       it "sends :method with an ad-hoc listener created from the block" do
-        object.hearken :foo, "ONE", "TWO" do |on|
+        heed object, :foo, "ONE", "TWO" do |on|
           on.foo {|a| transcript << [:foo, a] }
           on.bar {|a| transcript << [:bar, a] }
         end
@@ -162,7 +162,7 @@ describe Hark do
       it "sends :method with listener created by yielding to the block" do
         foo = hark(:foo) {|a| transcript << [:foo, a] }
 
-        object.hearken :foo, "ONE", "TWO" do
+        heed object, :foo, "ONE", "TWO" do
           hark(foo, :bar) {|a| transcript << [:bar, a] }
         end
         transcript.should == [[:foo, "ONE"], [:bar, "TWO"]]

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: heed
 version: !ruby/object:Gem::Version
-  version: 0.0.7
+  version: 0.0.8
 platform: ruby
 authors:
 - Ian White