convenient_service 0.24.0 → 0.25.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b223651455eef03afc210c38e6ce570703b35bafc8543633072a019cfbb312fa
-  data.tar.gz: ace1e707494c39cfe83e4eda8b72d64b356db659ab437fe49b530b101cef23b1
+  metadata.gz: 9a077e3ef95d8ad18dbc79399c5513f29a17491111557cfad7b446eda2bec5a8
+  data.tar.gz: 07e8481191d8a8fe51b7995d5507147755ee2676cfe51b9c5a5b11e42f5a47e2
 SHA512:
-  metadata.gz: 2e79cfb96f54558b5a2382236777543b7bba3f46e3b360919ca0779359bf16a61b7784d6f5d92c6b925813a2714bb1aec20dc6a943656f85d34ba3f37de1bc23
-  data.tar.gz: 79510a4c2dc7370b01c09f82b8f062dcab488eb7113f1f85f2c5bde20af5553c1fec19f9cb69c9e81ee4a5b894a73298c793ed2a5eb125757bcb8065231c70fc
+  metadata.gz: 268d3a56e8ea1e0161dde099762d3d91dcb8c85b005d2fc45e6ab9e8e622a7da15b4c6d70c45809dd8cd83787cbb042ffe71f4aaef369be4562f18d2b6b22340
+  data.tar.gz: deeb6b2c67a294a98fee2fdb409d653b4674c83c22f9e8ef413014ef42d1dfe8127e3aaecc85d020a206350607f2276e1f09575f5bb9e0888e4927a73697e513

data/lib/convenient_service/dependencies/queries.rb

@@ -25,10 +25,12 @@ module ConvenientService
       ##
       # Returns `true` when Convenient Service is in debug mode. In other words `$CONVENIENT_SERVICE_DEBUG` env variable is set to `true`.
       #
-      # @api private
+      # @api public
       # @since 1.0.0
       # @return [Boolean]
       #
+      # @see https://userdocs.convenientservice.org/comprehensive_docs/docs/the_how/how_to_debug_the_convenient_service_lib_itself.html
+      #
       def debug?
         ::ENV["CONVENIENT_SERVICE_DEBUG"] == "true"
       end
@@ -499,7 +501,7 @@ module ConvenientService
       # @return [Boolean]
       # @note Expected to be called from `spec_helper.rb`.
       #
-      def require_rspec_extentions
+      def require_rspec_extensions
         require "rspec/expectations"
         require "rspec/matchers"
         require "rspec/mocks"

data/lib/convenient_service/extras/rspec.rb

@@ -12,4 +12,4 @@
 
 require "convenient_service"
 
-ConvenientService::Dependencies.require_rspec_extentions
+ConvenientService::Dependencies.require_rspec_extensions

data/lib/convenient_service/logger.rb

@@ -46,10 +46,10 @@ module ConvenientService
       def new
         super(::STDOUT).tap do |logger|
           logger.level =
-            if ::ENV["CONVENIENT_SERVICE_DEBUG"] == "true"
-              ::Logger::DEBUG
-            elsif ::ENV["CONVENIENT_SERVICE_LOGGER_LEVEL"]
+            if ::ENV["CONVENIENT_SERVICE_LOGGER_LEVEL"]
               ::ENV["CONVENIENT_SERVICE_LOGGER_LEVEL"]
+            elsif ::ENV["CONVENIENT_SERVICE_DEBUG"] == "true"
+              ::Logger::DEBUG
             else
               ::Logger::INFO
             end
@@ -98,6 +98,9 @@ module ConvenientService
     ##
     # @api public
     #
+    # @see https://userdocs.convenientservice.org/comprehensive_docs/docs/the_what/what_is_convenient_service_logger.html
+    # @see https://userdocs.convenientservice.org/comprehensive_docs/docs/the_how/how_to_configure_convenient_service_logger.html
+    #
     # @internal
     #   IMPORTANT: Older versions of `Logger` do NOT support `level` as a string.
     #   - https://github.com/ruby/logger/blob/v1.2.8.1/lib/logger.rb#L333

data/lib/convenient_service/rspec/matchers/classes/results/base/entities/printers/error/commands/generate_got_jsend_attributes_part.rb

@@ -90,7 +90,7 @@ module ConvenientService
                       # @return [String]
                       #
                       def code_part
-                        (code == Service::Plugins::HasJSendResult::Constants::DEFAULT_ERROR_CODE) ? "" : "with code `#{code}`"
+                        (code == Service::Plugins::HasJSendResult.default_error_code) ? "" : "with code `#{code}`"
                       end
 
                       ##

data/lib/convenient_service/rspec/matchers/classes/results/base/entities/printers/failure/commands/generate_got_jsend_attributes_part.rb

@@ -90,7 +90,7 @@ module ConvenientService
                       # @return [String]
                       #
                       def code_part
-                        (code == Service::Plugins::HasJSendResult::Constants::DEFAULT_FAILURE_CODE) ? "" : "with code `#{code}`"
+                        (code == Service::Plugins::HasJSendResult.default_failure_code) ? "" : "with code `#{code}`"
                       end
 
                       ##

