convenient_service 0.10.1 → 0.12.0

data/lib/convenient_service/service/plugins/can_have_steps/entities/method/commands/cast_method.rb

@@ -0,0 +1,92 @@
+# frozen_string_literal: true
+
+module ConvenientService
+  module Service
+    module Plugins
+      module CanHaveSteps
+        module Entities
+          class Method
+            module Commands
+              class CastMethod < Support::Command
+                ##
+                # @!attribute [r] options
+                #   @return [Object] Can be any type.
+                #
+                attr_reader :other
+
+                ##
+                # @!attribute [r] options
+                #   @return [Hash]
+                #
+                attr_reader :options
+
+                ##
+                # @param other [Object] Can be any type.
+                # @param options [Hash]
+                #
+                def initialize(other:, options:)
+                  @other = other
+                  @options = options
+                end
+
+                ##
+                # @return [ConvenientService::Service::Plugins::CanHaveSteps::Entities::Method, nil]
+                #
+                # @internal
+                #   NOTE: Read more about Composition over Inheritance.
+                #   - https://en.wikipedia.org/wiki/Composition_over_inheritance
+                #
+                def call
+                  return unless factory
+                  return unless key
+                  return unless name
+                  return unless caller
+                  return unless direction
+
+                  Method.new(key: key, name: name, caller: caller, direction: direction)
+                end
+
+                private
+
+                ##
+                # @return [ConvenientService::Service::Plugins::CanHaveSteps::Entities::Method::Entities::Factories::Base]
+                #
+                def factory
+                  Utils::Object.memoize_including_falsy_values(self, :@factory) { Commands::CastMethodFactory.call(other: other) }
+                end
+
+                ##
+                # @return [ConvenientService::Service::Plugins::CanHaveSteps::Entities::Method::Entities::Key]
+                #
+                def key
+                  Utils::Object.memoize_including_falsy_values(self, :@key) { factory&.create_key }
+                end
+
+                ##
+                # @return [ConvenientService::Service::Plugins::CanHaveSteps::Entities::Method::Entities::Name]
+                #
+                def name
+                  Utils::Object.memoize_including_falsy_values(self, :@name) { factory&.create_name }
+                end
+
+                ##
+                # @return [ConvenientService::Service::Plugins::CanHaveSteps::Entities::Method::Entities::Callers::Base]
+                #
+                def caller
+                  Utils::Object.memoize_including_falsy_values(self, :@caller) { factory&.create_caller }
+                end
+
+                ##
+                # @return [ConvenientService::Service::Plugins::CanHaveSteps::Entities::Method::Entities::Direction::Base]
+                #
+                def direction
+                  Utils::Object.memoize_including_falsy_values(self, :@direction) { Commands::CastMethodDirection.call(other: other, options: options) }
+                end
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/convenient_service/service/plugins/{has_result_steps → can_have_steps}/entities/method/commands/cast_method_direction.rb

@@ -3,21 +3,39 @@
 module ConvenientService
   module Service
     module Plugins
-      module HasResultSteps
+      module CanHaveSteps
         module Entities
           class Method
             module Commands
               ##
-              # TODO: Abstract factory.
+              # @internal
+              #   TODO: Separate in and out methods?
               #
               class CastMethodDirection < Support::Command
-                attr_reader :other, :options
+                ##
+                # @!attribute [r] options
+                #   @return [Object] Can be any type.
+                #
+                attr_reader :other
 
+                ##
+                # @!attribute [r] options
+                #   @return [Hash]
+                #
+                attr_reader :options
+
+                ##
+                # @param other [Object] Can be any type.
+                # @param options [Hash]
+                #
                 def initialize(other:, options:)
                   @other = other
                   @options = options
                 end
 
+                ##
+                # @return [Entities::Directions::Base, nil]
+                #
                 def call
                   casted =
                     case options[:direction]
@@ -37,6 +55,9 @@ module ConvenientService
 
                 private
 
+                ##
+                # @return [Entities::Directions::Base, nil]
+                #
                 def cast_symbol
                   case options[:direction]
                   when :input
@@ -46,6 +67,9 @@ module ConvenientService
                   end
                 end
 
+                ##
+                # @return [Entities::Directions::Base, nil]
+                #
                 def cast_string
                   case options[:direction]
                   when "input"
@@ -55,6 +79,9 @@ module ConvenientService
                   end
                 end
 
+                ##
+                # @return [Entities::Directions::Base, nil]
+                #
                 def cast_method
                   other.direction.copy
                 end

data/lib/convenient_service/service/plugins/can_have_steps/entities/method/commands/cast_method_factory.rb

