interaktor 0.1.3

data/spec/interactor/organizer_spec.rb

@@ -0,0 +1,61 @@
+module Interaktor
+  describe Organizer do
+    let(:organizer) { Class.new.send(:include, Organizer) }
+
+    include_examples "lint"
+
+    describe ".organize" do
+      let(:interaktor2) { double(:interaktor2) }
+      let(:interaktor3) { double(:interaktor3) }
+
+      it "sets interaktors given class arguments" do
+        expect {
+          organizer.organize(interaktor2, interaktor3)
+        }.to change(organizer, :organized).from([]).to([interaktor2, interaktor3])
+      end
+
+      it "sets interaktors given an array of classes" do
+        expect {
+          organizer.organize([interaktor2, interaktor3])
+        }.to change(organizer, :organized).from([]).to([interaktor2, interaktor3])
+      end
+
+      it "allows multiple organize calls" do
+        interaktor4 = double(:interaktor4)
+        expect {
+          organizer.organize(interaktor2, interaktor3)
+          organizer.organize(interaktor4)
+        }.to change(organizer, :organized).from([]).to([interaktor2, interaktor3, interaktor4])
+      end
+    end
+
+    describe ".organized" do
+      it "is empty by default" do
+        expect(organizer.organized).to eq([])
+      end
+    end
+
+    describe "#call" do
+      let(:instance) { organizer.new }
+      let(:context) { double(:context) }
+      let(:interaktor2) { double(:interaktor2) }
+      let(:interaktor3) { double(:interaktor3) }
+      let(:interaktor4) { double(:interaktor4) }
+
+      before do
+        allow(instance).to receive(:context) { context }
+        allow(organizer).to receive(:organized) {
+          [interaktor2, interaktor3, interaktor4]
+        }
+      end
+
+      it "calls each interaktor in order with the context" do
+        expect(interaktor2).to receive(:call!).once.with(context).ordered
+        expect(interaktor3).to receive(:call!).once.with(context).ordered
+        expect(interaktor4).to receive(:call!).once.with(context).ordered
+
+        instance.call
+      end
+    end
+  end
+end

data/spec/interactor_spec.rb

@@ -0,0 +1,3 @@
+describe Interaktor do
+  include_examples "lint"
+end

data/spec/spec_helper.rb

@@ -0,0 +1,8 @@
+if ENV["CODECLIMATE_REPO_TOKEN"]
+  require "simplecov"
+  SimpleCov.start
+end
+
+require "interaktor"
+
+Dir[File.expand_path("support/*.rb", __dir__)].sort.each { |f| require f }

data/spec/support/lint.rb

