activeinteractor 0.1.7 → 1.0.0.beta.1

data/spec/integration/basic_context_integration_spec.rb

@@ -0,0 +1,73 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+RSpec.describe 'Basic Context Integration', type: :integration do
+  describe 'An interactor with context attributes' do
+    let(:interactor_class) do
+      build_interactor do
+        context_attributes :test_field
+
+        def perform
+          context.test_field = 'test'
+          context.some_other_field = 'test 2'
+        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 '.perform' do
+      subject(:result) { interactor_class.perform }
+
+      it { is_expected.to be_a interactor_class.context_class }
+      it { is_expected.to be_successful }
+      it { is_expected.to have_attributes(test_field: 'test', some_other_field: 'test 2') }
+
+      describe '.attributes' do
+        subject { result.attributes }
+
+        it { is_expected.to eq(test_field: 'test') }
+      end
+    end
+  end
+
+  describe 'An interactor with a defined context class named "AnInteractor"' do
+    let(:interactor_class) { build_interactor('AnInteractor') }
+    let!(:context_class) { build_context('AnInteractorContext') }
+
+    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 AnInteractorContext }
+      it { is_expected.to be < ActiveInteractor::Context::Base }
+    end
+  end
+
+  describe 'An interactor contextualized with ATestContext' do
+    let(:interactor_class) do
+      build_interactor do
+        contextualize_with :a_test_context
+      end
+    end
+
+    let!(:context_class) { build_context('ATestContext') }
+
+    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 ATestContext }
+      it { is_expected.to be < ActiveInteractor::Context::Base }
+    end
+  end
+end

data/spec/integration/basic_integration_spec.rb

