convenient_service 0.14.0 → 0.16.0

data/lib/convenient_service/rspec/{helpers/custom → primitive_helpers/classes}/ignoring_exception.rb

@@ -4,8 +4,8 @@ require_relative "ignoring_exception/exceptions"
 
 module ConvenientService
   module RSpec
-    module Helpers
-      module Custom
+    module PrimitiveHelpers
+      module Classes
         class IgnoringException < Support::Command
           ##
           # @!attribute [r] exception
@@ -30,7 +30,7 @@ module ConvenientService
 
           ##
           # @return [ConvenientService::Support::UniqueValue]
-          # @raise [ConvenientService::RSpec::Helpers::Custom::IgnoringException::Exceptions::IgnoredExceptionIsNotRaised]
+          # @raise [ConvenientService::RSpec::PrimitiveHelpers::Classes::IgnoringException::Exceptions::IgnoredExceptionIsNotRaised]
           #
           # @note Rescue `StandardError`, NOT `Exception`.
           # @see https://thoughtbot.com/blog/rescue-standarderror-not-exception

data/lib/convenient_service/rspec/{helpers/custom → primitive_helpers/classes}/in_threads.rb

@@ -2,8 +2,8 @@
 
 module ConvenientService
   module RSpec
-    module Helpers
-      module Custom
+    module PrimitiveHelpers
+      module Classes
         # @internal
         #   TODO: Specs.
         #

data/lib/convenient_service/rspec/primitive_helpers/classes.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+require_relative "classes/ignoring_exception"
+require_relative "classes/in_threads"

data/lib/convenient_service/rspec/primitive_helpers/ignoring_exception.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module ConvenientService
+  module RSpec
+    module PrimitiveHelpers
+      module IgnoringException
+        def ignoring_exception(...)
+          Classes::IgnoringException.call(...)
+        end
+      end
+    end
+  end
+end

data/lib/convenient_service/rspec/{helpers → primitive_helpers}/in_threads.rb

@@ -2,10 +2,10 @@
 
 module ConvenientService
   module RSpec
-    module Helpers
+    module PrimitiveHelpers
       module InThreads
         def in_threads(...)
-          Custom::InThreads.call(...)
+          Classes::InThreads.call(...)
         end
       end
     end

data/lib/convenient_service/rspec/primitive_helpers.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+require_relative "primitive_helpers/classes"
+
+require_relative "primitive_helpers/ignoring_exception"
+require_relative "primitive_helpers/in_threads"
+
+module ConvenientService
+  module RSpec
+    module PrimitiveHelpers
+      include Support::Concern
+
+      included do
+        include IgnoringException
+        include InThreads
+      end
+    end
+  end
+end

data/lib/convenient_service/rspec/{matchers → primitive_matchers}/be_descendant_of.rb

@@ -2,10 +2,10 @@
 
 module ConvenientService
   module RSpec
-    module Matchers
+    module PrimitiveMatchers
       module BeDescendantOf
         def be_descendant_of(...)
-          Custom::BeDescendantOf.new(...)
+          Classes::BeDescendantOf.new(...)
         end
       end
     end

data/lib/convenient_service/rspec/{matchers → primitive_matchers}/be_direct_descendant_of.rb

@@ -2,10 +2,10 @@
 
 module ConvenientService
   module RSpec
-    module Matchers
+    module PrimitiveMatchers
       module BeDirectDescendantOf
         def be_direct_descendant_of(...)
-          Custom::BeDirectDescendantOf.new(...)
+          Classes::BeDirectDescendantOf.new(...)
         end
       end
     end

data/lib/convenient_service/rspec/{matchers → primitive_matchers}/cache_its_value.rb

@@ -2,10 +2,10 @@
 
 module ConvenientService
   module RSpec
-    module Matchers
+    module PrimitiveMatchers
       module CacheItsValue
         def cache_its_value(...)
-          Custom::CacheItsValue.new(...)
+          Classes::CacheItsValue.new(...)
         end
       end
     end

data/lib/convenient_service/rspec/{matchers/custom → primitive_matchers/classes}/be_descendant_of.rb

