eventer 0.0.1 → 0.0.2

data/README.en.md

@@ -0,0 +1,35 @@
+# Eventer
+
+Eventer is simple engine to control custom class events.
+
+## Usage
+
+### Creation, and setup a handler
+
+Make a class, and set the allowable events for it. Then create a class instance, and set handler to process an event as a block using 'on_...' method of the class instance, where instead ... put the name of the event. For an each of events, thou canst setup an unlimited number of handlers.
+
+    class Test
+      events :event
+    end
+
+    t = Test.new
+
+    t.on_event do |args|
+      "Matched"
+    end
+
+### Triggering the handlers
+
+In order to the event triggers, call 'event' method, that enumerates and calls all settled handlers. The 'event' method will return an Array, with a Hash values. The Hash will contain the pair as seen as the Proc pointer, and a result value.
+
+    t.event :event, args... # -> [{<#Proc...> => "Matched"}, ...]
+
+Also, there is the procedure allowing to output the simple result value as an Array with values from each handler.
+
+    t.event_rs :event, args... # -> ["Matched", ...]
+
+# Copyright
+
+Copyright (c) 2011 Malo Skrylevo
+See LICENSE for details.
+

data/README.md

@@ -1,15 +1,13 @@
 # Eventer
 
-Eventer есть простой движокъ для управления событями класса.
+Eventer есть простой движокъ для управленія событіями класса.
 
-Eventer is simple engine to control custom class events.
+## Использованіе
 
-## Использованіе (Usage)
+### Созданіе и установка обработчика
 
-### Используя методъ экземпляра класса (Using the class instance method)
-Создай класс, и задай допустимыя для него событія. Затѣмъ создай экземпляръ класса и задай обработчикъ событія въ блокѣ съ помощью метода 'on_...' экземпляра класса, гдѣ вмѣсто ... задай имя событія. А потомъ, по необходимости, дёрни событіе методомъ 'event' экземпляра класса. А плодомъ выполненія сего метода будетъ словарь (Hash) съ ключами какъ экземплярами класса Proc отражающими вызванные обработчики и со значеніями какъ плодами работы сихъ обработчиковъ:
+Создай классъ, и задай допустимыя для него событія. Затѣмъ создай екземпляръ класса и опредѣли обработчикъ событія въ блокѣ съ помощью метода 'on_...' екземпляра класса, гдѣ вмѣсто ... установи имя событія. Для каждаго предопредѣленнаго событія можно закладывать неограниченное количество обработчиковъ.
 
-Make a class, and set the allowable events for it. Then create a class instance, and set handler to process an event as a block using 'on_...' method of the class instance, where instead ... put the name of the event. And then, if needed, trigger event with the 'event' method of the class instance. The result is a Hash with keys as the handler block instance, and values as the handler's output:
 
     class Test
       events :event
@@ -19,13 +17,21 @@ Make a class, and set the allowable events for it. Then create a class instance,
 
     t.on_event do |args|
       "Matched"
-    end # -> {<#Proc...> => "Matched"}
+    end
+
+### Задѣствованіе обработчика
+
+Чтобы событіе сработало, вызови методъ event, задѣйствующій всѣ установленныя обработчики. Методъ же сей вернётъ наборъ съ словарями для каждаго из обработчиковъ. Словарь при семъ будетъ содержать обѣ ключъ-значеніе, выраженныя какъ указатель на обработчикъ и плодъ его выполненія.
+
+    t.event :event, args... # -> [{<#Proc...> => "Matched"}, ...]
+
+Есть также процедура съ выводомъ болѣе простаго результата въ видѣ набора значеній, полученныхъ изъ оныхъ обработчиковъ.
+
+    t.event_rs :event, args... # -> ["Matched", ...]
 
-# Права (Copyright)
+# Права
 
 Авторскія и исключительныя права (а) 2011 Малъ Скрылевъ
 Зри LICENSE за подробностями.
 
-Copyright (c) 2011 Malo Skrylevo
-See LICENSE for details.
 

data/lib/eventer.rb

@@ -1,44 +1,64 @@
 #!/usr/bin/ruby
 
 module Eventer
-  class EventerError < StandardError
+  class UnknownEventError < StandardError
+    def initialize(*args)
+      args[0] = "Unregistered event :#{args[0]}" if args[0]
+      super(*args)
+    end
   end
 
-  def method_missing(sym, *args, &block)
-    if sym.to_s =~ /^on_(.*)/
-      (event, prc) = [ $1.to_sym, block ]
-      raise EventerError.new "Unregistered event :#{event}" unless self.class.events.include? event
-      @__events__ = {} unless @__events__
-      @__events__[event] = [] unless @__events__[event]
-      @__events__[event] << prc unless @__events__[event].include? prc
-    else; super; end
+private
+
+  def add_event(event, &prc)
+    event = event.to_sym
+    @__events__ = {} unless @__events__
+    @__events__[event] = [] unless @__events__[event]
+    @__events__[event] << prc unless @__events__[event].include? prc
+    true
   end
 
