orator 0.2.2 → 0.3.2

data/README.md

@@ -8,7 +8,7 @@ well as [em-websocket](https://github.com/igrigorik/em-websocket).
 
 ## Ruby on Rails Integration
 Orator integrates easily with Ruby on Rails.  Just add
-  
+
     gem 'orator'
 
 to your Gemfile and `bundle install` away.  In order to use it, you'll need to
@@ -19,18 +19,18 @@ add the following line to your `application.js` file:
 Now you can use the orator client in your JavaScript!  If the browser doesn't
 support JavaScript, it'll fall back to a flash object.
 
-## Server Handlers
+### Server Orators
 We'll start with the server-side stuff.  A simple `rails g orator:config` will
-place the file `orator_config.yml` in `config/`, and an example handler in
-`app/handlers`.  Feel free to modify the configuration file (I'll add
-documentation to it).  Let's set up a handler here:
+place the file `orator_config.yml` in `config/`, and an example orator in
+`app/orators`.  Feel free to modify the configuration file (I'll add
+documentation to it).  Let's set up a orator here:
 
 ```Ruby
-class TestHandler < Orator::Handlers::Base
+class TestOrator < Orator::Base
 ```
 
 This is important.  Orator will not accept the Handler unless it is a child
-of `Orator::Handlers::Base`.  `Orator::Handlers::Base` implements methods that
+of `Orator::Base`.  `Orator::Base` implements methods that
 are used by Orator.
 
 ```Ruby
@@ -72,15 +72,15 @@ Either way, we're outputting a message that we received.
 ```Ruby
 end
 
-Orator.add_handler(TestHandler)
+Orator.add_orator(TestOrator)
 ```
 
-Here we register our handler with Orator, so it can use it for routing events.
-But say we also want to handle a `socket.open` event.  Our handler above can't
+Here we register our orator with Orator, so it can use it for routing events.
+But say we also want to handle a `socket.open` event.  Our orator above can't
 handle that, sadly, so we use this method:
 
 ```Ruby
-Orator.add_handler do |events|
+Orator.add_orator do |events|
   events.on('socket.open') do |data|
     self.user = {}
 
@@ -94,7 +94,7 @@ end
 ```
 
 So when the socket opens in `socket.open`, we set `#user` to an empty hash and
-send a ping message (whose response will be handled by our TestHandler).  When
+send a ping message (whose response will be handled by our TestOrator).  When
 we receive the `user.alias` message, we set the key-pair `:name => json["name"]`
 on the `#user` hash.  Cool, eh?
 
@@ -102,11 +102,11 @@ To run the server, run `orator --command start` in the root rails directory.
 To daemonize it, run `orator --command start -d`.  To stop, run
 `orator --command stop`.
 
-## JavaScript Client
+### JavaScript Client
 Let's go through an example together.
 
-```JavaScript    
-$(document).ready(function() {      
+```JavaScript
+$(document).ready(function() {
   Orator.setup("ws://host:port/path?query", function(events){
 ```
 
@@ -114,7 +114,7 @@ $(document).ready(function() {
 events and routing, as well.  There are some locally defined events that are
 triggered even if the server hadn't sent them, such as `socket.open` and
 `socket.close`.
-        
+
 ```JavaScript
   events.on('some.event', function() {})
 ```
@@ -123,7 +123,7 @@ Here we're binding some event named `some.event` to an empty function.  Boring.
 Note that the name of the event doesn't matter here.
 
 ```JavaScript
-  events.on('test.ping', function() { 
+  events.on('test.ping', function() {
     this.server.send('test.pong', { message: 'pong' });
   });
 ```

data/lib/generators/orator/config_generator.rb

@@ -6,7 +6,8 @@ module Orator
 
       def copy_configuration
         template "config.yml", "config/orator_config.yml"
-        directory "handlers", "app/handlers"
+        empty_directory "config/orator"
+        directory "orators", "app/orators"
       end
 
     end

data/lib/generators/orator/orator_generator.rb

@@ -0,0 +1,15 @@
+module Orator
+  module Generators
+    class OratorGenerator < Rails::Generators::Base
+
+      source_root File.expand_path('../../templates', __FILE__)
+      argument :orator_name, :required => true,
+        :desc => "The name of the orator to generate."
+
+      def copy_configuration
+        template "template_orator.rb", "app/orators/#{orator_name}_orator.rb"
+      end
+
+    end
+  end
+end

data/lib/generators/templates/config.yml

@@ -4,4 +4,5 @@
 :server_options:
   :host: 0.0.0.0
   :port: 8080
-:handlers_path: app/handlers/*
+:orators_path: app/orators/*
+:require: config/orator/*

data/lib/generators/templates/{handlers/example_handler.rb → orators/example_orator.rb}

@@ -1,9 +1,9 @@
-class ExampleHandler < Orator::Handlers::Base
+class ExampleOrator < Orator::Base
 
-  # This defines the name of the handler.  THIS IS REQUIRED.  Orator will not
-  # be able to correctly route your events to this handler if it is not put
+  # This defines the name of the orator.  THIS IS REQUIRED.  Orator will not
+  # be able to correctly route your events to this orator if it is not put
   # here.
-  #handler_name 'example'
+  #orator_name 'example'
 
   # This defines a before event.  It can take a block or a symbol.  If it's a
   # symbol, it'll call the method.
@@ -28,4 +28,4 @@ class ExampleHandler < Orator::Handlers::Base
 
 end
 
-#Orator.add_handler(ExampleHandler)
+#Orator.add_orator(ExampleOrator)

data/lib/generators/templates/template_orator.rb

@@ -0,0 +1,8 @@
+class <%= orator_name.camelcase %>Orator < Orator::Base
+
+  orator_name '<%= orator_name.underscore %>'
+
+
+end
+
+Orator.add_orator(<%= orator_name.camelcase %>Orator)

data/lib/orator/base.rb

@@ -0,0 +1,181 @@
+module Orator
+
+  # A base for the orators to split off of.  It handles contexts and running
+  # methods.  Most of the methods defined in this  class are prefixed with
+  # two dashes to prevent polluting the namespace.
+  #
+  # @abstract
+  class Base
+
+    # Initialize the orator with the context.
+    #
+    # @param context [Object]
+    def initialize(context)
+      @__context = context
+    end
+
+    # This triggers an event if it's defined on this orator.  If it is not
+    # defined, it raises an error.
+    #
+    # @param event [Symbol, String] the event to trigger.
+    # @raise [NoMethodError] if the event isn't defined on the orator.
+    # @return [Array<Object>, nil] the values of the trigger, or nil if the
+    #   event was prevented.
+    def __trigger(event, *args)
+      orator, method_name = event.to_s.split('.')
+      __check_event(orator, method_name)
+
+      __run_callbacks(:before)
+      out = __run_event(method_name, args) unless @__prevent_event
+      __run_callbacks(:after)
+
+      out
+    end
+
+    # Checks the event list to see if this class responds to it.
+    #
+    # @return [Set<Symbol, Proc>, nil]
+    def __method_exists?(method)
+      __event_list[method]
+    end
+
+    # A map of the events that determine how this class will respond.
+    #
+    # @return [Hash]
+    # @see [ClassMethods::event_list]
+    def __event_list
+      self.class.event_list
+    end
+
+    # This tells the orator to not execute the events in the class.  This
+    # should only be called in a `before` block.
+    def prevent_event
+      @__prevent_event = true
+    end
+
+    # Handles missing methods by delegating them to the context.  Should
+    # never be called directly.
+    #
+    # @return [Object]
+    def method_missing(method, *args, &block)
+      super unless respond_to_missing?(method)
+
+      @__context.public_send(method, *args, &block)
+    end
+
+    # Lets Ruby know that there are some undefined methods on this class.
+    #
+    # @return [Boolean]
+    def respond_to_missing?(method, include_private = false)
+      @__context.respond_to?(method, include_private)
+    end
+
+    # This forwards {#send} on to the context.
+    #
+    # @return [Object]
+    def send(*args, &block)
+      @__context.send(*args, &block)
+    end
+
+    private
+
+    # Run the event.
+    def __run_event(method_name, args)
+      result = __event_list[method_name].map do |responder|
+        responder = method(responder) if responder.is_a? Symbol
+        instance_exec *args, &responder
+      end
+
+      result
+    end
+
+    # Check the event, making sure that this orator can respond to it.
+    def __check_event(orator, method)
+      if orator != self.class.orator_name
+        raise NoMethodError,
+          "Event #{orator} does not match #{self.class.name}"
+        return
+      elsif !__method_exists?(method)
+        raise NoMethodError,
+          "Method #{method} does not exist on #{self.class.name}"
+        return
+      end
+    end
+
+    # Runs the callbacks.
+    def __run_callbacks(type)
+      self.class.send("#{type}_list").map do |cb|
+        if cb.is_a? Symbol
+          method(cb).call
+        else
+          instance_exec &cb
+        end
+      end
+    end
+
+    module ClassMethods
+
+      # This manages the orator's name.  If an argument is passed, the name
+      # is set to that.  Otherwise, it returns the orator's name.
+      #
+      # @param value [String, nil] the new name.
+      # @return [String] the orator name.
+      def orator_name(value = nil)
+        if value
+          @_orator_name = value
+        end
+
+        @_orator_name
+      end
+
+      # This registers a method for this orator.
+      #
+      # @param event [Symbol] the event to register it to.
+      # @return [void]
+      def on(event, method = nil, &block)
+        event_list[event.to_s] ||= []
+
+        if block_given?
+          event_list[event.to_s] << block
+        else
+          event_list[event.to_s] << (method || event).to_sym
+        end
+      end
+
+      # The event matchings.  The keys are the event name, the values can be
+      # an array of mappings or a the mapping itself.
+      #
+      # @return [Hash] the event list.
+      def event_list
+        @event_list ||= {}
+      end
+
+      # This registers this orator with the event handler by telling it what
+      # methods it responds to.
+      #
+      # @param event_handler [EventHandler]
+      def register_with(event_handler)
+        event_list.keys.each do |event|
+          event_handler.on("#{self.orator_name}.#{event}", self)
+        end
+      end
+
+      [:before, :after].each do |type|
+        module_eval <<-METHOD, __FILE__, __LINE__
+          def #{type}(method = nil, &block)
+            #{type}_list << (method || block)
+          end
+
+          def #{type}_list
+            @#{type}_list ||= Set.new
+          end
+        METHOD
+      end
+    end
+
+    extend ClassMethods
+    orator_name ''
+
+  end
+
+end

data/lib/orator/cli.rb

@@ -61,17 +61,18 @@ module Orator
 
     def start
       daemonize? do
-        load_handlers
+        load_orators
+        require_files
         server = Orator::Server.new(yaml_options[:server_options])
-        handlers = self.class.handlers
+        orators = self.class.orators
 
         puts "Starting server..." if Orator.debug
         server.run do
-          handlers.each do |handler|
-            if handler.is_a? Proc
-              handler.call(self)
+          orators.each do |orator|
+            if orator.is_a? Proc
+              orator.call(self)
             else
-              handler.register_with(self)
+              orator.register_with(self)
             end
           end
         end
@@ -99,20 +100,20 @@ module Orator
       exit
     end
 
-    # Add a handler to be used by the server.
+    # Add a orator to be used by the server.
     #
-    # @param klass [Class] the class to use as a handler.
-    # @return [Array<Class>] a list of handlers that will be used for the
+    # @param klass [Class] the class to use as aorator.
+    # @return [Array<Class>] a list of orators that will be used for the
     #   server.
-    def self.add_handler(klass = nil, &block)
-      handlers << (klass || block)
+    def self.add_orator(klass = nil, &block)
+      orators << (klass || block)
     end
 
-    # A list of handlers.
+    # A list of orators.
     #
-    # @return [Array<Class>] the handlers.
-    def self.handlers
-      @handlers ||= []
+    # @return [Array<Class>] the orators.
+    def self.orators
+      @orators ||= []
     end
 
     private
@@ -138,16 +139,32 @@ module Orator
       end
     end
 
-    # Loads the handlers from the YAML file by requiring each file.
+    # Loads the orators from the YAML file by requiring each file.
     #
     # @return [void]
-    def load_handlers
-      p yaml_options, yaml_options[:handlers_path]
-      Dir[yaml_options[:handlers_path]].each do |file|
+    def load_orators
+      return unless yaml_options[:orators_path]
+      Dir[yaml_options[:orators_path]].each do |file|
         load file
       end
     end
 
+    # This loads files that are deemed required by the configuration file.
+    #
+    # @return [void]
+    def require_files
+      return unless yaml_options[:require]
+      requires = if yaml_options[:require].is_a? Array
+        yaml_options[:require]
+      else
+        [yaml_options[:require]]
+      end
+
+      requires.each do |r|
+        Dir[r].each { |f| load f }
+      end
+    end
+
     # Daemonizes the block, if it's applicable.
     #
     # @yields [] in the new process, if daemonized; otherwise, a normal yield.

data/lib/orator/event_handler.rb

@@ -14,15 +14,15 @@ module Orator
     end
 
     # This adds an event to the set.  It can accept a block or a class.  If
-    # it's a class, the class should inherit from [Handlers::Base].  If both
+    # it's a class, the class should inherit from [Base].  If both
     # a class and a block is given, the block is preferred.
     #
     # @param event [String, Symbol] the event to bind it to.
-    # @param klass [Handlers::Base, nil] the class that contains the method to 
+    # @param klass [Base, nil] the class that contains the method to
     #   use for the event.
     # @param count [Numeric, nil] the number of times to run this event.  No
     #   value is an infinite number of times.
-    # @raise [ArgumentError] if klass isn't a subclass of Handlers::Base.
+    # @raise [ArgumentError] if klass isn't a subclass of Base.
     # @return [void]
     def on(event, klass = nil, count = nil, &block)
       puts "Binding #{event} to #{klass || block}..." if Orator.debug
@@ -30,7 +30,7 @@ module Orator
 
       if block_given?
         data[:block] = block
-      elsif klass and klass < Handlers::Base
+      elsif klass and klass < Base
         data[:class] = klass
       else
         raise ArgumentError, "No class or block was given."
@@ -52,7 +52,7 @@ module Orator
       puts "Running event #{event}..." if Orator.debug
       events(event).map do |event|
         puts "Found responder #{event[:block] || event[:class]}" if Orator.debug
-        
+
         run_event(event, context, args)
         if event[:count] then event[:count] -= 1 end
       end

data/lib/orator/version.rb

@@ -1,5 +1,5 @@
 module Orator
 
   # Version of Orator.
-  VERSION = '0.2.2'
+  VERSION = '0.3.2'
 end

data/lib/orator.rb

@@ -5,10 +5,10 @@ require 'set'
 require 'ostruct'
 require 'em-websocket'
 
+require 'orator/base'
 require 'orator/server'
 require 'orator/client'
 require 'orator/version'
-require 'orator/handlers'
 require 'orator/event_handler'
 require 'orator/middle_ground'
 
@@ -19,8 +19,8 @@ module Orator
   class << self; attr_accessor :debug; end
   Orator.debug = false
 
-  def self.add_handler(*args, &block)
-    Orator::CLI.add_handler(*args, &block)
+  def self.add_orator(*args, &block)
+    Orator::CLI.add_orator(*args, &block)
   end
-  
+
 end

data/spec/{base_handler_spec.rb → base_orator_spec.rb}

@@ -1,9 +1,9 @@
-describe Orator::Handlers::Base do
+describe Orator::Base do
   it "should call before blocks" do
     something = double('something')
     something.should_receive(:to_call)
     klass = Class.new(described_class) do
-      handler_name 'test'
+      orator_name 'test'
       before { something.to_call }
       on 'some_event'
       def some_event; end
@@ -21,7 +21,7 @@ describe Orator::Handlers::Base do
     something = double('something')
     something.should_not_receive(:to_call)
     klass = Class.new(described_class) do
-      handler_name 'test'
+      orator_name 'test'
       before { prevent_event }
       on('some_event') { something.to_call }
     end
@@ -33,7 +33,7 @@ describe Orator::Handlers::Base do
     event_handler = double('event_handler')
 
     klass = Class.new(described_class) do
-      handler_name 'test'
+      orator_name 'test'
 
       on('some_event') { }
     end
@@ -48,7 +48,7 @@ describe Orator::Handlers::Base do
     something.should_not_receive(:to_call)
 
     klass = Class.new(described_class) do
-      handler_name 'test'
+      orator_name 'test'
 
       before :do_something
 
@@ -63,7 +63,7 @@ describe Orator::Handlers::Base do
   it "should be able to use a different method" do
 
     klass = Class.new(described_class) do
-      handler_name 'test'
+      orator_name 'test'
 
       on 'some_event', :other_method
       def other_method; end

data/spec/event_handler_spec.rb

@@ -1,7 +1,7 @@
 describe Orator::EventHandler do
   it "should initalize with block" do
-    expect { 
-      EventHandler.new { raise StandardError } 
+    expect {
+      EventHandler.new { raise StandardError }
     }.to raise_error(StandardError)
   end
 
@@ -13,7 +13,7 @@ describe Orator::EventHandler do
     subject.events.first[:block].should be_kind_of Proc
   end
 
-  class SomeClass < Orator::Handlers::Base; end
+  class SomeClass < Orator::Base; end
 
   it "should accept a class for an event" do
     subject.on(:some_event, SomeClass)

metadata

@@ -1,7 +1,8 @@
 --- !ruby/object:Gem::Specification
 name: orator
 version: !ruby/object:Gem::Version
-  version: 0.2.2
+  version: 0.3.2
+  prerelease: 
 platform: ruby
 authors:
 - Jeremy Rodi
@@ -13,6 +14,7 @@ dependencies:
 - !ruby/object:Gem::Dependency
   name: em-websocket
   requirement: !ruby/object:Gem::Requirement
+    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
@@ -20,6 +22,7 @@ dependencies:
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
+    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
@@ -27,6 +30,7 @@ dependencies:
 - !ruby/object:Gem::Dependency
   name: oj
   requirement: !ruby/object:Gem::Requirement
+    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
@@ -34,6 +38,7 @@ dependencies:
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
+    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
@@ -41,6 +46,7 @@ dependencies:
 - !ruby/object:Gem::Dependency
   name: swf_fu
   requirement: !ruby/object:Gem::Requirement
+    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
@@ -48,6 +54,7 @@ dependencies:
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
+    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
@@ -55,6 +62,7 @@ dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
+    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
@@ -62,6 +70,7 @@ dependencies:
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
+    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
@@ -75,53 +84,52 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
+- lib/tasks/orator.rake
+- lib/orator.rb
+- lib/orator/engine.rb
+- lib/orator/server.rb
+- lib/orator/base.rb
 - lib/orator/middle_ground.rb
+- lib/orator/event_handler.rb
 - lib/orator/version.rb
-- lib/orator/handlers.rb
-- lib/orator/server.rb
 - lib/orator/cli.rb
 - lib/orator/client.rb
-- lib/orator/handlers/base.rb
-- lib/orator/engine.rb
-- lib/orator/event_handler.rb
-- lib/generators/orator/handler_generator.rb
-- lib/generators/orator/config_generator.rb
-- lib/generators/templates/template_handler.rb
+- lib/generators/templates/template_orator.rb
 - lib/generators/templates/config.yml
-- lib/generators/templates/handlers/example_handler.rb
-- lib/orator.rb
-- lib/tasks/orator.rake
+- lib/generators/templates/orators/example_orator.rb
+- lib/generators/orator/config_generator.rb
+- lib/generators/orator/orator_generator.rb
 - bin/orator
+- spec/event_handler_spec.rb
+- spec/middle_ground_spec.rb
 - spec/client_spec.rb
+- spec/base_orator_spec.rb
 - spec/spec_helper.rb
-- spec/middle_ground_spec.rb
-- spec/event_handler_spec.rb
-- spec/base_handler_spec.rb
 - README.md
 - Rakefile
 - LICENSE
 homepage: http://github.com/redjazz96/orator
 licenses: []
-metadata: {}
 post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
   requirements:
   - - ! '>='
     - !ruby/object:Gem::Version
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
   requirements:
   - - ! '>='
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.0.2
+rubygems_version: 1.8.24
 signing_key: 
-specification_version: 4
+specification_version: 3
 summary: Magic for your browser.
 test_files: []
-has_rdoc: false

checksums.yaml

@@ -1,15 +0,0 @@
----
-!binary "U0hBMQ==":
-  metadata.gz: !binary |-
-    OGNmZTliMTc2ZjkxYTM1NzU0YmE2MzY4ODE5MTQ0Y2EyYzBlODU1ZQ==
-  data.tar.gz: !binary |-
-    YmJhNDE5ZDI1YmY3OGQ5MjlkMTY5OGE0YTNhZjU5Y2JlMTFmOThhZA==
-!binary "U0hBNTEy":
-  metadata.gz: !binary |-
-    NTI3YjA0NjdlMjBjOWU4Zjk0NWI1MGMyYmE0YzkzNzVjMzQ4YTE3NzhhNWQ5
-    NDc0MGRkODIzZDhlMjg0ZGQ1ZDYyYzA0MDgwM2U5ZWI3YzMzNDc3YWZkNDRj
-    NDE4NDc1MmYxMjk4YTY0OTk0NzkzNjg2MmQyMWI2NGIwNWMxMDI=
-  data.tar.gz: !binary |-
-    NGRmM2U1NmVmNWI0YmFiNDM5NjBkMGUwNDYyYzgzYmQ0ZWE4YWEwNmFmMmI5
-    NjRkNGZhMmZlZTlkYzRmOWI2ZDE0OTY4Y2NhODQxY2MxODRhZGQ0NDk1N2Jl
-    MDYxM2ZiZmU0NDhjMmU0N2FiODk2Mzc3OWYyOWMxYzBjODMyNDI=

data/lib/generators/orator/handler_generator.rb

@@ -1,15 +0,0 @@
-module Orator
-  module Generators
-    class HandlerGenerator < Rails::Generators::Base
-
-      source_root File.expand_path('../../templates', __FILE__)
-      argument :handler_name, :required => true,
-        :desc => "The name of the handler to use."
-
-      def copy_configuration
-        template "template_handler.rb", "app/handlers/#{handler_name}_handler.rb"
-      end
-
-    end
-  end
-end

data/lib/generators/templates/template_handler.rb

@@ -1,6 +0,0 @@
-class <%= handler_name.camelcase %>Handler < Orator::Handlers::Base
-  
-  handler_name '<%= handler_name.underscore %>'
-
-  
-end

data/lib/orator/handlers/base.rb

@@ -1,183 +0,0 @@
-module Orator
-  module Handlers
-
-    # A base for the handlers to split off of.  It handles contexts and running
-    # methods.  Most of the methods defined in this  class are prefixed with
-    # two dashes to prevent polluting the namespace. 
-    #
-    # @abstract
-    class Base
-
-      # Initialize the handler with the context.
-      #
-      # @param context [Object]
-      def initialize(context)
-        @__context = context
-      end
-
-      # This triggers an event if it's defined on this handler.  If it is not
-      # defined, it raises an error.
-      #
-      # @param event [Symbol, String] the event to trigger.
-      # @raise [NoMethodError] if the event isn't defined on the handler.
-      # @return [Array<Object>, nil] the values of the trigger, or nil if the
-      #   event was prevented.
-      def __trigger(event, *args)
-        handler, method_name = event.to_s.split('.')
-        __check_event(handler, method_name)
-
-        __run_callbacks(:before)
-        out = __run_event(method_name, args) unless @__prevent_event
-        __run_callbacks(:after)
-
-        out
-      end
-
-      # Checks the event list to see if this class responds to it.
-      #
-      # @return [Set<Symbol, Proc>, nil]
-      def __method_exists?(method)
-        __event_list[method]
-      end
-
-      # A map of the events that determine how this class will respond.
-      #
-      # @return [Hash]
-      # @see [ClassMethods::event_list]
-      def __event_list
-        self.class.event_list
-      end
-
-      # This tells the handler to not execute the events in the class.  This
-      # should only be called in a `before` block.
-      def prevent_event
-        @__prevent_event = true
-      end
-
-      # Handles missing methods by delegating them to the context.  Should
-      # never be called directly.
-      #
-      # @return [Object]
-      def method_missing(method, *args, &block)
-        super unless respond_to_missing?(method)
-
-        @__context.public_send(method, *args, &block)
-      end
-
-      # Lets Ruby know that there are some undefined methods on this class.
-      #
-      # @return [Boolean]
-      def respond_to_missing?(method, include_private = false)
-        @__context.respond_to?(method, include_private)
-      end
-
-      # This forwards {#send} on to the context.
-      #
-      # @return [Object]
-      def send(*args, &block)
-        @__context.send(*args, &block)
-      end
-
-      private
-
-      # Run the event.
-      def __run_event(method_name, args)
-        result = __event_list[method_name].map do |responder|
-          responder = method(responder) if responder.is_a? Symbol
-          instance_exec *args, &responder
-        end
-
-        result
-      end
-
-      # Check the event, making sure that this handler can respond to it.
-      def __check_event(handler, method)
-        if handler != self.class.handler_name
-          raise NoMethodError, 
-            "Event #{handler} does not match #{self.class.name}"
-          return
-        elsif !__method_exists?(method)
-          raise NoMethodError, 
-            "Method #{method} does not exist on #{self.class.name}"
-          return
-        end
-      end
-
-      # Runs the callbacks.
-      def __run_callbacks(type)
-        self.class.send("#{type}_list").map do |cb|
-          if cb.is_a? Symbol
-            method(cb).call
-          else
-            instance_exec &cb
-          end
-        end
-      end
-
-      module ClassMethods
-        
-        # This manages the handler's name.  If an argument is passed, the name
-        # is set to that.  Otherwise, it returns the handler's name.
-        #
-        # @param value [String, nil] the new name.
-        # @return [String] the handler name.
-        def handler_name(value = nil)
-          if value
-            @_handler_name = value
-          end
-
-          @_handler_name
-        end
-
-        # This registers a method for this Handler.
-        #
-        # @param event [Symbol] the event to register it to.
-        # @return [void]
-        def on(event, method = nil, &block)
-          event_list[event.to_s] ||= []
-
-          if block_given?
-            event_list[event.to_s] << block
-          else
-            event_list[event.to_s] << (method || event).to_sym
-          end
-        end
-
-        # The event matchings.  The keys are the event name, the values can be
-        # an array of mappings or a the mapping itself.
-        #
-        # @return [Hash] the event list.
-        def event_list
-          @event_list ||= {}
-        end
-
-        # This registers this handler with the event handler by telling it what
-        # methods it responds to.
-        #
-        # @param event_handler [EventHandler]
-        def register_with(event_handler)
-          event_list.keys.each do |event|
-            event_handler.on("#{self.handler_name}.#{event}", self)
-          end
-        end
-
-        [:before, :after].each do |type|
-          module_eval <<-METHOD, __FILE__, __LINE__
-            def #{type}(method = nil, &block)
-              #{type}_list << (method || block)
-            end
-       
-            def #{type}_list
-              @#{type}_list ||= Set.new
-            end
-          METHOD
-        end
-      end
-
-      extend ClassMethods
-      handler_name ''
-
-    end
-
-  end
-end

data/lib/orator/handlers.rb

@@ -1,9 +0,0 @@
-require 'orator/handlers/base'
-
-module Orator
-
-  # Handlers to be used by orator.
-  module Handlers
-
-  end
-end