@@ -0,0 +1,220 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+RSpec.describe 'Basic Integration', type: :integration do
+  describe 'A basic interactor' do
+    let(:interactor_class) do
+      build_interactor do
+        def perform
+          context.test_field = 'test'
+        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 TestInteractor::Context }
+      it { is_expected.to be < ActiveInteractor::Context::Base }
+    end
+
+    describe '.perform' do
+      subject { interactor_class.perform }
+
+      it { is_expected.to be_a interactor_class.context_class }
+      it { is_expected.to be_successful }
+      it { is_expected.to have_attributes(test_field: 'test') }
+    end
+
+    describe '.perform!' do
+      subject { interactor_class.perform! }
+
+      it { expect { subject }.not_to raise_error }
+      it { is_expected.to be_a interactor_class.context_class }
+      it { is_expected.to be_successful }
+      it { is_expected.to have_attributes(test_field: 'test') }
+    end
+  end
+
+  describe 'A failing interactor' do
+    let(:interactor_class) do
+      build_interactor do
+        def perform
+          context.fail!
+        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 TestInteractor::Context }
+      it { is_expected.to be < ActiveInteractor::Context::Base }
+    end
+
+    describe '.perform' do
+      subject { interactor_class.perform }
+
+      it { expect { subject }.not_to raise_error }
+      it { is_expected.to be_a interactor_class.context_class }
+      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
+
+  describe 'A basic organizer' do
+    let!(:test_interactor_1) do
+      build_interactor('TestInteractor1') do
+        def perform
+          context.test_field_1 = 'test 1'
+        end
+      end
+    end
+
+    let!(:test_interactor_2) do
+      build_interactor('TestInteractor2') do
+        def perform
+          context.test_field_2 = 'test 2'
+        end
+      end
+    end
+
+    let(:interactor_class) do
+      build_organizer do
+        organize TestInteractor1, TestInteractor2
+      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 '.context_class' do
+      subject { interactor_class.context_class }
+
+      it { is_expected.to eq TestOrganizer::Context }
+      it { is_expected.to be < ActiveInteractor::Context::Base }
+    end
+
+    describe '.organized' do
+      subject { interactor_class.organized }
+
+      it { is_expected.to eq [TestInteractor1, TestInteractor2] }
+    end
+
+    describe '.perform' do
+      subject { interactor_class.perform }
+
+      it { is_expected.to be_a interactor_class.context_class }
+      it { is_expected.to be_successful }
+      it { is_expected.to have_attributes(test_field_1: 'test 1', test_field_2: 'test 2') }
+    end
+  end
+
+  describe 'A basic organizer having the first interactor fail' do
+    let!(:test_interactor_1) do
+      build_interactor('TestInteractor1') do
+        def perform
+          context.fail!
+        end
+      end
+    end
+
+    let!(:test_interactor_2) do
+      build_interactor('TestInteractor2') do
+        def perform
+          context.test_field_2 = 'test 2'
+        end
+      end
+    end
+
+    let(:interactor_class) do
+      build_organizer do
+        organize TestInteractor1, TestInteractor2
+      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 { expect { subject }.not_to raise_error }
+      it { is_expected.to be_a interactor_class.context_class }
+      it { is_expected.to be_failure }
+      it 'is expected to rollback the first interactor' do
+        expect_any_instance_of(test_interactor_1).to receive(:rollback)
+          .and_call_original
+        subject
+      end
+      it 'is expected not to call #perform! on the second interactor' do
+        expect_any_instance_of(test_interactor_2).not_to receive(:perform!)
+        subject
+      end
+    end
+  end
+
+  describe 'A basic organizer having the second interactor fail' do
+    let!(:test_interactor_1) do
+      build_interactor('TestInteractor1') do
+        def perform
+          context.test_field_1 = 'test 1'
+        end
+      end
+    end
+
+    let!(:test_interactor_2) do
+      build_interactor('TestInteractor2') do
+        def perform
+          context.fail!
+        end
+      end
+    end
+
+    let(:interactor_class) do
+      build_organizer do
+        organize TestInteractor1, TestInteractor2
+      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 { expect { subject }.not_to raise_error }
+      it { is_expected.to be_a interactor_class.context_class }
+      it { is_expected.to be_failure }
+      it 'is expected to rollback all interactors' do
+        expect_any_instance_of(test_interactor_2).to receive(:rollback)
+        expect_any_instance_of(test_interactor_1).to receive(:rollback)
+        subject
+      end
+    end
+  end
+end

data/spec/integration/basic_validations_integration_spec.rb