+public
+
   def event(event, *args)
     res = {}
 
-    if @__events__ and @__events__[event]
-      @__events__[event].each do |event_h|
-	res[event_h] = event_h.call(args)
+    if @__events__
+      if @__events__[event]
+	@__events__[event].each do |event_h|
+	  res[event_h] = event_h.call(*args)
+	end
+      else
+	[]
       end
     else
-      raise EventerError.new "Unregistered event :#{event}"
+      raise UnknownEventError.new event
     end
 
     res
   end
 
+  def purge_events(*events)
+    (events.empty? ? @__events__ : events).each do |e|
+	@__events__[e].clear if @__events__[e]
+    end if @__events__
+  end
+
+  def event_rs(event, *args)
+    event(event, *args).map do |x| x[1..-1] end.flatten
+  end
+
 end
 
 
 class Class
 
+public
   def events(*args)
-    return @__events__ if args.empty?
-    return if @__events__
-
-    @__events__ = args.map do |event| event.to_sym end.compact
     include Eventer
+    args.map do |e| e.to_sym end.compact.each do |e|
+      self.class_eval "def on_#{e}(&block); add_event(:#{e}, &block); end"
+    end
   end
 
 end

data/lib/eventer/version.rb

@@ -1,3 +1,3 @@
 module Eventer
-  VERSION = "0.0.1"
+  VERSION = "0.0.2"
 end

data/spec/eventer_spec.rb

@@ -3,60 +3,60 @@
 require File.expand_path('../spec_helper', __FILE__)
 
 describe 'Eventer' do
-    it "Good event match" do
-      class Test
-	events :event
-      end
+  it "Good event match" do
+    class Test
+      events :event
+    end
 
-      t = Test.new
+    t = Test.new
 
-      t.on_event do |args|
-	"Matched"
-      end
+    t.on_event do |args|
+      "Matched"
+    end
 
-      o = (t.event :event).to_a.flatten.map do |x| x.class == String ? x : nil end.compact
+    o = t.event_rs :event
 
-      raise "Event result isn't matched" if o != [ "Matched" ]
+    raise "Event result isn't matched" if o != [ "Matched" ]
+  end
+
+  it "Unknown event triggered" do
+    class Test
+      events :event
     end
 
-    it "Unknown event triggered" do
-      class Test
-	events :event
-      end
+    t = Test.new
 
-      t = Test.new
+    t.on_event do |args|
+      "Matched"
+    end
 
-      t.on_event do |args|
-	"Matched"
-      end
+    o = begin
+      t.event_rs :unknown
+    rescue Eventer::UnknownEventError
+      true
+    end
 
-      o = begin
-	(t.event :unknown).to_a.flatten.map do |x| x.class == String ? x : nil end.compact
-      rescue Eventer::EventerError
-	true
-      end
+    raise "Event result isn't matched" if (not o) or (o != true)
+  end
 
-      raise "Event result isn't matched" if (not o) or (o != true)
+  it "Try to register an unknown event" do
+    class Test
+      events :event
     end
 
-    it "Try to register an unknown event" do
-      class Test
-	events :event
-      end
+    t = Test.new
 
-      t = Test.new
-
-      o = begin
-	t.on_unknown do |args|
-	  "Matched"
-	end
-	false
-      rescue Eventer::EventerError
-	true
+    o = begin
+      t.on_unknown do |args|
+        "Matched"
       end
-
-      raise "Event result isn't matched" if (not o) or (o != true)
+      false
+    rescue NoMethodError
+      true
     end
+
+    raise "Event result isn't matched" if (not o) or (o != true)
+  end
 end
 
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: eventer
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.2
   prerelease: 
 platform: ruby
 authors:
@@ -9,11 +9,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2011-04-14 00:00:00.000000000Z
+date: 2011-05-16 00:00:00.000000000Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
-  requirement: &69651220 !ruby/object:Gem::Requirement
+  requirement: &69597080 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -21,10 +21,10 @@ dependencies:
         version: 1.0.0
   type: :development
   prerelease: false
-  version_requirements: *69651220
+  version_requirements: *69597080
 - !ruby/object:Gem::Dependency
   name: rspec
-  requirement: &69650990 !ruby/object:Gem::Requirement
+  requirement: &69596850 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -32,7 +32,7 @@ dependencies:
         version: 2.0.1
   type: :development
   prerelease: false
-  version_requirements: *69650990
+  version_requirements: *69596850
 description: eventer is the simpest event throwing engine
 email:
 - 3aHyga@gmail.com
@@ -44,6 +44,7 @@ files:
 - Gemfile
 - Gemfile.lock
 - LICENSE
+- README.en.md
 - README.md
 - Rakefile
 - eventer.gemspec