decouplio 1.0.0alpha1 → 1.0.0alpha2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 455ba12276135c618f5d53a9ff53bf8d3c7ec8074e387ea4790f2307e344c4ec
-  data.tar.gz: 126488804cc9391fdb0fe3f9a0d2ac4060fa42bbe1d733af64bec5681e9f890d
+  metadata.gz: 1b94378c5ef6384c1e88ea9c71ef987b7a607da12cae8ed05f1ffdcc5c575c3b
+  data.tar.gz: 7954e4f1bd9fad05c07be76cbd3b8343477d9f5610751c59840e0b01907b079d
 SHA512:
-  metadata.gz: '00912905816c9e9393e907185347ddd3d9fb2de753a2fa3d7aeaae704ef8d93e26ff5f3ae62a7589384921717b9d764af2e2502b7c43866fb503f63837079999'
-  data.tar.gz: 50d1d117ee1ec34f94f750c1f2d1aad73f41127e8585bd01ee32209b361d067b6fa054b242878e18bfa01682344388badb386dc6a39883a1957516ccfc4a202f
+  metadata.gz: 762378c8f56ca4833f79255396a0a09b449767d04be8dbc07f87b66924f90334f6780b63eeca020853a065d5c227f99a6987ec2cb024cfbffccd62326d1b2f36
+  data.tar.gz: b233ac1a47544de489e147b2b021d1d98968f85feb8dc780d182147d4db6cb81098240f43b9da2893cba2b4cb1e7a823b07619fb7495dce3fb29d70e6174c1b4

data/.rubocop.yml

@@ -104,3 +104,7 @@ RSpec/MultipleMemoizedHelpers:
 Naming/PredicateName:
   Exclude:
     - lib/decouplio/step.rb
+
+Naming/MethodParameterName:
+  Exclude:
+  - spec/support/cases/**/*

data/README.md

@@ -14,16 +14,40 @@ And then execute:
 
     $ bundle
 
-Or install it yourself as:
+Or install it by yourself:
 
     $ gem install decouplio
 