data/lib/convenient_service/rspec/matchers/classes/results/base/entities/printers/success/commands/generate_got_jsend_attributes_part.rb

@@ -90,7 +90,7 @@ module ConvenientService
                       # @return [String]
                       #
                       def code_part
-                        (code == Service::Plugins::HasJSendResult::Constants::DEFAULT_SUCCESS_CODE) ? "" : "with code `#{code}`"
+                        (code == Service::Plugins::HasJSendResult.default_success_code) ? "" : "with code `#{code}`"
                       end
 
                       ##

data/lib/convenient_service/rspec/matchers/classes/results/be_error.rb

@@ -17,7 +17,7 @@ module ConvenientService
             # @return [Array<Symbol>]
             #
             def statuses
-              [Service::Plugins::HasJSendResult::Constants::ERROR_STATUS]
+              [Service::Plugins::HasJSendResult.error_status]
             end
           end
         end

data/lib/convenient_service/rspec/matchers/classes/results/be_failure.rb

@@ -17,7 +17,7 @@ module ConvenientService
             # @return [Array<Symbol>]
             #
             def statuses
-              [Service::Plugins::HasJSendResult::Constants::FAILURE_STATUS]
+              [Service::Plugins::HasJSendResult.failure_status]
             end
           end
         end

data/lib/convenient_service/rspec/matchers/classes/results/be_not_error.rb

@@ -18,8 +18,8 @@ module ConvenientService
             #
             def statuses
               [
-                Service::Plugins::HasJSendResult::Constants::SUCCESS_STATUS,
-                Service::Plugins::HasJSendResult::Constants::FAILURE_STATUS
+                Service::Plugins::HasJSendResult.success_status,
+                Service::Plugins::HasJSendResult.failure_status
               ]
             end
           end

data/lib/convenient_service/rspec/matchers/classes/results/be_not_failure.rb

@@ -18,8 +18,8 @@ module ConvenientService
             #
             def statuses
               [
-                Service::Plugins::HasJSendResult::Constants::SUCCESS_STATUS,
-                Service::Plugins::HasJSendResult::Constants::ERROR_STATUS
+                Service::Plugins::HasJSendResult.success_status,
+                Service::Plugins::HasJSendResult.error_status
               ]
             end
           end

data/lib/convenient_service/rspec/matchers/classes/results/be_not_success.rb

@@ -18,8 +18,8 @@ module ConvenientService
             #
             def statuses
               [
-                Service::Plugins::HasJSendResult::Constants::FAILURE_STATUS,
-                Service::Plugins::HasJSendResult::Constants::ERROR_STATUS
+                Service::Plugins::HasJSendResult.failure_status,
+                Service::Plugins::HasJSendResult.error_status
               ]
             end
           end

data/lib/convenient_service/rspec/matchers/classes/results/be_success.rb

@@ -17,7 +17,7 @@ module ConvenientService
             # @return [Array<Symbol>]
             #
             def statuses
-              [Service::Plugins::HasJSendResult::Constants::SUCCESS_STATUS]
+              [Service::Plugins::HasJSendResult.success_status]
             end
           end
         end

data/lib/convenient_service/service/configs/standard.rb

@@ -94,6 +94,7 @@ module ConvenientService
             use ConvenientService::Plugins::Service::CanBeCalled::Concern if options.enabled?(:essential)
             use ConvenientService::Plugins::Common::CanHaveCallbacks::Concern if options.enabled?(:callbacks)
             use ConvenientService::Plugins::Service::CanHaveFallbacks::Concern if options.enabled?(:fallbacks)
+            use ConvenientService::Plugins::Service::CanHaveInlineServices::Concern if options.enabled?(:essential)
             use ConvenientService::Plugins::Service::HasInspect::Concern if options.enabled?(:inspect)
             use ConvenientService::Plugins::Service::HasAwesomePrintInspect::Concern if options.enabled?(:awesome_print_inspect)
             use ConvenientService::Plugins::Service::HasAmazingPrintInspect::Concern if options.enabled?(:amazing_print_inspect)
@@ -338,7 +339,7 @@ module ConvenientService
             concerns do
               use ConvenientService::Plugins::Common::HasInternals::Concern if options.enabled?(:essential)
               use ConvenientService::Plugins::Step::HasResult::Concern if options.enabled?(:essential)
-              use ConvenientService::Plugins::Step::CanBeCompleted::Concern if options.enabled?(:essential)
+              use ConvenientService::Plugins::Step::CanBeEvaluated::Concern if options.enabled?(:essential)
               use ConvenientService::Plugins::Step::CanBeServiceStep::Concern if options.enabled?(:essential)
               use ConvenientService::Plugins::Step::CanBeMethodStep::Concern if options.enabled?(:essential)
               use ConvenientService::Plugins::Step::CanBeUsedInServiceAwareEnumerables::Concern if options.enabled?(:essential)
@@ -352,7 +353,6 @@ module ConvenientService
 
             middlewares :result do
               use ConvenientService::Plugins::Common::CachesReturnValue::Middleware if options.enabled?(:per_instance_caching)
