servactory 2.2.3 → 2.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a51453d18412c6b59e5bf08eafdc54c5bf30d5f174b3f0bac9f765f86ce571d3
-  data.tar.gz: 2c808474f78bc6de5305768c95ed8da3b235c25f51bdf03b8f88e824aa25ad9d
+  metadata.gz: 9598623fa8187288fe92566315cf8bf293f0fec4995cd778186b7b29bba90504
+  data.tar.gz: 03d3236b8b846e1fecc11ee19d754a235c5b40a9b7d58f36298767a2ea36b241
 SHA512:
-  metadata.gz: 2868a096dd3b76d8bcc5ee718220c7335abbab1b5d9423260b0d0e84e258bf97cf2b737976a625d6bed4ef0dbbfc036bb26f9aadfc7ebf208fedd97c797cad47
-  data.tar.gz: fb248ceeaf20d9d4945b7e0872d3c069416379f650afca902910d324747c03d98dce46330283ae67466a1cc79651225903ef53075b3d5c3295023fd3ac883c84
+  metadata.gz: 9a56ab102855338ee035e6b4163af6e39d618ea56c3a8277b9f6bae7c5974d203ade30db911ed32a0cad0c541e8f2b3e7dced9fb7015ee905e0e15ef66b06094
+  data.tar.gz: c2d2014270e95e382de071858c8ce43f555c6b05d019f24b30f824fad934c63cd849b837813dbe53faf5afde8b6da4cb32d5f7ee72c6074ccc275d4a2a0dc453

data/lib/servactory/configuration/dsl.rb

@@ -11,9 +11,9 @@ module Servactory
         def inherited(child) # rubocop:disable Metrics/MethodLength, Metrics/AbcSize
           super
 
-          child.config.input_error_class = config.input_error_class
-          child.config.internal_error_class = config.internal_error_class
-          child.config.output_error_class = config.output_error_class
+          child.config.input_exception_class = config.input_exception_class
+          child.config.internal_exception_class = config.internal_exception_class
+          child.config.output_exception_class = config.output_exception_class
 
           child.config.success_class = config.success_class
           child.config.failure_class = config.failure_class

data/lib/servactory/configuration/factory.rb

@@ -7,20 +7,60 @@ module Servactory
         @config = config
       end
 
+      # DEPRECATED: These configs must be deleted after release 2.4.
       def input_error_class(input_error_class)
-        @config.input_error_class = input_error_class
+        Kernel.warn "DEPRECATION WARNING: " \
+                    "Configuration `input_error_class` is deprecated; " \
+                    "use `internal_exception_class` instead. " \
+                    "It will be removed in one of the next releases."
+
+        input_exception_class(input_error_class)
+      end
+
+      # DEPRECATED: These configs must be deleted after release 2.4.
+      def internal_error_class(internal_error_class)
+        Kernel.warn "DEPRECATION WARNING: " \
+                    "Configuration `internal_error_class` is deprecated; " \
+                    "use `internal_exception_class` instead. " \
+                    "It will be removed in one of the next releases."
+
+        internal_exception_class(internal_error_class)
       end
 
+      # DEPRECATED: These configs must be deleted after release 2.4.
       def output_error_class(output_error_class)
-        @config.output_error_class = output_error_class
+        Kernel.warn "DEPRECATION WARNING: " \
+                    "Configuration `output_error_class` is deprecated; " \
+                    "use `output_exception_class` instead. " \
+                    "It will be removed in one of the next releases."
+
+        output_exception_class(output_error_class)
       end
 
-      def internal_error_class(internal_error_class)
-        @config.internal_error_class = internal_error_class
+      def input_exception_class(input_exception_class)
+        return @config.input_exception_class = input_exception_class if subclass_of_exception?(input_exception_class)
+
+        raise_error_about_wrong_exception_class_with(:input_exception_class, input_exception_class)
+      end
+
+      def internal_exception_class(internal_exception_class)
+        if subclass_of_exception?(internal_exception_class)
+          return @config.internal_exception_class = internal_exception_class
+        end
+
+        raise_error_about_wrong_exception_class_with(:internal_exception_class, internal_exception_class)
+      end
+
+      def output_exception_class(output_exception_class)
+        return @config.output_exception_class = output_exception_class if subclass_of_exception?(output_exception_class)
+
+        raise_error_about_wrong_exception_class_with(:output_exception_class, output_exception_class)
       end
 
       def failure_class(failure_class)
-        @config.failure_class = failure_class
+        return @config.failure_class = failure_class if subclass_of_exception?(failure_class)
+
+        raise_error_about_wrong_exception_class_with(:failure_class, failure_class)
       end
 
       def collection_mode_class_names(collection_mode_class_names)
