activeinteractor 1.0.0.beta.5 → 1.0.0.beta.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4d3d5616823da9559ae98eab086893b6daf7b9030b6baa2cf1cf29c0bc5b4ea3
-  data.tar.gz: e97629bee106e82dc438c227354f9ef598c8c1945f8f28a0a03e99e012e86ece
+  metadata.gz: 2607fe1a40ac6e082fa6d3bb2ffb59c0987226c8e88a01cfd9f66329bf2439d3
+  data.tar.gz: 2fc83930cd1bc7f011e63b78028d0ba658f29dcbfc9001469b5168b15a6c25de
 SHA512:
-  metadata.gz: 6f0b4ebbf1e49d32536d07b52e4d92608df89a4413a215edb1c4f330da2ad5f4e63b6c1e7eff908bd93f74ecb42f5a7e5a829df3ddab86d4aa739c1dfbf0f89c
-  data.tar.gz: 2666da64595c132aa988c3b7818c4bee589935d826a4e9d480ab5467a31e9c45106f6ca1aaee4b4a0069f95c411c420472535a723409d9f369b6c5c239bacea2
+  metadata.gz: 1a6d8e00458fce9b81929008eadd2a8d0c83a1dde70c0ca4cd65130fb8d3ab6b51a1c123db707baa777af618fb8c86924a067b5eb8c3baba6463e095b3abd21c
+  data.tar.gz: 1e9e136432675755607b891c54d9a2d50cfbd67b79ab17bd48e63981331da099a223009b3e40d8067b05049a00258cac406190adf221cf178df2d4be47d63cc5

data/CHANGELOG.md

@@ -7,6 +7,18 @@ and this project adheres to [Semantic Versioning].
 
 ## [Unreleased]
 