-              use ConvenientService::Plugins::Common::CanHaveCallbacks::Middleware if options.enabled?(:callbacks)
               use ConvenientService::Plugins::Step::HasResult::Middleware if options.enabled?(:essential)
               use ConvenientService::Plugins::Step::CanHaveParentResult::Middleware if options.enabled?(:result_parents_trace)
               use ConvenientService::Plugins::Step::CanHaveFallbacks::Middleware.with(fallback_true_status: :failure) if options.enabled?(:fallbacks)
@@ -369,6 +369,11 @@ module ConvenientService
               use ConvenientService::Plugins::Common::CachesReturnValue::Middleware if options.enabled?(:per_instance_caching)
             end
 
+            middlewares :organizer_result do
+              use ConvenientService::Plugins::Common::CachesReturnValue::Middleware if options.enabled?(:per_instance_caching)
+              use ConvenientService::Plugins::Common::CanHaveCallbacks::Middleware if options.enabled?(:callbacks)
+            end
+
             entity :Internals do
               concerns do
                 use ConvenientService::Plugins::Internals::HasCache::Concern if options.enabled?(:per_instance_caching)

data/lib/convenient_service/service/plugins/can_have_after_step_callbacks/middleware.rb

@@ -65,11 +65,15 @@ module ConvenientService
           #     end
           #   end
           #
+          # @internal
+          #   IMPORTANT: `result.step.result` does NOT take result from internal cache, it raises instead. That is frustrating to the end-users, but there is NO workaroud yet.
+          #   TODO: Think about passing `result` with `callback_arguments`. Not perfect, but better than nothing.
+          #
           def next(method, **kwargs, &block)
             return chain.next(method, **kwargs, &block) if method != :step
 
             entity.step_class.class_exec(kwargs, block) do |kwargs, block|