@@ -0,0 +1,113 @@
+# frozen_string_literal: true
+
+module ConvenientService
+  module Service
+    module Plugins
+      module CanHaveSteps
+        module Entities
+          class Method
+            module Commands
+              class CastMethodFactory < Support::Command
+                ##
+                # @!attribute [r] options
+                #   @return [Object] Can be any type.
+                #
+                attr_reader :other
+
+                ##
+                # @param other [Object] Can be any type.
+                #
+                def initialize(other:)
+                  @other = other
+                end
+
+                ##
+                # @return [ConvenientService::Service::Plugins::CanHaveSteps::Entities::Method::Entities::Factries::Base, nil]
+                #
+                def call
+                  return unless factory_class
+
+                  factory_class.new(**factory_kwargs)
+                end
+
+                private
+
+                ##
+                # @return [Class, nil]
+                #
+                def factory_class
+                  Utils::Object.memoize_including_falsy_values(self, :@factory_class) do
+                    case other
+                    when ::Symbol then cast_symbol
+                    when ::String then cast_string
+                    when ::Hash then cast_hash
+                    when Entities::Values::Reassignment then cast_reassignment
+                    when Method then cast_method
+                    end
+                  end
+                end
+
+                ##
+                # @return [Hash]
+                #
+                def factory_kwargs
+                  {other: other}
+                end
+
+                ##
+                # @return [ConvenientService::Service::Plugins::CanHaveSteps::Entities::Method::Entities::Factries::Base, nil]
+                #
+                def cast_symbol
+                  Entities::Factories::Symbol
+                end
+
+                ##
+                # @return [ConvenientService::Service::Plugins::CanHaveSteps::Entities::Method::Entities::Factries::Base, nil]
+                #
+                def cast_string
+                  Entities::Factories::String
+                end
+
+                ##
+                # @return [ConvenientService::Service::Plugins::CanHaveSteps::Entities::Method::Entities::Factries::Base, nil]
+                #
+                def cast_reassignment
+                  Entities::Factories::Reassignment
+                end
+
+                ##
+                # @return [ConvenientService::Service::Plugins::CanHaveSteps::Entities::Method::Entities::Factries::Base, nil]
+                #
+                def cast_hash
+                  return unless other.keys.one?
+
+                  value = other.values.first
+
+                  case value
+                  when ::Symbol
+                    Entities::Factories::Hash::SymbolValue
+                  when ::String
+                    Entities::Factories::Hash::StringValue
+                  when ::Proc
+                    Entities::Factories::Hash::ProcValue
+                  when Support::RawValue
+                    Entities::Factories::Hash::RawValue
+                  when Entities::Values::Reassignment
+                    Entities::Factories::Hash::ReassignmentValue
+                  end
+                end
+
+                ##
+                # @return [ConvenientService::Service::Plugins::CanHaveSteps::Entities::Method::Entities::Factries::Base, nil]
+                #
+                def cast_method
+                  Entities::Factories::Method
+                end
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/convenient_service/service/plugins/{has_result_steps → can_have_steps}/entities/method/commands/define_method_in_container.rb

@@ -3,7 +3,7 @@
 module ConvenientService
   module Service
     module Plugins
-      module HasResultSteps
+      module CanHaveSteps
         module Entities
           class Method
             module Commands
@@ -43,13 +43,13 @@ module ConvenientService
 
                 def not_completed_step_error
                   <<~RUBY.chomp
-                    ::ConvenientService::Service::Plugins::HasResultSteps::Entities::Method::Errors::NotCompletedStep
+                    ::ConvenientService::Service::Plugins::CanHaveSteps::Entities::Method::Errors::NotCompletedStep
                   RUBY
                 end
 
                 def not_existing_step_result_data_attribute_error
                   <<~RUBY.chomp
-                    ::ConvenientService::Service::Plugins::HasResultSteps::Entities::Method::Errors::NotExistingStepResultDataAttribute
+                    ::ConvenientService::Service::Plugins::CanHaveSteps::Entities::Method::Errors::NotExistingStepResultDataAttribute
                   RUBY
                 end
               end

data/lib/convenient_service/service/plugins/{has_result_steps → can_have_steps}/entities/method/commands.rb

@@ -1,8 +1,6 @@
 # frozen_string_literal: true
 
-require_relative "commands/cast_method_caller"
+require_relative "commands/cast_method_factory"
 require_relative "commands/cast_method_direction"
-require_relative "commands/cast_method_key"
-require_relative "commands/cast_method_name"
 require_relative "commands/cast_method"
 require_relative "commands/define_method_in_container"

data/lib/convenient_service/service/plugins/{has_result_steps → can_have_steps}/entities/method/concern/class_methods.rb

