convenient_service 0.12.0 → 0.14.0

data/lib/convenient_service/service/plugins/has_j_send_result/entities/result/plugins/has_awesome_print_inspect/concern.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+module ConvenientService
+  module Service
+    module Plugins
+      module HasJSendResult
+        module Entities
+          class Result
+            module Plugins
+              module HasAwesomePrintInspect
+                module Concern
+                  include Support::Concern
+
+                  instance_methods do
+                    ##
+                    # @return [String]
+                    #
+                    def inspect
+                      metadata = {
+                        ConvenientService: {
+                          entity: "Result",
+                          service: service.inspect_values[:name],
+                          status: status.to_sym
+                        }
+                      }
+
+                      metadata[:data_keys] = unsafe_data.keys if unsafe_data.keys.any?
+                      metadata[:message] = unsafe_message unless unsafe_message.empty?
+
+                      metadata.ai
+                    end
+                  end
+                end
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/convenient_service/service/plugins/has_j_send_result/entities/result/plugins/has_awesome_print_inspect.rb

@@ -0,0 +1,3 @@
+# frozen_string_literal: true
+
+require_relative "has_awesome_print_inspect/concern"

data/lib/convenient_service/service/plugins/has_j_send_result/entities/result/plugins/has_inspect/concern.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+module ConvenientService
+  module Service
+    module Plugins
+      module HasJSendResult
+        module Entities
+          class Result
+            module Plugins
+              module HasInspect
+                module Concern
+                  include Support::Concern
+
+                  instance_methods do
+                    ##
+                    # @return [String]
+                    #
+                    def inspect
+                      parts = [
+                        "#{service.inspect_values[:name]}::Result",
+                        "status: :#{status}"
+                      ]
+
+                      parts << "data_keys: #{unsafe_data.keys.inspect}" if unsafe_data.keys.any?
+                      parts << "message: \"#{unsafe_message}\"" unless unsafe_message.empty?
+
+                      "<#{parts.join(" ")}>"
+                    end
+                  end
+                end
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/convenient_service/service/plugins/has_j_send_result/entities/result/plugins/has_j_send_status_and_attributes/commands/cast_j_send_attributes.rb

@@ -0,0 +1,99 @@
+# frozen_string_literal: true
+
+module ConvenientService
+  module Service
+    module Plugins
+      module HasJSendResult
+        module Entities
+          class Result
+            module Plugins
+              module HasJSendStatusAndAttributes
+                module Commands
+                  class CastJSendAttributes < Support::Command
+                    ##
+                    # @!attribute [r] result
+                    #   @return [ConvenientService::Service::Plugins::HasJSendResult::Entities::Result]
+                    #
+                    attr_reader :result
+
+                    ##
+                    # @!attribute [r] kwargs
+                    #   @return [Hash{Symbol => Object}]
+                    #
+                    attr_reader :kwargs
+
+                    ##
+                    # @param result [ConvenientService::Service::Plugins::HasJSendResult::Entities::Result]
+                    # @param kwargs [Hash{Symbol => Object}]
+                    # @return [void]
+                    #
+                    def initialize(result:, kwargs:)
+                      @result = result
+                      @kwargs = kwargs
+                    end
+
+                    ##
+                    # @return [ConvenientService::Service::Plugins::HasJSendResult::Entities::Result::Plugins::HasJSendStatusAndAttributes::Structs::JSendAttributes]
+                    # @raise [ConvenientService::Support::Castable::Exceptions::FailedToCast]
+                    #
+                    def call
+                      Structs::JSendAttributes.new(service: service, status: status, data: data, message: message, code: code, extra_kwargs: extra_kwargs)
+                    end
+
+                    private
+
+                    ##
+                    # @return [Object]
+                    #
+                    def service
+                      kwargs[:service]
+                    end
+
+                    ##
+                    # @return [ConvenientService::Service::Plugins::HasJSendResult::Entities::Result::Plugins::HasJSendStatusAndAttributes::Entities::Status]
+                    # @raise [ConvenientService::Support::Castable::Exceptions::FailedToCast]
+                    #
+                    def status
+                      @status ||= result.class.status(value: kwargs[:status], result: result)
+                    end
+
+                    ##
+                    # @return [ConvenientService::Service::Plugins::HasJSendResult::Entities::Result::Plugins::HasJSendStatusAndAttributes::Entities::Data]
+                    # @raise [ConvenientService::Support::Castable::Exceptions::FailedToCast]
+                    #
+                    def data
+                      @data ||= result.class.data(value: kwargs[:data], result: result)
+                    end
+
+                    ##
+                    # @return [ConvenientService::Service::Plugins::HasJSendResult::Entities::Result::Plugins::HasJSendStatusAndAttributes::Entities::Message]
+                    # @raise [ConvenientService::Support::Castable::Exceptions::FailedToCast]
+                    #
+                    def message
+                      @message ||= result.class.message(value: kwargs[:message], result: result)
+                    end
+
+                    ##
+                    # @return [ConvenientService::Service::Plugins::HasJSendResult::Entities::Result::Plugins::HasJSendStatusAndAttributes::Entities::Code]
+                    # @raise [ConvenientService::Support::Castable::Exceptions::FailedToCast]
+                    #
+                    def code
+                      @code ||= result.class.code(value: kwargs[:code], result: result)
+                    end
+
+                    ##
+                    # @return [Hash{Symbol => Object}]
+                    #
+                    def extra_kwargs
+                      @extra_kwargs ||= Utils::Hash.except(kwargs, [:service, :status, :data, :message, :code])
+                    end
+                  end
+                end
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/convenient_service/service/plugins/{has_result → has_j_send_result}/entities/result/plugins/has_j_send_status_and_attributes/commands/create_code_class.rb