+## [v1.0.0-beta.6] - 2020-01-21
+
+### Added
+
+- [#124] `ActiveInteractor::Context::Status`
+- [#124] `ActiveInteractor::Rails::ActiveRecord`
+
+### Changed
+
+- [#124] Abstracted status methods from `ActiveInteractor::Context::Base`
+  into `ActiveInteractor::Context::Status`
+
 ## [v1.0.0-beta.5] - 2020-01-21
 
 ### Added
@@ -182,7 +194,8 @@ and this project adheres to [Semantic Versioning].
 
 <!-- versions -->
 
-[Unreleased]: https://github.com/aaronmallen/activeinteractor/compare/v1.0.0-beta.5...HEAD
+[Unreleased]: https://github.com/aaronmallen/activeinteractor/compare/v1.0.0-beta.6...HEAD
+[v1.0.0-beta.6]: https://github.com/aaronmallen/activeinteractor/compare/v1.0.0-beta.5...v1.0.0-beta.6
 [v1.0.0-beta.5]: https://github.com/aaronmallen/activeinteractor/compare/v1.0.0-beta.4...v1.0.0-beta.5
 [v1.0.0-beta.4]: https://github.com/aaronmallen/activeinteractor/compare/v1.0.0-beta.3...v1.0.0-beta.4
 [v1.0.0-beta.3]: https://github.com/aaronmallen/activeinteractor/compare/v1.0.0-beta.2...v1.0.0-beta.3
@@ -218,6 +231,7 @@ and this project adheres to [Semantic Versioning].
 [#105]: https://github.com/aaronmallen/activeinteractor/pull/105
 [#109]: https://github.com/aaronmallen/activeinteractor/pull/109
 [#110]: https://github.com/aaronmallen/activeinteractor/pull/110
-[#114]:https://github.com/aaronmallen/activeinteractor/pull/114
+[#114]: https://github.com/aaronmallen/activeinteractor/pull/114
 [#115]: https://github.com/aaronmallen/activeinteractor/pull/115
 [#122]: https://github.com/aaronmallen/activeinteractor/pull/122
+[#124]: https://github.com/aaronmallen/activeinteractor/pull/124

data/README.md

@@ -37,6 +37,8 @@ see [v0.1.7](https://github.com/aaronmallen/activeinteractor/tree/0-1-stable)**
       * [Rollback Callbacks](#rollback-callbacks)
       * [Organizer Callbacks](#organizer-callbacks)
 * [Working With Rails](#working-with-rails)
+  * [Generators](#generators)
+  * [ActiveRecord Helper Methods](#activerecord-helper-methods)
 * [Development](#development)
 * [Contributing](#contributing)
 * [Acknowledgements](#acknowledgements)
@@ -49,7 +51,7 @@ see [v0.1.7](https://github.com/aaronmallen/activeinteractor/tree/0-1-stable)**
 Add this line to your application's Gemfile:
 
 ```ruby
-gem 'activeinteractor', '~> 1.0.0.beta.5'
+gem 'activeinteractor', '~> 1.0.0.beta.6'
 ```
 
 And then execute:
@@ -835,7 +837,10 @@ application (defaults to 'interactors').
 This will create an initializer a some new classes `ApplicationInteractor`, `ApplicationOrganizer` and
 `ApplicationContext` in the `app/<directory>` directory.
 
-You can then automatically generate interactors, organizers, and contexts with:
+### Generators
+
+ActiveInteractor comes bundled with some rails generators to automatically generate interactors,
+organizers, and contexts with:
 
 ```bash
 rails generate interactor MyInteractor
@@ -851,6 +856,32 @@ rails generate interactor:context MyContext
 
 These generators will automatically create the approriate classes and matching spec or test files.
 
+### ActiveRecord Helper Methods
+
+In some instances you may want to use an `ActiveRecord` model as a context for an interactor.  You can
+do this by calling the `acts_as_context` method on any `ActiveRecord` model, and then simply call the
+`contextualize_with` method on your interactor or organizer to point it to the approriate class.
+
+```ruby
+# app/models/user
+class User < ApplicationRecord
+  acts_as_context
+end
+
+# app/interactors/create_user
+class CreateUser < ApplicationInteractor
+  contextualize_with :user
+
+  def perform
+    context.email&.downcase!
+    context.save
+  end
+end
+
+CreateUser.perform(email: 'HELLO@AARONMALLEN.ME')
+#=> <#User id=1 email='hello@aaronmallen.me'>
+```
+
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests.

data/lib/active_interactor/context/base.rb

@@ -14,6 +14,7 @@ module ActiveInteractor
     class Base < OpenStruct
       include ActiveModel::Validations
       include Attributes
+      include Status
 
       # @param context [Hash|Context::Base] attributes to assign to the context
       # @return [Context::Base] a new instance of {Context::Base}
@@ -29,58 +30,6 @@ module ActiveInteractor
       #   https://github.com/rails/rails/blob/master/activemodel/lib/active_model/validations.rb#L305
       #   ActiveModel::Validations#valid?
 
-      # @api private
-      # Track that an Interactor has been called. The {#called!} method
-      #  is used by the interactor being invoked with this context. After an
-      #  interactor is successfully called, the interactor instance is tracked in
-      #  the context for the purpose of potential future rollback
-      # @param interactor [ActiveInteractor::Base] the called interactor
-      # @return [Array<ActiveInteractor::Base>] all called interactors
-      def called!(interactor)
-        _called << interactor
-      end
-
-      # Fail the context instance. Failing a context raises an error
-      #  that may be rescued by the calling interactor. The context is also flagged
-      #  as having failed
-      #
-      # @example Fail an interactor context
-      #   class MyInteractor < ActiveInteractor::Base
-      #     def perform
-      #       context.fail!
-      #     end
-      #   end
-      #
-      #   MyInteractor.perform!
-      #   #=> ActiveInteractor::Error::ContextFailure: <#MyInteractor::Context>
-      # @param errors [ActiveModel::Errors|nil] errors to add to the context on failure
-      # @see https://api.rubyonrails.org/classes/ActiveModel/Errors.html ActiveModel::Errors
-      # @raise [Error::ContextFailure]
-      def fail!(errors = nil)
-        merge_errors!(errors) if errors
-        @_failed = true
-        raise Error::ContextFailure, self
-      end
-
-      # Whether the context instance has failed. By default, a new
-      # context is successful and only changes when explicitly failed
-      # @note The {#failure?} method is the inverse of the {#success?} method
-      # @example Check if a context has failed
-      #   class MyInteractor < ActiveInteractor::Base
-      #     def perform; end
-      #   end
-      #
-      #   result = MyInteractor.perform
-      #   #=> <#MyInteractor::Context>
-      #
-      #   result.failure?
-      #   #=> false
-      # @return [Boolean] `false` by default or `true` if failed
-      def failure?
-        @_failed || false
-      end
-      alias fail? failure?
-
       # Merge an instance of context or a hash into an existing context
       # @since 1.0.0
       # @example
@@ -112,75 +61,8 @@ module ActiveInteractor
         self
       end
 
-      # Roll back an interactor context. Any interactors to which this
-      # context has been passed and which have been successfully called are asked
-      # to roll themselves back by invoking their
-      # {ActiveInteractor::Base#rollback} instance methods.
-      # @example Rollback an interactor's context
-      #   class MyInteractor < ActiveInteractor::Base
-      #     def perform
-      #       context.fail!
-      #     end
-      #
-      #     def rollback
-      #       context.user&.destroy
-      #     end
-      #   end
-      #
-      #   user = User.create
-      #   #=> <#User>
-      #
-      #   result = MyInteractor.perform(user: user)
-      #   #=> <#MyInteractor::Context user=<#User>>
-      #
-      #   result.user.destroyed?
-      #   #=> true
-      # @return [Boolean] `true` if rolled back successfully or `false` if already
-      #  rolled back
-      def rollback!
-        return false if @_rolled_back
-
-        _called.reverse_each(&:rollback)
-        @_rolled_back = true
-      end
-
-      # Whether the context instance is successful. By default, a new
-      # context is successful and only changes when explicitly failed
-      # @note the {#success?} method is the inverse of the {#failure?} method
-      # @example Check if a context is successful
-      #   class MyInteractor < ActiveInteractor::Base
-      #     def perform; end
-      #   end
-      #
-      #   result = MyInteractor.perform
-      #   #=> <#MyInteractor::Context>
-      #
-      #   result.success?
-      #   #=> true
-      # @return [Boolean] `true` by default or `false` if failed
-      def success?
-        !failure?
-      end
-      alias successful? success?
-
       private
 
-      def _called
-        @_called ||= []
-      end
-
-      def copy_called!(context)
-        value = context.instance_variable_get('@_called') || []
-        instance_variable_set('@_called', value)
-      end
-
-      def copy_flags!(context)
-        %w[_failed _rolled_back].each do |flag|
-          value = context.instance_variable_get("@#{flag}")
-          instance_variable_set("@#{flag}", value)
-        end
-      end
-
       def merge_errors!(errors)
         if errors.is_a? String
           self.errors.add(:context, errors)

data/lib/active_interactor/context/status.rb

@@ -0,0 +1,131 @@
+# frozen_string_literal: true
+
+module ActiveInteractor
+  module Context
+    # Context status methods included by all {Context::Base}
+    # @author Aaron Allen <hello@aaronmallen.me>
+    # @since 1.0.0
+    module Status
+      # @api private
+      # Track that an Interactor has been called. The {#called!} method
+      #  is used by the interactor being invoked with this context. After an
+      #  interactor is successfully called, the interactor instance is tracked in
+      #  the context for the purpose of potential future rollback
+      # @param interactor [ActiveInteractor::Base] the called interactor
+      # @return [Array<ActiveInteractor::Base>] all called interactors
+      def called!(interactor)
+        _called << interactor
+      end
+
+      # Fail the context instance. Failing a context raises an error
+      #  that may be rescued by the calling interactor. The context is also flagged
+      #  as having failed
+      #
+      # @example Fail an interactor context
+      #   class MyInteractor < ActiveInteractor::Base
+      #     def perform
+      #       context.fail!
+      #     end
+      #   end
+      #
+      #   MyInteractor.perform!
+      #   #=> ActiveInteractor::Error::ContextFailure: <#MyInteractor::Context>
+      # @param errors [ActiveModel::Errors|nil] errors to add to the context on failure
+      # @see https://api.rubyonrails.org/classes/ActiveModel/Errors.html ActiveModel::Errors
+      # @raise [Error::ContextFailure]
+      def fail!(errors = nil)
+        merge_errors!(errors) if errors
+        @_failed = true
+        raise Error::ContextFailure, self
+      end
+
+      # Whether the context instance has failed. By default, a new
+      # context is successful and only changes when explicitly failed
+      # @note The {#failure?} method is the inverse of the {#success?} method
+      # @example Check if a context has failed
+      #   class MyInteractor < ActiveInteractor::Base
+      #     def perform; end
+      #   end
+      #
+      #   result = MyInteractor.perform
+      #   #=> <#MyInteractor::Context>
+      #
+      #   result.failure?
+      #   #=> false
+      # @return [Boolean] `false` by default or `true` if failed
+      def failure?
+        @_failed || false
+      end
+      alias fail? failure?
+
+      # Roll back an interactor context. Any interactors to which this
+      # context has been passed and which have been successfully called are asked
+      # to roll themselves back by invoking their
+      # {ActiveInteractor::Base#rollback} instance methods.
+      # @example Rollback an interactor's context
+      #   class MyInteractor < ActiveInteractor::Base
+      #     def perform
+      #       context.fail!
+      #     end
+      #
+      #     def rollback
+      #       context.user&.destroy
+      #     end
+      #   end
+      #
+      #   user = User.create
+      #   #=> <#User>
+      #
+      #   result = MyInteractor.perform(user: user)
+      #   #=> <#MyInteractor::Context user=<#User>>
+      #
+      #   result.user.destroyed?
+      #   #=> true
+      # @return [Boolean] `true` if rolled back successfully or `false` if already
+      #  rolled back
+      def rollback!
+        return false if @_rolled_back
+
+        _called.reverse_each(&:rollback)
+        @_rolled_back = true
+      end
+
+      # Whether the context instance is successful. By default, a new
+      # context is successful and only changes when explicitly failed
+      # @note the {#success?} method is the inverse of the {#failure?} method
+      # @example Check if a context is successful
+      #   class MyInteractor < ActiveInteractor::Base
+      #     def perform; end
+      #   end
+      #
+      #   result = MyInteractor.perform
+      #   #=> <#MyInteractor::Context>
+      #
+      #   result.success?
+      #   #=> true
+      # @return [Boolean] `true` by default or `false` if failed
+      def success?
+        !failure?
+      end
+      alias successful? success?
+
+      private
+
+      def _called
+        @_called ||= []
+      end
+
+      def copy_called!(context)
+        value = context.instance_variable_get('@_called') || []
+        instance_variable_set('@_called', value)
+      end
+
+      def copy_flags!(context)
+        %w[_failed _rolled_back].each do |flag|
+          value = context.instance_variable_get("@#{flag}")
+          instance_variable_set("@#{flag}", value)
+        end
+      end
+    end
+  end
+end

data/lib/active_interactor/rails/active_record.rb

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+
+module ActiveInteractor
+  module Rails
+    # ActiveRecord helper methods
+    # @author Aaron Allen <hello@aaronmallen.me>
+    # @since 1.0.0
+    module ActiveRecord
+      # Include ActiveRecord helper methods on load
+      def self.include_helpers
+        ActiveSupport.on_load(:active_record_base) do
+          extend ClassMethods
+        end
+      end
+
+      # ActiveRecord class helper methods
+      # @author Aaron Allen <hello@aaronmallen.me>
+      # @since 1.0.0
+      module ClassMethods
+        # Include {Context::Status} methods
+        def acts_as_context
+          class_eval do
+            include InstanceMethods
+            include ActiveInteractor::Context::Status
+            delegate :each_pair, to: :attributes
+          end
+        end
+      end
+
+      module InstanceMethods
+        # Override ActiveRecord's initialize method to ensure
+        #  context flags are copied to the new instance
+        # @param context [Hash|nil] attributes to assign to the class
+        # @param options [Hash|nil] options for the class
+        def initialize(context = nil, options = {})
+          copy_flags!(context) if context
+          copy_called!(context) if context
+          attributes = context.to_h if context
+          super(attributes, options)
+        end
+
+        # Merge an ActiveRecord::Base instance and ensure
+        #  context flags are copied to the new instance
+        # @param context [*] the instance to be merged
+        # @return [*] the merged instance
+        def merge!(context)
+          copy_flags!(context)
+          context.each_pair do |key, value|
+            self[key] = value
+          end
+          self
+        end
+      end
+    end
+  end
+end

data/lib/active_interactor/rails/railtie.rb

@@ -14,6 +14,10 @@ module ActiveInteractor
 
       config.eager_load_namespaces << ActiveInteractor
 
+      initializer 'active_interactor.active_record_helpers' do
+        ActiveInteractor::Rails::ActiveRecord.include_helpers
+      end
+
       config.to_prepare do
         ActiveInteractor.configure do |c|
           c.logger = ::Rails.logger

data/lib/active_interactor/rails.rb

@@ -1,8 +1,7 @@
 # frozen_string_literal: true
 
-require 'rails'
-
 require 'active_interactor'
+require 'active_interactor/rails/active_record'
 require 'active_interactor/rails/config'
 require 'active_interactor/rails/railtie'
 

data/lib/active_interactor/version.rb

@@ -2,5 +2,5 @@
 
 module ActiveInteractor
   # @return [String] the ActiveInteractor version
-  VERSION = '1.0.0.beta.5'
+  VERSION = '1.0.0.beta.6'
 end

data/lib/active_interactor.rb

@@ -28,7 +28,18 @@ module ActiveInteractor
   extend ActiveSupport::Autoload
 
   autoload :Base
-  autoload :Context
+
+  # ActiveInteractor::Context classes
+  # @author Aaron Allen <hello@aaronmallen.me>
+  # @since 0.0.1
+  module Context
+    extend ActiveSupport::Autoload
+
+    autoload :Base
+    autoload :Loader
+    autoload :Status
+  end
+
   autoload :Organizer
 
   eager_autoload do

data/spec/active_interactor/rails/active_record_spec.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+begin
+  require 'active_interactor/rails'
+
+  RSpec.describe ActiveInteractor::Rails::ActiveRecord do
+    describe '.include_helpers' do
+      subject { described_class.include_helpers }
+      let!(:active_record_mock) { build_class('ActiveRecordBaseMock') }
+
+      it 'is expected to extend ClassMethods' do
+        subject
+        ActiveSupport.run_load_hooks(:active_record_base, active_record_mock)
+        expect(active_record_mock).to respond_to :acts_as_context
+      end
+    end
+  end
+rescue LoadError
+  RSpec.describe 'ActiveInteractor::Rails::ActiveRecord' do
+    pending 'Rails not found skipping specs...'
+  end
+end

data/spec/active_interactor/rails/config_spec.rb

@@ -1,23 +1,29 @@
 # frozen_string_literal: true
 
 require 'spec_helper'
-require 'active_interactor/rails'
+begin
+  require 'active_interactor/rails'
 
-RSpec.describe ActiveInteractor::Rails::Config do
-  subject { described_class.new }
+  RSpec.describe ActiveInteractor::Rails::Config do
+    subject { described_class.new }
 
-  it { is_expected.to respond_to :directory }
-  it { is_expected.to respond_to :generate_context_classes }
+    it { is_expected.to respond_to :directory }
+    it { is_expected.to respond_to :generate_context_classes }
 
-  describe '.defaults' do
-    subject { described_class.defaults }
+    describe '.defaults' do
+      subject { described_class.defaults }
 
-    it 'is expected to have attributes :directory => "interactors"' do
-      expect(subject[:directory]).to eq 'interactors'
-    end
+      it 'is expected to have attributes :directory => "interactors"' do
+        expect(subject[:directory]).to eq 'interactors'
+      end
 
-    it 'is expected to have attributes :generate_context_classes => true' do
-      expect(subject[:generate_context_classes]).to eq true
+      it 'is expected to have attributes :generate_context_classes => true' do
+        expect(subject[:generate_context_classes]).to eq true
+      end
     end
   end
+rescue LoadError
+  RSpec.describe 'ActiveInteractor::Rails::Config' do
+    pending 'Rails not found skipping specs...'
+  end
 end

data/spec/active_interactor/rails_spec.rb

@@ -1,18 +1,24 @@
 # frozen_string_literal: true
 
 require 'spec_helper'
-require 'active_interactor/rails'
+begin
+  require 'active_interactor/rails'
 
-RSpec.describe ActiveInteractor::Rails do
-  describe '.config' do
-    subject { described_class.config }
+  RSpec.describe ActiveInteractor::Rails do
+    describe '.config' do
+      subject { described_class.config }
 
-    it { is_expected.to be_a ActiveInteractor::Rails::Config }
-  end
+      it { is_expected.to be_a ActiveInteractor::Rails::Config }
+    end
 
-  describe '.configure' do
-    it 'is expected to yield config' do
-      expect { |b| described_class.configure(&b) }.to yield_control
+    describe '.configure' do
+      it 'is expected to yield config' do
+        expect { |b| described_class.configure(&b) }.to yield_control
+      end
     end
   end
+rescue LoadError
+  RSpec.describe 'ActiveInteractor::Rails' do
+    pending 'Rails not found skipping specs...'
+  end
 end

data/spec/integration/active_record_integration_spec.rb

@@ -0,0 +1,369 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+begin
+  require 'active_interactor/rails'
+
+  RSpec.describe 'ActiveRecord Integration', type: :integration do
+    let!(:active_record_base_mock) do
+      build_class('ActiveRecordBaseMock') do
+        def self.attr_accessor(*attributes)
+          attribute_keys.concat(attributes.map(&:to_sym))
+          super
+        end
+
+        def self.attribute_keys
+          @attribute_keys ||= []
+        end
+
+        def initialize(attributes = nil, _options = {})
+          (attributes || {}).each do |key, value|
+            instance_variable_set("@#{key}", value)
+          end
+        end
+
+        def [](name)
+          instance_variable_get("@#{name}")
+        end
+
+        def []=(name, value)
+          instance_variable_set("@#{name}", value)
+        end
+
+        def attributes
+          self.class.attribute_keys.each_with_object({}) do |key, hash|
+            hash[key] = instance_variable_get("@#{key}")
+          end
+        end
+
+        def to_h
+          attributes.to_h
+        end
+      end
+    end
+
+    context 'after ActiveInteractor::Rails::ActiveRecord.include_helpers has been invoked' do
+      before { ActiveInteractor::Rails::ActiveRecord.include_helpers }
+
+      context 'after ActiveSupport.run_load_hooks has been invoked with :active_record_base' do
+        before { ActiveSupport.run_load_hooks(:active_record_base, active_record_base_mock) }
+
+        describe 'an ActiveRecord model class with .acts_as_context' do
+          let(:model_mock) do
+            build_class('ModelMock', active_record_base_mock) do
+              attr_accessor :foo
+              acts_as_context
+            end
+          end
+
+          describe 'as an instance' do
+            subject { model_mock.new }
+
+            it { is_expected.to respond_to :called! }
+            it { is_expected.to respond_to :fail! }
+            it { is_expected.to respond_to :fail? }
+            it { is_expected.to respond_to :failure? }
+            it { is_expected.to respond_to :merge! }
+            it { is_expected.to respond_to :rollback! }
+            it { is_expected.to respond_to :success? }
+            it { is_expected.to respond_to :successful? }
+          end
+
+          describe '.new' do
+            subject { model_mock.new(attributes) }
+            let(:attributes) { nil }
+
+            it 'is expected not to receive #copy_flags!' do
+              expect_any_instance_of(model_mock).not_to receive(:copy_flags!)
+              subject
+            end
+
+            it 'is expected not to receive #copy_called!' do
+              expect_any_instance_of(model_mock).not_to receive(:copy_called!)
+              subject
+            end
+
+            it 'is expected to invoke super on parent class with nil attributes' do
+              expect(active_record_base_mock).to receive(:new).with(nil)
+              subject
+            end
+
+            context 'with attributes { :foo => "foo" }' do
+              let(:attributes) { { foo: 'foo' } }
+
+              it { expect { subject }.not_to raise_error }
+
+              it 'is expected to receive #copy_flags!' do
+                expect_any_instance_of(model_mock).to receive(:copy_flags!).with(foo: 'foo')
+                subject
+              end
+
+              it 'is expected to receive #copy_called!' do
+                expect_any_instance_of(model_mock).to receive(:copy_called!).with(foo: 'foo')
+                subject
+              end
+
+              it 'is expected to invoke super on parent class with { :foo => "foo" }' do
+                expect(active_record_base_mock).to receive(:new).with(foo: 'foo')
+                subject
+              end
+            end
+
+            context 'with attributes being an instance of ModelMock having attributes { :foo => "foo" }' do
+              let(:previous_instance) { model_mock.new(foo: 'foo') }
+              let(:attributes) { previous_instance }
+
+              it { is_expected.to have_attributes(foo: 'foo') }
+
+              context 'with _failed equal to true on previous instance' do
+                before { previous_instance.instance_variable_set('@_failed', true) }
+
+                it { is_expected.to be_failure }
+              end
+
+              context 'with _rolled_back equal to true on previous instance' do
+                before { previous_instance.instance_variable_set('@_rolled_back', true) }
+
+                it 'is expected to have instance_variable @_rolled_back eq to true' do
+                  expect(subject.instance_variable_get('@_rolled_back')).to eq true
+                end
+              end
+
+              context 'with _called eq to ["foo"] on previous instance' do
+                before { previous_instance.instance_variable_set('@_called', %w[foo]) }
+
+                it 'is expected to have instance_variable @_called eq to ["foo"]' do
+                  expect(subject.instance_variable_get('@_called')).to eq %w[foo]
+                end
+              end
+            end
+          end
+
+          describe '#merge!' do
+            subject { model_mock.new(attributes).merge!(merge_instance) }
+            context 'having attributes { :foo => nil }' do
+              let(:attributes) { { foo: nil } }
+
+              context 'with merging instance having attributes { :foo => "foo" }' do
+                let(:merge_instance) { model_mock.new(foo: 'foo') }
+
+                it { is_expected.to have_attributes(foo: 'foo') }
+
+                context 'with _failed equal to true on merging instance' do
+                  before { merge_instance.instance_variable_set('@_failed', true) }
+
+                  it { is_expected.to be_failure }
+                end
+
+                context 'with _rolled_back equal to true on merging instance' do
+                  before { merge_instance.instance_variable_set('@_rolled_back', true) }
+
+                  it 'is expected to have instance_variable @_rolled_back eq to true' do
+                    expect(subject.instance_variable_get('@_rolled_back')).to eq true
+                  end
+                end
+              end
+            end
+
+            context 'having attributes { :foo => "foo"}' do
+              let(:attributes) { { foo: 'foo' } }
+
+              context 'with merging instance having attributes { :foo => "bar" }' do
+                let(:merge_instance) { model_mock.new(foo: 'bar') }
+
+                it { is_expected.to have_attributes(foo: 'bar') }
+
+                context 'with _failed equal to true on merging instance' do
+                  before { merge_instance.instance_variable_set('@_failed', true) }
+
+                  it { is_expected.to be_failure }
+                end
+
+                context 'with _rolled_back equal to true on merging instance' do
+                  before { merge_instance.instance_variable_set('@_rolled_back', true) }
+
+                  it 'is expected to have instance_variable @_rolled_back eq to true' do
+                    expect(subject.instance_variable_get('@_rolled_back')).to eq true
+                  end
+                end
+              end
+            end
+          end
+        end
+
+        describe 'a basic interactor using an ActiveRecord model class as context' do
+          let!(:model_mock) do
+            require 'active_model'
+            build_class('ModelMock', active_record_base_mock) do
+              include ActiveModel::Validations
+              attr_accessor :foo
+              acts_as_context
+            end
+          end
+
+          let(:interactor_class) do
+            build_interactor do
+              contextualize_with :model_mock
+
+              def perform
+                context.foo = 'foo'
+              end
+            end
+          end
+
+          include_examples 'a class with interactor methods'
+          include_examples 'a class with interactor callback methods'
+          include_examples 'a class with interactor context methods'
+
+          describe '.context_class' do
+            subject { interactor_class.context_class }
+
+            it { is_expected.to eq model_mock }
+          end
+
+          describe '.perform' do
+            subject { interactor_class.perform }
+
+            it { is_expected.to be_a model_mock }
+            it { is_expected.to be_successful }
+            it { is_expected.to have_attributes(foo: 'foo') }
+          end
+
+          describe '.perform!' do
+            subject { interactor_class.perform! }
+
+            it { expect { subject }.not_to raise_error }
+            it { is_expected.to be_a model_mock }
+            it { is_expected.to be_successful }
+            it { is_expected.to have_attributes(foo: 'foo') }
+          end
+
+          context 'failing the context on #perform' do
+            let(:interactor_class) do
+              build_interactor do
+                contextualize_with :model_mock
+
+                def perform
+                  context.fail!
+                end
+              end
+            end
+
+            describe '.perform' do
+              subject { interactor_class.perform }
+
+              it { expect { subject }.not_to raise_error }
+              it { is_expected.to be_a model_mock }
+              it { is_expected.to be_failure }
+              it 'is expected to #rollback' do
+                expect_any_instance_of(interactor_class).to receive(:rollback)
+                subject
+              end
+            end
+
+            describe '.perform!' do
+              subject { interactor_class.perform! }
+
+              it { expect { subject }.to raise_error(ActiveInteractor::Error::ContextFailure) }
+            end
+          end
+        end
+
+        describe 'a basic organizer using an ActiveRecord model class as context' do
+          let!(:model_mock) do
+            require 'active_model'
+            build_class('ModelMock', active_record_base_mock) do
+              include ActiveModel::Validations
+              attr_accessor :first_name, :last_name
+              acts_as_context
+            end
+          end
+
+          context 'with each organized interactor using the model' do
+            let!(:test_interactor_1) do
+              build_interactor('TestInteractor1') do
+                contextualize_with :model_mock
+
+                def perform
+                  context.first_name = 'Test'
+                end
+              end
+            end
+
+            let!(:test_interactor_2) do
+              build_interactor('TestInteractor2') do
+                contextualize_with :model_mock
+
+                def perform
+                  context.last_name = 'User'
+                end
+              end
+            end
+
+            let(:interactor_class) do
+              build_organizer do
+                contextualize_with :model_mock
+                organize :test_interactor_1, :test_interactor_2
+              end
+            end
+
+            include_examples 'a class with interactor methods'
+            include_examples 'a class with interactor callback methods'
+            include_examples 'a class with interactor context methods'
+            include_examples 'a class with organizer callback methods'
+
+            describe '.perform' do
+              subject { interactor_class.perform }
+
+              it { is_expected.to be_a model_mock }
+              it { is_expected.to be_successful }
+              it { is_expected.to have_attributes(first_name: 'Test', last_name: 'User') }
+            end
+          end
+
+          context 'with each organized interactor using their default context' do
+            let!(:test_interactor_1) do
+              build_interactor('TestInteractor1') do
+                def perform
+                  context.first_name = 'Test'
+                end
+              end
+            end
+
+            let!(:test_interactor_2) do
+              build_interactor('TestInteractor2') do
+                def perform
+                  context.last_name = 'User'
+                end
+              end
+            end
+
+            let(:interactor_class) do
+              build_organizer do
+                contextualize_with :model_mock
+                organize :test_interactor_1, :test_interactor_2
+              end
+            end
+
+            include_examples 'a class with interactor methods'
+            include_examples 'a class with interactor callback methods'
+            include_examples 'a class with interactor context methods'
+            include_examples 'a class with organizer callback methods'
+
+            describe '.perform' do
+              subject { interactor_class.perform }
+
+              it { is_expected.to be_a model_mock }
+              it { is_expected.to be_successful }
+              it { is_expected.to have_attributes(first_name: 'Test', last_name: 'User') }
+            end
+          end
+        end
+      end
+    end
+  end
+rescue LoadError
+  RSpec.describe 'ActiveRecord Integration', type: :integration do
+    pending 'Rails not found skipping specs...'
+  end
+end

data/spec/support/helpers/factories.rb

@@ -13,7 +13,7 @@ module Spec
     module Factories
       def build_class(class_name, parent_class = nil, &block)
         Object.send(:remove_const, class_name.to_sym) if Object.const_defined?(class_name)
-        klass = Object.const_set(class_name, Class.new(parent_class))
+        klass = create_class(class_name, parent_class)
         klass.class_eval(&block) if block
         FactoryCollection.factories << klass.name.to_sym
         klass
@@ -36,6 +36,14 @@ module Spec
           Object.send(:remove_const, factory) if Object.const_defined?(factory)
         end
       end
+
+      private
+
+      def create_class(class_name, parent_class = nil)
+        return Object.const_set(class_name, Class.new) unless parent_class
+
+        Object.const_set(class_name, Class.new(parent_class))
+      end
     end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: activeinteractor
 version: !ruby/object:Gem::Version
-  version: 1.0.0.beta.5
+  version: 1.0.0.beta.6
 platform: ruby
 authors:
 - Aaron Allen
@@ -108,10 +108,10 @@ files:
 - lib/active_interactor/base.rb
 - lib/active_interactor/config.rb
 - lib/active_interactor/configurable.rb
-- lib/active_interactor/context.rb
 - lib/active_interactor/context/attributes.rb
 - lib/active_interactor/context/base.rb
 - lib/active_interactor/context/loader.rb
+- lib/active_interactor/context/status.rb
 - lib/active_interactor/error.rb
 - lib/active_interactor/interactor.rb
 - lib/active_interactor/interactor/callbacks.rb
@@ -122,6 +122,7 @@ files:
 - lib/active_interactor/organizer/interactor_interface.rb
 - lib/active_interactor/organizer/interactor_interface_collection.rb
 - lib/active_interactor/rails.rb
+- lib/active_interactor/rails/active_record.rb
 - lib/active_interactor/rails/config.rb
 - lib/active_interactor/rails/railtie.rb
 - lib/active_interactor/version.rb
@@ -155,9 +156,11 @@ files:
 - spec/active_interactor/organizer/interactor_interface_collection_spec.rb
 - spec/active_interactor/organizer/interactor_interface_spec.rb
 - spec/active_interactor/organizer_spec.rb
+- spec/active_interactor/rails/active_record_spec.rb
 - spec/active_interactor/rails/config_spec.rb
 - spec/active_interactor/rails_spec.rb
 - spec/active_interactor_spec.rb
+- spec/integration/active_record_integration_spec.rb
 - spec/integration/basic_callback_integration_spec.rb
 - spec/integration/basic_context_integration_spec.rb
 - spec/integration/basic_integration_spec.rb
@@ -174,10 +177,10 @@ licenses:
 - MIT
 metadata:
   bug_tracker_uri: https://github.com/aaronmallen/activeinteractor/issues
-  changelog_uri: https://github.com/aaronmallen/activeinteractor/blob/v1.0.0.beta.5/CHANGELOG.md
-  documentation_uri: https://www.rubydoc.info/gems/activeinteractor/1.0.0.beta.5
+  changelog_uri: https://github.com/aaronmallen/activeinteractor/blob/v1.0.0.beta.6/CHANGELOG.md
+  documentation_uri: https://www.rubydoc.info/gems/activeinteractor/1.0.0.beta.6
   hompage_uri: https://github.com/aaronmallen/activeinteractor
-  source_code_uri: https://github.com/aaronmallen/activeinteractor/tree/v1.0.0.beta.5
+  source_code_uri: https://github.com/aaronmallen/activeinteractor/tree/v1.0.0.beta.6
   wiki_uri: https://github.com/aaronmallen/activeinteractor/wiki
 post_install_message: 
 rdoc_options: []
@@ -200,6 +203,7 @@ specification_version: 4
 summary: Ruby interactors with ActiveModel::Validations
 test_files:
 - spec/active_interactor_spec.rb
+- spec/integration/active_record_integration_spec.rb
 - spec/integration/basic_validations_integration_spec.rb
 - spec/integration/basic_integration_spec.rb
 - spec/integration/basic_callback_integration_spec.rb
@@ -217,6 +221,7 @@ test_files:
 - spec/active_interactor/organizer_spec.rb
 - spec/active_interactor/organizer/interactor_interface_spec.rb
 - spec/active_interactor/organizer/interactor_interface_collection_spec.rb
+- spec/active_interactor/rails/active_record_spec.rb
 - spec/active_interactor/rails/config_spec.rb
 - spec/active_interactor/rails_spec.rb
 - spec/active_interactor/interactor/worker_spec.rb

data/lib/active_interactor/context.rb

@@ -1,13 +0,0 @@
-# frozen_string_literal: true
-
-module ActiveInteractor
-  # ActiveInteractor::Context classes
-  # @author Aaron Allen <hello@aaronmallen.me>
-  # @since 0.0.1
-  module Context
-    extend ActiveSupport::Autoload
-
-    autoload :Base
-    autoload :Loader
-  end
-end