active_interaction 0.6.1 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: ddc5d64fad3052b09b16259d6aae6760411b384b
-  data.tar.gz: 1c3569cfc819b0153c2c875cf5674c29382fc956
+  metadata.gz: 4988ddb8d0259f53b92c2d8d81226902c0030d86
+  data.tar.gz: 8e36ae7a40b895596de17a7b94a5e568354dd686
 SHA512:
-  metadata.gz: 399f01cd79b55412083c29364afa80e53660e28ccbfc9d01788a138e30152ee61f4e6307e7a8f496a1b058557555ece132bf496b9e7d623b580e9414e203b030
-  data.tar.gz: c25734f3428395f3c063c7a6b1f867b65107dc806a7e5a391b38d8692fcd46a391cc8f3259aca4df2911bfb377fe45adb96393f7738eb2cfc7acde95cf401d86
+  metadata.gz: 7af4c2ad4e2ae219859035746672c653318d7fbf9de7fe50f857c2518852cf6b78d92cbaf2161702c2c489f065f60a3af3bd2e8b9fbe205791b805cdd5b39975
+  data.tar.gz: 6454349ce56378be4373257973c4ac710712299e963ebe165828eca0ef90d5b09f257c8ca6763ea5791f2217a95f3eac5253cd9ab7b5bc5fc8c31fc418275909

data/CHANGELOG.md

@@ -1,5 +1,11 @@
 # [Master][]
 
+# [0.7.0][] (2013-11-14)
+
+- Add ability to chain a series of interactions together with
+  `ActiveInteraction::Pipeline`.
+- Refactor internals (abstract filters & core class).
+
 # [0.6.1][] (2013-11-14)
 
 - Re-release. Forgot to merge into master.
@@ -70,7 +76,8 @@
 
 - Initial release.
 
-  [master]: https://github.com/orgsync/active_interaction/compare/v0.6.1...master
+  [master]: https://github.com/orgsync/active_interaction/compare/v0.7.0...master
+  [0.7.0]: https://github.com/orgsync/active_interaction/compare/v0.6.1...v0.7.0
   [0.6.1]: https://github.com/orgsync/active_interaction/compare/v0.6.0...v0.6.1
   [0.6.0]: https://github.com/orgsync/active_interaction/compare/v0.5.0...v0.6.0
   [0.5.0]: https://github.com/orgsync/active_interaction/compare/v0.4.0...v0.5.0

data/README.md

@@ -25,7 +25,7 @@ This project uses [semantic versioning][].
 Add it to your Gemfile:
 
 ```ruby
-gem 'active_interaction', '~> 0.6.1'
+gem 'active_interaction', '~> 0.7.0'
 ```
 
 And then execute:
@@ -200,6 +200,29 @@ end
 
 Check out the [documentation][] for a full list of methods.
 
+## How do I compose interactions?
+
+You can run many interactions in series by setting up a pipeline. Simply list
+the interactions you want to run with `pipe`. Transforming the output of an
+interaction into the input of the next one is accomplished with lambdas.
+
+```ruby
+pipeline = ActiveInteraction::Pipeline.new do
+  pipe Add
+  pipe Square, :x
+  pipe Add, -> result { { x: result, y: result } }
+end
+outcome = pipeline.run(x: 3, y: 5)
+outcome.result
+# => 128 # ((3 + 5) ** 2) * 2
+```
+
+The whole pipeline executes in a single transaction. The pipeline returns the
+outcome of the last successful interaction. An error in the pipeline will
+short-circuit and stop execution immediately.
+
+While pipelines are similar to interactions, the two are not substitutable.
+
 ## How do I translate an interaction?
 
 ActiveInteraction is i18n-aware out of the box! All you have to do

data/lib/active_interaction.rb

@@ -6,6 +6,8 @@ require 'active_interaction/active_model'
 require 'active_interaction/method_missing'
 require 'active_interaction/overload_hash'
 require 'active_interaction/filter'
+require 'active_interaction/filters/abstract_date_time_filter'
+require 'active_interaction/filters/abstract_numeric_filter'
 require 'active_interaction/filters/array_filter'
 require 'active_interaction/filters/boolean_filter'
 require 'active_interaction/filters/date_filter'
@@ -20,7 +22,9 @@ require 'active_interaction/filters/symbol_filter'
 require 'active_interaction/filters/time_filter'
 require 'active_interaction/filters'
 require 'active_interaction/validation'