@@ -3,7 +3,7 @@
 module ConvenientService
   module Service
     module Plugins
-      module HasResult
+      module HasJSendResult
         module Entities
           class Result
             module Plugins

data/lib/convenient_service/service/plugins/{has_result → has_j_send_result}/entities/result/plugins/has_j_send_status_and_attributes/commands/create_data_class.rb

@@ -3,7 +3,7 @@
 module ConvenientService
   module Service
     module Plugins
-      module HasResult
+      module HasJSendResult
         module Entities
           class Result
             module Plugins

data/lib/convenient_service/service/plugins/{has_result → has_j_send_result}/entities/result/plugins/has_j_send_status_and_attributes/commands/create_message_class.rb

@@ -3,7 +3,7 @@
 module ConvenientService
   module Service
     module Plugins
-      module HasResult
+      module HasJSendResult
         module Entities
           class Result
             module Plugins

data/lib/convenient_service/service/plugins/{has_result → has_j_send_result}/entities/result/plugins/has_j_send_status_and_attributes/commands/create_status_class.rb

@@ -3,7 +3,7 @@
 module ConvenientService
   module Service
     module Plugins
-      module HasResult
+      module HasJSendResult
         module Entities
           class Result
             module Plugins

data/lib/convenient_service/service/plugins/has_j_send_result/entities/result/plugins/has_j_send_status_and_attributes/concern/class_methods.rb