@@ -0,0 +1,136 @@
+shared_examples "lint" do
+  let(:interaktor) { Class.new.send(:include, described_class) }
+
+  describe ".call" do
+    let(:context) { double(:context) }
+    let(:instance) { double(:instance, context: context) }
+
+    it "calls an instance with the given context" do
+      expect(interaktor).to receive(:new).once.with(foo: "bar") { instance }
+      expect(instance).to receive(:run).once.with(no_args)
+
+      expect(interaktor.call(foo: "bar")).to eq(context)
+    end
+
+    it "provides a blank context if none is given" do
+      expect(interaktor).to receive(:new).once.with({}) { instance }
+      expect(instance).to receive(:run).once.with(no_args)
+
+      expect(interaktor.call).to eq(context)
+    end
+  end
+
+  describe ".call!" do
+    let(:context) { double(:context) }
+    let(:instance) { double(:instance, context: context) }
+
+    it "calls an instance with the given context" do
+      expect(interaktor).to receive(:new).once.with(foo: "bar") { instance }
+      expect(instance).to receive(:run!).once.with(no_args)
+
+      expect(interaktor.call!(foo: "bar")).to eq(context)
+    end
+
+    it "provides a blank context if none is given" do
+      expect(interaktor).to receive(:new).once.with({}) { instance }
+      expect(instance).to receive(:run!).once.with(no_args)
+
+      expect(interaktor.call!).to eq(context)
+    end
+  end
+
+  describe ".new" do
+    let(:context) { double(:context) }
+
+    it "initializes a context" do
+      expect(Interaktor::Context).to receive(:build)
+                                       .once.with(foo: "bar") { context }
+
+      instance = interaktor.new(foo: "bar")
+
+      expect(instance).to be_a(interaktor)
+      expect(instance.context).to eq(context)
+    end
+
+    it "initializes a blank context if none is given" do
+      expect(Interaktor::Context).to receive(:build).once.with({}) { context }
+
+      instance = interaktor.new
+
+      expect(instance).to be_a(interaktor)
+      expect(instance.context).to eq(context)
+    end
+  end
+
+  describe "#run" do
+    let(:instance) { interaktor.new }
+
+    it "runs the interaktor" do
+      expect(instance).to receive(:run!).once.with(no_args)
+
+      instance.run
+    end
+
+    it "rescues failure" do
+      expect(instance).to receive(:run!).and_raise(Interaktor::Failure)
+
+      expect {
+        instance.run
+      }.not_to raise_error
+    end
+
+    it "raises other errors" do
+      expect(instance).to receive(:run!).and_raise("foo")
+
+      expect {
+        instance.run
+      }.to raise_error("foo")
+    end
+  end
+
+  describe "#run!" do
+    let(:instance) { interaktor.new }
+
+    it "calls the interaktor" do
+      expect(instance).to receive(:call).once.with(no_args)
+
+      instance.run!
+    end
+
+    it "raises failure" do
+      expect(instance).to receive(:run!).and_raise(Interaktor::Failure)
+
+      expect {
+        instance.run!
+      }.to raise_error(Interaktor::Failure)
+    end
+
+    it "raises other errors" do
+      expect(instance).to receive(:run!).and_raise("foo")
+
+      expect {
+        instance.run
+      }.to raise_error("foo")
+    end
+  end
+
+  describe "#call" do
+    let(:instance) { interaktor.new }
+
+    it "exists" do
+      expect(instance).to respond_to(:call)
+      expect { instance.call }.not_to raise_error
+      expect { instance.method(:call) }.not_to raise_error
+    end
+  end
+
+  describe "#rollback" do
+    let(:instance) { interaktor.new }
+
+    it "exists" do
+      expect(instance).to respond_to(:rollback)
+      expect { instance.rollback }.not_to raise_error
+      expect { instance.method(:rollback) }.not_to raise_error
+    end
+  end
+end

metadata

@@ -0,0 +1,97 @@
+--- !ruby/object:Gem::Specification
+name: interaktor
+version: !ruby/object:Gem::Version
+  version: 0.1.3
+platform: ruby
+authors:
+- Taylor Thurlow
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2020-07-13 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: zeitwerk
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.3.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.3.1
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+description: A common interface for building service objects.
+email: taylorthurlow@me.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".rubocop.yml"
+- ".travis.yml"
+- Gemfile
+- README.md
+- Rakefile
+- interaktor.gemspec
+- lib/interaktor.rb
+- lib/interaktor/context.rb
+- lib/interaktor/failure.rb
+- lib/interaktor/hooks.rb
+- lib/interaktor/organizer.rb
+- spec/integration_spec.rb
+- spec/interactor/context_spec.rb
+- spec/interactor/hooks_spec.rb
+- spec/interactor/organizer_spec.rb
+- spec/interactor_spec.rb
+- spec/spec_helper.rb
+- spec/support/lint.rb
+homepage: https://github.com/taylorthurlow/interaktor
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '2.5'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.1.2
+signing_key: 
+specification_version: 4
+summary: Simple service object implementation
+test_files:
+- spec/integration_spec.rb
+- spec/interactor/context_spec.rb
+- spec/interactor/hooks_spec.rb
+- spec/interactor/organizer_spec.rb
+- spec/interactor_spec.rb
+- spec/spec_helper.rb
+- spec/support/lint.rb