+require 'active_interaction/core'
 require 'active_interaction/base'
+require 'active_interaction/pipeline'
 
 I18n.backend.load_translations(
   Dir.glob(File.join(%w(lib active_interaction locale *.yml)))

data/lib/active_interaction/active_model.rb

@@ -3,10 +3,15 @@ module ActiveInteraction
   module ActiveModel
     extend ::ActiveSupport::Concern
 
-    extend ::ActiveModel::Naming
     include ::ActiveModel::Conversion
     include ::ActiveModel::Validations
 
+    extend ::ActiveModel::Naming
+
+    def i18n_scope
+      self.class.i18n_scope
+    end
+
     def new_record?
       true
     end
@@ -15,10 +20,6 @@ module ActiveInteraction
       false
     end
 
-    def i18n_scope
-      self.class.i18n_scope
-    end
-
     # @private
     module ClassMethods
       def i18n_scope

data/lib/active_interaction/base.rb

@@ -1,10 +1,5 @@
 require 'active_support/core_ext/hash/indifferent_access'
 
-begin
-  require 'active_record'
-rescue LoadError
-end
-
 module ActiveInteraction
   # @abstract Subclass and override {#execute} to implement a custom
   #   ActiveInteraction class.
@@ -31,26 +26,12 @@ module ActiveInteraction
   #   end
   class Base
     include ActiveModel
+
+    extend Core
     extend MethodMissing
     extend OverloadHash
 
-    validate do
-      Validation.validate(self.class.filters, inputs).each do |error|
-        errors.add_sym(*error)
-      end
-    end
-
-    validate do
-      return unless instance_variable_defined?(:@_interaction_runtime_errors)
-
-      @_interaction_runtime_errors.symbolic.each do |attribute, symbols|
-        symbols.each { |symbol| errors.add_sym(attribute, symbol) }
-      end
-
-      @_interaction_runtime_errors.messages.each do |attribute, messages|
-        messages.each { |message| errors.add(attribute, message) }
-      end
-    end
+    validate :input_errors, :runtime_errors
 
     # Returns the inputs provided to {.run} or {.run!} after being cast based
     #   on the filters in the class.
@@ -120,18 +101,7 @@ module ActiveInteraction
 
     # @private
     def valid?(*args)
-      super || @_interaction_result = nil
-    end
-
-    # @private
-    def self.transaction
-      return unless block_given?
-
-      if defined?(ActiveRecord)
-        ::ActiveRecord::Base.transaction { yield }
-      else
-        yield
-      end
+      super(*args) || (@_interaction_result = nil)
     end
 
     # Get all the filters defined on this interaction.
@@ -164,26 +134,10 @@ module ActiveInteraction
       end
     end
 
-    # Like {.run} except that it returns the value of {#execute} or raises an
-    #   exception if there were any validation errors.
-    #
-    # @param (see .run)
-    #
-    # @return The return value of {#execute}.
-    #
-    # @raise [InteractionInvalidError] if there are any errors on the model.
-    def self.run!(*args)
-      outcome = run(*args)
-      if outcome.invalid?
-        raise InteractionInvalidError, outcome.errors.full_messages.join(', ')
-      end
-      outcome.result
-    end
-
     # @private
     def self.method_missing(*args, &block)
       super do |klass, names, options|
-        raise InvalidFilterError, 'no name' if names.empty?
+        raise InvalidFilterError, 'missing attribute name' if names.empty?
 
         names.each do |attribute|
           if attribute.to_s.start_with?('_interaction_')
@@ -194,9 +148,31 @@ module ActiveInteraction
           filters.add(filter)
           attr_accessor filter.name
 
+          # This isn't required, but it makes invalid defaults raise errors on
+          #   class definition instead of on execution.
           filter.default if filter.has_default?
         end
       end
     end
+
+    private
+
+    def input_errors
+      Validation.validate(self.class.filters, inputs).each do |error|
+        errors.add_sym(*error)
+      end
+    end
+
+    def runtime_errors
+      return unless instance_variable_defined?(:@_interaction_runtime_errors)
+
+      @_interaction_runtime_errors.symbolic.each do |attribute, symbols|
+        symbols.each { |symbol| errors.add_sym(attribute, symbol) }
+      end
+
+      @_interaction_runtime_errors.messages.each do |attribute, messages|
+        messages.each { |message| errors.add(attribute, message) }
+      end
+    end
   end
 end

data/lib/active_interaction/core.rb

@@ -0,0 +1,42 @@
+begin
+  require 'active_record'
+rescue LoadError
+end
+
+module ActiveInteraction
+  # Functionality common between {Base} and {Pipeline}.
+  #
+  # @see Base
+  # @see Pipeline
+  module Core
+    # Like {Base.run} except that it returns the value of {Base#execute} or
+    #   raises an exception if there were any validation errors.
+    #
+    # @param (see Base.run)
+    #
+    # @return [Object] the return value of {Base#execute}
+    #
+    # @raise [InvalidInteractionError] if the outcome is invalid
+    def run!(*args)
+      outcome = run(*args)
+
+      if outcome.valid?
+        outcome.result
+      else
+        raise InvalidInteractionError, outcome.errors.full_messages.join(', ')
+      end
+    end
+
+    private
+
+    def transaction(*args)
+      return unless block_given?
+
+      if defined?(ActiveRecord)
+        ::ActiveRecord::Base.transaction(*args) { yield }
+      else
+        yield
+      end
+    end
+  end
+end

data/lib/active_interaction/errors.rb

@@ -2,8 +2,8 @@ module ActiveInteraction
   # Top-level error class. All other errors subclass this.
   Error = Class.new(StandardError)
 
-  # Raised if an interaction is invalid.
-  InteractionInvalidError = Class.new(Error)
+  # Raised when trying to run an empty pipeline.
+  EmptyPipelineError = Class.new(Error)
 
   # Raised if a class name is invalid.
   InvalidClassError = Class.new(Error)
@@ -14,18 +14,21 @@ module ActiveInteraction
   # Raised if a filter has an invalid definition.
   InvalidFilterError = Class.new(Error)
 
+  # Raised if an interaction is invalid.
+  InvalidInteractionError = Class.new(Error)
+
   # Raised if a user-supplied value is invalid.
   InvalidValueError = Class.new(Error)
 
-  # Raised if there is no default value.
-  NoDefaultError = Class.new(Error)
-
   # Raised if a filter cannot be found.
   MissingFilterError = Class.new(Error)
 
   # Raised if no value is given.
   MissingValueError = Class.new(Error)
 
+  # Raised if there is no default value.
+  NoDefaultError = Class.new(Error)
+
   # A small extension to provide symbolic error messages to make introspecting
   #   and testing easier.
   #

data/lib/active_interaction/filter.rb

@@ -79,18 +79,12 @@ module ActiveInteraction
         match.captures.first.underscore.to_sym
       end
 
-      # @param klass [Class]
-      #
-      # @return [nil]
-      #
       # @private
       def inherited(klass)
         begin
           CLASSES[klass.slug] = klass
         rescue InvalidClassError
         end
-
-        super
       end
     end
 
@@ -129,7 +123,9 @@ module ActiveInteraction
     #
     # @return [Object]
     #
-    # @raise (see #cast)
+    # @raise [InvalidValueError] if the value is invalid
+    # @raise [MissingValueError] if the value is missing and the input is
+    #   required
     # @raise (see #default)
     #
     # @see #default
@@ -185,13 +181,6 @@ module ActiveInteraction
       options.has_key?(:default)
     end
 
-    # @param value [Object]
-    #
-    # @return [nil]
-    #
-    # @raise [InvalidValueError] if the value is invalid
-    # @raise [MissingValueError] if the value is missing and the input is required
-    #
     # @private
     def cast(value)
       case value

data/lib/active_interaction/filters/abstract_date_time_filter.rb

@@ -0,0 +1,37 @@
+module ActiveInteraction
+  # @private
+  class AbstractDateTimeFilter < Filter
+    def cast(value)
+      case value
+      when klass
+        value
+      when String
+        begin
+          if has_format?
+            klass.strptime(value, format)
+          else
+            klass.parse(value)
+          end
+        rescue ArgumentError
+          super
+        end
+      else
+        super
+      end
+    end
+
+    private
+
+    def format
+      options.fetch(:format)
+    end
+
+    def has_format?
+      options.has_key?(:format)
+    end
+
+    def klass
+      raise NotImplementedError
+    end
+  end
+end

data/lib/active_interaction/filters/abstract_numeric_filter.rb

@@ -0,0 +1,25 @@
+module ActiveInteraction
+  # @private
+  class AbstractNumericFilter < Filter
+    def cast(value)
+      case value
+      when klass
+        value
+      when Numeric, String
+        begin
+          send(klass.name, value)
+        rescue ArgumentError
+          super
+        end
+      else
+        super
+      end
+    end
+
+    private
+
+    def klass
+      raise NotImplementedError
+    end
+  end
+end

data/lib/active_interaction/filters/array_filter.rb

@@ -44,9 +44,15 @@ module ActiveInteraction
       super do |klass, names, options|
         filter = klass.new(name, options, &block)
 
-        raise InvalidFilterError, 'multiple nested filters' if filters.any?
-        raise InvalidFilterError, 'nested name' unless names.empty?
-        raise InvalidDefaultError, 'nested default' if filter.has_default?
+        if filters.any?
+          raise InvalidFilterError, 'multiple filters in array block'
+        end
+        unless names.empty?
+          raise InvalidFilterError, 'attribute names in array block'
+        end
+        if filter.has_default?
+          raise InvalidDefaultError, 'default values in array block'
+        end
 
         filters.add(filter)
       end

data/lib/active_interaction/filters/date_filter.rb

@@ -20,34 +20,11 @@ module ActiveInteraction
   end
 
   # @private
-  class DateFilter < Filter
-    def cast(value)
-      case value
-      when Date
-        value
-      when String
-        begin
-          if has_format?
-            Date.strptime(value, format)
-          else
-            Date.parse(value)
-          end
-        rescue ArgumentError
-          super
-        end
-      else
-        super
-      end
-    end
-
+  class DateFilter < AbstractDateTimeFilter
     private
 
-    def has_format?
-      options.has_key?(:format)
-    end
-
-    def format
-      options.fetch(:format)
+    def klass
+      Date
     end
   end
 end

data/lib/active_interaction/filters/date_time_filter.rb

@@ -20,34 +20,11 @@ module ActiveInteraction
   end
 
   # @private
-  class DateTimeFilter < Filter
-    def cast(value)
-      case value
-      when DateTime
-        value
-      when String
-        begin
-          if has_format?
-            DateTime.strptime(value, format)
-          else
-            DateTime.parse(value)
-          end
-        rescue ArgumentError
-          super
-        end
-      else
-        super
-      end
-    end
-
+  class DateTimeFilter < AbstractDateTimeFilter
     private
 
-    def has_format?
-      options.has_key?(:format)
-    end
-
-    def format
-      options.fetch(:format)
+    def klass
+      DateTime
     end
   end
 end

data/lib/active_interaction/filters/float_filter.rb

@@ -15,20 +15,11 @@ module ActiveInteraction
   end
 
   # @private
-  class FloatFilter < Filter
-    def cast(value)
-      case value
-      when Numeric
-        value.to_f
-      when String
-        begin
-          Float(value)
-        rescue ArgumentError
-          super
-        end
-      else
-        super
-      end
+  class FloatFilter < AbstractNumericFilter
+    private
+
+    def klass
+      Float
     end
   end
 end

data/lib/active_interaction/filters/hash_filter.rb

@@ -50,8 +50,8 @@ module ActiveInteraction
     end
 
     def method_missing(*args, &block)
-      super do |klass, names, options|
-        raise InvalidFilterError, 'no name' if names.empty?
+      super(*args) do |klass, names, options|
+        raise InvalidFilterError, 'missing attribute name' if names.empty?
 
         names.each do |name|
           filters.add(klass.new(name, options, &block))

data/lib/active_interaction/filters/integer_filter.rb

@@ -14,20 +14,11 @@ module ActiveInteraction
   end
 
   # @private
-  class IntegerFilter < Filter
-    def cast(value)
-      case value
-      when Numeric
-        value.to_i
-      when String
-        begin
-          Integer(value)
-        rescue ArgumentError
-          super
-        end
-      else
-        super
-      end
+  class IntegerFilter < AbstractNumericFilter
+    private
+
+    def klass
+      Integer
     end
   end
 end

data/lib/active_interaction/filters/time_filter.rb

@@ -21,23 +21,11 @@ module ActiveInteraction
   end
 
   # @private
-  class TimeFilter < Filter
+  class TimeFilter < AbstractDateTimeFilter
     def cast(value)
       case value
-      when klass
-        value
       when Numeric
         time.at(value)
-      when String
-        begin
-          if has_format?
-            klass.strptime(value, format)
-          else
-            klass.parse(value)
-          end
-        rescue ArgumentError
-          super
-        end
       else
         super
       end
@@ -45,14 +33,6 @@ module ActiveInteraction
 
     private
 
-    def format
-      options.fetch(:format)
-    end
-
-    def has_format?
-      options.has_key?(:format)
-    end
-
     def klass
       time.at(0).class
     end

data/lib/active_interaction/pipeline.rb

@@ -0,0 +1,91 @@
+begin
+  require 'active_record'
+rescue LoadError
+end
+
+module ActiveInteraction
+  # Compose interactions by piping them together.
+  #
+  # @since 0.7.0
+  class Pipeline
+    include Core
+
+    # Set up a pipeline with a series of interactions.
+    #
+    # @example
+    #   ActiveInteraction::Pipeline.new do
+    #     pipe InteractionOne
+    #     pipe InteractionTwo
+    #   end
+    def initialize(&block)
+      @steps = []
+      instance_eval(&block) if block_given?
+    end
+
+    # Add an interaction to the end of the pipeline.
+    #
+    # @example With a lambda
+    #   pipe Interaction, -> result { { a: result, b: result } }
+    #
+    # @example With a symbol
+    #   pipe Interaction, :thing
+    #   # -> result { { thing: result } }
+    #
+    # @example With nil
+    #   pipe Interaction
+    #   # -> result { result }
+    #
+    # @param interaction [Base] the interaction to add
+    # @param function [Proc] a function to convert the output of an interaction
+    #   into the input for the next one
+    # @param function [Symbol] a shortcut for creating a function that puts the
+    #   output into a hash with this key
+    # @param function [nil] a shortcut for creating a function that passes the
+    #   output straight through
+    #
+    # @return [Pipeline]
+    def pipe(interaction, function = nil)
+      @steps << [lambdafy(function), interaction]
+      self
+    end
+
+    # Run all the interactions in the pipeline. If any interaction fails, stop
+    #   and return immediately without running any more interactions.
+    #
+    # @param (see Base.run)
+    #
+    # @return [Base] an instance of the last successful interaction in the
+    #   pipeline
+    #
+    # @raise [EmptyPipelineError] if nothing is in the pipeline
+    def run(*args)
+      raise EmptyPipelineError if @steps.empty?
+      transaction do
+        function, interaction = @steps.first
+        outcome = interaction.run(function.call(*args))
+        @steps[1..-1].reduce(outcome) { |o, (f, i)| bind(o, f, i) }
+      end
+    end
+
+    private
+
+    def bind(outcome, function, interaction)
+      if outcome.valid?
+        interaction.run(function.call(outcome.result))
+      else
+        outcome
+      end
+    end
+
+    def lambdafy(thing)
+      case thing
+      when NilClass
+        -> result { result }
+      when Symbol
+        -> result { { thing => result } }
+      else
+        thing
+      end
+    end
+  end
+end

data/lib/active_interaction/version.rb

@@ -1,3 +1,3 @@
 module ActiveInteraction
-  VERSION = Gem::Version.new('0.6.1')
+  VERSION = Gem::Version.new('0.7.0')
 end

data/spec/active_interaction/base_spec.rb

@@ -234,24 +234,6 @@ describe ActiveInteraction::Base do
           expect(described_class).to have_received(:transaction).once.
             with(no_args)
         end
-
-        context 'with ActiveRecord' do
-          before do
-            ActiveRecord = Class.new
-            ActiveRecord::Base = double
-            allow(ActiveRecord::Base).to receive(:transaction)
-          end
-
-          after do
-            Object.send(:remove_const, :ActiveRecord)
-          end
-
-          it 'calls ActiveRecord::Base.transaction' do
-            outcome
-            expect(ActiveRecord::Base).to have_received(:transaction).once.
-              with(no_args)
-          end
-        end
       end
     end
 
@@ -262,7 +244,7 @@ describe ActiveInteraction::Base do
         it 'raises an error' do
           expect {
             result
-          }.to raise_error ActiveInteraction::InteractionInvalidError
+          }.to raise_error ActiveInteraction::InvalidInteractionError
         end
       end
 