@@ -2,8 +2,8 @@
 
 module ConvenientService
   module RSpec
-    module Matchers
-      module Custom
+    module PrimitiveMatchers
+      module Classes
         ##
         # NOTE: Navigate to the link below and `Ctrl + F` for "Custom Matcher from scratch"
         # for a guide of how to define a complex custom matcher.

data/lib/convenient_service/rspec/{matchers/custom → primitive_matchers/classes}/be_direct_descendant_of.rb

@@ -2,8 +2,8 @@
 
 module ConvenientService
   module RSpec
-    module Matchers
-      module Custom
+    module PrimitiveMatchers
+      module Classes
         ##
         # NOTE: Navigate to the link below and `Ctrl + F` for "Custom Matcher from scratch"
         # for a guide of how to define a complex custom matcher.

data/lib/convenient_service/rspec/{matchers/custom → primitive_matchers/classes}/cache_its_value.rb

@@ -2,8 +2,8 @@
 
 module ConvenientService
   module RSpec
-    module Matchers
-      module Custom
+    module PrimitiveMatchers
+      module Classes
         class CacheItsValue
           ##
           # @note `cache_its_value` may lead to false positives.

data/lib/convenient_service/rspec/{matchers/custom → primitive_matchers/classes}/delegate_to/entities/matcher/commands/generate_printable_method.rb

@@ -2,8 +2,8 @@
 
 module ConvenientService
   module RSpec
-    module Matchers
-      module Custom
+    module PrimitiveMatchers
+      module Classes
         class DelegateTo
           module Entities
             class Matcher

data/lib/convenient_service/rspec/{matchers/custom → primitive_matchers/classes}/delegate_to/entities/matcher/entities/chainings/sub_matchers/arguments/commands/apply_stub_to_track_delegations.rb

@@ -2,8 +2,8 @@
 
 module ConvenientService
   module RSpec
-    module Matchers
-      module Custom
+    module PrimitiveMatchers
+      module Classes
         class DelegateTo
           module Entities
             class Matcher
@@ -22,12 +22,12 @@ module ConvenientService
                           include ::RSpec::Mocks::ExampleMethods
 
                           ##
-                          # @return [ConvenientService::RSpec::Matchers::Custom::DelegateTo]
+                          # @return [ConvenientService::RSpec::PrimitiveMatchers::Classes::DelegateTo]
                           #
                           attr_reader :matcher
 
                           ##
-                          # @param matcher [ConvenientService::RSpec::Matchers::Custom::DelegateTo]
+                          # @param matcher [ConvenientService::RSpec::PrimitiveMatchers::Classes::DelegateTo]
                           # @return [void]
                           #
                           def initialize(matcher:)

data/lib/convenient_service/rspec/{matchers/custom → primitive_matchers/classes}/delegate_to/entities/matcher/entities/chainings/sub_matchers/arguments/commands/generate_printable_arguments.rb

@@ -2,8 +2,8 @@
 
 module ConvenientService
   module RSpec
-    module Matchers
-      module Custom
+    module PrimitiveMatchers
+      module Classes
         class DelegateTo
           module Entities
             class Matcher
@@ -17,7 +17,7 @@ module ConvenientService
 
                           ##
                           # @!attribute [r] arguments
-                          #   @return [ConvenientService::RSpec::Matchers::Custom::DelegateTo::Entities::Arguments]
+                          #   @return [ConvenientService::RSpec::PrimitiveMatchers::Classes::DelegateTo::Entities::Arguments]
                           #
                           attr_reader :arguments
 
@@ -37,7 +37,7 @@ module ConvenientService
                           delegate :block, to: :arguments
 
                           ##
-                          # @param arguments [ConvenientService::RSpec::Matchers::Custom::DelegateTo::Entities::Arguments]
+                          # @param arguments [ConvenientService::RSpec::PrimitiveMatchers::Classes::DelegateTo::Entities::Arguments]
                           #
                           def initialize(arguments:)
                             @arguments = arguments

data/lib/convenient_service/rspec/{matchers/custom → primitive_matchers/classes}/delegate_to/entities/matcher/entities/chainings/sub_matchers/arguments.rb

