decouplio 1.0.0alpha

data/lib/decouplio/errors/step_name_error.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+require_relative 'base_error'
+require_relative '../const/validations/common'
+
+module Decouplio
+  module Errors
+    class StepNameError < Decouplio::Errors::BaseError
+      def template
+        Decouplio::Const::Validations::Common::STEP_NAME
+      end
+
+      def interpolation_values
+        [
+          @errored_option
+        ]
+      end
+    end
+  end
+end

data/lib/decouplio/errors/wrap_block_is_not_defined_error.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+require_relative 'base_error'
+require_relative '../const/validations/wrap'
+
+module Decouplio
+  module Errors
+    class WrapBlockIsNotDefinedError < Decouplio::Errors::BaseError
+      def template
+        Decouplio::Const::Validations::Wrap::NOT_DEFINED
+      end
+
+      def interpolation_values
+        []
+      end
+    end
+  end
+end

data/lib/decouplio/errors/wrap_controversial_keys_error.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+require_relative 'base_error'
+require_relative '../const/validations/wrap'
+
+module Decouplio
+  module Errors
+    class WrapControversialKeysError < Decouplio::Errors::BaseError
+      def template
+        Decouplio::Const::Validations::Wrap::VALIDATION_ERROR_MESSAGE
+      end
+
+      def interpolation_values
+        [
+          @errored_option,
+          format(
+            Decouplio::Const::Validations::Wrap::CONTROVERSIAL_KEYS,
+            *@details
+          ),
+          Decouplio::Const::Validations::Wrap::ALLOWED_OPTIONS_MESSAGE,
+          Decouplio::Const::Validations::Wrap::MANUAL_URL
+        ]
+      end
+    end
+  end
+end

data/lib/decouplio/errors/wrap_finish_him_error.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+require_relative 'base_error'
+require_relative '../const/validations/wrap'
+
+module Decouplio
+  module Errors
+    class WrapFinishHimError < Decouplio::Errors::BaseError
+      def template
+        Decouplio::Const::Validations::Wrap::VALIDATION_ERROR_MESSAGE
+      end
+
+      def interpolation_values
+        [
+          @errored_option,
+          format(
+            Decouplio::Const::Validations::Common::WRONG_FINISH_HIM_VALUE,
+            @details
+          ),
+          Decouplio::Const::Validations::Wrap::ALLOWED_OPTIONS_MESSAGE,
+          Decouplio::Const::Validations::Wrap::MANUAL_URL
+        ]
+      end
+    end
+  end
+end

data/lib/decouplio/errors/wrap_klass_method_error.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+require_relative 'base_error'
+require_relative '../const/validations/wrap'
+
+module Decouplio
+  module Errors
+    class WrapKlassMethodError < Decouplio::Errors::BaseError
+      def template
+        Decouplio::Const::Validations::Wrap::VALIDATION_ERROR_MESSAGE
+      end
+
+      def interpolation_values
+        [
+          @errored_option,
+          Decouplio::Const::Validations::Wrap::KLASS_AND_METHOD_PRESENCE,
+          Decouplio::Const::Validations::Wrap::ALLOWED_OPTIONS_MESSAGE,
+          Decouplio::Const::Validations::Wrap::MANUAL_URL
+        ]
+      end
+    end
+  end
+end

data/lib/decouplio/flow.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+require_relative 'logic_dsl'
+require_relative 'composer'
+
+module Decouplio
+  class Flow
+    def self.call(logic:, action_class:)
+      logic_container_raw_data = Class.new(Decouplio::LogicDsl, &logic)
+
+      Decouplio::Composer.compose(
+        logic_container_raw_data: logic_container_raw_data,
+        action_class: action_class
+      )
+    end
+  end
+end

data/lib/decouplio/logic_dsl.rb