@@ -3,7 +3,7 @@
 module ConvenientService
   module Service
     module Plugins
-      module HasResultSteps
+      module CanHaveSteps
         module Entities
           class Method
             module Concern

data/lib/convenient_service/service/plugins/{has_result_steps → can_have_steps}/entities/method/concern/instance_methods.rb

@@ -3,7 +3,7 @@
 module ConvenientService
   module Service
     module Plugins
-      module HasResultSteps
+      module CanHaveSteps
         module Entities
           class Method
             module Concern

data/lib/convenient_service/service/plugins/{has_result_steps → can_have_steps}/entities/method/concern.rb

@@ -6,7 +6,7 @@ require_relative "concern/class_methods"
 module ConvenientService
   module Service
     module Plugins
-      module HasResultSteps
+      module CanHaveSteps
         module Entities
           class Method
             module Concern

data/lib/convenient_service/service/plugins/{has_result_steps → can_have_steps}/entities/method/entities/callers/alias.rb

@@ -3,7 +3,7 @@
 module ConvenientService
   module Service
     module Plugins
-      module HasResultSteps
+      module CanHaveSteps
         module Entities
           class Method
             module Entities

data/lib/convenient_service/service/plugins/{has_result_steps → can_have_steps}/entities/method/entities/callers/base.rb

@@ -3,7 +3,7 @@
 module ConvenientService
   module Service
     module Plugins
-      module HasResultSteps
+      module CanHaveSteps
         module Entities
           class Method
             module Entities

data/lib/convenient_service/service/plugins/{has_result_steps → can_have_steps}/entities/method/entities/callers/proc.rb

@@ -3,7 +3,7 @@
 module ConvenientService
   module Service
     module Plugins
-      module HasResultSteps
+      module CanHaveSteps
         module Entities
           class Method
             module Entities

data/lib/convenient_service/service/plugins/{has_result_steps → can_have_steps}/entities/method/entities/callers/raw.rb

@@ -3,7 +3,7 @@
 module ConvenientService
   module Service
     module Plugins
-      module HasResultSteps
+      module CanHaveSteps
         module Entities
           class Method
             module Entities

data/lib/convenient_service/service/plugins/{has_result_steps → can_have_steps}/entities/method/entities/callers/reassignment/commands/define_method_in_container.rb

@@ -3,7 +3,7 @@
 module ConvenientService
   module Service
     module Plugins
-      module HasResultSteps
+      module CanHaveSteps
         module Entities
           class Method
             module Entities

data/lib/convenient_service/service/plugins/{has_result_steps → can_have_steps}/entities/method/entities/callers/reassignment.rb

@@ -5,7 +5,7 @@ require_relative "reassignment/commands"
 module ConvenientService
   module Service
     module Plugins
-      module HasResultSteps
+      module CanHaveSteps
         module Entities
           class Method
             module Entities

data/lib/convenient_service/service/plugins/{has_result_steps → can_have_steps}/entities/method/entities/callers/usual.rb

@@ -3,7 +3,7 @@
 module ConvenientService
   module Service
     module Plugins
-      module HasResultSteps
+      module CanHaveSteps
         module Entities
           class Method
             module Entities

data/lib/convenient_service/service/plugins/{has_result_steps → can_have_steps}/entities/method/entities/directions/base.rb

@@ -3,7 +3,7 @@
 module ConvenientService
   module Service
     module Plugins
-      module HasResultSteps
+      module CanHaveSteps
         module Entities
           class Method
             module Entities

data/lib/convenient_service/service/plugins/{has_result_steps → can_have_steps}/entities/method/entities/directions/input.rb

@@ -3,7 +3,7 @@
 module ConvenientService
   module Service
     module Plugins
-      module HasResultSteps
+      module CanHaveSteps
         module Entities
           class Method
             module Entities

data/lib/convenient_service/service/plugins/{has_result_steps → can_have_steps}/entities/method/entities/directions/output.rb

@@ -3,7 +3,7 @@
 module ConvenientService
   module Service
     module Plugins
-      module HasResultSteps
+      module CanHaveSteps
         module Entities
           class Method
             module Entities

