convenient_service 0.20.0 → 0.21.0

data/lib/convenient_service/rspec/helpers/stub_entry.rb

@@ -10,18 +10,36 @@ module ConvenientService
     module Helpers
       module StubEntry
         ##
-        # @return [ConvenientService::RSpec::Helpers::StubEntry::Classes::StubEntry]
+        # @param feature_class [Class<ConvenientService::Feature>]
+        # @param entry_name [Symbol, String]
+        # @return [ConvenientService::Feature::Plugins::CanHaveStubbedEntries::Entities::EntryStub]
         #
-        def stub_entry(...)
-          Classes::StubEntry.call(...)
+        def stub_entry(feature_class, entry_name)
+          feature_class.stub_entry(entry_name)
+        end
+
+        ##
+        # @param feature_class [Class<ConvenientService::Feature>]
+        # @param entry_name [Symbol, String]
+        # @return [ConvenientService::Feature::Plugins::CanHaveStubbedEntries::Entities::EntryUnstub]
+        #
+        def unstub_entry(feature_class, entry_name)
+          feature_class.unstub_entry(entry_name)
         end
 
         ##
         # @param value [Object] Can be any type.
-        # @return [ConvenientService::RSpec::Helpers::StubEntry::Classes::StubEntry::Entities::ValueSpec]
+        # @return [ConvenientService::Feature::Plugins::CanHaveStubbedEntries::Entities::ValueMock]
         #
         def return_value(value)
-          Classes::StubEntry::Entities::ValueSpec.new(value: value)
+          ConvenientService::Feature::Plugins::CanHaveStubbedEntries::Entities::ValueMock.new(value: value)
+        end
+
+        ##
+        # @return [ConvenientService::Feature::Plugins::CanHaveStubbedEntries::Entities::ValueUnmock]
+        #
+        def return_value_mock
+          ConvenientService::Feature::Plugins::CanHaveStubbedEntries::Entities::ValueUnmock.new
         end
       end
     end

data/lib/convenient_service/rspec/helpers/stub_service.rb

@@ -10,39 +10,107 @@ module ConvenientService
     module Helpers
       module StubService
         ##
-        # @return [ConvenientService::RSpec::Helpers::StubEntry::Classes::StubService]
+        # Stubs service if it was NOT stubbed before, otherwise - overrides the previous stub.
         #
-        def stub_service(...)
-          Classes::StubService.call(...)
+        # @api public
+        # @since 1.0.0
+        #
+        # @param service_class [Class<ConvenientService::Service>]
+        # @return [ConvenientService::Service::Plugins::CanHaveStubbedResults::Entities::ServiceStub]
+        #
+        # @example Unstub service with any arguments.
+        #   class Service
+        #     include ConvenientService::Standard::Config
+        #
+        #     def result
+        #       success
+        #     end
+        #   end
+        #
+        #   RSpec.describe Service do
+        #     include ConvenientService::RSpec::Helpers::StubService
+        #     include ConvenientService::RSpec::Matchers::Results
+        #
+        #     it "works" do
+        #       stub_service(Service).to return_error.with_code(:custom_code)
+        #
+        #       expect(Service).to be_error.with_code(:custom_code)
+        #     end
+        #   end
+        #
+        def stub_service(service_class)
+          service_class.stub_result
+        end
+
+        ##
+        # Unstubs service if it was stubbed before, otherwise - does nothing.
+        #
+        # @api public
+        # @since 1.0.0
+        #
+        # @param service_class [Class<ConvenientService::Service>]
+        # @return [ConvenientService::Service::Plugins::CanHaveStubbedResults::Entities::ServiceUnstub]
+        #
+        # @example Unstub service with any arguments.
+        #   class Service
+        #     include ConvenientService::Standard::Config
+        #
+        #     def result
+        #       success
+        #     end
+        #   end
+        #
+        #   RSpec.describe Service do
+        #     include ConvenientService::RSpec::Helpers::StubService
+        #     include ConvenientService::RSpec::Matchers::Results
+        #
+        #     it "works" do
+        #       stub_service(Service).to return_error.with_code(:custom_code)
+        #
+        #       unstub_service(Service).to return_result_mock
+        #
+        #       expect(Service).to be_success.without_data
+        #     end
+        #   end
+        #
+        def unstub_service(service_class)
+          service_class.unstub_result
         end
 
         ##
         # @param status [Symbol]