@@ -50,6 +90,21 @@ module Servactory
       def action_shortcuts(action_shortcuts)
         @config.action_shortcuts.merge(action_shortcuts)
       end
+
+      ##########################################################################
+
+      def subclass_of_exception?(value)
+        value.is_a?(Class) && value <= Exception
+      end
+
+      ##########################################################################
+
+      def raise_error_about_wrong_exception_class_with(config_name, value)
+        raise ArgumentError,
+              "Error in `#{config_name}` configuration. " \
+              "The `#{value}` value must be a subclass of `Exception`. " \
+              "See example configuration here: https://servactory.com/guide/configuration"
+      end
     end
   end
 end

data/lib/servactory/configuration/setup.rb

@@ -3,9 +3,9 @@
 module Servactory
   module Configuration
     class Setup
-      attr_accessor :input_error_class,
-                    :internal_error_class,
-                    :output_error_class,
+      attr_accessor :input_exception_class,
+                    :internal_exception_class,
+                    :output_exception_class,
                     :success_class,
                     :failure_class,
                     :collection_mode_class_names,
@@ -17,12 +17,12 @@ module Servactory
                     :action_shortcuts
 
       def initialize # rubocop:disable Metrics/MethodLength
-        @input_error_class = Servactory::Errors::InputError
-        @internal_error_class = Servactory::Errors::InternalError
-        @output_error_class = Servactory::Errors::OutputError
+        @input_exception_class = Servactory::Exceptions::Input
+        @internal_exception_class = Servactory::Exceptions::Internal
+        @output_exception_class = Servactory::Exceptions::Output
 
         @success_class = Servactory::Exceptions::Success
-        @failure_class = Servactory::Errors::Failure
+        @failure_class = Servactory::Exceptions::Failure
 
         @collection_mode_class_names =
           Servactory::Maintenance::CollectionMode::ClassNamesCollection.new(default_collection_mode_class_names)

data/lib/servactory/context/callable.rb

@@ -21,7 +21,20 @@ module Servactory
       end
 
       def call(arguments = {})
-        call!(arguments)
+        context = send(:new)
+
+        context.send(
+          :_call!,
+          incoming_arguments: arguments.symbolize_keys,
+          collection_of_inputs: collection_of_inputs,
+          collection_of_internals: collection_of_internals,
+          collection_of_outputs: collection_of_outputs,
+          collection_of_stages: collection_of_stages
+        )
+
+        Servactory::Result.success_for(context: context)
+      rescue config.success_class => e
+        Servactory::Result.success_for(context: e.context)
       rescue config.failure_class => e
         Servactory::Result.failure_for(exception: e)
       end

data/lib/servactory/context/workspace/inputs.rb

@@ -104,7 +104,7 @@ module Servactory
             input_name: name
           )
 
-          raise @context.class.config.input_error_class.new(message: message_text, input_name: name)
+          raise @context.class.config.input_exception_class.new(message: message_text, input_name: name)
         end
       end
     end

data/lib/servactory/context/workspace/internals.rb

@@ -75,7 +75,7 @@ module Servactory
             internal_name: name
           )
 
-          raise @context.class.config.input_error_class.new(message: message_text)
+          raise @context.class.config.input_exception_class.new(message: message_text)
         end
       end
     end

data/lib/servactory/context/workspace/outputs.rb

@@ -75,7 +75,7 @@ module Servactory
             output_name: name
           )
 
-          raise @context.class.config.output_error_class.new(message: message_text)
+          raise @context.class.config.output_exception_class.new(message: message_text)
         end
       end
     end

data/lib/servactory/context/workspace.rb

@@ -30,21 +30,21 @@ module Servactory
       end
 
       def fail_input!(input_name, message:)