data/spec/active_interaction/core_spec.rb

@@ -0,0 +1,97 @@
+require 'spec_helper'
+
+describe ActiveInteraction::Core do
+  let(:model) do
+    Class.new do
+      include ActiveInteraction::Core
+    end
+  end
+
+  subject(:instance) { model.new }
+
+  describe '#run!' do
+    let(:errors) { double(full_messages: []) }
+    let(:outcome) { double(errors: errors, result: result) }
+    let(:result) { double }
+
+    before do
+      allow(instance).to receive(:run).and_return(outcome)
+    end
+
+    shared_examples '#run!' do
+      let(:options) { double }
+
+      it 'calls #run' do
+        expect(instance).to receive(:run).once.with(options)
+        instance.run!(options) rescue nil
+      end
+    end
+
+    context 'with invalid outcome' do
+      include_examples '#run!'
+
+      before do
+        allow(outcome).to receive(:valid?).and_return(false)
+      end
+
+      it 'raises an error' do
+        expect {
+          instance.run!
+        }.to raise_error ActiveInteraction::InvalidInteractionError
+      end
+    end
+
+    context 'with valid outcome' do
+      include_examples '#run!'
+
+      before do
+        allow(outcome).to receive(:valid?).and_return(true)
+      end
+
+      it 'returns the result' do
+        expect(instance.run!).to eq result
+      end
+    end
+  end
+
+  describe '#transaction' do
+    context 'without ActiveRecord' do
+      it 'returns nil' do
+        expect(instance.send(:transaction)).to be_nil
+      end
+
+      it 'yields' do
+        expect { |b| instance.send(:transaction, &b) }.to yield_control
+      end
+    end
+
+    context 'with ActiveRecord' do
+      before do
+        ActiveRecord = Class.new
+        ActiveRecord::Base = double
+        allow(ActiveRecord::Base).to receive(:transaction)
+      end
+
+      after do
+        Object.send(:remove_const, :ActiveRecord)
+      end
+
+      it 'returns nil' do
+        expect(instance.send(:transaction)).to be_nil
+      end
+
+      it 'calls ActiveRecord::Base#transaction' do
+        block = Proc.new {}
+        expect(ActiveRecord::Base).to receive(:transaction).once.with(no_args)
+        instance.send(:transaction, &block)
+      end
+
+      it 'calls ActiveRecord::Base#transaction' do
+        args = [:a, :b, :c]
+        block = Proc.new {}
+        expect(ActiveRecord::Base).to receive(:transaction).once.with(*args)
+        instance.send(:transaction, *args, &block)
+      end
+    end
+  end
+end