@@ -0,0 +1,125 @@
+# frozen_string_literal: true
+
+module ConvenientService
+  module Service
+    module Plugins
+      module HasJSendResult
+        module Entities
+          class Result
+            module Plugins
+              module HasJSendStatusAndAttributes
+                module Concern
+                  module ClassMethods
+                    ##
+                    # @api private
+                    # @param value [Object] Can be any type.
+                    # @param result [ConvenientService::Service::Plugins::HasJSendResult::Entities::Result].
+                    # @return [ConvenientService::Service::Plugins::HasJSendResult::Entities::Result::Plugins::HasJSendStatusAndAttributes::Entities::Code]
+                    # @raise [ConvenientService::Support::Castable::Exceptions::FailedToCast]
+                    #
+                    # @internal
+                    #   IMPORTANT: Skipping `result` is allowed only for tests.
+                    #
+                    def code(value:, result: new_without_initialize)
+                      code_class.cast!(value).copy(overrides: {kwargs: {result: result}})
+                    end
+
+                    ##
+                    # @api private
+                    # @param value [Object] Can be any type.
+                    # @param result [ConvenientService::Service::Plugins::HasJSendResult::Entities::Result].
+                    # @return [ConvenientService::Service::Plugins::HasJSendResult::Entities::Result::Plugins::HasJSendStatusAndAttributes::Entities::Data]
+                    # @raise [ConvenientService::Support::Castable::Exceptions::FailedToCast]
+                    #
+                    # @internal
+                    #   IMPORTANT: Skipping `result` is allowed only for tests.
+                    #
+                    def data(value:, result: new_without_initialize)
+                      data_class.cast!(value).copy(overrides: {kwargs: {result: result}})
+                    end
+
+                    ##
+                    # @api private
+                    # @param value [Object] Can be any type.
+                    # @param result [ConvenientService::Service::Plugins::HasJSendResult::Entities::Result].
+                    # @return [ConvenientService::Service::Plugins::HasJSendResult::Entities::Result::Plugins::HasJSendStatusAndAttributes::Entities::Message]
+                    # @raise [ConvenientService::Support::Castable::Exceptions::FailedToCast]
+                    #
+                    # @internal
+                    #   IMPORTANT: Skipping `result` is allowed only for tests.
+                    #
+                    def message(value:, result: new_without_initialize)
+                      message_class.cast!(value).copy(overrides: {kwargs: {result: result}})
+                    end
+
+                    ##
+                    # @api private
+                    # @param value [Object] Can be any type.
+                    # @param result [ConvenientService::Service::Plugins::HasJSendResult::Entities::Result].
+                    # @return [ConvenientService::Service::Plugins::HasJSendResult::Entities::Result::Plugins::HasJSendStatusAndAttributes::Entities::Status]
+                    # @raise [ConvenientService::Support::Castable::Exceptions::FailedToCast]
+                    #
+                    # @internal
+                    #   IMPORTANT: Skipping `result` is allowed only for tests.
+                    #
+                    def status(value:, result: new_without_initialize)
+                      status_class.cast!(value).copy(overrides: {kwargs: {result: result}})
+                    end
+
+                    ##
+                    # @api private
+                    # @return [Class]
+                    #
+                    # @internal
+                    #   NOTE: A command instead of `import` is used in order to NOT pollute the public interface.
+                    #   TODO: Specs that prevent public interface accidental pollution.
+                    #
+                    def code_class
+                      @code_class ||= Commands::CreateCodeClass.call(result_class: self)
+                    end
+
+                    ##
+                    # @api private
+                    # @return [Class]
+                    #
+                    # @internal
+                    #   NOTE: A command instead of `import` is used in order to NOT pollute the public interface.
+                    #   TODO: Specs that prevent public interface accidental pollution.
+                    #
+                    def data_class
+                      @data_class ||= Commands::CreateDataClass.call(result_class: self)
+                    end
+
+                    ##
+                    # @api private
+                    # @return [Class]
+                    #
+                    # @internal
+                    #   NOTE: A command instead of `import` is used in order to NOT pollute the public interface.
+                    #   TODO: Specs that prevent public interface accidental pollution.
+                    #
+                    def message_class
+                      @message_class ||= Commands::CreateMessageClass.call(result_class: self)
+                    end
+
+                    ##
+                    # @api private
+                    # @return [Class]
+                    #
+                    # @internal
+                    #   NOTE: A command instead of `import` is used in order to NOT pollute the public interface.
+                    #   TODO: Specs that prevent public interface accidental pollution.
+                    #
+                    def status_class
+                      @status_class ||= Commands::CreateStatusClass.call(result_class: self)
+                    end
+                  end
+                end
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/convenient_service/service/plugins/{has_result → has_j_send_result}/entities/result/plugins/has_j_send_status_and_attributes/concern/instance_methods.rb

@@ -3,7 +3,7 @@
 module ConvenientService
   module Service
     module Plugins
-      module HasResult
+      module HasJSendResult
         module Entities
           class Result
             module Plugins
@@ -52,51 +52,87 @@ module ConvenientService
                     delegate :service, to: :jsend_attributes
 
                     ##