@@ -4,8 +4,8 @@ require_relative "arguments/commands"
 
 module ConvenientService
   module RSpec
-    module Matchers
-      module Custom
+    module PrimitiveMatchers
+      module Classes
         class DelegateTo
           module Entities
             class Matcher

data/lib/convenient_service/rspec/{matchers/custom → primitive_matchers/classes}/delegate_to/entities/matcher/entities/chainings/sub_matchers/base.rb

@@ -2,8 +2,8 @@
 
 module ConvenientService
   module RSpec
-    module Matchers
-      module Custom
+    module PrimitiveMatchers
+      module Classes
         class DelegateTo
           module Entities
             class Matcher
@@ -12,7 +12,7 @@ module ConvenientService
                   module SubMatchers
                     class Base
                       ##
-                      # @return [ConvenientService::RSpec::Matchers::Custom::DelegateTo]
+                      # @return [ConvenientService::RSpec::PrimitiveMatchers::Classes::DelegateTo]
                       #
                       attr_reader :matcher
 
@@ -23,11 +23,11 @@ module ConvenientService
 
                       ##
                       # @overload initialize(matcher:)
-                      #   @param matcher [ConvenientService::RSpec::Matchers::Custom::DelegateTo]
+                      #   @param matcher [ConvenientService::RSpec::PrimitiveMatchers::Classes::DelegateTo]
                       #   @return [void]
                       #
                       # @overload initialize(matcher:, block_expectation_value:)
-                      #   @param matcher [ConvenientService::RSpec::Matchers::Custom::DelegateTo]
+                      #   @param matcher [ConvenientService::RSpec::PrimitiveMatchers::Classes::DelegateTo]
                       #   @param block_expectation_value [Object] Can be any type.
                       #   @return [void]
                       #   @api private

data/lib/convenient_service/rspec/{matchers/custom → primitive_matchers/classes}/delegate_to/entities/matcher/entities/chainings/sub_matchers/return_its_value.rb

@@ -2,8 +2,8 @@
 
 module ConvenientService
   module RSpec
-    module Matchers
-      module Custom
+    module PrimitiveMatchers
+      module Classes
         class DelegateTo
           module Entities
             class Matcher

data/lib/convenient_service/rspec/{matchers/custom → primitive_matchers/classes}/delegate_to/entities/matcher/entities/chainings/sub_matchers/with_any_arguments.rb

@@ -2,8 +2,8 @@
 
 module ConvenientService
   module RSpec
-    module Matchers
-      module Custom
+    module PrimitiveMatchers
+      module Classes
         class DelegateTo
           module Entities
             class Matcher

data/lib/convenient_service/rspec/{matchers/custom → primitive_matchers/classes}/delegate_to/entities/matcher/entities/chainings/sub_matchers/with_concrete_arguments.rb

@@ -2,8 +2,8 @@
 
 module ConvenientService
   module RSpec
-    module Matchers
-      module Custom
+    module PrimitiveMatchers
+      module Classes
         class DelegateTo
           module Entities
             class Matcher

data/lib/convenient_service/rspec/{matchers/custom → primitive_matchers/classes}/delegate_to/entities/matcher/entities/chainings/sub_matchers/without_arguments.rb

@@ -2,8 +2,8 @@
 
 module ConvenientService
   module RSpec
-    module Matchers
-      module Custom
+    module PrimitiveMatchers
+      module Classes
         class DelegateTo
           module Entities
             class Matcher

data/lib/convenient_service/rspec/{matchers/custom → primitive_matchers/classes}/delegate_to/entities/matcher/entities/chainings/values/base.rb

@@ -2,8 +2,8 @@
 
 module ConvenientService
   module RSpec
-    module Matchers
-      module Custom
+    module PrimitiveMatchers
+      module Classes
         class DelegateTo
           module Entities
             class Matcher
@@ -12,7 +12,7 @@ module ConvenientService
                   module Values
                     class Base
                       ##
-                      # @return [ConvenientService::RSpec::Matchers::Custom::DelegateTo]
+                      # @return [ConvenientService::RSpec::PrimitiveMatchers::Classes::DelegateTo]
                       #
                       attr_reader :matcher
 