data/spec/active_interaction/pipeline_spec.rb

@@ -0,0 +1,117 @@
+require 'spec_helper'
+
+describe ActiveInteraction::Pipeline do
+  let(:invalid_interaction) do
+    Class.new(TestInteraction) do
+      float :a
+      validates :a, inclusion: { in: [] }
+      def execute; a end
+    end
+  end
+
+  let(:square_interaction) do
+    Class.new(TestInteraction) do
+      float :a
+      def execute; a ** 2 end
+    end
+  end
+
+  let(:swap_interaction) do
+    Class.new(TestInteraction) do
+      float :a, :b
+      def execute; { a: b, b: a } end
+    end
+  end
+
+  it 'raises an error with no pipes' do
+    pipeline = described_class.new
+    expect {
+      pipeline.run
+    }.to raise_error ActiveInteraction::EmptyPipelineError
+  end
+
+  it 'returns an invalid outcome with one invalid pipe' do
+    interaction = invalid_interaction
+    pipeline = described_class.new do
+      pipe interaction
+    end
+
+    options = { a: rand }
+    expect(pipeline.run(options)).to be_invalid
+  end
+
+  it 'succeeds with one pipe' do
+    interaction = swap_interaction
+    pipeline = described_class.new do
+      pipe interaction
+    end
+
+    options = { a: rand, b: rand }
+    expect(pipeline.run(options).result).to eq(a: options[:b], b: options[:a])
+  end
+
+  it 'succeeds with two pipes' do
+    interaction = swap_interaction
+    pipeline = described_class.new do
+      pipe interaction
+      pipe interaction
+    end
+
+    options = { a: rand, b: rand }
+    expect(pipeline.run(options).result).to eq options
+  end
+
+  it 'succeeds with an implicit transformation' do
+    interaction = square_interaction
+    pipeline = described_class.new do
+      pipe interaction
+    end
+
+    options = { a: rand }
+    expect(pipeline.run(options).result).to eq options[:a] ** 2
+  end
+
+  it 'succeeds with a symbolic transformation' do
+    interaction = square_interaction
+    pipeline = described_class.new do
+      pipe interaction, :a
+    end
+
+    options = rand
+    expect(pipeline.run(options).result).to eq options ** 2
+  end
+
+  it 'succeeds with a lambda transformation' do
+    interaction = square_interaction
+    pipeline = described_class.new do
+      pipe interaction, -> result { { a: 2 * result } }
+    end
+
+    options = rand
+    expect(pipeline.run(options).result).to eq (2 * options) ** 2
+  end
+
+  describe '#run!' do
+    it 'raises an error with one invalid pipe' do
+      interaction = invalid_interaction
+      pipeline = described_class.new do
+        pipe interaction
+      end
+
+      options = { a: rand }
+      expect {
+        pipeline.run!(options)
+      }.to raise_error ActiveInteraction::InvalidInteractionError
+    end
+
+    it 'returns the outcome with one valid pipe' do
+      interaction = square_interaction
+      pipeline = described_class.new do
+        pipe interaction
+      end
+
+      options = { a: rand }
+      expect(pipeline.run!(options)).to eq options[:a] ** 2
+    end
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: active_interaction
 version: !ruby/object:Gem::Version
