RubyGems - convenient_service - Versions diffs - 0.12.0 → 0.13.0 - Mend

convenient_service 0.12.0 → 0.13.0

Files changed (639) hide show

data/lib/convenient_service/service/plugins/has_mermaid_flowchart/entities/flowchart/templates/flowchart.html.erb ADDED Viewed

@@ -0,0 +1,95 @@
+<!DOCTYPE html>
+<html>
+  <head>
+    <title><%= title %></title>
+    <!-- https://www.w3schools.com/css/css_rwd_viewport.asp -->
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <style>
+      /**
+       * https://www.w3schools.com/howto/howto_css_loader.asp
+       * https://www.w3schools.com/howto/tryit.asp?filename=tryhow_css_loader
+       */
+      #loader {
+        border: 16px solid #f3f3f3;
+        border-radius: 50%;
+        border-top: 16px solid #3498db;
+        width: 120px;
+        height: 120px;
+        -webkit-animation: spin 2s linear infinite; /* Safari */
+        animation: spin 2s linear infinite;
+      }
+      /* Safari */
+      @-webkit-keyframes spin {
+        0% { -webkit-transform: rotate(0deg); }
+        100% { -webkit-transform: rotate(360deg); }
+      }
+      @keyframes spin {
+        0% { transform: rotate(0deg); }
+        100% { transform: rotate(360deg); }
+      }
+      /**
+       * https://github.com/anvaka/panzoom
+       */
+      #diagram {
+        height: 100%;
+        width: 100%;
+        /*
+         * https://www.w3schools.com/howto/howto_js_toggle_hide_show.asp
+         */
+        display: none;
+      }
+    </style>
+  </head>
+  <body>
+    <!-- https://www.w3schools.com/howto/howto_css_loader.asp -->
+    <!-- https://www.w3schools.com/howto/tryit.asp?filename=tryhow_css_loader -->
+    <div id="loader"></div>
+    <!-- https://mermaid-js.github.io/mermaid/#/sequenceDiagram?id=sequence-diagrams -->
+    <div id="diagram" class="mermaid">
+      <%= code %>
+    </div>
+    <script type="module">
+      /**
+       * https://docs.skypack.dev/
+       */
+      import mermaid from 'https://cdn.skypack.dev/mermaid@^8.14.0';
+      import panzoom from 'https://cdn.skypack.dev/panzoom@^9.4.3';
+      /**
+       * https://mermaid-js.github.io/mermaid/#/
+       */
+      mermaid.initialize({ startOnLoad: true });
+      /**
+       * https://github.com/anvaka/panzoom
+       */
+      const elementWithDiagram = document.getElementById('diagram');
+      panzoom(elementWithDiagram);
+      /**
+       * https://www.w3schools.com/howto/howto_css_loader.asp
+       * https://www.w3schools.com/howto/tryit.asp?filename=tryhow_css_loader
+       */
+      const loader = document.getElementById('loader');
+      /*
+       * https://developer.mozilla.org/en-US/docs/Web/API/Element/remove
+       */
+      loader.remove();
+      /*
+       * https://www.w3schools.com/howto/howto_js_toggle_hide_show.asp
+       */
+      elementWithDiagram.style.display = 'block';
+    </script>
+  </body>
+</html>

data/lib/convenient_service/service/plugins/has_mermaid_flowchart/entities/flowchart.rb ADDED Viewed