@@ -0,0 +1,204 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+RSpec.describe 'Basic Validations Integration', type: :integration do
+  describe 'An interactor with validations' do
+    let(:interactor_class) do
+      build_interactor do
+        context_validates :test_field, presence: true
+
+        def perform
+          context.other_field = context.test_field
+        end
+
+        def rollback
+          context.other_field = 'failed'
+        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 '.perform' do
+      subject { interactor_class.perform(context_attributes) }
+
+      context 'with valid context attributes' do
+        let(:context_attributes) { { test_field: 'test' } }
+
+        it { is_expected.to be_a interactor_class.context_class }
+        it { is_expected.to be_successful }
+        it { is_expected.to have_attributes(test_field: 'test', other_field: 'test') }
+      end
+
+      context 'with invalid context attributes' do
+        let(:context_attributes) { {} }
+
+        it { is_expected.to be_a interactor_class.context_class }
+        it { is_expected.to be_failure }
+        it { is_expected.to have_attributes(other_field: 'failed') }
+        it 'is expected to have errors on :test_field' do
+          expect(subject.errors[:test_field]).not_to be_nil
+        end
+      end
+    end
+  end
+
+  describe 'An interactor with conditional validations' do
+    let(:interactor_class) do
+      build_interactor do
+        context_validates :test_field, presence: true, if: :test_condition
+
+        def perform
+          context.other_field = context.test_field
+        end
+
+        def rollback
+          context.other_field = 'failed'
+        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 '.perform' do
+      subject { interactor_class.perform(context_attributes) }
+
+      context 'with :test_field defined and :test_condition false' do
+        let(:context_attributes) { { test_field: 'test', test_condition: false } }
+
+        it { is_expected.to be_a interactor_class.context_class }
+        it { is_expected.to be_successful }
+        it { is_expected.to have_attributes(test_field: 'test', test_condition: false, other_field: 'test') }
+      end
+
+      context 'with :test_field defined and :test_condition true' do
+        let(:context_attributes) { { test_field: 'test', test_condition: true } }
+
+        it { is_expected.to be_a interactor_class.context_class }
+        it { is_expected.to be_successful }
+        it { is_expected.to have_attributes(test_field: 'test', test_condition: true, other_field: 'test') }
+      end
+
+      context 'with :test_field undefined and :test_condition true' do
+        let(:context_attributes) { { test_condition: true } }
+
+        it { is_expected.to be_a interactor_class.context_class }
+        it { is_expected.to be_failure }
+        it { is_expected.to have_attributes(test_condition: true, other_field: 'failed') }
+        it 'is expected to have errors on :test_field' do
+          expect(subject.errors[:test_field]).not_to be_nil
+        end
+      end
+    end
+  end
+
+  describe 'An interactor named "AnInteractor" with validations on context class named "AnInteractorContext"' do
+    let!(:context_class) do
+      build_context('AnInteractorContext') do
+        validates :test_field, presence: true
+      end
+    end
+    let(:interactor_class) { build_interactor('AnInteractor') }
+
+    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 AnInteractorContext }
+      it { is_expected.to be < ActiveInteractor::Context::Base }
+    end
+
+    subject { interactor_class.perform(context_attributes) }
+
+    context 'with valid context attributes' do
+      let(:context_attributes) { { test_field: 'test' } }
+
+      it { is_expected.to be_an AnInteractorContext }
+      it { is_expected.to be_successful }
+    end
+
+    context 'with invalid context attributes' do
+      let(:context_attributes) { {} }
+
+      it { is_expected.to be_an AnInteractorContext }
+      it { is_expected.to be_failure }
+      it 'is expected to have errors on :some_field' do
+        expect(subject.errors[:test_field]).not_to be_nil
+      end
+    end
+  end
+
+  describe 'An interactor with validations having validation context on :calling' do
+    let(:interactor_class) do
+      build_interactor do
+        context_validates :test_field, presence: true, on: :calling
+      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'
+
+    subject { interactor_class.perform(context_attributes) }
+
+    context 'with :test_field "test"' do
+      let(:context_attributes) { { test_field: 'test' } }
+
+      it { is_expected.to be_an TestInteractor::Context }
+      it { is_expected.to be_successful }
+    end
+
+    context 'with :test_field nil' do
+      let(:context_attributes) { {} }
+
+      it { is_expected.to be_an TestInteractor::Context }
+      it { is_expected.to be_failure }
+      it 'is expected to have errors on :some_field' do
+        expect(subject.errors[:test_field]).not_to be_nil
+      end
+    end
+  end
+
+  describe 'An interactor with validations having validation context on :called' do
+    let(:interactor_class) do
+      build_interactor do
+        context_validates :test_field, presence: true, on: :called
+
+        def perform
+          context.test_field = 'test' if context.should_have_test_field
+        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'
+
+    subject { interactor_class.perform(context_attributes) }
+
+    context 'with :should_have_test_field true' do
+      let(:context_attributes) { { should_have_test_field: true } }
+
+      it { is_expected.to be_an TestInteractor::Context }
+      it { is_expected.to be_successful }
+    end
+
+    context 'with :should_have_test_field false' do
+      let(:context_attributes) { { should_have_test_field: false } }
+
+      it { is_expected.to be_an TestInteractor::Context }
+      it { is_expected.to be_failure }
+      it 'is expected to have errors on :some_field' do
+        expect(subject.errors[:test_field]).not_to be_nil
+      end
+    end
+  end
+end