-  version: 0.6.1
+  version: 0.7.0
 platform: ruby
 authors:
 - Aaron Lasseigne
@@ -153,8 +153,11 @@ extra_rdoc_files: []
 files:
 - lib/active_interaction/active_model.rb
 - lib/active_interaction/base.rb
+- lib/active_interaction/core.rb
 - lib/active_interaction/errors.rb
 - lib/active_interaction/filter.rb
+- lib/active_interaction/filters/abstract_date_time_filter.rb
+- lib/active_interaction/filters/abstract_numeric_filter.rb
 - lib/active_interaction/filters/array_filter.rb
 - lib/active_interaction/filters/boolean_filter.rb
 - lib/active_interaction/filters/date_filter.rb
@@ -170,11 +173,13 @@ files:
 - lib/active_interaction/filters.rb
 - lib/active_interaction/method_missing.rb
 - lib/active_interaction/overload_hash.rb
+- lib/active_interaction/pipeline.rb
 - lib/active_interaction/validation.rb
 - lib/active_interaction/version.rb
 - lib/active_interaction.rb
 - spec/active_interaction/active_model_spec.rb
 - spec/active_interaction/base_spec.rb
+- spec/active_interaction/core_spec.rb
 - spec/active_interaction/errors_spec.rb
 - spec/active_interaction/filter_spec.rb
 - spec/active_interaction/filters/array_filter_spec.rb