@@ -22,7 +22,7 @@ module ConvenientService
                       attr_reader :value
 
                       ##
-                      # @param matcher [ConvenientService::RSpec::Matchers::Custom::DelegateTo]
+                      # @param matcher [ConvenientService::RSpec::PrimitiveMatchers::Classes::DelegateTo]
                       # @return [void]
                       #
                       def initialize(matcher:)

data/lib/convenient_service/rspec/{matchers/custom → primitive_matchers/classes}/delegate_to/entities/matcher/entities/chainings/values/with_calling_original.rb

@@ -2,8 +2,8 @@
 
 module ConvenientService
   module RSpec
-    module Matchers
-      module Custom
+    module PrimitiveMatchers
+      module Classes
         class DelegateTo
           module Entities
             class Matcher

data/lib/convenient_service/rspec/{matchers/custom → primitive_matchers/classes}/delegate_to/entities/matcher/entities/chainings/values/without_calling_original.rb

@@ -2,8 +2,8 @@
 
 module ConvenientService
   module RSpec
-    module Matchers
-      module Custom
+    module PrimitiveMatchers
+      module Classes
         class DelegateTo
           module Entities
             class Matcher

data/lib/convenient_service/rspec/{matchers/custom → primitive_matchers/classes}/delegate_to/entities/matcher/entities/chainings_collection/exceptions.rb

@@ -2,8 +2,8 @@
 
 module ConvenientService
   module RSpec
-    module Matchers
-      module Custom
+    module PrimitiveMatchers
+      module Classes
         class DelegateTo
           module Entities
             class Matcher

data/lib/convenient_service/rspec/{matchers/custom → primitive_matchers/classes}/delegate_to/entities/matcher/entities/chainings_collection.rb

@@ -4,8 +4,8 @@ require_relative "chainings_collection/exceptions"
 
 module ConvenientService
   module RSpec
-    module Matchers
-      module Custom
+    module PrimitiveMatchers
+      module Classes
         class DelegateTo
           module Entities
             class Matcher
@@ -15,7 +15,7 @@ module ConvenientService
 
                   ##
                   # @!attribute [r] matcher
-                  #   @return [ConvenientService::RSpec::Matchers::Custom::DelegateTo::Entities::Matcher::Entities::Chainings]
+                  #   @return [ConvenientService::RSpec::PrimitiveMatchers::Classes::DelegateTo::Entities::Matcher::Entities::Chainings]
                   #
                   attr_reader :matcher
 
@@ -27,24 +27,24 @@ module ConvenientService
 
                   ##
                   # @!attribute [r] call_original
-                  #   @return [ConvenientService::RSpec::Matchers::Custom::DelegateTo::Entities::Matcher::Entities::Chainings::Permissions:Base, nil]
+                  #   @return [ConvenientService::RSpec::PrimitiveMatchers::Classes::DelegateTo::Entities::Matcher::Entities::Chainings::Permissions:Base, nil]
                   #
                   attr_reader :call_original
 
                   ##
                   # @!attribute [r] arguments
-                  #   @return [ConvenientService::RSpec::Matchers::Custom::DelegateTo::Entities::Matcher::Entities::Chainings::SubMatchers::Base, nil]
+                  #   @return [ConvenientService::RSpec::PrimitiveMatchers::Classes::DelegateTo::Entities::Matcher::Entities::Chainings::SubMatchers::Base, nil]
                   #
                   attr_reader :arguments
 
                   ##
                   # @!attribute [r] return_its_value
-                  #   @return [ConvenientService::RSpec::Matchers::Custom::DelegateTo::Entities::Matcher::Entities::Chainings::SubMatchers::Base, nil]
+                  #   @return [ConvenientService::RSpec::PrimitiveMatchers::Classes::DelegateTo::Entities::Matcher::Entities::Chainings::SubMatchers::Base, nil]
                   #
                   attr_reader :return_its_value
 
                   ##