@@ -0,0 +1,96 @@
+# frozen_string_literal: true
+
+require_relative 'flow'
+require_relative 'const/types'
+require_relative 'octo_hash_case'
+require_relative 'errors/options_validation_error'
+require_relative 'errors/palp_validation_error'
+require_relative 'errors/resq_definition_error'
+require_relative 'errors/wrap_block_is_not_defined_error'
+require_relative 'errors/palp_block_is_not_defined_error'
+require_relative 'errors/fail_is_first_step_error'
+require_relative 'errors/octo_block_is_not_defined_error'
+
+module Decouplio
+  class LogicDsl
+    DEFAULT_WRAP_NAME = 'wrap'
+
+    class << self
+      attr_reader :steps, :palps
+
+      def inherited(subclass)
+        subclass.init_steps
+      end
+
+      def init_steps
+        @steps = []
+        @palps = {}
+      end
+
+      def step(stp, **options)
+        @steps << options.merge(type: Decouplio::Const::Types::STEP_TYPE, name: stp)
+      end
+
+      def fail(stp, **options)
+        raise Decouplio::Errors::FailCanNotBeTheFirstStepError if @steps.empty?
+
+        @steps << options.merge(type: Decouplio::Const::Types::FAIL_TYPE, name: stp)
+      end
+
+      def pass(stp, **options)
+        @steps << options.merge(type: Decouplio::Const::Types::PASS_TYPE, name: stp)
+      end
+
+      def octo(octo_name, **options, &block)
+        raise Decouplio::Errors::OctoBlockIsNotDefinedError unless block_given?
+
+        hash_case = Class.new(Decouplio::OctoHashCase, &block).hash_case
+
+        raise Decouplio::Errors::OctoBlockIsNotDefinedError if hash_case.empty?
+
+        options[:hash_case] = hash_case
+        @steps << options.merge(type: Decouplio::Const::Types::OCTO_TYPE, name: octo_name)
+      end
+
+      def palp(palp_name, **options, &block)
+        raise Decouplio::Errors::PalpBlockIsNotDefinedError unless block_given?
+
+        options.empty? || raise(Decouplio::Errors::PalpValidationError)
+
+        @palps[palp_name] = Class.new(self, &block)
+      end
+
+      def resq(name = :resq, **options)
+        unless Decouplio::Const::Types::MAIN_FLOW_TYPES.include?(@steps.last&.[](:type))
+          raise Decouplio::Errors::ResqDefinitionError
+        end
+
+        @steps << {
+          name: name,
+          type: Decouplio::Const::Types::RESQ_TYPE,
+          step_to_resq: @steps.delete(@steps.last),
+          handler_hash: options
+        }
+      end
+
+      def wrap(name = nil, **options, &block)
+        raise Decouplio::Errors::WrapBlockIsNotDefinedError unless block_given?
+
+        @steps << options.merge(
+          type: Decouplio::Const::Types::WRAP_TYPE,
+          name: name,
+          wrap_flow: block
+        )
+      end
+
+      def doby(doby_class, **options)
+        @steps << {
+          type: Decouplio::Const::Types::DOBY_TYPE,
+          name: doby_class.name.to_sym,
+          doby_class: doby_class,
+          doby_options: options
+        }
+      end
+    end
+  end
+end

data/lib/decouplio/octo_hash_case.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+require_relative 'octo_options_validator'
+
+module Decouplio
+  class OctoHashCase
+    class << self
+      attr_reader :hash_case
+
+      def inherited(subclass)
+        subclass.init_hash_case
+        super(subclass)
+      end
+
+      def init_hash_case
+        @hash_case = {}
+      end
+
+      def on(strategy_flow, **options)
+        validate_options(options)
+        @hash_case[strategy_flow] = options
+      end
+
+      private
+
+      def validate_options(options)
+        OctoOptionsValidator.call(options: options)
+      end
+    end
+  end
+end

data/lib/decouplio/octo_options_validator.rb

@@ -0,0 +1,89 @@
+# frozen_string_literal: true
+
+require_relative 'errors/options_validation_error'
+
+module Decouplio
+  class OctoOptionsValidator
+    def self.call(options:)
+      new(options: options).call
+    end
+
+    def initialize(options:)
+      @options = options
+    end
+
+    def call
+      validate_option_keys
+      validate_option_count
+    end
+
+    private
+
+    def validate_option_keys
+      extra_options = (@options.keys - ON_ALLOWED_OPTIONS)
+      return if extra_options.size.zero?
+
+      raise_validation_error(
+        compose_message(
+          STRATEGY_ON_ERROR_MESSAGE,
+          YELLOW,
+          extra_options,
+          EXTRA_OPTIONS_NOT_ALLOWED % extra_options,
+          ON_ALLOWED_OPTIONS,
+          STRATEGY_MANUAL_URL,
+          NO_COLOR
+        )
+      )
+    end
+
+    def validate_option_count
+      return if @options.keys.size == 1
+
+      raise_validation_error(
+        compose_message(
+          STRATEGY_ON_ERROR_MESSAGE,
+          YELLOW,
+          @options,
+          ONLY_ONE_OPTION_PER_TIME_IS_ALLOWED,
+          ON_ALLOWED_OPTIONS,
+          STRATEGY_MANUAL_URL,
+          NO_COLOR
+        )
+      )
+    end
+
+    def raise_validation_error(message)
+      raise Decouplio::Errors::OptionsValidationError, message
+    end
+
+    def compose_message(message, *interpolation_params)
+      message % interpolation_params
+    end
+
+    ALLOWED_OPTIONS = %i[palp step].freeze
+    YELLOW = "\033[1;33m"
+    NO_COLOR = "\033[0m"
+    STRATEGY_ON_ERROR_MESSAGE = <<~ERROR_MESSAGE
+      %s
+      Next options are not allowed for "on":
+      %s
+
+      Details:
+      %s
+
+      Allowed options are:
+      %s
+
+      Please read the manual about allowed options here:
+      %s
+      %s
+    ERROR_MESSAGE
+    EXTRA_OPTIONS_NOT_ALLOWED = '%s is not allowed for "on"'
+    ONLY_ONE_OPTION_PER_TIME_IS_ALLOWED = 'Only one option is allowed for "on".'
+    ON_ALLOWED_OPTIONS = %i[
+      step
+      palp
+    ].freeze
+    STRATEGY_MANUAL_URL = 'https://stub.strategy.manual.url'
+  end
+end