-        raise self.class.config.input_error_class.new(
+        raise self.class.config.input_exception_class.new(
           input_name: input_name,
           message: message
         )
       end
 
       def fail_internal!(internal_name, message:)
-        raise self.class.config.internal_error_class.new(
+        raise self.class.config.internal_exception_class.new(
           internal_name: internal_name,
           message: message
         )
       end
 
       def fail_output!(output_name, message:)
-        raise self.class.config.output_error_class.new(
+        raise self.class.config.output_exception_class.new(
           output_name: output_name,
           message: message
         )

data/lib/servactory/errors/failure.rb

@@ -2,6 +2,7 @@
 
 module Servactory
   module Errors
+    # DEPRECATED: This class will be deleted after release 2.4.
     class Failure < Servactory::Exceptions::Base
       attr_reader :type,
                   :message,

data/lib/servactory/errors/input_error.rb

@@ -2,6 +2,7 @@
 
 module Servactory
   module Errors
+    # DEPRECATED: This class will be deleted after release 2.4.
     class InputError < Servactory::Exceptions::Base
       attr_reader :message,
                   :input_name

data/lib/servactory/errors/internal_error.rb

@@ -2,6 +2,7 @@
 
 module Servactory
   module Errors
+    # DEPRECATED: This class will be deleted after release 2.4.
     class InternalError < Servactory::Exceptions::Base
       attr_reader :message,
                   :internal_name

data/lib/servactory/errors/output_error.rb

@@ -2,6 +2,7 @@
 
 module Servactory
   module Errors
+    # DEPRECATED: This class will be deleted after release 2.4.
     class OutputError < Servactory::Exceptions::Base
       attr_reader :message,
                   :output_name

data/lib/servactory/exceptions/failure.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Servactory
+  module Exceptions
+    class Failure < Base
+      attr_reader :type,
+                  :message,
+                  :meta
+
+      def initialize(type: :base, message:, meta: nil) # rubocop:disable Style/KeywordParametersOrder
+        @type = type
+        @message = message
+        @meta = meta
+
+        super(message)
+      end
+    end
+  end
+end

data/lib/servactory/exceptions/input.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Servactory
+  module Exceptions
+    class Input < Base
+      attr_reader :message,
+                  :input_name
+
+      def initialize(message:, input_name: nil)
+        @message = message
+        @input_name = input_name&.to_sym
+
+        super(message)
+      end
+    end
+  end
+end

data/lib/servactory/exceptions/internal.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Servactory
+  module Exceptions
+    class Internal < Base
+      attr_reader :message,
+                  :internal_name
+
+      def initialize(message:, internal_name: nil)
+        @message = message
+        @internal_name = internal_name&.to_sym
+
+        super(message)
+      end
+    end
+  end
+end

data/lib/servactory/exceptions/output.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Servactory
+  module Exceptions
+    class Output < Base
+      attr_reader :message,
+                  :output_name
+
+      def initialize(message:, output_name: nil)
+        @message = message
+        @output_name = output_name&.to_sym
+
+        super(message)
+      end
+    end
+  end
+end

data/lib/servactory/inputs/tools/rules.rb

@@ -35,7 +35,7 @@ module Servactory
             conflict_code: input.conflict_code
           )
 
-          raise @context.class.config.input_error_class.new(
+          raise @context.class.config.input_exception_class.new(
             message: message_text,
             input_name: input.name
           )

data/lib/servactory/inputs/tools/unnecessary.rb

@@ -23,7 +23,7 @@ module Servactory
             unnecessary_attributes: unnecessary_attributes.join(", ")
           )
 
-          raise @context.class.config.input_error_class.new(message: message_text)
+          raise @context.class.config.input_exception_class.new(message: message_text)
         end
 
         private

data/lib/servactory/inputs/tools/validation.rb

@@ -73,7 +73,7 @@ module Servactory
         def raise_errors
           return if (tmp_errors = errors.not_blank).empty?
 
-          raise @context.class.config.input_error_class.new(message: tmp_errors.first)
+          raise @context.class.config.input_exception_class.new(message: tmp_errors.first)
         end
       end
     end

data/lib/servactory/maintenance/attributes/tools/validation.rb

@@ -71,7 +71,7 @@ module Servactory
             return if (tmp_errors = errors.not_blank).empty?
 
             raise @context.class.config
-                          .public_send(:"#{@attribute.system_name}_error_class")
+                          .public_send(:"#{@attribute.system_name}_exception_class")
                           .new(message: tmp_errors.first)
           end
         end

data/lib/servactory/version.rb

@@ -3,8 +3,8 @@
 module Servactory
   module VERSION
     MAJOR = 2
-    MINOR = 2
-    PATCH = 3
+    MINOR = 3
+    PATCH = 1
     PRE = nil
 
     STRING = [MAJOR, MINOR, PATCH, PRE].compact.join(".")

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: servactory
 version: !ruby/object:Gem::Version
-  version: 2.2.3
+  version: 2.3.1
 platform: ruby
 authors:
 - Anton Sokolov
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-03-05 00:00:00.000000000 Z
+date: 2024-03-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -265,6 +265,10 @@ files:
 - lib/servactory/errors/internal_error.rb
 - lib/servactory/errors/output_error.rb
 - lib/servactory/exceptions/base.rb
+- lib/servactory/exceptions/failure.rb
+- lib/servactory/exceptions/input.rb
+- lib/servactory/exceptions/internal.rb
+- lib/servactory/exceptions/output.rb
 - lib/servactory/exceptions/success.rb
 - lib/servactory/info/dsl.rb
 - lib/servactory/info/result.rb