-        # @return [ConvenientService::RSpec::Helpers::StubEntry::Classes::StubService::Entities::ResultSpec]
+        # @return [ConvenientService::Service::Plugins::CanHaveStubbedResults::Entities::ResultMock]
         #
         def return_result(status)
-          Classes::StubService::Entities::ResultSpec.new(status: status)
+          ConvenientService::Service::Plugins::CanHaveStubbedResults::Entities::ResultMock.new(status: status)
         end
 
         ##
-        # @return [ConvenientService::RSpec::Helpers::StubEntry::Classes::StubService::Entities::ResultSpec]
+        # @return [ConvenientService::Service::Plugins::CanHaveStubbedResults::Entities::ResultMock]
         #
         def return_success
-          Classes::StubService::Entities::ResultSpec.new(status: :success)
+          ConvenientService::Service::Plugins::CanHaveStubbedResults::Entities::ResultMock.new(status: :success)
         end
 
         ##
-        # @return [ConvenientService::RSpec::Helpers::StubEntry::Classes::StubService::Entities::ResultSpec]
+        # @return [ConvenientService::Service::Plugins::CanHaveStubbedResults::Entities::ResultMock]
         #
         def return_failure
-          Classes::StubService::Entities::ResultSpec.new(status: :failure)
+          ConvenientService::Service::Plugins::CanHaveStubbedResults::Entities::ResultMock.new(status: :failure)
         end
 
         ##
-        # @return [ConvenientService::RSpec::Helpers::StubEntry::Classes::StubService::Entities::ResultSpec]
+        # @return [ConvenientService::Service::Plugins::CanHaveStubbedResults::Entities::ResultMock]
         #
         def return_error
-          Classes::StubService::Entities::ResultSpec.new(status: :error)
+          ConvenientService::Service::Plugins::CanHaveStubbedResults::Entities::ResultMock.new(status: :error)
+        end
+
+        ##
+        # @return [ConvenientService::Service::Plugins::CanHaveStubbedResults::Entities::ResultUnmock]
+        #
+        def return_result_mock
+          ConvenientService::Service::Plugins::CanHaveStubbedResults::Entities::ResultUnmock.new
         end
       end
     end

data/lib/convenient_service/rspec/matchers/classes/cache_its_value.rb

@@ -34,7 +34,8 @@ module ConvenientService
             @block_expectation = block_expectation
 
             ##
-            # NOTE: Identical to `block_expectation.call.object_id == block_expectation.call.object_id`.
+            # NOTE: Avoid comparing object ids. Prefer `equal?`.
+            # - https://bugs.ruby-lang.org/issues/15408
             #
             block_expectation.call.equal?(block_expectation.call)
           end

data/lib/convenient_service/rspec/matchers/classes/delegate_to.rb

@@ -9,11 +9,6 @@ require_relative "delegate_to/commands"
 require_relative "delegate_to/entities"
 require_relative "delegate_to/exceptions"
 
-##
-# @internal
-#   IMPORTANT: This matcher has a dedicated end-user doc. Do NOT forget to update it when needed.
-#   - https://github.com/marian13/convenient_service_docs/blob/main/docs/api/tests/rspec/matchers/delegate_to.mdx
-#
 module ConvenientService
   module RSpec
     module Matchers
@@ -37,6 +32,9 @@ module ConvenientService
         #   NOTE: A similar (with different behaviour) matcher exists in `saharspec`.
         #   - https://github.com/zverok/saharspec#send_messageobject-method-matcher
         #
+        #   IMPORTANT: This matcher has a dedicated end-user doc. Do NOT forget to update it when needed.
+        #   - https://github.com/marian13/convenient_service_docs/blob/main/docs/api/tests/rspec/matchers/delegate_to.mdx
+        #
         class DelegateTo
           ##
           # @api private

data/lib/convenient_service/rspec/matchers/classes/include_config.rb

@@ -24,11 +24,15 @@ module ConvenientService
           # @internal
           #   TODO: Util `include_module?`.
           #