-                    # @return [ConvenientService::Service::Plugins::HasResult::Entities::Result::Plugins::HasJSendStatusAndAttributes::Entities::Status]
+                    # @return [ConvenientService::Service::Plugins::HasJSendResult::Entities::Result::Plugins::HasJSendStatusAndAttributes::Entities::Status]
                     #
                     delegate :status, to: :jsend_attributes
 
                     ##
-                    # @return [ConvenientService::Service::Plugins::HasResult::Entities::Result::Plugins::HasJSendStatusAndAttributes::Entities::Data]
+                    # @return [ConvenientService::Service::Plugins::HasJSendResult::Entities::Result::Plugins::HasJSendStatusAndAttributes::Entities::Data]
                     #
                     delegate :data, to: :jsend_attributes
 
                     ##
-                    # @return [ConvenientService::Service::Plugins::HasResult::Entities::Result::Plugins::HasJSendStatusAndAttributes::Entities::Data]
+                    # @return [ConvenientService::Service::Plugins::HasJSendResult::Entities::Result::Plugins::HasJSendStatusAndAttributes::Entities::Data]
                     #
                     alias_method :unsafe_data, :data
 
                     ##
-                    # @return [ConvenientService::Service::Plugins::HasResult::Entities::Result::Plugins::HasJSendStatusAndAttributes::Entities::Message]
+                    # @return [ConvenientService::Service::Plugins::HasJSendResult::Entities::Result::Plugins::HasJSendStatusAndAttributes::Entities::Message]
                     #
                     delegate :message, to: :jsend_attributes
 
                     ##
-                    # @return [ConvenientService::Service::Plugins::HasResult::Entities::Result::Plugins::HasJSendStatusAndAttributes::Entities::Message]
+                    # @return [ConvenientService::Service::Plugins::HasJSendResult::Entities::Result::Plugins::HasJSendStatusAndAttributes::Entities::Message]
                     #
                     alias_method :unsafe_message, :message
 
                     ##
-                    # @return [ConvenientService::Service::Plugins::HasResult::Entities::Result::Plugins::HasJSendStatusAndAttributes::Entities::Code]
+                    # @return [ConvenientService::Service::Plugins::HasJSendResult::Entities::Result::Plugins::HasJSendStatusAndAttributes::Entities::Code]
                     #
                     delegate :code, to: :jsend_attributes
 
                     ##
-                    # @return [ConvenientService::Service::Plugins::HasResult::Entities::Result::Plugins::HasJSendStatusAndAttributes::Entities::Code]
+                    # @return [ConvenientService::Service::Plugins::HasJSendResult::Entities::Result::Plugins::HasJSendStatusAndAttributes::Entities::Code]
                     #
                     alias_method :unsafe_code, :code
 
                     ##
-                    # @return [ConvenientService::Service::Plugins::HasResult::Entities::Result::Plugins::HasJSendStatusAndAttributes::Structs::JSendAttributes]
+                    # @return [Hash{Object => Symbol}]
+                    #
+                    delegate :extra_kwargs, to: :jsend_attributes
+
+                    ##
+                    # @return [ConvenientService::Service::Plugins::HasJSendResult::Entities::Result::Plugins::HasJSendStatusAndAttributes::Structs::JSendAttributes]
                     #
                     def jsend_attributes
                       internals.cache[:jsend_attributes]
                     end
 
                     ##
-                    # @param other [ConvenientService::Service::Plugins::HasResult::Entities::Result]
+                    # @return [Symbol]
+                    #
+                    def create_status(status)
+                      self.class.status(value: status, result: self)
+                    end
+
+                    ##
+                    # @return [Hash{Symbol => Object}]
+                    #
+                    def create_data(data)
+                      self.class.data(value: data, result: self)
+                    end
+
+                    ##
+                    # @return [String]
+                    #
+                    def create_message(message)
+                      self.class.message(value: message, result: self)
+                    end
+
+                    ##
+                    # @return [Symbol]
+                    #
+                    def create_code(code)
+                      self.class.code(value: code, result: self)
+                    end
+
+                    ##
+                    # @param other [ConvenientService::Service::Plugins::HasJSendResult::Entities::Result]
                     # @return [Boolean, nil]
                     #
