Contents

module Tap
  module Joins
    
    # A Switch join allows a block to determine which output from an array
    # of outputs will receive the results of the input.
    #
    #--
    # Note that switch is NOT identified as a join that can be created from
    # the command line.  Switch inherently requires a block to select which
    # output receives the input, and so cannot be loaded from data alone.
    #
    # Switch facilitates in-code switch joins.
    class Switch < Join
      
      # An object responding to call that return the index of the output
      # to that receives the result.
      attr_accessor :selector
      
      def initialize(config={}, app=Tap::App.instance, &block)
        super(config, app)
        @selector = block
      end
      
      def join(inputs, outputs, &block)
        @selector = block
        super(inputs, outputs)
      end

      def call(result)
        index = selector.call(result)
        
        unless index && output = outputs[index] 
          raise SwitchError, "no switch target at index: #{index}"
        end

        dispatch(output, result)
      end
      
      # Raised by a Switch join to indicate when a switch index is out of bounds.
      class SwitchError < RuntimeError # :nodoc:
      end
    end
  end
end

Version data entries

4 entries across 4 versions & 1 rubygems

Version	Path
tap-0.19.0	lib/tap/joins/switch.rb
tap-0.18.0	lib/tap/joins/switch.rb
tap-0.17.0	lib/tap/joins/switch.rb
tap-0.17.1	lib/tap/joins/switch.rb