+          #   NOTE: `any?(arg)` compares with `===`. For this method `==` is mandatory.
+          #
+          # rubocop:disable Performance/RedundantEqualityComparisonBlock
           def matches?(klass)
             @klass = klass
 
             klass.ancestors.drop_while { |ancestor| ancestor != klass }.any? { |mod| config == mod }
           end
+          # rubocop:enable Performance/RedundantEqualityComparisonBlock
 
           ##
           # @return [String]

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

@@ -6,7 +6,49 @@
 ##
 
 module ConvenientService
+  ##
+  # Intermediate module to access `ConvenientService::Standard::Config` by the end-users.
+  #
+  # @api public
+  # @since 1.0.0
+  #
   module Standard
+    ##
+    # Convenient Service main entrypoint.
+    #
+    # @api public
+    # @since 1.0.0
+    #
+    # @note See `ConvenientService::Standard::Config.default_options` for default options.
+    # @note See `ConvenientService::Standard::Config.available_options` for all available options.
+    #
+    # @example Allows to define services.
+    #   class Service
+    #     include ConvenientService::Standard::Config
+    #
+    #     def result
+    #       success
+    #     end
+    #   end
+    #
+    # @example Can be customized by `with`, `without`, `with_defaults`, `without_defaults` options.
+    #   class Service
+    #     include ConvenientService::Standard::Config
+    #       .with(:fault_tolerance)
+    #       .without(:short_syntax)
+    #
+    #     def result
+    #       success
+    #     end
+    #   end
+    #
+    # @example Can be tested in RSpec.
+    #   RSpec.describe Service do
+    #     include ConvenientService::RSpec::Matchers::IncludeConfig
+    #
+    #     specify { expect(Service).to include_module(ConvenientService::Config.with(:fault_tolerance).without(:short_syntax)) }
+    #   end
+    #
     Config = ::ConvenientService::Service::Configs::Standard
   end
 end

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

@@ -7,7 +7,31 @@
 
 module ConvenientService
   module Standard
+    ##
+    # Intermediate module to access `ConvenientService::Standard::V1::Config` by the end-users.
+    #
+    # @api public
+    # @since 1.0.0
+    # @deprecated Refactor your code or use a backport.
+    # @see https://userdocs.convenientservice.org/deprecations/jsend_meaning_of_failure_and_error
+    #
     module V1
+      ##
+      # Deprecated Convenient Service main entrypoint.
+      #
+      # @api public
+      # @since 1.0.0
+      # @deprecated Refactor your code or use a backport.
+      # @see https://userdocs.convenientservice.org/deprecations/jsend_meaning_of_failure_and_error
+      # @example Allows to define services.
+      #   class Service
+      #     include ConvenientService::Standard::V1::Config
+      #
+      #     def result
+      #       success
+      #     end
+      #   end
+      #
       Config = ::ConvenientService::Service::Configs::Standard::V1
     end
   end

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

@@ -15,6 +15,23 @@ module ConvenientService
         module V1
           include ConvenientService::Config
 