+                    # @internal
+                    #   TODO: Currently `==` does NOT compare `extra_kwargs`. Is it OK?
+                    #
                     def ==(other)
                       return unless other.instance_of?(self.class)
 
@@ -110,16 +146,24 @@ module ConvenientService
                     end
 
                     ##
-                    # @return [Hash]
+                    # @return [Hash{Symbol => Object}]
                     #
                     def to_kwargs
-                      {
+                      to_arguments.kwargs
+                    end
+
+                    ##
+                    # @return [ConveninentService::Support::Arguments]
+                    #
+                    def to_arguments
+                      Support::Arguments.new(
                         service: service,
                         status: status,
                         data: unsafe_data,
                         message: unsafe_message,
-                        code: unsafe_code
-                      }
+                        code: unsafe_code,
+                        **extra_kwargs
+                      )
                     end
                   end
                 end

data/lib/convenient_service/service/plugins/{has_result → has_j_send_result}/entities/result/plugins/has_j_send_status_and_attributes/concern.rb

@@ -6,7 +6,7 @@ require_relative "concern/instance_methods"
 module ConvenientService
   module Service
     module Plugins
-      module HasResult
+      module HasJSendResult
         module Entities
           class Result
             module Plugins

data/lib/convenient_service/service/plugins/has_j_send_result/entities/result/plugins/has_j_send_status_and_attributes/entities/code/commands/is_code.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+module ConvenientService
+  module Service
+    module Plugins
+      module HasJSendResult
+        module Entities
+          class Result
+            module Plugins
+              module HasJSendStatusAndAttributes
+                module Entities
+                  class Code
+                    module Commands
+                      ##
+                      # Check whether `code` can be considered as `Code` instance.
+                      #
+                      class IsCode < Support::Command
+                        ##
+                        # @!attribute [r] code
+                        #   @return [Object] Can be any type.
+                        #
+                        attr_reader :code
+
+                        ##
+                        # @param code [Object] Can be any type.
+                        # @return [void]
+                        #
+                        def initialize(code:)
+                          @code = code
+                        end
+
+                        ##
+                        # @return [Boolean]
+                        #
+                        def call
+                          code.class.include?(Entities::Code::Concern)
+                        end
+                      end
+                    end
+                  end
+                end
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/convenient_service/service/plugins/has_j_send_result/entities/result/plugins/has_j_send_status_and_attributes/entities/code/commands.rb

@@ -0,0 +1,3 @@
+# frozen_string_literal: true
+
+require_relative "commands/is_code"

data/lib/convenient_service/service/plugins/{has_result → has_j_send_result}/entities/result/plugins/has_j_send_status_and_attributes/entities/code/concern/class_methods.rb

@@ -3,7 +3,7 @@
 module ConvenientService
   module Service
     module Plugins
-      module HasResult
+      module HasJSendResult
         module Entities
           class Result
             module Plugins
@@ -14,7 +14,7 @@ module ConvenientService
                       module ClassMethods
                         ##
                         # @param other [Object] Can be any type.
-                        # @return [ConvenientService::Service::Plugins::HasResult::Entities::Result::Plugins::HasJSendStatusAndAttributes::Entities::Code, nil]
+                        # @return [ConvenientService::Service::Plugins::HasJSendResult::Entities::Result::Plugins::HasJSendStatusAndAttributes::Entities::Code, nil]
                         #
                         def cast(other)
                           case other
@@ -26,6 +26,18 @@ module ConvenientService
                             new(value: other.value)
                           end
                         end
+
+                        ##
+                        # @param other [Object] Can be any type.
+                        # @return [Boolean, nil]
+                        #
+                        # @internal
+                        #   NOTE: Check `Module.===` in order to get an idea of how `super` works.
+                        #   - https://ruby-doc.org/core-2.7.0/Module.html#method-i-3D-3D-3D
+                        #
+                        def ===(other)
+                          Commands::IsCode.call(code: other) || super
+                        end
                       end
                     end
                   end