@@ -0,0 +1,108 @@
+# frozen_string_literal: true
+require_relative "flowchart/entities"
+module ConvenientService
+  module Service
+    module Plugins
+      module HasMermaidFlowchart
+        module Entities
+          class Flowchart
+            ##
+            # @api private
+            #
+            # @!attribute service [r]
+            #   @return [ConvenientService::Service]
+            #
+            attr_reader :service
+            ##
+            # @api private
+            #
+            # @param service [ConvenientService::Service]
+            # @return [void]
+            #
+            def initialize(service:)
+              @service = service
+            end
+            ##
+            # @api private
+            #
+            # @return [String]
+            #
+            def content
+              template.render(**replacements)
+            end
+            ##
+            # @api private
+            #
+            # @return [Hash{Symbol => Object}]
+            #
+            def replacements
+              {
+                title: settings.title,
+                code: code.generate
+              }
+            end
+            ##
+            # @api private
+            #
+            # @return [ConvenientService::Service::Plugins::HasMermaidFlowchart::Entities::Code]
+            #
+            def code
+              @code ||= Entities::Code.new(flowchart: self)
+            end
+            ##
+            # @api public
+            #
+            # @return [ConvenientService::Service::Plugins::HasMermaidFlowchart::Entities::Settings]
+            #
+            def settings
+              @settings ||= Entities::Settings.new(flowchart: self)
+            end
+            ##
+            # @api private
+            #
+            # @return [ConvenientService::Service::Plugins::HasMermaidFlowchart::Entities::Template]
+            #
+            def template
+              @template ||= Entities::Template.new
+            end
+            ##
+            # @api public
+            #
+            # @return [Boolean]
+            #
+            # @internal
+            #   TODO: Specs for logger.
+            #
+            def save
+              ::File.write(settings.absolute_path, content)
+                .tap { ConvenientService.logger.info { "[HasMermaidFlowchart] Flowchart is saved into `#{settings.absolute_path}` " } }
+            end
+            ##
+            # @api private
+            #
+            # @param other [Object]
+            # @return [Boolean, nil]
+            #
+            def ==(other)
+              return unless other.instance_of?(self.class)
+              return false if service != other.service
+              true
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/convenient_service/service/plugins/has_mermaid_flowchart/entities.rb ADDED Viewed

@@ -0,0 +1,3 @@
+# frozen_string_literal: true
+require_relative "entities/flowchart"

data/lib/convenient_service/service/plugins/has_mermaid_flowchart.rb ADDED Viewed

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+require_relative "has_mermaid_flowchart/concern"
+require_relative "has_mermaid_flowchart/entities"

data/lib/convenient_service/service/plugins/has_result/concern.rb CHANGED Viewed

@@ -1,8 +1,5 @@
 # frozen_string_literal: true
-require_relative "concern/instance_methods"
-require_relative "concern/class_methods"
 module ConvenientService
   module Service
     module Plugins
@@ -10,10 +7,24 @@ module ConvenientService
         module Concern
           include Support::Concern
-          included do |service_class|
-            service_class.include InstanceMethods
+          class_methods do
+            ##
+            # @api public
+            # @raise [ConvenientService::Service::Plugins::HasResult::Exceptions::ResultIsNotOverridden]
+            #
+            def result(...)
+              new(...).result
+            end
+          end
-            service_class.extend ClassMethods
+          instance_methods do
+            ##
+            # @api public
+            # @raise [ConvenientService::Service::Plugins::HasResult::Exceptions::ResultIsNotOverridden]
+            #
+            def result
+              raise Exceptions::ResultIsNotOverridden.new(service: self)
+            end
           end
         end
       end

