Contents

module Ray
  module DSL
    # The module that allows you to do something when something else happened.
    module EventListener
      # Registers a block to listen to an event.
      #
      # Arguments are compared with the ones of the regex using === and,
      # if it failed, ==.
      #
      # @param [Symbol] event Name of the event to listen to
      # @param [DSL::Matcher, Regexp, Object] args List of arguments that should
      #                                            match the event's (if empty,
      #                                            the block will be called anyway)
      def on(event, *args, &block)
        return unless listener_runner
        listener_runner.add_handler(event, args, block)
      end

      # @overload add_hook(event, ..., callable)
      #   Same as on, but the last argument is an object which responds to
      #   to_proc.
      #
      #   @example
      #     add_hook :quit, method(:exit!)
      def add_hook(event, *args)
        on(event, *args[0...-1], &args.last)
      end

      def listener_runner
        @__listener_runner
      end

      def listener_runner=(arg)
        @__listener_runner = arg
      end
    end
  end
end

Version data entries

1 entries across 1 versions & 1 rubygems

Version	Path
ray-0.0.1	lib/ray/dsl/event_listener.rb