data/lib/convenient_service/service/plugins/can_have_steps/entities/method/entities/factories/base.rb

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+
+module ConvenientService
+  module Service
+    module Plugins
+      module CanHaveSteps
+        module Entities
+          class Method
+            module Entities
+              module Factories
+                class Base
+                  include Support::AbstractMethod
+
+                  ##
+                  # @!attribute [r] other
+                  #   @return [Object] Can be any type.
+                  #
+                  attr_reader :other
+
+                  ##
+                  # @return [ConvenientService::Service::Plugins::CanHaveSteps::Entities::Method::Entities::Key]
+                  #
+                  abstract_method :create_key
+
+                  ##
+                  # @return [ConvenientService::Service::Plugins::CanHaveSteps::Entities::Method::Entities::Name]
+                  #
+                  abstract_method :create_name
+
+                  ##
+                  # @return [ConvenientService::Service::Plugins::CanHaveSteps::Entities::Method::Entities::Callers::Base]
+                  #
+                  abstract_method :create_caller
+
+                  ##
+                  # @param other [Object] Can be any type.
+                  # @return [void]
+                  #
+                  def initialize(other:)
+                    @other = other
+                  end
+
+                  ##
+                  # @param other [Object] Can be any type.
+                  # @return [Boolean, nil]
+                  #
+                  def ==(other)
+                    return unless other.instance_of?(self.class)
+
+                    return false if self.other != other.other
+
+                    true
+                  end
+                end
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/convenient_service/service/plugins/can_have_steps/entities/method/entities/factories/hash/base.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module ConvenientService
+  module Service
+    module Plugins
+      module CanHaveSteps
+        module Entities
+          class Method
+            module Entities
+              module Factories
+                module Hash
+                  class Base < Factories::Base
+                    ##
+                    # @return [Symbol]
+                    #
+                    def key
+                      @key ||= other.keys.first
+                    end
+
+                    ##
+                    # @return [Object] Can be any object.
+                    #
+                    def value
+                      Utils::Object.memoize_including_falsy_values(self, :@value) { other.values.first }
+                    end
+                  end
+                end
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/convenient_service/service/plugins/can_have_steps/entities/method/entities/factories/hash/proc_value.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+module ConvenientService
+  module Service
+    module Plugins
+      module CanHaveSteps
+        module Entities
+          class Method
+            module Entities
+              module Factories
+                module Hash
+                  class ProcValue < Factories::Hash::Base
+                    ##
+                    # @return [ConvenientService::Service::Plugins::CanHaveSteps::Entities::Method::Entities::Key]
+                    #
+                    def create_key
+                      Entities::Key.new(key)
+                    end
+
+                    ##
+                    # @return [ConvenientService::Service::Plugins::CanHaveSteps::Entities::Method::Entities::Name]
+                    #
+                    def create_name
+                      Entities::Name.new(key)
+                    end
+
+                    ##
+                    # @return [ConvenientService::Service::Plugins::CanHaveSteps::Entities::Method::Entities::Callers::Base]
+                    #
+                    def create_caller
+                      Entities::Callers::Proc.new(value)
+                    end
+                  end
+                end
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/convenient_service/service/plugins/can_have_steps/entities/method/entities/factories/hash/raw_value.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+module ConvenientService
+  module Service
+    module Plugins
+      module CanHaveSteps
+        module Entities
+          class Method
+            module Entities
+              module Factories
+                module Hash
+                  class RawValue < Factories::Hash::Base
+                    ##
+                    # @return [ConvenientService::Service::Plugins::CanHaveSteps::Entities::Method::Entities::Key]
+                    #
+                    def create_key
+                      Entities::Key.new(key)
+                    end
+
+                    ##
+                    # @return [ConvenientService::Service::Plugins::CanHaveSteps::Entities::Method::Entities::Name]
+                    #
+                    def create_name
+                      Entities::Name.new(key)
+                    end
+
+                    ##
+                    # @return [ConvenientService::Service::Plugins::CanHaveSteps::Entities::Method::Entities::Callers::Base]
+                    #
+                    def create_caller
+                      Entities::Callers::Raw.new(value)
+                    end
+                  end
+                end
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/convenient_service/service/plugins/can_have_steps/entities/method/entities/factories/hash/reassignment_value.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+module ConvenientService
+  module Service
+    module Plugins
+      module CanHaveSteps
+        module Entities
+          class Method
+            module Entities
+              module Factories
+                module Hash
+                  class ReassignmentValue < Factories::Hash::Base
+                    ##
+                    # @return [ConvenientService::Service::Plugins::CanHaveSteps::Entities::Method::Entities::Key]
+                    #
+                    def create_key
+                      Entities::Key.new(key)
+                    end
+
+                    ##
+                    # @return [ConvenientService::Service::Plugins::CanHaveSteps::Entities::Method::Entities::Name]
+                    #
+                    def create_name
+                      Entities::Name.new(value.to_sym)
+                    end
+
+                    ##
+                    # @return [ConvenientService::Service::Plugins::CanHaveSteps::Entities::Method::Entities::Callers::Base]
+                    #
+                    def create_caller
+                      Entities::Callers::Reassignment.new(value)
+                    end
+                  end
+                end
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end