-              after :result, **kwargs.merge(source_location: block.source_location) do |result|
+              after :organizer_result, **kwargs.merge(source_location: block.source_location) do |result|
                 organizer.instance_exec(
                   result.step,
                   params.to_callback_arguments,

data/lib/convenient_service/service/plugins/can_have_around_step_callbacks/middleware.rb

@@ -73,7 +73,7 @@ module ConvenientService
             return chain.next(method, **kwargs, &block) if method != :step
 
             entity.step_class.class_exec(kwargs, block) do |kwargs, block|
-              around :result, **kwargs.merge(source_location: block.source_location) do |chain|
+              around :organizer_result, **kwargs.merge(source_location: block.source_location) do |chain|
                 organizer.instance_exec(
                   proc { chain.yield.step },
                   params.to_callback_arguments,

data/lib/convenient_service/service/plugins/can_have_before_step_callbacks/middleware.rb

@@ -69,7 +69,7 @@ module ConvenientService
             return chain.next(method, **kwargs, &block) if method != :step
 
             entity.step_class.class_exec(kwargs, block) do |kwargs, block|
-              before :result, **kwargs.merge(source_location: block.source_location) do
+              before :organizer_result, **kwargs.merge(source_location: block.source_location) do
                 organizer.instance_exec(
                   params.to_callback_arguments,
                   &block

data/lib/convenient_service/service/plugins/can_have_connected_steps/concern.rb

@@ -23,6 +23,7 @@ module ConvenientService
             # @return [ConvenientService::Service::Plugins::CanHaveConnectedSteps::Entities::Expressions::Base]
             #
             # @note It is NOT recommended to rely on the return value of this method, since it may differ across different `step` related plugins.
+            # @see https://userdocs.convenientservice.org/comprehensive_docs/docs/the_what/what_step_input_types_are_available.html
             #
             def step(*args, **kwargs)
               previous_expression = steps.expression
@@ -717,12 +718,6 @@ module ConvenientService
             def steps_result
               ::ConvenientService.raise Exceptions::ServiceHasNoSteps.new(service_class: self.class) if steps.none?
 
-              steps.each_evaluated_step do |step|
-                step.save_outputs_in_organizer!
-
-                step.mark_as_evaluated!
-              end
-
               steps.result
             end
 

data/lib/convenient_service/service/plugins/can_have_connected_steps/entities/expressions/scalar.rb

@@ -37,7 +37,7 @@ module ConvenientService
               # @return [ConvenientService::Service::Plugins::HasJSendResult::Entities::Result]
               #
               def result
-                step.result
+                step.organizer_result
               end
 
               ##

data/lib/convenient_service/service/plugins/can_have_inline_services/concern.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+##
+# @author Marian Kostyk <mariankostyk13895@gmail.com>
+# @license LGPLv3 <https://www.gnu.org/licenses/lgpl-3.0.html>
+##
+
+module ConvenientService
+  module Service
+    module Plugins
+      module CanHaveInlineServices
+        module Concern
+          include Support::Concern
+
+          instance_methods do
+            ##
+            # @api private
+            # @param block [Proc, nil]
+            # @return [ConvenientService::Service::Plugins::CanHaveInlineServices::Entities::Proxy]
+            #
+            def inline(&block)
+              Entities::Proxy.new(&block)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/convenient_service/service/plugins/can_have_inline_services/entities/proxy.rb

@@ -0,0 +1,205 @@
+# frozen_string_literal: true
+
+##
+# @author Marian Kostyk <mariankostyk13895@gmail.com>
+# @license LGPLv3 <https://www.gnu.org/licenses/lgpl-3.0.html>
+##
+
+module ConvenientService
+  module Service
+    module Plugins
+      module CanHaveInlineServices
+        module Entities
+          ##
+          # @internal
+          #   TODO: Specs.
+          #
+          class Proxy
+            ##
+            # @param chain [Hash{Symbol => Object}]
+            # @param block [Proc, nil]
+            # @return [void]
+            #
+            def initialize(chain: {}, &block)
+              @chain = chain
+
+              if block
+                chain[:block] = block
+
+                define
+              end
+            end
+
+            ##
+            # @return [Boolean]
+            #
+            def defined?
+              chain.has_key?(:defined)
+            end
+
+            ##
+            # @return [Boolean]
+            #
+            def define
+              return false if self.defined?
+
+              klass.include config
+
+              variables.each_pair { |key, value| klass.define_method(key) { value } }
+
+              klass.class_exec(arguments, &block)
+
+              mark_as_defined!
+
+              true
+            end
+
+            ##
+            # @return [ConvenientService::Service::Plugins::CanHaveInlineServices::Entities::Proxy]
+            #
+            def with_arguments(...)
+              assert_not_defined!
+
+              chain[:arguments] = Support::Arguments.new(...)
+
+              self
+            end
+
+            ##
+            # @param variables [Hash{Symbol => Object}]
+            # @return [ConvenientService::Service::Plugins::CanHaveInlineServices::Entities::Proxy]
+            #
+            def with_variables(**variables)
+              assert_not_defined!
+
+              chain[:variables] = variables
+
+              self
+            end
+
+            ##
+            # @param config [ConvenientService::Config]
+            # @return [ConvenientService::Service::Plugins::CanHaveInlineServices::Entities::Proxy]
+            #
+            def with_config(config)
+              assert_not_defined!
+
+              chain[:config] = config
+
+              self
+            end
+
+            ##
+            # @param block [Proc, nil]
+            # @return [ConvenientService::Service::Plugins::HasJSendResult::Entities::Result]
+            #
+            def result(&block)
+              if block
+                assert_not_defined!
+
+                chain[:block] = block
+
+                define
+              end
+
+              klass.result
+            end
+
+            ##
+            # @param block [Proc, nil]
+            # @return [Class<ConvenientService::Service>]
+            #
+            def to_class(&block)
+              if block
+                assert_not_defined!
+
+                chain[:block] = block
+
+                define
+              end
+
+              klass
+            end
+
+            ##
+            # @return [Class<ConvenientService::Service>]
+            #
+            alias_method :service, :to_class
+
+            ##
+            # @param other [Object] Can be any type.
+            # @return [Boolean, nil]
+            #
+            def ==(other)
+              return unless other.instance_of?(self.class)
+
+              return false if chain != other.chain
+
+              true
+            end
+
+            protected
+
+            ##
+            # @!attribute [r] value
+            #   @return [Hash{Symbol => Object}]
+            #
+            attr_reader :chain
+
+            private
+
+            ##
+            # @return [Class]
+            #
+            def klass
+              @klass ||= ::Class.new
+            end
+
+            ##
+            # @return [ConvenientService::Support::Arguments]
+            #
+            def arguments
+              chain[:arguments] || Support::Arguments.null_arguments
+            end
+
+            ##
+            # @return [Hash{Symbol => Object}]
+            #
+            def variables
+              chain[:variables] || {}
+            end
+
+            ##
+            # @return [ConvenientService::Config]
+            #
+            def config
+              chain[:config] || ::ConvenientService::Standard::Config
+            end
+
+            ##
+            # @return [Proc]
+            #
+            def block
+              chain[:block] || proc {}
+            end
+
+            ##
+            # @return [void]
+            # @raise [ConvenientService::Service::Plugins::CanHaveInlineServices::Exceptions::InlineServiceIsAlreadyDefined]
+            #
+            def assert_not_defined!
+              ::ConvenientService.raise Exceptions::InlineServiceIsAlreadyDefined if self.defined?
+            end
+
+            ##
+            # @return [void]
+            #
+            def mark_as_defined!
+              chain[:defined] = true
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/convenient_service/service/plugins/{can_have_steps/entities/step/plugins/can_be_completed.rb → can_have_inline_services/entities.rb}

@@ -5,4 +5,4 @@
 # @license LGPLv3 <https://www.gnu.org/licenses/lgpl-3.0.html>
 ##
 
-require_relative "can_be_completed/concern"
+require_relative "entities/proxy"

data/lib/convenient_service/service/plugins/can_have_inline_services/exceptions.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+##
+# @author Marian Kostyk <mariankostyk13895@gmail.com>
+# @license LGPLv3 <https://www.gnu.org/licenses/lgpl-3.0.html>
+##
+
+module ConvenientService
+  module Service
+    module Plugins
+      module CanHaveInlineServices
+        module Exceptions
+          class InlineServiceIsAlreadyDefined < ::ConvenientService::Exception
+            ##
+            # @param object [Object] Can be any type.
+            # @return [void]
+            #
+            def initialize_with_kwargs(object:)
+              message = <<~TEXT
+                Definition of already defined inline service can NOT be modified.
+              TEXT
+
+              initialize(message)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/convenient_service/service/plugins/can_have_inline_services.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+##
+# @author Marian Kostyk <mariankostyk13895@gmail.com>
+# @license LGPLv3 <https://www.gnu.org/licenses/lgpl-3.0.html>
+##
+
+require_relative "can_have_inline_services/concern"
+require_relative "can_have_inline_services/entities"
+require_relative "can_have_inline_services/exceptions"
+
+# frozen_string_literal: true
+
+##
+# @author Marian Kostyk <mariankostyk13895@gmail.com>
+# @license LGPLv3 <https://www.gnu.org/licenses/lgpl-3.0.html>
+##
+
+module ConvenientService
+  module Service
+    module Plugins
+      module CanHaveInlineServices
+        class << self
+          ##
+          # @api private
+          # @param block [Proc, nil]
+          # @return [ConvenientService::Service::Plugins::CanHaveInlineServices::Entities::Proxy]
+          #
+          def proxy(&block)
+            Entities::Proxy.new(&block)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/convenient_service/service/plugins/can_have_sequential_steps/concern.rb

@@ -22,6 +22,8 @@ module ConvenientService
             # @param kwargs [Hash{Symbol => Object}]
             # @return [ConvenientService::Service::Plugins::CanHaveSteps::Entities::Step]
             #
+            # @see https://userdocs.convenientservice.org/comprehensive_docs/docs/best_practices/declare_in_out_explicitly_on_method_steps.html
+            #
             def step(*args, **kwargs)
               steps.create(*args, **kwargs)
             end

data/lib/convenient_service/service/plugins/can_have_sequential_steps/middleware.rb

@@ -52,11 +52,7 @@ module ConvenientService
           #   Do NOT spend too much time on that again, you have a lot of other tasks to do.
           #
           def find_first_not_successful_step_with_side_effects_during_lookup
-            entity.steps.find do |step|
-              step.status.unsafe_not_success?
-                .tap { step.save_outputs_in_organizer! }
-                .tap { step.mark_as_evaluated! }
-            end
+            entity.steps.find { |step| step.organizer_result.status.unsafe_not_success? }
           end
 
           ##

data/lib/convenient_service/service/plugins/can_have_steps/concern.rb

@@ -24,13 +24,8 @@ module ConvenientService
             ##
             # @api public
             #
-            # Allows to pass a value to `in` method without its intermediate processing.
             # @see https://userdocs.convenientservice.org/basics/step_to_result_translation_table
-            #
-            # @example `:chat_v2` is passed to `AssertFeatureEnabled` as it is.
-            #   step AssertFeatureEnabled, in: {name: raw(:chat_v2)}
-            #   # that is converted to the following service invocation:
-            #   AssertFeatureEnabled.result(name: :chat_v2)
+            # @see https://userdocs.convenientservice.org/comprehensive_docs/docs/the_what/what_is_a_step_raw_input.html
             #
             # @param value [Object] Can be any type.
             # @return [ConvenientService::Support::RawValue]

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

@@ -27,7 +27,7 @@ module ConvenientService
                 end
 
                 ##
-                # @return [ConvenientService::Service::Plugins::CanHaveSteps::Entities::Method::Entities::Factries::Base, nil]
+                # @return [ConvenientService::Service::Plugins::CanHaveSteps::Entities::Method::Entities::Factories::Base, nil]
                 #
                 def call
                   return unless factory_class
@@ -59,28 +59,25 @@ module ConvenientService
                 end
 
                 ##
-                # @return [ConvenientService::Service::Plugins::CanHaveSteps::Entities::Method::Entities::Factries::Base, nil]
+                # @return [ConvenientService::Service::Plugins::CanHaveSteps::Entities::Method::Entities::Factories::Base, nil]
                 #
                 def cast_symbol
                   Entities::Factories::Symbol
                 end
 
                 ##
-                # @return [ConvenientService::Service::Plugins::CanHaveSteps::Entities::Method::Entities::Factries::Base, nil]
+                # @return [ConvenientService::Service::Plugins::CanHaveSteps::Entities::Method::Entities::Factories::Base, nil]
                 #
                 def cast_string
                   Entities::Factories::String
                 end
 
                 ##
-                # @return [ConvenientService::Service::Plugins::CanHaveSteps::Entities::Method::Entities::Factries::Base, nil]
+                # @return [ConvenientService::Service::Plugins::CanHaveSteps::Entities::Method::Entities::Factories::Base, nil]
                 #
                 def cast_hash
                   return unless other.keys.one?
 
-                  ##
-                  # TODO: Add `other.keys.first.is_a?(Integer)` and `other.keys.first == Support::BLOCK` to support args and block via `step`?
-                  #
                   value = other.values.first
 
                   case value
@@ -96,7 +93,7 @@ module ConvenientService
                 end
 
                 ##
-                # @return [ConvenientService::Service::Plugins::CanHaveSteps::Entities::Method::Entities::Factries::Base, nil]
+                # @return [ConvenientService::Service::Plugins::CanHaveSteps::Entities::Method::Entities::Factories::Base, nil]
                 #
                 def cast_method
                   Entities::Factories::Method

data/lib/convenient_service/service/plugins/can_have_steps/entities/method/entities/callers/proc.rb

@@ -26,7 +26,7 @@ module ConvenientService
                   end
 
                   def define_output_in_container!(container, index:, method:)
-                    false
+                    Commands::DefineMethodInContainer.call(method: method, container: container, index: index)
                   end
 
                   private

data/lib/convenient_service/service/plugins/can_have_steps/entities/method/entities/callers/raw.rb

@@ -26,7 +26,7 @@ module ConvenientService
                   end
 
                   def define_output_in_container!(container, index:, method:)
-                    false
+                    Commands::DefineMethodInContainer.call(method: method, container: container, index: index)
                   end
 
                   private

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

@@ -18,7 +18,7 @@ module ConvenientService
                   # @return [ConvenientService::Service::Plugins::CanHaveSteps::Entities::Method::Entities::Key]
                   #
                   def create_key
-                    Entities::Key.new(other)
+                    Entities::Key.new(other.to_sym)
                   end
 
                   ##

data/lib/convenient_service/service/plugins/can_have_steps/entities/method/entities/key.rb

@@ -25,7 +25,7 @@ module ConvenientService
                 ##
                 # @return [String]
                 #
-                delegate :to_s, :to_sym, to: :value
+                delegate :to_s, to: :value
 
                 ##
                 # @return [Symbol]

data/lib/convenient_service/service/plugins/can_have_steps/entities/step/concern/instance_methods.rb

@@ -174,6 +174,19 @@ module ConvenientService
                   @organizer
                 end
 
+                ##
+                # @return [ConvenientService::Service::Plugins::HasJSendResult::Entities::Result]
+                #
+                def organizer_result
+                  original_result = result
+
+                  save_outputs_in_organizer!
+
+                  mark_as_evaluated!
+
+                  original_result
+                end
+
                 ##
                 # @api public
                 #

data/lib/convenient_service/service/plugins/can_have_steps/entities/step/plugins/{can_be_completed → can_be_evaluated}/concern.rb

@@ -12,7 +12,7 @@ module ConvenientService
         module Entities
           class Step
             module Plugins
-              module CanBeCompleted
+              module CanBeEvaluated
                 module Concern
                   include Support::Concern
 

data/lib/convenient_service/service/plugins/can_have_steps/entities/step/plugins/can_be_evaluated.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+##
+# @author Marian Kostyk <mariankostyk13895@gmail.com>
+# @license LGPLv3 <https://www.gnu.org/licenses/lgpl-3.0.html>
+##
+
+require_relative "can_be_evaluated/concern"

data/lib/convenient_service/service/plugins/can_have_steps/entities/step/plugins.rb

@@ -7,7 +7,7 @@
 
 require_relative "plugins/has_result"
 
-require_relative "plugins/can_be_completed"
+require_relative "plugins/can_be_evaluated"
 require_relative "plugins/can_be_service_step"
 require_relative "plugins/can_be_method_step"
 require_relative "plugins/can_be_used_in_service_aware_enumerables"

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

@@ -35,20 +35,40 @@ module ConvenientService
                       extra_kwargs.dig(:exceptions, :handled)
                     end
 
-                    ##
-                    # TODO: error.from_exception(exception)
-                    # TODO: error.from_exception(exception, max_backtrace_size: 5)
-                    # TODO: error("custom_message").from_exception(exception)
-                    # TODO: error(code: :custom_code).from_exception(exception)
-                    #
-                    # @internal
-                    #   If `error` message is default, use `from_exception` message.
-                    #   If `error` code is default, use `from_exception` code.
-                    #
-                    # def from_exception(exception, **kwargs)
-                    #   # ...
-                    # end
-                    ##
+                    def from_exception(exception, **kwargs)
+                      ::ConvenientService.raise Exceptions::FromExceptionOnNotErrorResult.new(result: self) unless status.unsafe_error?
+                      data =
+                        if Service::Plugins::HasJSendResult.default_error_data == unsafe_data.to_h
+                          {handled_exception: exception}
+                        else
+                          unsafe_data
+                        end
+
+                      message =
+                        if Service::Plugins::HasJSendResult.default_error_message == unsafe_message.to_s
+                          Service::Plugins::CanHaveFormattedExceptions.format_exception(exception, **kwargs)
+                        else
+                          unsafe_message
+                        end
+
+                      code =
+                        if Service::Plugins::HasJSendResult.default_error_code == unsafe_code.to_sym
+                          :handled_exception
+                        else
+                          unsafe_code
+                        end
+
+                      copy(
+                        overrides: {
+                          kwargs: {
+                            data: data,
+                            message: message,
+                            code: code,
+                            exceptions: {handled: exception}
+                          }
+                        }
+                      )
+                    end
                   end
                 end
               end

data/lib/convenient_service/service/plugins/has_j_send_result/entities/result/plugins/can_be_from_handled_exception/exceptions.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+##
+# @author Marian Kostyk <mariankostyk13895@gmail.com>
+# @license LGPLv3 <https://www.gnu.org/licenses/lgpl-3.0.html>
+##
+
+module ConvenientService
+  module Service
+    module Plugins
+      module HasJSendResult
+        module Entities
+          class Result
+            module Plugins
+              module CanBeFromHandledException
+                module Exceptions
+                  class FromExceptionOnNotErrorResult < ::ConvenientService::Exception
+                    ##
+                    # @param result [ConvenientService::Service::Plugins::HasJSendResult::Entities::Result]
+                    # @return [void]
+                    #
+                    def initialize_with_kwargs(result:)
+                      message = <<~TEXT
+                        `#{result.status}(...).from_exception(exception, ...)` is NOT allowed. Only `error` results can be from exceptions.
+                      TEXT
+
+                      initialize(message)
+                    end
+                  end
+                end
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -6,3 +6,4 @@
 ##
 
 require_relative "can_be_from_handled_exception/concern"
+require_relative "can_be_from_handled_exception/exceptions"

data/lib/convenient_service/service/plugins/has_j_send_result.rb

@@ -14,6 +14,90 @@ module ConvenientService
     module Plugins
       module HasJSendResult
         class << self
+          ##
+          # @return [Symbol]
+          #
+          def success_status
+            Constants::SUCCESS_STATUS
+          end
+
+          ##
+          # @return [Symbol]
+          #
+          def failure_status
+            Constants::FAILURE_STATUS
+          end
+
+          ##
+          # @return [Symbol]
+          #
+          def error_status
+            Constants::ERROR_STATUS
+          end
+
+          ##
+          # @return [Hash{Symbol => Object}]
+          #
+          def default_success_data
+            Constants::DEFAULT_SUCCESS_DATA
+          end
+
+          ##
+          # @return [Hash{Symbol => Object}]
+          #
+          def default_failure_data
+            Constants::DEFAULT_FAILURE_DATA
+          end
+
+          ##
+          # @return [Hash{Symbol => Object}]
+          #
+          def default_error_data
+            Constants::DEFAULT_ERROR_DATA
+          end
+
+          ##
+          # @return [String]
+          #
+          def default_success_message
+            Constants::DEFAULT_SUCCESS_MESSAGE
+          end
+
+          ##
+          # @return [String]
+          #
+          def default_failure_message
+            Constants::DEFAULT_FAILURE_MESSAGE
+          end
+
+          ##
+          # @return [String]
+          #
+          def default_error_message
+            Constants::DEFAULT_ERROR_MESSAGE
+          end
+
+          ##
+          # @return [Symbol]
+          #
+          def default_success_code
+            Constants::DEFAULT_SUCCESS_CODE
+          end
+
+          ##
+          # @return [Symbol]
+          #
+          def default_failure_code
+            Constants::DEFAULT_FAILURE_CODE
+          end
+
+          ##
+          # @return [Symbol]
+          #
+          def default_error_code
+            Constants::DEFAULT_ERROR_CODE
+          end
+
           ##
           # Checks whether an object is a result class.
           #

data/lib/convenient_service/service/plugins.rb

@@ -27,6 +27,7 @@ require_relative "plugins/can_have_around_step_callbacks"
 require_relative "plugins/can_have_before_step_callbacks"
 require_relative "plugins/can_have_fallbacks"
 require_relative "plugins/can_have_rollbacks"
+require_relative "plugins/can_have_inline_services"
 require_relative "plugins/can_have_stubbed_results"
 require_relative "plugins/can_not_be_inherited"
 require_relative "plugins/can_have_recalculations"

data/lib/convenient_service/version.rb

@@ -13,5 +13,5 @@ module ConvenientService
   # @since 1.0.0
   # @return [String]
   #
-  VERSION = "0.24.0"
+  VERSION = "0.25.0"
 end

data/lib/convenient_service.rb

@@ -209,10 +209,12 @@ module ConvenientService
     ##
     # Returns `true` when Convenient Service is in debug mode. In other words `$CONVENIENT_SERVICE_DEBUG` env variable is set to `true`.
     #
-    # @api private
+    # @api public
     # @since 1.0.0
     # @return [Boolean]
     #
+    # @see https://userdocs.convenientservice.org/comprehensive_docs/docs/the_how/how_to_debug_the_convenient_service_lib_itself.html
+    #
     def debug?
       Dependencies.debug?
     end
@@ -249,6 +251,9 @@ module ConvenientService
     #
     # @see https://github.com/ruby/logger
     # @see https://ruby-doc.org/stdlib-2.7.0/libdoc/logger/rdoc/Logger.html
+    # @see https://userdocs.convenientservice.org/comprehensive_docs/docs/the_how/how_to_debug_the_convenient_service_lib_itself.html
+    # @see https://userdocs.convenientservice.org/comprehensive_docs/docs/the_what/what_is_convenient_service_logger.html
+    # @see https://userdocs.convenientservice.org/comprehensive_docs/docs/the_how/how_to_configure_convenient_service_logger.html
     #
     # @example Set log level.
     #   ConvenientService.logger.level = Logger::DEBUG
@@ -267,6 +272,7 @@ module ConvenientService
     #
     # @see https://ruby-doc.org/core-2.7.1/Kernel.html#method-i-__dir__
     # @see https://api.rubyonrails.org/classes/Rails.html#method-c-root
+    # @see https://userdocs.convenientservice.org/comprehensive_docs/docs/the_how/how_to_get_convenient_service_root_folder.html
     #
     def root
       @root ||= ::Pathname.new(::File.expand_path(::File.join(__dir__, "..")))
@@ -280,6 +286,9 @@ module ConvenientService
     # @since 1.0.0
     # @return [Pathname]
     #
+    # @internal
+    #   TODO: Consider to make public for plugin devs.
+    #
     def lib_root
       @lib_root ||= ::Pathname.new(::File.join(root, "lib"))
     end
@@ -292,6 +301,9 @@ module ConvenientService
     # @since 1.0.0
     # @return [Pathname]
     #
+    # @internal
+    #   TODO: Consider to make public for plugin devs.
+    #
     def examples_root
       @examples_root ||= ::Pathname.new(::File.join(root, "lib", "convenient_service", "examples"))
     end
@@ -343,6 +355,16 @@ module ConvenientService
       @backtrace_cleaner ||= Support::BacktraceCleaner.new
     end
 
+    ##
+    # @api public
+    # @since 1.0.0
+    # @param block [Proc, nil]
+    # @return [ConvenientService::Service::Plugins::CanHaveInlineServices::Entities::Proxy]
+    #
+    def inline(&block)
+      Service::Plugins::CanHaveInlineServices.proxy(&block)
+    end
+
     ##
     # Raises Convenient Service exceptions.
     # Cleans exception backtrace with `ConvenientService.backtrace_cleaner.clean` before delegating to `Kernel.raise`.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: convenient_service
 version: !ruby/object:Gem::Version
-  version: 0.24.0
+  version: 0.25.0
 platform: ruby
 authors:
 - Marian Kostyk
@@ -436,6 +436,11 @@ files:
 - lib/convenient_service/service/plugins/can_have_formatted_exceptions/constants.rb
 - lib/convenient_service/service/plugins/can_have_handled_exceptions.rb
 - lib/convenient_service/service/plugins/can_have_handled_exceptions/concern.rb
+- lib/convenient_service/service/plugins/can_have_inline_services.rb
+- lib/convenient_service/service/plugins/can_have_inline_services/concern.rb
+- lib/convenient_service/service/plugins/can_have_inline_services/entities.rb
+- lib/convenient_service/service/plugins/can_have_inline_services/entities/proxy.rb
+- lib/convenient_service/service/plugins/can_have_inline_services/exceptions.rb
 - lib/convenient_service/service/plugins/can_have_recalculations.rb
 - lib/convenient_service/service/plugins/can_have_recalculations/concern.rb
 - lib/convenient_service/service/plugins/can_have_rollbacks.rb
@@ -518,8 +523,8 @@ files:
 - lib/convenient_service/service/plugins/can_have_steps/entities/step/exceptions.rb
 - lib/convenient_service/service/plugins/can_have_steps/entities/step/plugins.rb
 - lib/convenient_service/service/plugins/can_have_steps/entities/step/plugins/aliases.rb
-- lib/convenient_service/service/plugins/can_have_steps/entities/step/plugins/can_be_completed.rb
-- lib/convenient_service/service/plugins/can_have_steps/entities/step/plugins/can_be_completed/concern.rb
+- lib/convenient_service/service/plugins/can_have_steps/entities/step/plugins/can_be_evaluated.rb
+- lib/convenient_service/service/plugins/can_have_steps/entities/step/plugins/can_be_evaluated/concern.rb
 - lib/convenient_service/service/plugins/can_have_steps/entities/step/plugins/can_be_method_step.rb
 - lib/convenient_service/service/plugins/can_have_steps/entities/step/plugins/can_be_method_step/commands.rb
 - lib/convenient_service/service/plugins/can_have_steps/entities/step/plugins/can_be_method_step/commands/calculate_method_result.rb
@@ -607,6 +612,7 @@ files:
 - lib/convenient_service/service/plugins/has_j_send_result/entities/result/plugins/can_be_from_fallback/concern.rb
 - lib/convenient_service/service/plugins/has_j_send_result/entities/result/plugins/can_be_from_handled_exception.rb
 - lib/convenient_service/service/plugins/has_j_send_result/entities/result/plugins/can_be_from_handled_exception/concern.rb
+- lib/convenient_service/service/plugins/has_j_send_result/entities/result/plugins/can_be_from_handled_exception/exceptions.rb
 - lib/convenient_service/service/plugins/has_j_send_result/entities/result/plugins/can_be_from_unhandled_exception.rb
 - lib/convenient_service/service/plugins/has_j_send_result/entities/result/plugins/can_be_from_unhandled_exception/concern.rb
 - lib/convenient_service/service/plugins/has_j_send_result/entities/result/plugins/can_be_own_result.rb