tardvig 0.3.1 → 0.3.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 74bb4e671898af214d7bb7408eb278e6d14d0238
-  data.tar.gz: 18d4f3800571ec7694326dc42bd5f91aac0c371e
+  metadata.gz: 1c2202e722e19d6b70cd47740cb0b59a16d4f7de
+  data.tar.gz: 083573b0dd0803e3017476b886669e698f06df30
 SHA512:
-  metadata.gz: aede310e8a81dbcd8e17ee05d2eb92337357336b007c1957697c86aff5f44dd5a2d11c5b207ef9249738fa85eac2c97b154f4a5f99dd1195fd8ae86d0209fd7a
-  data.tar.gz: d4554afc2f958140f7e9643caefa0d50a91982c21f12502f21d2df91a1e69430057cef056cc248f5e98e20e1702b1821daaad86adc06be0de61fa2bd830b5ded
+  metadata.gz: b3bd839717b9c981c01d6108e6d7ebda3c97da3d24bdfe11985342c813e1fda778b7654b5ec1d70a43ccb2c62555d6e191e8e022888fb1a8f2f1513ff2e3c941
+  data.tar.gz: 8d8e63e94588de9bcdd27a03d7edd9582ddcfa32a9bd74a971616f5f4cb1507bf8a5e25e50e41bcfa9c8eb68df8caa94cb1c5725e85fbc9da88a58dff7bc96ee

data/lib/tardvig/events/proxy.rb

@@ -4,19 +4,32 @@ module Tardvig
     # It is useful when you do not have a direct access to object which you
     # are want to listen on, for example, when you have access only to GameIO 
     # from a display.
+    #
+    # To proxy an event from an object, you need to add this object to
+    # {#tracked_list} through {#spy_on} and then you can bind a listener on it
+    # through proxy (see {#on} for syntax).
+    #
+    # If you want proxy to forward event to itself even if you have not bound a
+    # listener, you can trigger the `:wait_for_event` event on the proxy.
+    # You should pass the name of the event you are waiting for as an argument.
     module Proxy
       # Adds objects to tracked list so you can bind proxy listeners to them
       # @param [Hash] `name: object` pairs.
       def spy_on(objects)
         tracked_list.merge! objects
       end
-      
+
       # @return [Hash] objects (with their names as keys) which you can bind
       #   proxy listeners to.
       def tracked_list
         @tracked_list ||= ({}.extend DataIdentifier)
       end
-      
+
+      def happen(event, data = nil)
+        track_event data if event == :wait_for_event
+        super event, data
+      end
+
       # It works like the original Events#on, but it also can bind listeners
       # to objects from the {tracked_list}. 
       #
@@ -31,8 +44,15 @@ module Tardvig
       # to this event. *Important!* When you will trigger this event, its name
       # must be a Symbol.
       #
-      # See spec if you did not understood.
+      # See spec if you have not understood.
       def on(event, &listener)
+        track_event event
+        super event, &listener
+      end
+
+      private
+      
+      def track_event(event)
         event_id_parts = event.to_s.split ':'
         if event_id_parts.size == 2
           event_target = tracked_list.get_this event_id_parts[0]
@@ -40,12 +60,8 @@ module Tardvig
             bind_proxy_listener event_target, event, event_id_parts[1]
           end
         end
-        super event, &listener
       end
-      
-      private
-      
-      
+
       def bind_proxy_listener(target, full_event_name, event_name)
         target.on event_name.to_sym do |data|
           happen full_event_name, data

data/lib/tardvig/version.rb

@@ -1,3 +1,3 @@
 module Tardvig
-  VERSION = '0.3.1'.freeze
+  VERSION = '0.3.2'.freeze
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tardvig
 version: !ruby/object:Gem::Version
-  version: 0.3.1
+  version: 0.3.2
 platform: ruby
 authors:
 - Vadim Saprykin
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-09-29 00:00:00.000000000 Z
+date: 2016-10-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake