tardvig 0.2.0 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 724c04628100a4d2d3fe3c4f246af597a26807c3
-  data.tar.gz: db371a8e466d8b3de396119bbeca10581b335f1b
+  metadata.gz: 6d19399953954acf68f31e5a9fb17befd2599a4b
+  data.tar.gz: adeb97c978d563c469aee6490d317adf174569eb
 SHA512:
-  metadata.gz: d9139f6e0c19bad867a5310718aecc2139f20e1009b8a75494eb3232eeca23fe9b2248ac9e2e04443c04308d3ba0cbde4f5b294a40cb8d08b607e46759713d46
-  data.tar.gz: 982a8884b2c6dfe3bf10172d4d2ada79634b3824a0f8ee60adbc61fe720550b1b12c49d9ed0e1f1cf02ed18b63cb472f768bab22ca7299290081c0a46471e817
+  metadata.gz: d219400808b22aad2ec4cb4c7d920af26b8b1227880b9b4f2292fa1c08a8df0434a8cdbf6b5e4a693f60987b12e1762389d74e3229443900a867b03b47bee594
+  data.tar.gz: 2cc8af78421f3b9877373b72993b10756703f5200c5f2aacb714e7398290d7502040a44f2a794bed415893baeb116420fed02f02911c5a859eca62f668a6307b

data/lib/tardvig/data_identifier.rb

@@ -0,0 +1,39 @@
+module Tardvig
+  # Mixin for containers which adds them ability to use "data identifier":
+  # universal selector of data which contains in a container. It is useful in
+  # situation when you need to access data, but you can not directly get
+  # them (e. g. in client-server games).
+  module DataIdentifier
+    # Gets an element from this container using data identifier.
+    # @param id [Symbol,String] key of the element. 
+    #   It supports attributes (id `:key` for `object.key`) and the `[]` method 
+    #   (`:key` for `object[:key]` or `object['key']`).
+    #   You can also get elements from container which is contained in this 
+    #   container (etc) using the `/` symbol (`foo/bar` for `object.foo.bar`).
+    def get_this(id)
+      obj = self
+      id.to_s.split('/').each do |part|
+        obj = get_elem_from_id obj, part
+      end
+      obj
+    end
+    
+    private
+    
+    def get_elem_from_id(container, id)
+      if id.respond_to?(:to_sym) && container.respond_to?(id.to_sym)
+        container.send id.to_sym
+      elsif container.respond_to?(:[])
+        if num?(id)
+          container[id.to_i]
+        elsif !container.class.ancestors.include?(Array)
+          container[id] || container[id.to_sym]
+        end
+      end
+    end
+    
+    def num?(str)
+      str.to_i.to_s == str
+    end
+  end
+end

data/lib/tardvig/events/proxy.rb

@@ -0,0 +1,56 @@
+module Tardvig
+  module Events
+    # It allows to listens events of object using another object.
+    # 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.
+    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
+      
+      # It works like the original Events#on, but it also can bind listeners
+      # to objects from the {tracked_list}. 
+      #
+      # To do it, you need to set event name using next syntax: 
+      # `tracked_obj_name:event_name`. 
+      #
+      # `tracked_obj_name` is
+      # {DataIdentifier} of an object (from {tracked_list}) which you want to 
+      # bind listener to. 
+      #
+      # `event_name` is the event of this object. The `listener` will be binded
+      # to this event. *Important!* When you will trigger this event, its name
+      # must be a Symbol.
+      #
+      # See spec if you did not understood.
+      def on(event, &listener)
+        event_id_parts = event.to_s.split ':'
+        if event_id_parts.size == 2
+          event_target = tracked_list.get_this event_id_parts[0]
+          if event_target
+            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
+        end
+      end
+    end
+  end
+end

data/lib/tardvig/version.rb

@@ -1,3 +1,3 @@
 module Tardvig
-  VERSION = '0.2.0'.freeze
+  VERSION = '0.2.1'.freeze
 end

data/lib/tardvig.rb

@@ -7,6 +7,8 @@ require_relative 'tardvig/saved_hash.rb'
 require_relative 'tardvig/toolkit.rb'
 require_relative 'tardvig/gameio.rb'
 require_relative 'tardvig/act.rb'
+require_relative 'tardvig/data_identifier.rb'
+require_relative 'tardvig/events/proxy.rb'
 
 # The main namespace for the gem
 module Tardvig

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tardvig
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.1
 platform: ruby
 authors:
 - Vadim Saprykin
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-09-01 00:00:00.000000000 Z
+date: 2016-09-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
@@ -80,7 +80,9 @@ files:
 - lib/tardvig.rb
 - lib/tardvig/act.rb
 - lib/tardvig/command.rb
+- lib/tardvig/data_identifier.rb
 - lib/tardvig/events.rb
+- lib/tardvig/events/proxy.rb
 - lib/tardvig/gameio.rb
 - lib/tardvig/saved_hash.rb
 - lib/tardvig/toolkit.rb