data/lib/convenient_service/service/plugins/has_result/exceptions.rb ADDED Viewed

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+module ConvenientService
+  module Service
+    module Plugins
+      module HasResult
+        module Exceptions
+          class ResultIsNotOverridden < ::ConvenientService::Exception
+            def initialize(service:)
+              message = <<~TEXT
+                Result method (#result) of `#{service.class}` is NOT overridden.
+              TEXT
+              super(message)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/convenient_service/service/plugins/has_result.rb CHANGED Viewed

@@ -1,8 +1,4 @@
 # frozen_string_literal: true
 require_relative "has_result/concern"
-require_relative "has_result/constants"
-require_relative "has_result/commands"
-require_relative "has_result/entities"
-require_relative "has_result/errors"
-require_relative "has_result/middleware"
+require_relative "has_result/exceptions"

data/lib/convenient_service/service/plugins/raises_on_double_result/{errors.rb → exceptions.rb} RENAMED Viewed

@@ -4,8 +4,8 @@ module ConvenientService
   module Service
     module Plugins
       module RaisesOnDoubleResult
-        module Errors
-          class DoubleResult < ::ConvenientService::Error
+        module Exceptions
+          class DoubleResult < ::ConvenientService::Exception
             def initialize(service:)
               message = <<~TEXT
                 `#{service.class}` service has a double result.

data/lib/convenient_service/service/plugins/raises_on_double_result/middleware.rb CHANGED Viewed

@@ -4,9 +4,11 @@ module ConvenientService
   module Service
     module Plugins
       module RaisesOnDoubleResult
-        class Middleware < Core::MethodChainMiddleware
+        class Middleware < MethodChainMiddleware
+          intended_for :result, entity: :service
           ##
-          # @return [ConvenientService::Service::Plugins::HasResult::Entities::Result]
+          # @return [ConvenientService::Service::Plugins::HasJSendResult::Entities::Result]
           #
           # @internal
           #   TODO: Rewrite `RaisesOnDoubleResult` to make it thread-safe.
@@ -26,7 +28,7 @@ module ConvenientService
           #     10.times.reduce([]) { |threads| threads << Thread.new { service.result } }.join
           #
           def next(...)
-            refute_has_result! || mark_as_has_result!
+            refute_has_j_send_result! || mark_as_has_j_send_result!
             chain.next(...)
           end
@@ -35,7 +37,7 @@ module ConvenientService
           ##
           # @return [Boolean]
-          # @raise [ConvenientService::Service::Plugins::RaisesOnDoubleResult::Errors::DoubleResult]
+          # @raise [ConvenientService::Service::Plugins::RaisesOnDoubleResult::Exceptions::DoubleResult]
           #
           # @internal
           #   NOTE: `refute` is `!assert`.
@@ -43,10 +45,10 @@ module ConvenientService
           #
           #   NOTE: This method contains a trailing exclamation mark in its name since it is mutable.
           #
-          def refute_has_result!
-            return unless entity.internals.cache.exist?(:has_result)
+          def refute_has_j_send_result!
+            return unless entity.internals.cache.exist?(:has_j_send_result)
-            raise Errors::DoubleResult.new(service: entity)
+            raise Exceptions::DoubleResult.new(service: entity)
           end
           ##
@@ -58,8 +60,8 @@ module ConvenientService
           #
           #   NOTE: This method contains a trailing exclamation mark in its name since it is mutable.
           #
-          def mark_as_has_result!
-            entity.internals.cache.write(:has_result, true)
+          def mark_as_has_j_send_result!
+            entity.internals.cache.write(:has_j_send_result, true)
           end
         end
       end

data/lib/convenient_service/service/plugins/raises_on_double_result.rb CHANGED Viewed

@@ -1,4 +1,4 @@
 # frozen_string_literal: true
-require_relative "raises_on_double_result/errors"
+require_relative "raises_on_double_result/exceptions"
 require_relative "raises_on_double_result/middleware"

data/lib/convenient_service/service/plugins/raises_on_not_result_return_value/exceptions.rb ADDED Viewed

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+module ConvenientService
+  module Service
+    module Plugins
+      module RaisesOnNotResultReturnValue
+        module Exceptions
+          class ReturnValueNotKindOfResult < ::ConvenientService::Exception
+            def initialize(service:, result:, method:)
+              message = <<~TEXT
+                Return value of service `#{service.class}` is NOT a `Result`.
+                It is `#{result.class}`.
+                Did you forget to call `success`, `failure`, or `error` from the `:#{method}` method?
+              TEXT
+              super(message)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/convenient_service/service/plugins/raises_on_not_result_return_value/middleware.rb ADDED Viewed

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+module ConvenientService
+  module Service
+    module Plugins
+      module RaisesOnNotResultReturnValue
+        class Middleware < MethodChainMiddleware
+          include Support::DependencyContainer::Import
+          import :"commands.is_result?", from: Service::Plugins::HasJSendResult::Container
+          intended_for any_method, entity: :service
+          def next(...)
+            original_result = chain.next(...)
+            return original_result if commands.is_result?(original_result)
+            raise Exceptions::ReturnValueNotKindOfResult.new(service: entity, result: original_result, method: method)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/convenient_service/service/plugins/raises_on_not_result_return_value.rb ADDED Viewed

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+require_relative "raises_on_not_result_return_value/exceptions"
+require_relative "raises_on_not_result_return_value/middleware"

data/lib/convenient_service/service/plugins/rescues_result_unhandled_exceptions/middleware.rb CHANGED Viewed

@@ -4,12 +4,46 @@ module ConvenientService
   module Service
     module Plugins
       module RescuesResultUnhandledExceptions
-        class Middleware < Core::MethodChainMiddleware
+        class Middleware < MethodChainMiddleware
+          intended_for :result, scope: any_scope, entity: :service
           ##
           # @param args [Array<Object>]
           # @param kwargs [Hash{Symbol => Object}]
           # @param block [Proc, nil]
-          # @return [ConvenientService::Service::Plugins::HasResult::Entities::Result]
+          # @return [ConvenientService::Service::Plugins::HasJSendResult::Entities::Result]
+          #
+          # @note This middleware can be used for both instance and class `:result` methods.
+          #
+          # @example Usage for instance `:result`.
+          #
+          #   class Service
+          #     include ConvenientService::Standard::Config
+          #
+          #     middlewares :result do
+          #       use ConvenientService::Plugins::Service::RescuesResultUnhandledExceptions::Middleware
+          #     end
+          #   end
+          #
+          # @example Usage for class `:result`.
+          #
+          #   class Service
+          #     include ConvenientService::Standard::Config
+          #
+          #     middlewares :result, scope: :class do
+          #       use ConvenientService::Plugins::Service::RescuesResultUnhandledExceptions::Middleware
+          #     end
+          #   end
+          #
+          # @example Max backtrace size can be configured.
+          #
+          #   class Service
+          #     include ConvenientService::Standard::Config
+          #
+          #     middlewares :result do
+          #       use ConvenientService::Plugins::Service::RescuesResultUnhandledExceptions::Middleware.with(max_backtrace_size: 1_000)
+          #     end
+          #   end
           #
           # @internal
           #   NOTE: `rescue => exception` is the same as `rescue ::StandardError => exception`.
@@ -32,7 +66,7 @@ module ConvenientService
           # @param args [Array<Object>]
           # @param kwargs [Hash{Symbol => Object}]
           # @param block [Proc, nil]
-          # @return [ConvenientService::Service::Plugins::HasResult::Entities::Result]
+          # @return [ConvenientService::Service::Plugins::HasJSendResult::Entities::Result]
           #
           def failure_result_from(exception, *args, **kwargs, &block)
             entity.failure(
@@ -56,7 +90,7 @@ module ConvenientService
           # @return [Integer]
           #
           def max_backtrace_size
-            arguments.kwargs.fetch(:max_backtrace_size) { Constants::DEFAULT_MAX_BACKTRACE_SIZE }
+            middleware_arguments.kwargs.fetch(:max_backtrace_size) { Constants::DEFAULT_MAX_BACKTRACE_SIZE }
           end
         end
       end

data/lib/convenient_service/service/plugins/sets_parent_to_foreign_result/middleware.rb ADDED Viewed

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+module ConvenientService
+  module Service
+    module Plugins
+      module SetsParentToForeignResult
+        class Middleware < MethodChainMiddleware
+          intended_for :result, entity: :service
+          ##
+          # @return [ConvenientService::Service::Plugins::HasJSendResult::Entities::Result]
+          #
+          # @example Behavior when `SetsParentToForeignResult` middleware is NOT used.
+          #
+          #   class Service
+          #     def result
+          #       OtherService.result
+          #     end
+          #   end
+          #
+          #   service = Service.new
+          #
+          #   service.result
+          #   # => Result.new(service: instance_of(OtherService), parent: instance_of(OtherService).parent)
+          #
+          # @example Behavior when `SetsParentToForeignResult` middleware is used.
+          #
+          #   class Service
+          #     def result
+          #       OtherService.result
+          #     end
+          #   end
+          #
+          #   service = Service.new
+          #
+          #   service.result
+          #   # => Result.new(service: instance_of(Service), parent: instance_of(OtherService))
+          #
+          # @internal
+          #   TODO: Document order of plugins.
+          #
+          #   NOTE: It is imposible to receive a foreign result from a step result, that is why `step: nil` is passed to `copy`. See `Step#result` for details.
+          #
+          #
+          def next(...)
+            result = chain.next(...)
+            return result unless result.foreign_result_for?(entity)
+            result.copy(overrides: {kwargs: {service: entity, step: nil, parent: result}})
+          end
+        end
+      end
+    end
+  end
+end

data/lib/convenient_service/service/plugins/sets_parent_to_foreign_result.rb ADDED Viewed

@@ -0,0 +1,3 @@
+# frozen_string_literal: true
+require_relative "sets_parent_to_foreign_result/middleware"

data/lib/convenient_service/service/plugins/wraps_result_in_db_transaction/middleware.rb CHANGED Viewed

@@ -4,7 +4,9 @@ module ConvenientService
   module Service
     module Plugins
       module WrapsResultInDbTransaction
-        class Middleware < Core::MethodChainMiddleware
+        class Middleware < MethodChainMiddleware
+          intended_for :result, scope: :class, entity: :service
           def next(...)
             ::ActiveRecord::Base.transaction { chain.next(...) }
           end

data/lib/convenient_service/service/plugins.rb CHANGED Viewed

@@ -1,18 +1,26 @@
 # frozen_string_literal: true
 ##
-# NOTE: Order matters.
+# @internal
+#   NOTE: Order matters.
 #
+require_relative "plugins/has_result"
+require_relative "plugins/has_j_send_result"
 require_relative "plugins/can_recalculate_result"
 require_relative "plugins/can_have_method_steps"
-require_relative "plugins/can_have_result_step"
 require_relative "plugins/can_have_steps"
-require_relative "plugins/can_have_stubbed_result"
+require_relative "plugins/can_have_stubbed_results"
+require_relative "plugins/can_have_fallback"
+require_relative "plugins/collects_services_in_exception"
+require_relative "plugins/counts_stubbed_results_invocations"
 require_relative "plugins/has_inspect"
-require_relative "plugins/has_result"
-require_relative "plugins/has_result_short_syntax"
+require_relative "plugins/has_j_send_result_short_syntax"
+require_relative "plugins/has_j_send_result_status_check_short_syntax"
+require_relative "plugins/has_mermaid_flowchart"
+require_relative "plugins/raises_on_not_result_return_value"
 require_relative "plugins/raises_on_double_result"
+require_relative "plugins/sets_parent_to_foreign_result"
 require_relative "plugins/wraps_result_in_db_transaction"
-require_relative "plugins/has_result_status_check_short_syntax"
 require_relative "plugins/aliases"

data/lib/convenient_service/support/abstract_method/{errors.rb → exceptions.rb} RENAMED Viewed

@@ -3,8 +3,8 @@
 module ConvenientService
   module Support
     module AbstractMethod
-      module Errors
-        class AbstractMethodNotOverridden < ::ConvenientService::Error
+      module Exceptions
+        class AbstractMethodNotOverridden < ::ConvenientService::Exception
           def initialize(instance:, method:)
             klass = instance.is_a?(::Class) ? instance : instance.class
             method_type = Utils::Object.resolve_type(instance)

data/lib/convenient_service/support/abstract_method.rb CHANGED Viewed

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
-require_relative "abstract_method/errors"
+require_relative "abstract_method/exceptions"
 module ConvenientService
   module Support
@@ -11,7 +11,7 @@ module ConvenientService
         def abstract_method(*names)
           names.each do |name|
             define_method(name) do |*args, **kwargs, &block|
-              raise Errors::AbstractMethodNotOverridden.new(instance: self, method: name)
+              raise Exceptions::AbstractMethodNotOverridden.new(instance: self, method: name)
             end
           end
         end

data/lib/convenient_service/support/cache/constants.rb ADDED Viewed

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+module ConvenientService
+  module Support
+    class Cache
+      class Constants
+        module Backends
+          ##
+          # @return [Symbol]
+          #
+          ARRAY = :array
+          ##
+          # @return [Symbol]
+          #
+          HASH = :hash
+          ##
+          # @return [Symbol]
+          #
+          THREAD_SAFE_ARRAY = :thread_safe_array
+          ##
+          # @return [Array<Symbol>]
+          #
+          ALL = [ARRAY, HASH, THREAD_SAFE_ARRAY]
+          ##
+          # @return [Symbol]
+          #
+          DEFAULT = HASH
+        end
+      end
+    end
+  end
+end