convenient_service 0.24.0 → 0.26.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b223651455eef03afc210c38e6ce570703b35bafc8543633072a019cfbb312fa
-  data.tar.gz: ace1e707494c39cfe83e4eda8b72d64b356db659ab437fe49b530b101cef23b1
+  metadata.gz: 31bdaa61be77d7c69da22c3baaf05b545d60606fbf45e9a7baac33929e845544
+  data.tar.gz: 7fa4432c8ce4b57a43b3bbcc9c8ea18d5002b69fc00db81da0cba78c9ac8ba54
 SHA512:
-  metadata.gz: 2e79cfb96f54558b5a2382236777543b7bba3f46e3b360919ca0779359bf16a61b7784d6f5d92c6b925813a2714bb1aec20dc6a943656f85d34ba3f37de1bc23
-  data.tar.gz: 79510a4c2dc7370b01c09f82b8f062dcab488eb7113f1f85f2c5bde20af5553c1fec19f9cb69c9e81ee4a5b894a73298c793ed2a5eb125757bcb8065231c70fc
+  metadata.gz: 8195321c43354288cd9d99a74a3384dbc552ca4845d0fa58ef347a34e21cab420c284a4bed10ea62d71885c02cff5e3999b9956facd50d8ea58928eb74e7cf67
+  data.tar.gz: 9d4007218ddf5eb3061a57f6038af8596c7e98bf8dc4791acf7e0ef66e1a0b9987d36689e508747eeef54c3fa7f4291374a500b032a5944e03c677a26feb0110

data/lib/convenient_service/common/plugins/tries_to_convert_result_duck_to_result/middleware.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+##
+# @author Marian Kostyk <mariankostyk13895@gmail.com>
+# @license LGPLv3 <https://www.gnu.org/licenses/lgpl-3.0.html>
+##
+
+module ConvenientService
+  module Common
+    module Plugins
+      module TriesToConvertResultDuckToResult
+        class Middleware < MethodChainMiddleware
+          intended_for :result, entity: any_entity
+
+          ##
+          # @return [ConvenientService::Service::Plugins::HasJSendResult::Entities::Result]
+          #
+          # @internal
+          #   NOTE: When original result is a result duck and it has `NoMethodError` exception, that exception should be raised just like any other exception. See specs for details.
+          #
+          #   NOTE: `exception.receiver` is available on `NameError` descendants (like `NoMethodError`), but NOT on `StandardError`.
+          #   - https://ruby-doc.org/core-2.7.1/NoMethodError.html
+          #   - https://ruby-doc.org/core-2.7.1/NameError.html#method-i-receiver
+          #   - https://ruby-doc.org/core-2.7.1/StandardError.html
+          #
+          def next(...)
+            original_object = chain.next(...)
+
+            result_duck, result = try_convert(original_object)
+
+            result_duck ? result : original_object
+          end
+
+          private
+
+          ##
+          # @param original_object [Object] Can be any type.
+          # @return [Array]
+          # @raise [NoMethodError]
+          #
+          def try_convert(original_object)
+            result = original_object.result
+
+            [true, result]
+          rescue ::NoMethodError => exception
+            raise exception if original_object.respond_to?(:result)
+
+            [false, nil]
+          end
+        end
+      end
+    end
+  end
+end

data/lib/convenient_service/common/plugins/tries_to_convert_result_duck_to_result.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 "tries_to_convert_result_duck_to_result/middleware"

data/lib/convenient_service/common/plugins.rb

@@ -14,6 +14,7 @@ require_relative "plugins/caches_return_value"
 require_relative "plugins/can_be_copied"
 require_relative "plugins/can_have_user_provided_entity"
 require_relative "plugins/ensures_negated_j_send_result"
+require_relative "plugins/tries_to_convert_result_duck_to_result"
 require_relative "plugins/can_have_callbacks"
 require_relative "plugins/can_have_not_passed_arguments"
 require_relative "plugins/can_utilize_finite_loop"

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

@@ -29,6 +29,7 @@ module ConvenientService
             :result_parents_trace,
             :code_review_automation,
             :short_syntax,
+            :duck_typing,
             :type_safety,
             :exception_services_trace,
             :per_instance_caching,
@@ -58,6 +59,7 @@ module ConvenientService
             :result_parents_trace,
             :code_review_automation,
             :short_syntax,
+            :duck_typing,
             :type_safety,
             :exception_services_trace,
             :per_instance_caching,
@@ -94,6 +96,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)
@@ -133,6 +136,7 @@ module ConvenientService
             use ConvenientService::Plugins::Service::RaisesOnNotResultReturnValue::Middleware if options.enabled?(:type_safety)
             use ConvenientService::Plugins::Service::RescuesResultUnhandledExceptions::Middleware if options.enabled?(:fault_tolerance)
             use ConvenientService::Plugins::Common::CleansExceptionBacktrace::Middleware if options.enabled?(:backtrace_cleaner)