-# [>>>>>>>DOCS HERE<<<<<<<](https://github.com/differencialx/decouplio/blob/master/docs/index.md)
+## Currently decouplio is in alpha testing, more features will come soon.
+
+### Compatibility
+  Ruby:
+ - 2.7
+ - 3.0
+
+ ### Docs
+
+- [Quick start](https://github.com/differencialx/decouplio/blob/master/docs/quick_start.md)
+- [Logic block](https://github.com/differencialx/decouplio/blob/master/docs/logic_block.md)
+  - [Context](https://github.com/differencialx/decouplio/blob/master/docs/context.md)
+  - [Step](https://github.com/differencialx/decouplio/blob/master/docs/step.md)
+  - [Fail](https://github.com/differencialx/decouplio/blob/master/docs/fail.md)
+  - [Pass](https://github.com/differencialx/decouplio/blob/master/docs/pass.md)
+  - [Octo](https://github.com/differencialx/decouplio/blob/master/docs/octo.md)
+  - [Wrap](https://github.com/differencialx/decouplio/blob/master/docs/wrap.md)
+  - [Resq](https://github.com/differencialx/decouplio/blob/master/docs/resq.md)
+  - [Inner action](https://github.com/differencialx/decouplio/blob/master/docs/inner_action.md)
+  - [Doby/Deny](https://github.com/differencialx/decouplio/blob/master/docs/doby_deny.md)
+  - [Step as a service](https://github.com/differencialx/decouplio/blob/master/docs/step_as_a_service.md)
+- [Error store](https://github.com/differencialx/decouplio/blob/master/docs/error_store.md)
+- [Benchmarks](https://github.com/differencialx/decouplio/blob/master/docs/benchmarks.md)
 
 ## Contributing
 
 Bug reports and pull requests are welcome on GitHub at https://github.com/differencialx/decouplio.
 
+More detailed description for contribution process will be added later.
+
 ## License
 
 The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/benchmarks/Gemfile

@@ -3,7 +3,8 @@
 source 'https://rubygems.org'
 
 gem 'active_interaction', '~> 4.1'
-gem 'decouplio', path: '../'
+gem 'benchmark-ips'
+gem 'decouplio'
 gem 'interactor', '~> 3.0'
 gem 'mutations'
 gem 'pry-byebug'

data/benchmarks/multi_step_benchmark.rb

@@ -0,0 +1,335 @@
+# frozen_string_literal: true
+
+require 'active_interaction'
+require 'interactor'
+require 'mutations'
+require 'trailblazer'
+require 'decouplio'
+require 'benchmark/ips'
+
+class RegularServiceTest
+  attr_accessor :ctx, :param1
+
+  def self.call(param1:)
+    new(param1: param1).call
+  end
+
+  def initialize(param1:)
+    @param1 = param1
+    @ctx = {}
+  end
+
+  def call
+    step_one
+    step_two
+    step_three
+    step_four
+    step_five
+    step_six
+    step_seven
+    step_eight
+    step_nine
+  end
+
+  def step_one
+    ctx[:step_one] = param1
+  end
+
+  def step_two
+    ctx[:step_two] = ctx[:step_one]
+  end
+
+  def step_three
+    ctx[:step_three] = ctx[:step_two]
+  end
+
+  def step_four
+    ctx[:step_four] = ctx[:step_three]
+  end
+
+  def step_five
+    ctx[:step_five] = ctx[:step_four]
+  end
+
+  def step_six
+    ctx[:step_six] = ctx[:step_five]
+  end
+
+  def step_seven
+    ctx[:step_seven] = ctx[:step_six]
+  end
+
+  def step_eight
+    ctx[:step_eight] = ctx[:step_seven]
+  end
+
+  def step_nine
+    ctx[:step_nine] = ctx[:step_eight]
+  end
+end
+
+class DecouplioTestSeveralSteps < Decouplio::Action
+  logic do
+    step :step_one
+    step :step_two
+    step :step_three
+    step :step_four
+    step :step_five
+    step :step_six
+    step :step_seven
+    step :step_eight
+    step :step_nine
+  end
+
+  def step_one(param1:, **)
+    ctx[:step_one] = param1
+  end
+
+  def step_two(step_one:, **)
+    ctx[:step_two] = step_one
+  end
+
+  def step_three(step_two:, **)
+    ctx[:step_three] = step_two
+  end
+
+  def step_four(step_three:, **)
+    ctx[:step_four] = step_three
+  end
+
+  def step_five(step_four:, **)
+    ctx[:step_five] = step_four
+  end
+
+  def step_six(step_five:, **)
+    ctx[:step_six] = step_five
+  end
+
+  def step_seven(step_six:, **)
+    ctx[:step_seven] = step_six
+  end
+
+  def step_eight(step_seven:, **)
+    ctx[:step_eight] = step_seven
+  end
+
+  def step_nine(step_eight:, **)
+    ctx[:step_nine] = step_eight
+  end
+end
+
+class StepOne
+  include Interactor
+
+  def call
+    context.step_one = context.param1
+  end
+end
+
+class StepTwo
+  include Interactor
+
+  def call
+    context.step_two = context.step_one
+  end
+end
+
+class StepThree
+  include Interactor
+
+  def call
+    context.step_three = context.step_two
+  end
+end
+
+class StepFour
+  include Interactor
+
+  def call
+    context.step_four = context.step_three
+  end
+end
+
+class StepFive
+  include Interactor
+
+  def call
+    context.step_five = context.step_four
+  end
+end
+
+class StepSix
+  include Interactor
+
+  def call
+    context.step_six = context.step_five
+  end
+end
+
+class StepSeven
+  include Interactor
+
+  def call
+    context.step_seven = context.step_six
+  end
+end
+
+class StepEight
+  include Interactor
+
+  def call
+    context.step_eight = context.step_seven
+  end
+end
+
+class StepNine
+  include Interactor
+
+  def call
+    context.step_nine = context.step_eight
+  end
+end
+
+class InteractorTestOrganizer
+  include Interactor::Organizer
+
+  organize StepOne,
+           StepTwo,
+           StepThree,
+           StepFour,
+           StepFive,
+           StepSix,
+           StepSeven,
+           StepEight,
+           StepNine
+end
+
+class TrailblazerTestSeveralSteps < Trailblazer::Activity::Railway
+  step :step_one
+  step :step_two
+  step :step_three
+  step :step_four
+  step :step_five
+  step :step_six
+  step :step_seven
+  step :step_eight
+  step :step_nine
+
+  def step_one(ctx, param1:, **)
+    ctx[:step_one] = param1
+  end
+
+  def step_two(ctx, step_one:, **)
+    ctx[:step_two] = step_one
+  end
+
+  def step_three(ctx, step_two:, **)
+    ctx[:step_three] = step_two
+  end
+
+  def step_four(ctx, step_three:, **)
+    ctx[:step_four] = step_three
+  end
+
+  def step_five(ctx, step_four:, **)
+    ctx[:step_five] = step_four
+  end
+
+  def step_six(ctx, step_five:, **)
+    ctx[:step_six] = step_five
+  end
+
+  def step_seven(ctx, step_six:, **)
+    ctx[:step_seven] = step_six
+  end
+
+  def step_eight(ctx, step_seven:, **)
+    ctx[:step_eight] = step_seven
+  end
+
+  def step_nine(ctx, step_eight:, **)
+    ctx[:step_nine] = step_eight
+  end
+end
+
+class DecouplioStepOne
+  def self.call(ctx:)
+    ctx[:step_one] = ctx[:param1]
+  end
+end
+
+class DecouplioStepTwo
+  def self.call(ctx:)
+    ctx[:step_two] = ctx[:step_one]
+  end
+end
+
+class DecouplioStepThree
+  def self.call(ctx:)
+    ctx[:step_three] = ctx[:step_two]
+  end
+end
+
+class DecouplioStepFour
+  def self.call(ctx:)
+    ctx[:step_four] = ctx[:step_three]
+  end
+end
+
+class DecouplioStepFive
+  def self.call(ctx:)
+    ctx[:step_five] = ctx[:step_four]
+  end
+end
+
+class DecouplioStepSix
+  def self.call(ctx:)
+    ctx[:step_six] = ctx[:step_five]
+  end
+end
+
+class DecouplioStepSeven
+  def self.call(ctx:)
+    ctx[:step_seven] = ctx[:step_six]
+  end
+end
+
+class DecouplioStepEight
+  def self.call(ctx:)
+    ctx[:step_eight] = ctx[:step_seven]
+  end
+end
+
+class DecouplioStepNine
+  def self.call(ctx:)
+    ctx[:step_nine] = ctx[:step_eight]
+  end
+end
+
+class DecouplioServiceStepsTest < Decouplio::Action
+  logic do
+    step DecouplioStepOne
+    step DecouplioStepTwo
+    step DecouplioStepThree
+    step DecouplioStepFour
+    step DecouplioStepFive
+    step DecouplioStepSix
+    step DecouplioStepSeven
+    step DecouplioStepEight
+    step DecouplioStepNine
+  end
+end
+
+iteration_count = 100_000_0
+
+Benchmark.ips do |x|
+  x.report('RegularService') { iteration_count.times { RegularServiceTest.call(param1: 'param1') } }
+  x.report('Decouplio several steps') { iteration_count.times { DecouplioTestSeveralSteps.call(param1: 'param1') } }
+  x.report('Decouplio service steps') { iteration_count.times { DecouplioServiceStepsTest.call(param1: 'param1') } }
+  x.report('Trailblazer several steps') { iteration_count.times { TrailblazerTestSeveralSteps.call(param1: 'param1') } }
+  x.report('Interactor several interactions with organizer') do
+    iteration_count.times { InteractorTestOrganizer.call(param1: 'param1') }
+  end
+
+  x.compare!
+end

data/benchmarks/single_step_benchmark.rb

@@ -0,0 +1,159 @@
+# frozen_string_literal: true
+
+require 'active_interaction'
+require 'interactor'
+require 'mutations'
+require 'trailblazer'
+require 'decouplio'
+require 'benchmark/ips'
+
+class MutationTest < Mutations::Command
+  optional do
+    string :param1
+  end
+
+  def execute
+    @context = {}
+    @context[:step_one] = param1
+    @context[:step_two] = @context[:step_one]
+    @context[:step_three] = @context[:step_two]
+    @context[:step_four] = @context[:step_three]
+    @context[:step_five] = @context[:step_four]
+    @context[:step_six] = @context[:step_five]
+    @context[:step_seven] = @context[:step_six]
+    @context[:step_eight] = @context[:step_seven]
+    @context[:step_nine] = @context[:step_eight]
+
+    @context
+  end
+end
+
+class ActiveInteractionTest < ActiveInteraction::Base
+  string :param1
+
+  def execute
+    @context = {}
+    @context[:step_one] = param1
+    @context[:step_two] = @context[:step_one]
+    @context[:step_three] = @context[:step_two]
+    @context[:step_four] = @context[:step_three]
+    @context[:step_five] = @context[:step_four]
+    @context[:step_six] = @context[:step_five]
+    @context[:step_seven] = @context[:step_six]
+    @context[:step_eight] = @context[:step_seven]
+    @context[:step_nine] = @context[:step_eight]
+
+    @context
+  end
+end
+
+class DecouplioTestOneStep < Decouplio::Action
+  logic do
+    step :step_one
+  end
+
+  def step_one(param1:, **)
+    ctx[:step_one] = param1
+    ctx[:step_two] = ctx[:step_one]
+    ctx[:step_three] = ctx[:step_two]
+    ctx[:step_four] = ctx[:step_three]
+    ctx[:step_five] = ctx[:step_four]
+    ctx[:step_six] = ctx[:step_five]
+    ctx[:step_seven] = ctx[:step_six]
+    ctx[:step_eight] = ctx[:step_seven]
+    ctx[:step_nine] = ctx[:step_eight]
+  end
+end
+
+class InteractorWithoutOrganizer
+  include Interactor
+
+  def call
+    context.step_one = context.param1
+    context.step_two = context.step_one
+    context.step_three = context.step_two
+    context.step_four = context.step_three
+    context.step_five = context.step_four
+    context.step_six = context.step_five
+    context.step_seven = context.step_six
+    context.step_eight = context.step_seven
+    context.step_nine = context.step_eight
+  end
+end
+
+class RegularServiceTest
+  attr_accessor :ctx, :param1
+
+  def self.call(param1:)
+    new(param1: param1).call
+  end
+
+  def initialize(param1:)
+    @param1 = param1
+    @ctx = {}
+  end
+
+  def call
+    ctx[:step_one] = param1
+    ctx[:step_two] = ctx[:step_one]
+    ctx[:step_three] = ctx[:step_two]
+    ctx[:step_four] = ctx[:step_three]
+    ctx[:step_five] = ctx[:step_four]
+    ctx[:step_six] = ctx[:step_five]
+    ctx[:step_seven] = ctx[:step_six]
+    ctx[:step_eight] = ctx[:step_seven]
+    ctx[:step_nine] = ctx[:step_eight]
+  end
+end
+
+class TrailblazerTestOneStep < Trailblazer::Activity::Railway
+  step :step_one
+
+  def step_one(ctx, param1:, **)
+    ctx[:step_one] = param1
+    ctx[:step_two] = ctx[:step_one]
+    ctx[:step_three] = ctx[:step_two]
+    ctx[:step_four] = ctx[:step_three]
+    ctx[:step_five] = ctx[:step_four]
+    ctx[:step_six] = ctx[:step_five]
+    ctx[:step_seven] = ctx[:step_six]
+    ctx[:step_eight] = ctx[:step_seven]
+    ctx[:step_nine] = ctx[:step_eight]
+  end
+end
+
+class ServiceAsStep
+  def self.call(ctx:)
+    ctx[:step_one] = ctx[:param1]
+    ctx[:step_two] = ctx[:step_one]
+    ctx[:step_three] = ctx[:step_two]
+    ctx[:step_four] = ctx[:step_three]
+    ctx[:step_five] = ctx[:step_four]
+    ctx[:step_six] = ctx[:step_five]
+    ctx[:step_seven] = ctx[:step_six]
+    ctx[:step_eight] = ctx[:step_seven]
+    ctx[:step_nine] = ctx[:step_eight]
+  end
+end
+
+class DecouplioTestOneStepAsService < Decouplio::Action
+  logic do
+    step ServiceAsStep
+  end
+end
+
+iteration_count = 100_000
+
+Benchmark.ips do |x|
+  x.report('Mutation') { iteration_count.times { MutationTest.run(param1: 'param1') } }
+  x.report('ActiveInteraction') { iteration_count.times { ActiveInteractionTest.run(param1: 'param1') } }
+  x.report('Trailblazer one step') { iteration_count.times { TrailblazerTestOneStep.call(param1: 'param1') } }
+  x.report('Interactor one interactor') { iteration_count.times { InteractorWithoutOrganizer.call(param1: 'param1') } }
+  x.report('RegularService') { iteration_count.times { RegularServiceTest.call(param1: 'param1') } }
+  x.report('Decouplio one step') { iteration_count.times { DecouplioTestOneStep.call(param1: 'param1') } }
+  x.report('Decouplio one step as service') do
+    iteration_count.times { DecouplioTestOneStepAsService.call(param1: 'param1') }
+  end
+
+  x.compare!
+end

data/docker-compose.yml

@@ -1,11 +1,22 @@
 version: "3.7"
 
 services:
-  benchmark:
+  benchmark_single_step:
     build:
       dockerfile: benchmarks/Dockerfile
       context: .
-    command: "ruby benchmarks.rb"
+    command: "ruby single_step_benchmark.rb"
+    deploy:
+      resources:
+        limits:
+          cpus: '1'
+          memory: 400M
+
+  benchmark_multi_step:
+    build:
+      dockerfile: benchmarks/Dockerfile
+      context: .
+    command: "ruby multi_step_benchmark.rb"
     deploy:
       resources:
         limits:

data/docs/deny.rb

@@ -0,0 +1,59 @@
+require_relative '../lib/decouplio'
+
+class SemanticDeny
+  def self.call(ctx:, error_store:, semantic:, error_message:)
+    ctx[:semantic] = semantic
+    error_store.add_error(semantic, error_message)
+  end
+end
+
+class SomeAction < Decouplio::Action
+  logic do
+    step :step_one
+    deny SemanticDeny, semantic: :bad_request, error_message: 'Bad request'
+    step :step_two
+  end
+
+  def step_one(step_one_param:, **)
+    ctx[:step_one] = step_one_param
+  end
+
+  def step_two(**)
+    ctx[:step_two] = 'Success'
+  end
+
+  def fail_one(**)
+    ctx[:fail_one] = 'Failure'
+  end
+end
+
+success_action = SomeAction.call(step_one_param: true)
+failure_action = SomeAction.call(step_one_param: false)
+
+success_action # =>
+# Result: success
+
+# Railway Flow:
+#   step_one -> step_two
+
+# Context:
+#   :step_one_param => true
+#   :step_one => true
+#   :step_two => "Success"
+
+# Errors:
+#   None
+
+failure_action # =>
+# Result: failure
+
+# Railway Flow:
+#   step_one -> SemanticDeny
+
+# Context:
+#   :step_one_param => false
+#   :step_one => false
+#   :semantic => :bad_request
+
+# Errors:
+#   :bad_request => ["Bad request"]

data/docs/doby.rb

@@ -1,7 +1,7 @@
 require_relative '../lib/decouplio'
 
 class AssignDoby
-  def self.call(ctx:, to:, from: nil, value: nil)
+  def self.call(ctx:, to:, from: nil, value: nil, **)
     raise 'from/value is empty' unless from || value
 
     ctx[to] = value || ctx[from]