dry-transaction 0.13.0 → 0.13.1

data/LICENSE.md

@@ -1,9 +0,0 @@
-The MIT License (MIT)
-
-Copyright © 2015-2016 [Icelab](http://icelab.com.au/).
-
-Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/Rakefile

@@ -1,6 +0,0 @@
-require "bundler/gem_tasks"
-
-require "rspec/core/rake_task"
-RSpec::Core::RakeTask.new
-
-task default: :spec

data/spec/examples.txt

@@ -1,88 +0,0 @@
-example_id                                                  | status | run_time        |
------------------------------------------------------------ | ------ | --------------- |
-./spec/integration/around_spec.rb[1:1]                      | passed | 0.00234 seconds |
-./spec/integration/around_spec.rb[1:2]                      | passed | 0.00095 seconds |
-./spec/integration/around_spec.rb[1:3]                      | passed | 0.00149 seconds |
-./spec/integration/around_spec.rb[1:4]                      | passed | 0.00118 seconds |
-./spec/integration/around_spec.rb[1:5]                      | passed | 0.00104 seconds |
-./spec/integration/around_spec.rb[1:6:1]                    | passed | 0.00096 seconds |
-./spec/integration/auto_injection_spec.rb[1:1]              | failed | 0.00149 seconds |
-./spec/integration/custom_step_adapters_spec.rb[1:1]        | passed | 0.00372 seconds |
-./spec/integration/operation_spec.rb[1:1]                   | passed | 0.00013 seconds |
-./spec/integration/operation_spec.rb[1:2]                   | passed | 0.00014 seconds |
-./spec/integration/passing_step_arguments_spec.rb[1:1:1]    | passed | 0.00063 seconds |
-./spec/integration/passing_step_arguments_spec.rb[1:2:1]    | passed | 0.00072 seconds |
-./spec/integration/passing_step_arguments_spec.rb[1:3:1]    | passed | 0.00038 seconds |
-./spec/integration/publishing_step_events_spec.rb[1:1:1]    | passed | 0.00057 seconds |
-./spec/integration/publishing_step_events_spec.rb[1:1:2]    | passed | 0.0007 seconds  |
-./spec/integration/publishing_step_events_spec.rb[1:2:1]    | passed | 0.00054 seconds |
-./spec/integration/publishing_step_events_spec.rb[1:2:2]    | passed | 0.00052 seconds |
-./spec/integration/publishing_step_events_spec.rb[1:3:1]    | passed | 0.00075 seconds |
-./spec/integration/publishing_step_events_spec.rb[1:3:2]    | passed | 0.00071 seconds |
-./spec/integration/transaction_spec.rb[1:1:1]               | passed | 0.0006 seconds  |
-./spec/integration/transaction_spec.rb[1:1:2]               | passed | 0.0006 seconds  |
-./spec/integration/transaction_spec.rb[1:1:3]               | passed | 0.00058 seconds |
-./spec/integration/transaction_spec.rb[1:1:4]               | passed | 0.00072 seconds |
-./spec/integration/transaction_spec.rb[1:1:5]               | passed | 0.00058 seconds |
-./spec/integration/transaction_spec.rb[1:2:1]               | passed | 0.00075 seconds |
-./spec/integration/transaction_spec.rb[1:3:1]               | passed | 0.00055 seconds |
-./spec/integration/transaction_spec.rb[1:4:1]               | passed | 0.00055 seconds |
-./spec/integration/transaction_spec.rb[1:5:1]               | passed | 0.00059 seconds |
-./spec/integration/transaction_spec.rb[1:6:1]               | passed | 0.00043 seconds |
-./spec/integration/transaction_spec.rb[1:7:1]               | passed | 0.00047 seconds |
-./spec/integration/transaction_spec.rb[1:8:1]               | passed | 0.00043 seconds |
-./spec/integration/transaction_spec.rb[1:9:1]               | passed | 0.00068 seconds |
-./spec/integration/transaction_spec.rb[1:10:1]              | passed | 0.00052 seconds |
-./spec/integration/transaction_spec.rb[1:11:1]              | passed | 0.00053 seconds |
-./spec/integration/transaction_spec.rb[1:11:2]              | passed | 0.00047 seconds |
-./spec/integration/transaction_spec.rb[1:12:1]              | passed | 0.00065 seconds |
-./spec/integration/transaction_spec.rb[1:12:2]              | passed | 0.00062 seconds |
-./spec/integration/transaction_spec.rb[1:12:3]              | passed | 0.00066 seconds |
-./spec/integration/transaction_spec.rb[1:12:4]              | passed | 0.00063 seconds |
-./spec/integration/transaction_spec.rb[1:12:5]              | passed | 0.0006 seconds  |
-./spec/integration/transaction_spec.rb[1:12:6]              | passed | 0.00063 seconds |
-./spec/integration/transaction_spec.rb[1:13:1]              | passed | 0.00076 seconds |
-./spec/integration/transaction_spec.rb[1:13:2]              | passed | 0.0007 seconds  |
-./spec/integration/transaction_spec.rb[1:13:3]              | passed | 0.00198 seconds |
-./spec/integration/transaction_spec.rb[1:13:4]              | passed | 0.00065 seconds |
-./spec/integration/transaction_spec.rb[1:13:5]              | passed | 0.00068 seconds |
-./spec/integration/transaction_spec.rb[1:14:1]              | passed | 0.00055 seconds |
-./spec/integration/transaction_spec.rb[1:15:1]              | passed | 0.00042 seconds |
-./spec/integration/transaction_spec.rb[1:16:1:1:1]          | passed | 0.0004 seconds  |
-./spec/integration/transaction_spec.rb[1:16:2:1:1]          | passed | 0.00037 seconds |
-./spec/integration/transaction_spec.rb[1:16:2:2:1]          | passed | 0.00042 seconds |
-./spec/integration/transaction_without_steps_spec.rb[1:1:1] | passed | 0.00066 seconds |
-./spec/integration/transaction_without_steps_spec.rb[1:1:2] | passed | 0.0007 seconds  |
-./spec/integration/transaction_without_steps_spec.rb[1:1:3] | passed | 0.00072 seconds |
-./spec/integration/transaction_without_steps_spec.rb[1:1:4] | passed | 0.00064 seconds |
-./spec/integration/transaction_without_steps_spec.rb[1:2:1] | passed | 0.0008 seconds  |
-./spec/integration/transaction_without_steps_spec.rb[1:3:1] | passed | 0.00071 seconds |
-./spec/unit/step_adapters/around_spec.rb[1:1:1:1]           | passed | 0.0016 seconds  |
-./spec/unit/step_adapters/around_spec.rb[1:1:2:1]           | passed | 0.00092 seconds |
-./spec/unit/step_adapters/around_spec.rb[1:1:3:1]           | passed | 0.00011 seconds |
-./spec/unit/step_adapters/check_spec.rb[1:1:1]              | passed | 0.00012 seconds |
-./spec/unit/step_adapters/check_spec.rb[1:1:2:1]            | passed | 0.00012 seconds |
-./spec/unit/step_adapters/check_spec.rb[1:1:3:1]            | passed | 0.00009 seconds |
-./spec/unit/step_adapters/check_spec.rb[1:1:4:1]            | passed | 0.00009 seconds |
-./spec/unit/step_adapters/map_spec.rb[1:1:1]                | passed | 0.00009 seconds |
-./spec/unit/step_adapters/raw_spec.rb[1:1:1:1]              | passed | 0.00014 seconds |
-./spec/unit/step_adapters/raw_spec.rb[1:1:2:1]              | passed | 0.00009 seconds |
-./spec/unit/step_adapters/tee_spec.rb[1:1:1]                | passed | 0.00012 seconds |
-./spec/unit/step_adapters/try_spec.rb[1:1:1:1]              | passed | 0.00016 seconds |
-./spec/unit/step_adapters/try_spec.rb[1:1:2:1:1]            | passed | 0.00013 seconds |
-./spec/unit/step_adapters/try_spec.rb[1:1:2:1:2]            | passed | 0.00016 seconds |
-./spec/unit/step_adapters/try_spec.rb[1:1:2:1:3:1]          | passed | 0.00017 seconds |
-./spec/unit/step_adapters/try_spec.rb[1:1:2:1:3:2]          | passed | 0.00012 seconds |
-./spec/unit/step_adapters/try_spec.rb[1:1:2:2:1]            | passed | 0.00012 seconds |
-./spec/unit/step_adapters/try_spec.rb[1:1:2:2:2:1]          | passed | 0.00012 seconds |
-./spec/unit/step_spec.rb[1:1:1:1]                           | passed | 0.00225 seconds |
-./spec/unit/step_spec.rb[1:1:1:2]                           | passed | 0.00071 seconds |
-./spec/unit/step_spec.rb[1:1:2:1]                           | passed | 0.01719 seconds |
-./spec/unit/step_spec.rb[1:1:3:1]                           | passed | 0.00026 seconds |
-./spec/unit/step_spec.rb[1:1:3:2]                           | passed | 0.00306 seconds |
-./spec/unit/step_spec.rb[1:1:3:3]                           | passed | 0.00057 seconds |
-./spec/unit/step_spec.rb[1:2:1:1]                           | passed | 0.00014 seconds |
-./spec/unit/step_spec.rb[1:2:2:1]                           | passed | 0.00014 seconds |
-./spec/unit/step_spec.rb[1:2:3:1]                           | passed | 0.00013 seconds |
-./spec/unit/step_spec.rb[1:3:1:1]                           | passed | 0.00014 seconds |
-./spec/unit/step_spec.rb[1:3:2:1]                           | passed | 0.00013 seconds |

data/spec/integration/around_spec.rb

@@ -1,120 +0,0 @@
-RSpec.describe "around steps" do
-  include_context "db transactions"
-
-  include Dry::Monads::Result::Mixin
-
-  before do
-    container.instance_exec do
-      register :validate, -> input {
-        if input[:account][:balance] >= 0
-          Success(input)
-        else
-          Failure(input)
-        end
-      }
-
-      register :persist_user do |user:, **other|
-        self[:database] << [:user, user]
-        Success(other)
-      end
-
-      register :persist_account do |account: |
-        self[:database] << [:account, account]
-        Success(true)
-      end
-    end
-  end
-
-  let(:transaction) do
-    Class.new do
-      include Dry::Transaction(container: Test::Container)
-
-      around :transaction, with: :transaction
-      step :validate, with: :validate
-      step :persist_user, with: :persist_user
-      step :persist_account, with: :persist_account
-      step :finalize, with: :finalize
-    end
-  end
-
-  let(:input) { { user: { name: "Jane" }, account: { balance: 0 } } }
-
-  it "starts a transaction" do
-    called = false
-
-    finalize = -> x do
-      called = true
-      expect(database).to(be_in_transaction)
-      Success(x)
-    end
-
-    result = transaction.new(finalize: finalize).call(input)
-    expect(called).to be true
-    expect(result).to eql(Success(true))
-  end
-
-  it "commits transactions" do
-    transaction.new(finalize: -> x { Success(x) }).call(input)
-
-    expect(database).to be_committed
-    expect(database).not_to be_rolled_back
-    expect(database).not_to be_in_transaction
-    expect(database).to eql([[:user, name: "Jane"],
-                             [:account, balance: 0]])
-  end
-
-  it "rolls back transactions on failure" do
-    transaction.new(finalize: -> x { Failure(x) }).call(input)
-
-    expect(database).to be_rolled_back
-    expect(database).not_to be_in_transaction
-    expect(database).not_to be_committed
-    expect(database).to be_empty
-  end
-
-  it "rolls back transaction on exception" do
-    uncaught = Class.new(StandardError)
-
-    expect {
-      transaction.new(finalize: -> x { raise uncaught }).call(input)
-    }.to raise_error(uncaught)
-
-    expect(database).to be_rolled_back
-    expect(database).not_to be_in_transaction
-    expect(database).not_to be_committed
-    expect(database).to be_empty
-  end
-
-  it "supports matching on nested failures" do
-    invalid_input = input.merge(account: {balance: -10})
-
-    failed_input = nil
-
-    transaction.new(finalize: -> x { Success(x) }).call(invalid_input) do |m|
-      m.success { |v| v }
-      m.failure(:validate) { |input| failed_input = input }
-    end
-
-    expect(failed_input).to eq invalid_input
-  end
-
-  describe "subscribing to events" do
-    let(:subscriber) {
-      Class.new do
-        attr_reader :user_persisted
-
-        def on_step_succeeded(event)
-          @user_persisted = true if event[:step_name] == :persist_user
-        end
-      end.new
-    }
-
-    it "supports subscribing to events from nested steps" do
-      trans = transaction.new(finalize: -> x { Success(x) })
-      trans.subscribe(subscriber)
-      trans.call(input)
-
-      expect(subscriber.user_persisted).to be_truthy
-    end
-  end
-end

data/spec/integration/auto_injection_spec.rb

@@ -1,32 +0,0 @@
-# require "dry-monads"
-# require "dry-auto_inject"
-
-# RSpec.describe "Using dry-auto_inject" do
-#   let(:transaction) {
-#     Class.new do
-#       include Dry::Transaction(container: Test::Container)
-#       include Test::Inject[:extract_email]
-
-#       step :symbolize
-
-#       def call(input)
-#         super(input).bind(extract_email)
-#       end
-#     end.new
-#   }
-
-#   before do
-#     module Test
-#       Container = {
-#         symbolize: -> input { Dry::Monads::Right(name: input["name"], email: input["email"]) },
-#         extract_email: -> input { Dry::Monads::Right(email: input[:email]) },
-#       }
-
-#       Inject = Dry::AutoInject(container: Container)
-#     end
-#   end
-
-#   it "support auto-injection of dependencies alongside step operations" do
-#     expect(transaction.("name" => "Jane", "email" => "jane@example.com").value).to eq(email: "jane@example.com")
-#   end
-# end

data/spec/integration/custom_step_adapters_spec.rb

@@ -1,41 +0,0 @@
-RSpec.describe "Custom step adapters" do
-  let(:transaction) {
-    Class.new do
-      include Dry::Transaction(container: Test::Container, step_adapters: Test::CustomStepAdapters)
-
-      check :jane?, with: :jane?
-      map :process, with: :process
-      tee :persist, with: :persist
-      enqueue :deliver, with: :deliver
-    end.new
-  }
-
-  before do
-    Test::DB = []
-    Test::QUEUE = []
-
-    module Test
-      Container = {
-        jane?:   -> input { input["name"] == "Jane" },
-        process: -> input { {name: input["name"], email: input["email"]} },
-        persist: -> input { Test::DB << input and true },
-        deliver: -> input { "Delivered email to #{input[:email]}" },
-      }
-
-      class CustomStepAdapters < Dry::Transaction::StepAdapters
-        extend Dry::Monads::Result::Mixin
-
-        register :enqueue, -> operation, _options, args {
-          Test::QUEUE << operation.(*args)
-          Success(args[0])
-        }
-      end
-    end
-  end
-
-  it "supports custom step adapters" do
-    input = {"name" => "Jane", "email" => "jane@doe.com"}
-    transaction.call(input)
-    expect(Test::QUEUE).to include("Delivered email to jane@doe.com")
-  end
-end

data/spec/integration/operation_spec.rb

@@ -1,30 +0,0 @@
-require "dry/transaction/operation"
-
-RSpec.describe Dry::Transaction::Operation do
-  subject(:operation) {
-    Class.new do
-      include Dry::Transaction::Operation
-
-      def call(input)
-        Success(input)
-      end
-    end.new
-  }
-
-  it "mixes in the Result monad constructors" do
-    expect(operation.("hello")).to be_success
-  end
-
-  it "supports pattern matching when called with a block" do
-    result = operation.("hello") do |m|
-      m.success do |v|
-        "Success: #{v}"
-      end
-      m.failure do |v|
-        "Failure: #{v}"
-      end
-    end
-
-    expect(result).to eq "Success: hello"
-  end
-end

data/spec/integration/passing_step_arguments_spec.rb

@@ -1,51 +0,0 @@
-RSpec.describe "Passing additional arguments to step operations" do
-  let(:call_transaction) { transaction.with_step_args(step_options).call(input) }
-
-  let(:transaction) {
-    Class.new do
-      include Dry::Transaction(container: Test::Container)
-
-      map :process, with: :process
-      try :validate, with: :validate, catch: Test::NotValidError
-      tee :persist, with: :persist
-    end.new
-  }
-
-  let(:input) { {"name" => "Jane", "email" => "jane@doe.com"} }
-
-  before do
-    Test::NotValidError = Class.new(StandardError)
-    Test::DB = []
-    module Test
-      Container = {
-        process:  -> input { {name: input["name"], email: input["email"]} },
-        validate: -> input, allowed { !input[:email].include?(allowed) ? raise(Test::NotValidError, "email not allowed") : input },
-        persist:  -> input { Test::DB << input and true }
-      }
-    end
-  end
-
-  context "required arguments provided" do
-    let(:step_options) { {validate: ["doe.com"]} }
-
-    it "passes the arguments and calls the operations successfully" do
-      expect(call_transaction).to be_a Dry::Monads::Result::Success
-    end
-  end
-
-  context "required arguments not provided" do
-    let(:step_options) { {} }
-
-    it "raises an ArgumentError" do
-      expect { call_transaction }.to raise_error(ArgumentError)
-    end
-  end
-
-  context "spurious arguments provided" do
-    let(:step_options) { {validate: ["doe.com"], bogus: ["not matching any step"]} }
-
-    it "raises an ArgumentError" do
-      expect { call_transaction }.to raise_error(ArgumentError)
-    end
-  end
-end

data/spec/integration/publishing_step_events_spec.rb

@@ -1,119 +0,0 @@
-RSpec.describe "publishing step events" do
-  let(:container) {
-    Class.new do
-      extend Dry::Container::Mixin
-
-      register :process, -> input { {name: input["name"]} }
-      register :verify,  -> input { input[:name].to_s != "" ? Dry::Monads.Success(input) : Dry::Monads.Failure("no name") }
-      register :persist, -> input { Test::DB << input and true }
-    end
-  }
-
-  let(:transaction) {
-    Class.new do
-      include Dry::Transaction(container: Test::Container)
-
-      map :process, with: :process
-      step :verify, with: :verify
-      tee :persist, with: :persist
-    end.new
-  }
-
-  let(:subscriber) do
-    Class.new do
-      attr_reader :started, :success, :failed
-
-      def initialize
-        @started = []
-        @success = []
-        @failed = []
-      end
-
-      def on_step(event)
-        started << event[:step_name]
-      end
-      def on_step_succeeded(event)
-        success << {step_name: event[:step_name], args: event[:args]}
-      end
-      def on_step_failed(event)
-        failed << {step_name: event[:step_name], args: event[:args], value: event[:value]}
-      end
-    end.new
-  end
-
-  before do
-    Test::DB = []
-    Test::Container = container
-  end
-
-  context "subscribing to all step events" do
-    before do
-      transaction.subscribe(subscriber)
-    end
-
-    specify "subscriber receives success events" do
-      transaction.call("name" => "Jane")
-
-      expected_result = [
-        { step_name: :process, args: [ {"name" => "Jane"} ] },
-        { step_name: :verify, args: [ { name: "Jane" } ] },
-        { step_name: :persist, args: [ { name: "Jane" } ] }
-      ]
-
-      expect(subscriber.success).to eq expected_result
-    end
-
-    specify "subsriber receives success events for passing steps, a failure event for the failing step, and no subsequent events" do
-      transaction.call("name" => "")
-
-      expect(subscriber.success).to eq [ { step_name: :process, args:[ { "name" => "" } ] } ]
-      expect(subscriber.failed).to eq [ { step_name: :verify, args: [ { name: ""} ],  value: "no name" } ]
-    end
-  end
-
-  context "subscribing to particular step events" do
-    before do
-      transaction.subscribe(verify: subscriber)
-    end
-
-    specify "subscriber receives success event for the specified step" do
-      transaction.call("name" => "Jane")
-
-      expect(subscriber.success).to eq [ { step_name: :verify, args: [ { name: "Jane" } ] } ]
-    end
-
-    specify "subscriber receives failure event for the specified step" do
-      transaction.call("name" => "")
-
-      expect(subscriber.failed).to eq [ { step_name: :verify, args: [ { name: ""} ],  value: "no name" } ]
-    end
-  end
-
-  context "subscribing to step events when passing step arguments" do
-    before do
-      transaction.subscribe(verify: subscriber)
-    end
-
-    let(:container) {
-      Class.new do
-        extend Dry::Container::Mixin
-
-        register :process, -> input { {name: input["name"]} }
-        register :verify,  -> input, name { input[:name].to_s == name ? Dry::Monads.Success(input) : Dry::Monads.Failure("wrong name") }
-        register :persist, -> input { Test::DB << input and true }
-      end
-    }
-
-    specify "subscriber receives success event for the specified step" do
-      transaction.with_step_args(verify: ["Jane"]).call("name" => "Jane")
-
-      expect(subscriber.success).to eq [ { step_name: :verify, args: [ { name: "Jane" }, "Jane"] } ]
-    end
-
-    specify "subscriber receives failure event for the specified step" do
-      transaction.with_step_args(verify: ["Jade"]).call("name" => "")
-
-      expect(subscriber.failed).to eq [ { step_name: :verify, args: [ { name: "" }, "Jade"], value: "wrong name"} ]
-    end
-  end
-end