+            use ConvenientService::Plugins::Common::TriesToConvertResultDuckToResult::Middleware if options.enabled?(:duck_typing)
             use ConvenientService::Plugins::Service::HasJSendResultParamsValidations::UsingActiveModelValidations::Middleware if options.enabled?(:active_model_validations)
             use ConvenientService::Plugins::Service::HasJSendResultParamsValidations::UsingDryValidation::Middleware if options.enabled?(:dry_validation)
             use ConvenientService::Plugins::Service::CanHaveConnectedSteps::Middleware if options.enabled?(:essential)
@@ -145,6 +149,7 @@ module ConvenientService
             use ConvenientService::Plugins::Service::RaisesOnNotResultReturnValue::Middleware if options.enabled?(:type_safety)
             use ConvenientService::Plugins::Service::RescuesResultUnhandledExceptions::Middleware if options.enabled?(:fault_tolerance)
             use ConvenientService::Plugins::Common::CleansExceptionBacktrace::Middleware if options.enabled?(:backtrace_cleaner)
+            use ConvenientService::Plugins::Common::TriesToConvertResultDuckToResult::Middleware if options.enabled?(:duck_typing)
           end
 
           middlewares :regular_result do
@@ -159,27 +164,30 @@ module ConvenientService
             use ConvenientService::Plugins::Common::CachesReturnValue::Middleware if options.enabled?(:per_instance_caching)
             use ConvenientService::Plugins::Service::CollectsServicesInException::Middleware if options.enabled?(:exception_services_trace)
             use ConvenientService::Plugins::Service::RaisesOnNotResultReturnValue::Middleware if options.enabled?(:type_safety)
-            # use ConvenientService::Plugins::Service::RescuesResultUnhandledExceptions::Middleware if options.enabled?(:fault_tolerance) # TODO: Dedicted `rescue`?
+            # use ConvenientService::Plugins::Service::RescuesResultUnhandledExceptions::Middleware if options.enabled?(:fault_tolerance) # TODO: Dedicated `rescue`?
             use ConvenientService::Plugins::Common::CleansExceptionBacktrace::Middleware if options.enabled?(:backtrace_cleaner)
             use ConvenientService::Plugins::Service::CanHaveFallbacks::Middleware.with(status: :failure) if options.enabled?(:fallbacks)
+            use ConvenientService::Plugins::Common::TriesToConvertResultDuckToResult::Middleware if options.enabled?(:duck_typing)
           end
 
           middlewares :fallback_error_result do
             use ConvenientService::Plugins::Common::CachesReturnValue::Middleware if options.enabled?(:per_instance_caching)
             use ConvenientService::Plugins::Service::CollectsServicesInException::Middleware if options.enabled?(:exception_services_trace)
             use ConvenientService::Plugins::Service::RaisesOnNotResultReturnValue::Middleware if options.enabled?(:type_safety)
-            # use ConvenientService::Plugins::Service::RescuesResultUnhandledExceptions::Middleware if options.enabled?(:fault_tolerance) # TODO: Dedicted `rescue`?
+            # use ConvenientService::Plugins::Service::RescuesResultUnhandledExceptions::Middleware if options.enabled?(:fault_tolerance) # TODO: Dedicated `rescue`?
             use ConvenientService::Plugins::Common::CleansExceptionBacktrace::Middleware if options.enabled?(:backtrace_cleaner)
             use ConvenientService::Plugins::Service::CanHaveFallbacks::Middleware.with(status: :error) if options.enabled?(:fallbacks)
+            use ConvenientService::Plugins::Common::TriesToConvertResultDuckToResult::Middleware if options.enabled?(:duck_typing)
           end
 
           middlewares :fallback_result do
             use ConvenientService::Plugins::Common::CachesReturnValue::Middleware if options.enabled?(:per_instance_caching)
             use ConvenientService::Plugins::Service::CollectsServicesInException::Middleware if options.enabled?(:exception_services_trace)
             use ConvenientService::Plugins::Service::RaisesOnNotResultReturnValue::Middleware if options.enabled?(:type_safety)
-            # use ConvenientService::Plugins::Service::RescuesResultUnhandledExceptions::Middleware if options.enabled?(:fault_tolerance) # TODO: Dedicted `rescue`?
+            # use ConvenientService::Plugins::Service::RescuesResultUnhandledExceptions::Middleware if options.enabled?(:fault_tolerance) # TODO: Dedicated `rescue`?
             use ConvenientService::Plugins::Common::CleansExceptionBacktrace::Middleware if options.enabled?(:backtrace_cleaner)
             use ConvenientService::Plugins::Service::CanHaveFallbacks::Middleware.with(status: nil) if options.enabled?(:fallbacks)
+            use ConvenientService::Plugins::Common::TriesToConvertResultDuckToResult::Middleware if options.enabled?(:duck_typing)
           end
 
           middlewares :success do
@@ -338,7 +346,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 +360,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 +376,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"