@@ -205,6 +210,7 @@ files:
 - spec/active_interaction/integration/time_interaction_spec.rb
 - spec/active_interaction/method_missing_spec.rb
 - spec/active_interaction/overload_hash_spec.rb
+- spec/active_interaction/pipeline_spec.rb
 - spec/active_interaction/validation_spec.rb
 - spec/spec_helper.rb
 - spec/support/filters.rb
@@ -232,13 +238,14 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.1.10
+rubygems_version: 2.1.11
 signing_key: 
 specification_version: 4
 summary: Manage application specific business logic.
 test_files:
 - spec/active_interaction/active_model_spec.rb
 - spec/active_interaction/base_spec.rb
+- spec/active_interaction/core_spec.rb
 - spec/active_interaction/errors_spec.rb
 - spec/active_interaction/filter_spec.rb
 - spec/active_interaction/filters/array_filter_spec.rb
@@ -269,6 +276,7 @@ test_files:
 - spec/active_interaction/integration/time_interaction_spec.rb
 - spec/active_interaction/method_missing_spec.rb
 - spec/active_interaction/overload_hash_spec.rb
+- spec/active_interaction/pipeline_spec.rb
 - spec/active_interaction/validation_spec.rb
 - spec/spec_helper.rb
 - spec/support/filters.rb