+          available_options do
+            [
+              :essential,
+              :callbacks,
+              :inspect,
+              :recalculation,
+              :result_parents_trace,
+              :code_review_automation,
+              :short_syntax,
+              :type_safety,
+              :exception_services_trace,
+              :per_instance_caching,
+              :backtrace_cleaner,
+              :rspec
+            ]
+          end
+
           default_options do
             [
               :essential,

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

@@ -5,8 +5,6 @@
 # @license LGPLv3 <https://www.gnu.org/licenses/lgpl-3.0.html>
 ##
 
-require_relative "standard/commands"
-
 require_relative "standard/v1"
 require_relative "standard/aliases"
 
@@ -19,13 +17,42 @@ module ConvenientService
       module Standard
         include ConvenientService::Config
 
+        available_options do
+          [
+            :essential,
+            :callbacks,
+            :fallbacks,
+            :rollbacks,
+            :fault_tolerance,
+            :inspect,
+            :recalculation,
+            :result_parents_trace,
+            :code_review_automation,
+            :short_syntax,
+            :type_safety,
+            :exception_services_trace,
+            :per_instance_caching,
+            :backtrace_cleaner,
+            :active_model_attribute_assignment,
+            :dry_initializer,
+            :active_model_attributes,
+            :active_model_validations,
+            :dry_validation,
+            :memo_wise,
+            :has_amazing_print_inspect,
+            :has_awesome_print_inspect,
+            :not_passed_arguments,
+            :finite_loop,
+            :test,
+            :rspec
+          ]
+        end
+
         default_options do
           [
             :essential,
             :callbacks,
             :fallbacks,
-            # :rollbacks,
-            # :fault_tolerance,
             :inspect,
             :recalculation,
             :result_parents_trace,
@@ -35,14 +62,7 @@ module ConvenientService
             :exception_services_trace,
             :per_instance_caching,
             :backtrace_cleaner,
-            # :active_model_attribute_assignment,
-            # :dry_initializer,
-            # :active_model_attributes,
-            # :active_model_validations,
-            # :dry_validation,
-            # :memo_wise,
-            # :not_passed_arguments,
-            # :finite_loop,
+            test: Dependencies.rspec.loaded? || Dependencies.minitest.loaded?,
             rspec: Dependencies.rspec.loaded?
           ]
         end
@@ -55,12 +75,12 @@ module ConvenientService
         #   That is why `entity :Result do` is used.
         #   - https://stackoverflow.com/a/51965126/12201472
         #
-        # rubocop:disable Lint/ConstantDefinitionInBlock
         included do
           include ConvenientService::Service::Core
 
           concerns do
-            use ConvenientService::Plugins::Service::CanHaveStubbedResults::Concern if options.enabled?(:rspec)
+            use ConvenientService::Plugins::Service::CanHaveStubbedResults::Concern if options.enabled?(:test) || options.enabled?(:rspec)
+            use ConvenientService::Plugins::Service::CanHaveRSpecStubbedResults::Concern if options.enabled?(:rspec)
             use ConvenientService::Plugins::Common::HasInternals::Concern if options.enabled?(:essential)
             use ConvenientService::Plugins::Common::HasConstructor::Concern if options.enabled?(:essential)
             use ConvenientService::Plugins::Common::HasConstructorWithoutInitialize::Concern if options.enabled?(:essential)
@@ -99,15 +119,15 @@ module ConvenientService
             use ConvenientService::Plugins::Common::CleansExceptionBacktrace::Middleware if options.enabled?(:backtrace_cleaner)
             use ConvenientService::Plugins::Service::CanHaveSteps::Middleware if options.enabled?(:essential)
             use ConvenientService::Plugins::Common::AssignsAttributesInConstructor::UsingActiveModelAttributeAssignment::Middleware if options.enabled?(:active_model_attribute_assignment)
-            use ConvenientService::Service::Plugins::ForbidsConvenientServiceEntitiesAsConstructorArguments::Middleware if options.enabled?(:code_review_automation)
+            use ConvenientService::Plugins::Service::ForbidsConvenientServiceEntitiesAsConstructorArguments::Middleware if options.enabled?(:code_review_automation)
           end
 
           middlewares :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::CanHaveStubbedResults::Middleware if options.enabled?(:rspec)
+            use ConvenientService::Plugins::Service::CanHaveStubbedResults::Middleware if options.enabled?(:test) || options.enabled?(:rspec)
             use ConvenientService::Plugins::Common::CanHaveCallbacks::Middleware if options.enabled?(:callbacks)
-            use ConvenientService::Service::Plugins::CanHaveRollbacks::Middleware if options.enabled?(:rollbacks)
+            use ConvenientService::Plugins::Service::CanHaveRollbacks::Middleware if options.enabled?(:rollbacks)
             use ConvenientService::Plugins::Service::SetsParentToForeignResult::Middleware if options.enabled?(:result_parents_trace)
             use ConvenientService::Plugins::Service::RaisesOnNotResultReturnValue::Middleware if options.enabled?(:type_safety)
             use ConvenientService::Plugins::Service::RescuesResultUnhandledExceptions::Middleware if options.enabled?(:fault_tolerance)
@@ -174,7 +194,7 @@ module ConvenientService
           end
 
           middlewares :result, scope: :class do
-            use ConvenientService::Plugins::Service::CanHaveStubbedResults::Middleware if options.enabled?(:rspec)
+            use ConvenientService::Plugins::Service::CanHaveStubbedResults::Middleware if options.enabled?(:test) || options.enabled?(:rspec)
             use ConvenientService::Plugins::Service::RescuesResultUnhandledExceptions::Middleware if options.enabled?(:fault_tolerance)
           end
 
@@ -209,7 +229,7 @@ module ConvenientService
               use ConvenientService::Plugins::Result::HasAmazingPrintInspect::Concern if options.enabled?(:amazing_print_inspect)
               use ConvenientService::Plugins::Result::CanBeOwnResult::Concern if options.enabled?(:result_parents_trace)
               use ConvenientService::Plugins::Result::CanHaveParentResult::Concern if options.enabled?(:result_parents_trace)
-              use ConvenientService::Plugins::Result::CanBeStubbedResult::Concern if options.enabled?(:rspec)
+              use ConvenientService::Plugins::Result::CanBeStubbedResult::Concern if options.enabled?(:test) || options.enabled?(:rspec)
               use ConvenientService::Plugins::Result::CanHaveCheckedStatus::Concern if options.enabled?(:code_review_automation)
               use ConvenientService::Plugins::Common::HasJSendResultDuckShortSyntax::Concern if options.enabled?(:short_syntax)
               # use ConvenientService::Plugins::Result::HelpsToLearnSimilaritiesWithCommonObjects::Concern
@@ -364,7 +384,6 @@ module ConvenientService
           #   use ConvenientService::Plugins::Service::RaisesOnDoubleResult::Middleware
           # end
         end
-        # rubocop:enable Lint/ConstantDefinitionInBlock
 
         class << self
           ##
@@ -387,11 +406,16 @@ module ConvenientService
           #   ConvenientService::Service::Configs::Standard.service_class?(Service)
           #   # => true
           #
+          #   ConvenientService::Service::Configs::Standard.service_class?(Service.new)
+          #   # => false
+          #
           #   ConvenientService::Service::Configs::Standard.service_class?(42)
           #   # => false
           #
           def service_class?(service_class)
-            Commands::IsServiceClass[service_class: service_class]
+            return false unless service_class.instance_of?(::Class)
+
+            service_class.include?(Service::Core)
           end
 
           ##
@@ -411,16 +435,17 @@ module ConvenientService
           #     end
           #   end
           #
-          #   service = Service.new
-          #
-          #   ConvenientService::Service::Configs::Standard.service?(service)
+          #   ConvenientService::Service::Configs::Standard.service?(Service.new)
           #   # => true
           #
+          #   ConvenientService::Service::Configs::Standard.service?(Service)
+          #   # => false
+          #
           #   ConvenientService::Service::Configs::Standard.service?(42)
           #   # => false
           #
           def service?(service)
-            Commands::IsService[service: service]
+            service_class?(service.class)
           end
         end
       end

data/lib/convenient_service/service/core.rb

@@ -13,6 +13,45 @@ module ConvenientService
       included do
         include ::ConvenientService::Core
       end
+
+      instance_methods do
+        ##
+        # Returns string representation of service.
+        #
+        # @api public
+        # @since 1.0.0
+        #
+        # @param format [Symbol]
+        # @return [String]
+        #
+        # @note Intended to be used for debugging purposes.
+        #
+        # @example Common usage.
+        #   class Service
+        #     include ConvenientService::Standard::Config
+        #
+        #     def result
+        #       success
+        #     end
+        #   end
+        #
+        #   puts Service.new
+        #   # <Service>
+        #   # => nil
+        #
+        #   Service.new.to_s
+        #   # => "<Service>"
+        #
+        #   Service.new.to_s(format: :inspect)
+        #   # => "<Service>"
+        #
+        #   Service.new.to_s(format: :original)
+        #   # => "#<Service:0x00005639cd363000>"
+        #
+        def to_s(format: :inspect)
+          (format == :inspect) ? inspect : super()
+        end
+      end
     end
   end
 end

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

@@ -7,6 +7,54 @@
 
 module ConvenientService
   module Plugins
+    ##
+    # Intermediate module/namespace to access plugins that can be applied only to services.
+    #
+    # @api public
+    # @since 1.0.0
+    # @return [Module]
+    #
+    # @example Service plugin `CanHaveRollbacks` can be used only by services.
+    #   class Service
+    #     include ConvenientService::Standard::Config
+    #
+    #     middlewares :result do
+    #       insert_after \
+    #         ConvenientService::Plugins::Common::CanHaveCallbacks::Middleware,
+    #         ConvenientService::Plugins::Service::CanHaveRollbacks::Middleware
+    #     end
+    #
+    #     def result
+    #       success
+    #     end
+    #
+    #     ##
+    #     # Is called in case of `failure` or `error` from `result`, since `CanHaveRollbacks` is now enabled.
+    #     #
+    #     def rollback_result
+    #       puts "from `rollback_result`"
+    #     end
+    #   end
+    #
+    # @example Shorter way to add `CanHaveRollbacks` plugin.
+    #   ##
+    #   # Some service plugin groups like `:rollbacks` can be added by config option.
+    #   #
+    #   class Service
+    #     include ConvenientService::Standard::Config.with(:rollbacks)
+    #
+    #     def result
+    #       success
+    #     end
+    #
+    #     ##
+    #     # Is called in case of `failure` or `error` from `result`, since `CanHaveRollbacks` is now enabled.
+    #     #
+    #     def rollback_result
+    #       puts "from `rollback_result`"
+    #     end
+    #   end
+    #
     Service = ::ConvenientService::Service::Plugins
   end
 end

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

@@ -37,17 +37,48 @@ module ConvenientService
           end
 
           ##
-          # Calls service own rollback.
+          # Calls service rollback.
           #
           # @param service [ConvenientService::Service]
           # @return [void]
           #
+          # @note All rollback exceptions are automatically rescued. That is done to NOT skip the rest of rollbacks just because one of them raises exception. Such skipping usually leads to the worse and even more inconsistent system state.
+          #
+          # @note Rollback exception log.
+          #   class Service
+          #     include ConvenientService::Standard::Config.with(:rollbacks)
+          #
+          #     step OtherService
+          #
+          #     def rollback_result
+          #       puts "Hello from `Service` rollback!" # Still executed although `OtherService` rollback raises exception.
+          #     end
+          #   end
+          #
+          #   class OtherService
+          #     include ConvenientService::Standard::Config.with(:rollbacks)
+          #
+          #     def result
+          #       16 / 0 # Service raises `ZeroDivisionError` exception to trigger rollback.
+          #
+          #       success
+          #     end
+          #
+          #     def rollback_result
+          #       [].keys # Rollback raises `NoMethodError` exception that is ignored by other rollbacks, but still can be logged by the end-user in `rescue` statement.
+          #     rescue => exception
+          #       puts exception.class
+          #       puts exception.message
+          #       puts exception.backtrace.to_a.take(10)
+          #     end
+          #   end
+          #
           def rollback_service(service)
             Utils::Object.safe_send(service, :rollback_result)
           end
 
           ##
-          # Calls organizer own rollback.
+          # Calls organizer rollback.
           # Then calls organizer steps rollbacks with nestings in the reverse order.
           #
           # @param organizer [ConvenientService::Service]

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

@@ -0,0 +1,34 @@
+# 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 CanHaveRSpecStubbedResults
+        module Concern
+          include Support::Concern
+
+          class_methods do
+            ##
+            # @return [RSpec::Core::Example, nil]
+            #
+            # @internal
+            #   NOTE: `::RSpec.current_example` docs.
+            #   - https://www.rubydoc.info/github/rspec/rspec-core/RSpec.current_example
+            #   - https://github.com/rspec/rspec-core/blob/v3.12.0/lib/rspec/core.rb#L122
+            #   - https://github.com/rspec/rspec-support/blob/v3.12.0/lib/rspec/support.rb#L92
+            #   - https://relishapp.com/rspec/rspec-core/docs/metadata/current-example
+            #
+            def stubbed_results_store
+              Dependencies.rspec.current_example
+            end
+          end
+        end
+      end
+    end
+  end
+end