-                  # @param matcher [ConvenientService::RSpec::Matchers::Custom::DelegateTo::Entities::Matcher]
+                  # @param matcher [ConvenientService::RSpec::PrimitiveMatchers::Classes::DelegateTo::Entities::Matcher]
                   # @return [void]
                   #
                   def initialize(matcher:)
@@ -132,8 +132,8 @@ module ConvenientService
                   end
 
                   ##
-                  # @param chaining [ConvenientService::RSpec::Matchers::Custom::DelegateTo::Entities::Matcher::Entities::Chainings::Values::Base]
-                  # @raise [ConvenientService::RSpec::Matchers::Custom::DelegateTo::Exceptions::ReturnItsValueChainingIsAlreadySet]
+                  # @param chaining [ConvenientService::RSpec::PrimitiveMatchers::Classes::DelegateTo::Entities::Matcher::Entities::Chainings::Values::Base]
+                  # @raise [ConvenientService::RSpec::PrimitiveMatchers::Classes::DelegateTo::Exceptions::ReturnItsValueChainingIsAlreadySet]
                   #
                   def call_original=(chaining)
                     raise Exceptions::CallOriginalChainingIsAlreadySet.new if @call_original
@@ -142,8 +142,8 @@ module ConvenientService
                   end
 
                   ##
-                  # @param chaining [ConvenientService::RSpec::Matchers::Custom::DelegateTo::Entities::Matcher::Entities::Chainings::SubMatchers::Base]
-                  # @raise [ConvenientService::RSpec::Matchers::Custom::DelegateTo::Exceptions::ArgumentsChainingIsAlreadySet]
+                  # @param chaining [ConvenientService::RSpec::PrimitiveMatchers::Classes::DelegateTo::Entities::Matcher::Entities::Chainings::SubMatchers::Base]
+                  # @raise [ConvenientService::RSpec::PrimitiveMatchers::Classes::DelegateTo::Exceptions::ArgumentsChainingIsAlreadySet]
                   #
                   def arguments=(chaining)
                     raise Exceptions::ArgumentsChainingIsAlreadySet.new if @arguments
@@ -152,8 +152,8 @@ module ConvenientService
                   end
 
                   ##
-                  # @param chaining [ConvenientService::RSpec::Matchers::Custom::DelegateTo::Entities::Matcher::Entities::Chainings::SubMatchers::Base]
-                  # @raise [ConvenientService::RSpec::Matchers::Custom::DelegateTo::Exceptions::ReturnItsValueChainingIsAlreadySet]
+                  # @param chaining [ConvenientService::RSpec::PrimitiveMatchers::Classes::DelegateTo::Entities::Matcher::Entities::Chainings::SubMatchers::Base]
+                  # @raise [ConvenientService::RSpec::PrimitiveMatchers::Classes::DelegateTo::Exceptions::ReturnItsValueChainingIsAlreadySet]
                   #
                   def return_its_value=(chaining)
                     raise Exceptions::ReturnItsValueChainingIsAlreadySet.new if @return_its_value

data/lib/convenient_service/rspec/{matchers/custom → primitive_matchers/classes}/delegate_to/entities/matcher/entities/delegation.rb

@@ -2,8 +2,8 @@
 
 module ConvenientService
   module RSpec
-    module Matchers
-      module Custom
+    module PrimitiveMatchers
+      module Classes
         class DelegateTo
           module Entities
             class Matcher
@@ -23,7 +23,7 @@ module ConvenientService
 
                   ##
                   # @!attribute [r] arguments
-                  #   @return [ConvenientService::RSpec::Matchers::Custom::DelegateTo::Entities::Matcher::Entities::Delegation]
+                  #   @return [ConvenientService::RSpec::PrimitiveMatchers::Classes::DelegateTo::Entities::Matcher::Entities::Delegation]
                   #
                   attr_reader :arguments
 

data/lib/convenient_service/rspec/{matchers/custom → primitive_matchers/classes}/delegate_to/entities/matcher.rb

@@ -10,8 +10,8 @@ require_relative "matcher/entities"
 #
 module ConvenientService
   module RSpec
-    module Matchers
-      module Custom
+    module PrimitiveMatchers
+      module Classes
         ##
         # @internal
         #   specify {
