Contents

module Tap
  module Signals
    
    # Signal attaches an object and allows a specific method to be triggered
    # through a standard interface.
    class Signal
      class << self
        # A description of self
        attr_accessor :desc
      end
      
      # The object receiving signals through self.
      attr_reader :obj
      
      attr_reader :block
      
      def initialize(obj, &block)
        @obj = obj
        @block = block
      end
      
      # Calls process with the input args and returns the result.  This method
      # is a hook for subclasses.
      def call(args)
        process(args)
      end
      
      # Simply returns the input args.  This method is a hook for subclasses.
      def process(args)
        args
      end
      
      protected
      
      def convert_to_array(obj, signature=[], options=false)
        return obj if obj.kind_of?(Array)
        
        argv = signature.collect {|key| obj[key] }
        
        if options
          opts = {}
          (obj.keys - signature).each do |key|
            opts[key] = obj[key]
          end
          
          argv << opts
        end
        
        argv
      end
      
      def convert_to_hash(obj, signature=[], remainder=nil)
        return obj if obj.kind_of?(Hash)
        
        args, argh = obj, {}
        signature.each do |key|
          argh[key] = args.shift
        end
        
        if remainder
          argh[remainder] = args
        end
        
        argh
      end
    end
  end
end

Version data entries

1 entries across 1 versions & 1 rubygems

Version	Path
tap-0.19.0	lib/tap/signals/signal.rb