decouplio 1.0.0alpha2 → 1.0.0alpha3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1b94378c5ef6384c1e88ea9c71ef987b7a607da12cae8ed05f1ffdcc5c575c3b
-  data.tar.gz: 7954e4f1bd9fad05c07be76cbd3b8343477d9f5610751c59840e0b01907b079d
+  metadata.gz: b52142f648d5043e84d6daa6b36026f33d01a6bd9197d5e6f65ac0fb51abac81
+  data.tar.gz: 7825cc21ae535df0c950c7b5eaf34264d37f6fe13f346282bc3a15e88e4e8b8e
 SHA512:
-  metadata.gz: 762378c8f56ca4833f79255396a0a09b449767d04be8dbc07f87b66924f90334f6780b63eeca020853a065d5c227f99a6987ec2cb024cfbffccd62326d1b2f36
-  data.tar.gz: b233ac1a47544de489e147b2b021d1d98968f85feb8dc780d182147d4db6cb81098240f43b9da2893cba2b4cb1e7a823b07619fb7495dce3fb29d70e6174c1b4
+  metadata.gz: 395c7ca0d0618abd369307426edba5ada1d4dc002f55ff8c0906205e08924a07ec60b0905fd2031860a7b32effbe88265139faf397972ea1359448b5c1572ebb
+  data.tar.gz: 0fa93d697696700e24758eb3b774d183b1e24486a5846273c24d6ff7dc3684876b587e0afb90165bdb3f8bde8deeee938fc78d90361b4d0d2c193eeec7870ac0

data/README.md

@@ -37,7 +37,7 @@ Or install it by yourself:
   - [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)