@@ -128,8 +128,8 @@ module ConvenientService
               end
 
               ##
-              # @return [ConvenientService::RSpec::Matchers::Custom::DelegateTo]
-              # @raise [ConvenientService::RSpec::Matchers::Custom::DelegateTo::Exceptions::ArgumentsChainingIsAlreadySet]
+              # @return [ConvenientService::RSpec::PrimitiveMatchers::Classes::DelegateTo]
+              # @raise [ConvenientService::RSpec::PrimitiveMatchers::Classes::DelegateTo::Exceptions::ArgumentsChainingIsAlreadySet]
               #
               def with_arguments(...)
                 self.expected_arguments = Support::Arguments.new(...)
@@ -140,8 +140,8 @@ module ConvenientService
               end
 
               ##
-              # @return [ConvenientService::RSpec::Matchers::Custom::DelegateTo]
-              # @raise [ConvenientService::RSpec::Matchers::Custom::DelegateTo::Exceptions::ArgumentsChainingIsAlreadySet]
+              # @return [ConvenientService::RSpec::PrimitiveMatchers::Classes::DelegateTo]
+              # @raise [ConvenientService::RSpec::PrimitiveMatchers::Classes::DelegateTo::Exceptions::ArgumentsChainingIsAlreadySet]
               #
               def with_any_arguments
                 chainings.arguments = Entities::Chainings::SubMatchers::WithAnyArguments.new(matcher: self)
@@ -150,8 +150,8 @@ module ConvenientService
               end
 
               ##
-              # @return [ConvenientService::RSpec::Matchers::Custom::DelegateTo]
-              # @raise [ConvenientService::RSpec::Matchers::Custom::DelegateTo::Exceptions::ArgumentsChainingIsAlreadySet]
+              # @return [ConvenientService::RSpec::PrimitiveMatchers::Classes::DelegateTo]
+              # @raise [ConvenientService::RSpec::PrimitiveMatchers::Classes::DelegateTo::Exceptions::ArgumentsChainingIsAlreadySet]
               #
               def without_arguments
                 chainings.arguments = Entities::Chainings::SubMatchers::WithoutArguments.new(matcher: self)
@@ -160,8 +160,8 @@ module ConvenientService
               end
 
               ##
-              # @return [ConvenientService::RSpec::Matchers::Custom::DelegateTo]
-              # @raise [ConvenientService::RSpec::Matchers::Custom::DelegateTo::Exceptions::ReturnItsValueChainingIsAlreadySet]
+              # @return [ConvenientService::RSpec::PrimitiveMatchers::Classes::DelegateTo]
+              # @raise [ConvenientService::RSpec::PrimitiveMatchers::Classes::DelegateTo::Exceptions::ReturnItsValueChainingIsAlreadySet]
               #
               def and_return_its_value
                 chainings.return_its_value = Entities::Chainings::SubMatchers::ReturnItsValue.new(matcher: self)
@@ -170,7 +170,7 @@ module ConvenientService
               end
 
               ##
-              # @return [ConvenientService::RSpec::Matchers::Custom::DelegateTo]
+              # @return [ConvenientService::RSpec::PrimitiveMatchers::Classes::DelegateTo]
               #
               def with_calling_original
                 chainings.call_original = Entities::Chainings::Values::WithCallingOriginal.new(matcher: self)
@@ -179,7 +179,7 @@ module ConvenientService
               end
 
               ##
-              # @return [ConvenientService::RSpec::Matchers::Custom::DelegateTo]
+              # @return [ConvenientService::RSpec::PrimitiveMatchers::Classes::DelegateTo]
               #
               def without_calling_original
                 chainings.call_original = Entities::Chainings::Values::WithoutCallingOriginal.new(matcher: self)
@@ -222,7 +222,7 @@ module ConvenientService
               end
 
               ##
-              # @return [ConvenientService::RSpec::Matchers::Custom::DelegateTo::Entities::Matcher::Entities::Chainings]
+              # @return [ConvenientService::RSpec::PrimitiveMatchers::Classes::DelegateTo::Entities::Matcher::Entities::Chainings]
               # @api private
               #
               def chainings