+  - [Doby/Aide](https://github.com/differencialx/decouplio/blob/master/docs/doby_aide.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)

data/benchmarks/multi_step_benchmark.rb

@@ -29,6 +29,7 @@ class RegularServiceTest
     step_seven
     step_eight
     step_nine
+    self
   end
 
   def step_one
@@ -253,55 +254,55 @@ class TrailblazerTestSeveralSteps < Trailblazer::Activity::Railway
 end
 
 class DecouplioStepOne
-  def self.call(ctx:)
+  def self.call(ctx:, **)
     ctx[:step_one] = ctx[:param1]
   end
 end
 
 class DecouplioStepTwo
-  def self.call(ctx:)
+  def self.call(ctx:, **)
     ctx[:step_two] = ctx[:step_one]
   end
 end
 
 class DecouplioStepThree
-  def self.call(ctx:)
+  def self.call(ctx:, **)
     ctx[:step_three] = ctx[:step_two]
   end
 end
 
 class DecouplioStepFour
-  def self.call(ctx:)
+  def self.call(ctx:, **)
     ctx[:step_four] = ctx[:step_three]
   end
 end
 
 class DecouplioStepFive
-  def self.call(ctx:)
+  def self.call(ctx:, **)
     ctx[:step_five] = ctx[:step_four]
   end
 end
 
 class DecouplioStepSix
-  def self.call(ctx:)
+  def self.call(ctx:, **)
     ctx[:step_six] = ctx[:step_five]
   end
 end
 
 class DecouplioStepSeven
-  def self.call(ctx:)
+  def self.call(ctx:, **)
     ctx[:step_seven] = ctx[:step_six]
   end
 end
 
 class DecouplioStepEight
-  def self.call(ctx:)
+  def self.call(ctx:, **)
     ctx[:step_eight] = ctx[:step_seven]
   end
 end
 
 class DecouplioStepNine
-  def self.call(ctx:)
+  def self.call(ctx:, **)
     ctx[:step_nine] = ctx[:step_eight]
   end
 end
@@ -320,7 +321,7 @@ class DecouplioServiceStepsTest < Decouplio::Action
   end
 end
 
-iteration_count = 100_000_0
+iteration_count = 100_00
 
 Benchmark.ips do |x|
   x.report('RegularService') { iteration_count.times { RegularServiceTest.call(param1: 'param1') } }

data/benchmarks/single_step_benchmark.rb

@@ -123,7 +123,7 @@ class TrailblazerTestOneStep < Trailblazer::Activity::Railway
 end
 
 class ServiceAsStep
-  def self.call(ctx:)
+  def self.call(ctx:, **)
     ctx[:step_one] = ctx[:param1]
     ctx[:step_two] = ctx[:step_one]
     ctx[:step_three] = ctx[:step_two]

data/docs/{deny.rb → aide.rb}

@@ -1,6 +1,6 @@
 require_relative '../lib/decouplio'
 
-class SemanticDeny
+class SemanticAide
   def self.call(ctx:, error_store:, semantic:, error_message:)
     ctx[:semantic] = semantic
     error_store.add_error(semantic, error_message)
@@ -10,7 +10,7 @@ end
 class SomeAction < Decouplio::Action
   logic do
     step :step_one
-    deny SemanticDeny, semantic: :bad_request, error_message: 'Bad request'
+    aide SemanticAide, semantic: :bad_request, error_message: 'Bad request'
     step :step_two
   end
 
@@ -48,7 +48,7 @@ failure_action # =>
 # Result: failure
 
 # Railway Flow:
-#   step_one -> SemanticDeny
+#   step_one -> SemanticAide
 
 # Context:
 #   :step_one_param => false

data/docs/{doby_deny.md → doby_aide.md}

@@ -1,13 +1,13 @@
-# Doby/Deny
+# Doby/Aide
 
-It's a step type to make configurable manipulations with action context.
+Steps which make configurable manipulations with action context.
 
 
 ## Signature
 
 ```ruby
 doby(class_constant, **options)
-deny(class_constant, **options)
+aide(class_constant, **options)
 ```
 
 ## Behavior
@@ -18,9 +18,9 @@ deny(class_constant, **options)
 - `doby` doesn't have `on_success, on_failure, if, unless, finish_him` options.
 - All options passed after class constant will be passed as kwargs for `.call` method.
 
-### Deny
-- `deny` behaves similar to `fail`, no matter which value will be returned by `.call` method, it moves to `failure` track.
-- `deny` doesn't have `on_success, on_failure, if, unless, finish_him` options.
+### Aide
+- `aide` behaves similar to `fail`, no matter which value will be returned by `.call` method, it moves to `failure` track.
+- `aide` doesn't have `on_success, on_failure, if, unless, finish_him` options.
 - All options passed after class constant will be passed as kwargs for `.call` method.
 
 
@@ -49,7 +49,7 @@ end
 
 # OR
 
-class SemanticDeny
+class SemanticAide
   def self.call(ctx:, error_store:, semantic:, error_message:)
     ctx[:semantic] = semantic
     error_store.add_error(semantic, error_message)
@@ -81,7 +81,7 @@ end
 class SomeAction < Decouplio::Action
   logic do
     step :user
-    step AssignDoby, to: :current_user, from: :user
+    doby AssignDoby, to: :current_user, from: :user
   end
 
   def user(id:, **)
@@ -107,11 +107,11 @@ action # =>
 # Errors:
 #   {}
 ```
-`SemanticDeny` example.
+`SemanticAide` example.
 ```ruby
 require 'decouplio'
 
-class SemanticDeny
+class SemanticAide
   def self.call(ctx:, error_store:, semantic:, error_message:)
     ctx[:semantic] = semantic
     error_store.add_error(semantic, error_message)
@@ -121,7 +121,7 @@ end
 class SomeAction < Decouplio::Action
   logic do
     step :step_one
-    deny SemanticDeny, semantic: :bad_request, error_message: 'Bad request'
+    aide SemanticAide, semantic: :bad_request, error_message: 'Bad request'
     step :step_two
   end
 
@@ -159,7 +159,7 @@ failure_action # =>
 # Result: failure
 
 # Railway Flow:
-#   step_one -> SemanticDeny
+#   step_one -> SemanticAide
 
 # Context:
 #   :step_one_param => false
@@ -169,3 +169,40 @@ failure_action # =>
 # Errors:
 #   :bad_request => ["Bad request"]
 ```
+
+
+## Options
+
+### Doby
+Has the same options and behavior as [step](https://github.com/differencialx/decouplio/blob/master/docs/step.md), just specify them along with doby class options like here:
+```ruby
+# ...
+
+logic do
+  doby AssignDoby,
+       to: :current_user,
+       from: :user,
+       on_success: :finish_him,
+       if: :condition
+end
+
+# ...
+```
+
+### Aide
+Has the same options and behavior as [fail](https://github.com/differencialx/decouplio/blob/master/docs/fail.md), just specify them along with aide class options like here:
+
+```ruby
+# ...
+
+logic do
+  step :step_one
+  aide SemanticAide,
+       semantic: :bad_request,
+       error_message: 'Bad request',
+       on_failure: :PASS,
+       unless: :condition
+end
+
+# ...
+```

data/docs/index.md

@@ -19,7 +19,7 @@ Decouplio is a zero dependency, thread safe and framework agnostic gem designed
   - [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](https://github.com/differencialx/decouplio/blob/master/docs/doby.md)
+  - [Doby/Aide](https://github.com/differencialx/decouplio/blob/master/docs/doby_aide.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)

data/docs/logic_block.md

@@ -23,3 +23,7 @@ Possible logic steps:
 |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)|
+|doby|[--->>>](https://github.com/differencialx/decouplio/blob/master/docs/doby_aide.md)|
+|aide|[--->>>](https://github.com/differencialx/decouplio/blob/master/docs/doby_aide.md)|
+|inner action|[--->>>](https://github.com/differencialx/decouplio/blob/master/docs/inner_action.md)|
+|step as service|[--->>>](https://github.com/differencialx/decouplio/blob/master/docs/step_as_a_service.md)|

data/docs/octo.md

@@ -5,7 +5,7 @@ It's a step type which helps to implement strategy pattern.
 ## Signature
 
 ```ruby
-octo(octo_name, ctx_key:, **options) do
+octo(octo_name, ctx_key:, method:, **options) do
   on :key1, palp: :palp_name_one
   on :key2, palp: :palp_name_two
   on :key3, palp: :palp_name_three
@@ -14,7 +14,11 @@ end
 
 ## Behavior
 
-- depending on the value inside `ctx_key` in context `octo` will perform flow defined for this key. So basically `octo` will be replaces with flow you defined.
+- Depending on some value you can perform different flow. Imagine that `octo` will be replaced with another flow.
+- You have two options to set value for octo. By `ctx_key` and `method` options.
+- `ctx_key` and `method` options are controversial, so you can use only one of them.
+- with `ctx_key` you can specify the key inside action context with value for `octo`
+- with `method` you can specify method name symbol, which will be called to retrieve `octo` value, like we do for `if` and `unless` options.
 ```ruby
 logic do
   palp :palp_name_one do
@@ -263,7 +267,60 @@ Currently only one possibility is present to define flow for `octo`, it's `palp`
 ***
 ## Options
 
+### ctx_key: context key with octo value
+
+See examples above
+
+***
+
+### method: method symbol which returns octo value
+<details><summary><b>EXAMPLE (CLICK ME)</b></summary>
+<p>
+
+  ```ruby
+    require 'decouplio'
+
+    class SomeAction < Decouplio::Action
+      logic do
+        palp :palp_one do
+          step :step_one
+        end
+
+        palp :palp_two do
+          step :step_two
+        end
+
+        octo :octo_name, method: :what_is_next? do
+          on :option_one, palp: :palp_one
+          on :option_two, palp: :palp_two
+        end
+      end
+
+      def step_one(**)
+        # ...
+      end
+
+      def step_two(**)
+        # ...
+      end
+
+      def what_is_next?(connection:, url:)
+        connection.get(url).body[:decision]
+      end
+    end
+  ```
+
+</p>
+</details>
+
+***
+
 ### if: condition method name
 The same as for [step](https://github.com/differencialx/decouplio/blob/master/docs/step.md)
+
+***
+
 ### unless: condition method name
 The same as for [step](https://github.com/differencialx/decouplio/blob/master/docs/step.md)
+
+***

data/docs/quick_start.md

@@ -66,6 +66,6 @@ Learn more about all features:
   - [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](https://github.com/differencialx/decouplio/blob/master/docs/doby.md)
+  - [Doby/Aide](https://github.com/differencialx/decouplio/blob/master/docs/doby_aide.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)

data/lib/decouplio/composer.rb

@@ -21,7 +21,7 @@ require_relative 'steps/service_step'
 require_relative 'steps/service_fail'
 require_relative 'steps/service_pass'
 require_relative 'steps/doby'
-require_relative 'steps/deny'
+require_relative 'steps/aide'
 require_relative 'options_validator'
 require_relative 'validators/condition'
 
@@ -130,9 +130,9 @@ module Decouplio
         when Decouplio::Const::Types::SERVICE_TYPE_PASS
           create_inner_service_pass(stp, flow)
         when Decouplio::Const::Types::DOBY_TYPE
-          create_doby(stp)
-        when Decouplio::Const::Types::DENY_TYPE
-          create_deny(stp)
+          create_doby(stp, flow)
+        when Decouplio::Const::Types::AIDE_TYPE
+          create_aide(stp, flow)
         end
       end
 
@@ -186,7 +186,8 @@ module Decouplio
       def create_octo(stp)
         Decouplio::Steps::Octo.new(
           name: stp[:name],
-          ctx_key: stp[:ctx_key]
+          ctx_key: stp[:ctx_key],
+          method: stp[:method]
         )
       end
 
@@ -269,19 +270,23 @@ module Decouplio
         )
       end
 
-      def create_doby(stp)
+      def create_doby(stp, flow)
         Decouplio::Steps::Doby.new(
           name: stp[:name],
           doby_class: stp[:doby_class],
-          doby_options: stp[:doby_options]
+          doby_options: stp[:doby_options],
+          on_success_type: success_type(flow, stp),
+          on_failure_type: failure_type(flow, stp)
         )
       end
 
-      def create_deny(stp)
-        Decouplio::Steps::Deny.new(
+      def create_aide(stp, flow)
+        Decouplio::Steps::Aide.new(
           name: stp[:name],
-          deny_class: stp[:deny_class],
-          deny_options: stp[:deny_options]
+          aide_class: stp[:aide_class],
+          aide_options: stp[:aide_options],
+          on_success_type: success_type(flow, stp),
+          on_failure_type: failure_type(flow, stp)
         )
       end
 
@@ -305,8 +310,8 @@ module Decouplio
             compose_fail_flow(stp, step_id, flow, idx, flow_hash, next_steps)
           when Decouplio::Const::Types::DOBY_TYPE
             compose_doby_flow(stp, step_id, flow, idx, flow_hash, next_steps)
-          when Decouplio::Const::Types::DENY_TYPE
-            compose_deny_flow(stp, step_id, flow, idx, flow_hash, next_steps)
+          when Decouplio::Const::Types::AIDE_TYPE
+            compose_aide_flow(stp, step_id, flow, idx, flow_hash, next_steps)
           when Decouplio::Const::Types::IF_TYPE_PASS, Decouplio::Const::Types::UNLESS_TYPE_PASS
             compose_pass_condition_flow(stp, flow, idx, flow_hash)
           when Decouplio::Const::Types::IF_TYPE_FAIL, Decouplio::Const::Types::UNLESS_TYPE_FAIL
@@ -340,22 +345,22 @@ module Decouplio
         stp[:flow][Decouplio::Const::Results::FINISH_HIM] = Decouplio::Const::Results::NO_STEP
       end
 
-      def compose_doby_flow(stp, _step_id, flow, idx, flow_hash, next_steps)
+      def compose_doby_flow(stp, step_id, flow, idx, flow_hash, next_steps)
         flow_values = flow.values + (next_steps&.values || [])
         stp[:flow][Decouplio::Const::Results::PASS] = next_success_step(
           flow_values,
           idx,
-          nil
+          flow[step_id][:on_success]
         )
         stp[:flow][Decouplio::Const::Results::FAIL] = next_failure_step(
           flow_values,
           idx,
-          nil
+          flow[step_id][:on_failure]
         )
         stp[:flow][Decouplio::Const::Results::ERROR] = next_failure_step(
           flow_values,
           idx,
-          nil
+          flow[step_id][:on_error]
         )
         stp[:flow][Decouplio::Const::Results::PASS] ||= flow_hash[Decouplio::Const::Results::PASS]
         stp[:flow][Decouplio::Const::Results::FAIL] ||= flow_hash[Decouplio::Const::Results::FAIL]
@@ -363,22 +368,22 @@ module Decouplio
         stp[:flow][Decouplio::Const::Results::FINISH_HIM] = Decouplio::Const::Results::NO_STEP
       end
 
-      def compose_deny_flow(stp, _step_id, flow, idx, flow_hash, next_steps)
+      def compose_aide_flow(stp, step_id, flow, idx, flow_hash, next_steps)
         flow_values = flow.values + (next_steps&.values || [])
         stp[:flow][Decouplio::Const::Results::PASS] = next_failure_step(
           flow_values,
           idx,
-          nil
+          flow[step_id][:on_success]
         )
         stp[:flow][Decouplio::Const::Results::FAIL] = next_failure_step(
           flow_values,
           idx,
-          nil
+          flow[step_id][:on_failure]
         )
         stp[:flow][Decouplio::Const::Results::ERROR] = next_failure_step(
           flow_values,
           idx,
-          nil
+          flow[step_id][:on_error]
         )
         stp[:flow][Decouplio::Const::Results::PASS] ||= flow_hash[Decouplio::Const::Results::FAIL]
         stp[:flow][Decouplio::Const::Results::FAIL] ||= flow_hash[Decouplio::Const::Results::FAIL]

data/lib/decouplio/const/doby_aide_options.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Decouplio
+  module Const
+    module DobyAideOptions
+      ALLOWED = %i[
+        on_success
+        on_failure
+        finish_him
+        if
+        unless
+      ].freeze
+    end
+  end
+end

data/lib/decouplio/const/types.rb

@@ -14,7 +14,7 @@ module Decouplio
       UNLESS_TYPE_FAIL = :unless_fail
       OCTO_TYPE = :octo
       DOBY_TYPE = :doby
-      DENY_TYPE = :deny
+      AIDE_TYPE = :aide
       ACTION_TYPE_STEP = :action_step
       ACTION_TYPE_FAIL = :action_fail
       ACTION_TYPE_PASS = :action_pass
@@ -82,6 +82,14 @@ module Decouplio
         SERVICE_TYPE_PASS => {
           IF_TYPE => IF_TYPE_PASS,
           UNLESS_TYPE => UNLESS_TYPE_PASS
+        },
+        DOBY_TYPE => {
+          IF_TYPE => IF_TYPE_PASS,
+          UNLESS_TYPE => UNLESS_TYPE_PASS
+        },
+        AIDE_TYPE => {
+          IF_TYPE => IF_TYPE_FAIL,
+          UNLESS_TYPE => UNLESS_TYPE_FAIL
         }
       }.freeze
       STEP_TYPE_TO_RESQ_TYPE = {
@@ -95,7 +103,7 @@ module Decouplio
         IF_TYPE_FAIL => RESQ_TYPE_FAIL,
         UNLESS_TYPE_FAIL => RESQ_TYPE_FAIL,
         DOBY_TYPE => RESQ_TYPE_STEP,
-        DENY_TYPE => RESQ_TYPE_FAIL
+        AIDE_TYPE => RESQ_TYPE_FAIL
       }.freeze
       STEP_TYPE_TO_INNER_TYPE = {
         STEP_TYPE => ACTION_TYPE_STEP,
@@ -118,7 +126,7 @@ module Decouplio
         WRAP_TYPE,
         RESQ_TYPE,
         DOBY_TYPE,
-        DENY_TYPE
+        AIDE_TYPE
       ].freeze
       PASS_FLOW = [
         STEP_TYPE,
@@ -139,7 +147,7 @@ module Decouplio
         UNLESS_TYPE_FAIL,
         ACTION_TYPE_FAIL,
         SERVICE_TYPE_FAIL,
-        DENY_TYPE
+        AIDE_TYPE
       ].freeze
 
       MAIN_FLOW_TYPES = [
@@ -148,7 +156,7 @@ module Decouplio
         PASS_TYPE,
         WRAP_TYPE,
         DOBY_TYPE,
-        DENY_TYPE
+        AIDE_TYPE
       ].freeze
       SUCCESS_TRACK_STEP_TYPES = [
         STEP_TYPE,
@@ -172,7 +180,7 @@ module Decouplio
         RESQ_TYPE_FAIL,
         ACTION_TYPE_FAIL,
         SERVICE_TYPE_FAIL,
-        DENY_TYPE
+        AIDE_TYPE
       ].freeze
     end
   end

data/lib/decouplio/const/validations/aide.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+module Decouplio
+  module Const
+    module Validations
+      module Aide
+        VALIDATION_ERROR_MESSAGE = <<~ERROR_MESSAGE
+          Next options are not allowed for "aide":
+          %s
+
+          Details:
+          %s
+
+          Allowed options are:
+          %s
+
+          Please read the manual about allowed options here:
+          %s
+        ERROR_MESSAGE
+
+        ALLOWED_OPTIONS_MESSAGE = <<~ALLOWED_OPTIONS
+          on_success: <step name OR :finish_him>
+          on_failure: <step name OR :finish_him>
+          finish_him: :on_success
+          finish_him: :on_failure
+          finish_him: true
+          if: <instance method symbol>
+          unless: <instance method symbol>
+        ALLOWED_OPTIONS
+        MANUAL_URL = 'https://stub.aide.manual.url'
+        OPTIONS_IS_NOT_ALLOWED = '"%s" option(s) is not allowed for "aide"'
+        METHOD_NOT_DEFINED = 'aide :%s'
+        CONTROVERSIAL_KEYS = '"%s" option(s) is not allowed along with "%s" option(s)'
+        FIRST_STEP = '"aide" can not be the first step'
+      end
+    end
+  end
+end

data/lib/decouplio/const/validations/doby.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+module Decouplio
+  module Const
+    module Validations
+      module Doby
+        VALIDATION_ERROR_MESSAGE = <<~ERROR_MESSAGE
+          Next options are not allowed for "doby":
+          %s
+
+          Details:
+          %s
+
+          Allowed options are:
+          %s
+
+          Please read the manual about allowed options here:
+          %s
+        ERROR_MESSAGE
+
+        ALLOWED_OPTIONS_MESSAGE = <<~ALLOWED_OPTIONS
+          on_success: <step name OR :finish_him>
+          on_failure: <step name OR :finish_him>
+          finish_him: :on_success
+          finish_him: :on_failure
+          if: <instance method symbol>
+          unless: <instance method symbol>
+        ALLOWED_OPTIONS
+        MANUAL_URL = 'https://stub.doby.manual.url'
+        OPTIONS_IS_NOT_ALLOWED = '"%s" option(s) is not allowed for "doby"'
+        METHOD_NOT_DEFINED = 'doby :%s'
+        CONTROVERSIAL_KEYS = '"%s" option(s) is not allowed along with "%s" option(s)'
+      end
+    end
+  end
+end

data/lib/decouplio/const/validations/fail.rb

@@ -19,6 +19,10 @@ module Decouplio
         ERROR_MESSAGE
 
         ALLOWED_OPTIONS_MESSAGE = <<~ALLOWED_OPTIONS
+          on_success: <step name OR :finish_him>
+          on_failure: <step name OR :finish_him>
+          finish_him: :on_success
+          finish_him: :on_failure
           finish_him: true
           if: <instance method symbol>
           unless: <instance method symbol>

data/lib/decouplio/const/validations/octo.rb

@@ -28,7 +28,8 @@ module Decouplio
           %s
         ERROR_MESSAGE
         ALLOWED_OPTIONS_MESSAGE = <<~ALLOWED_OPTIONS
-          ctx_key: <ctx key with strategy name to be used for strategy mapping> - required
+          ctx_key: <ctx key with strategy name to be used for strategy mapping> - required if "method" option is not present
+          method: <method which will return strategy name to be used for strategy mapping> - required if "ctx_key" option is not present
           if: <instance method symbol>
           unless: <instance method symbol>
         ALLOWED_OPTIONS