convenient_service 0.19.1 → 0.21.0

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

@@ -1,20 +0,0 @@
-# frozen_string_literal: true
-
-module ConvenientService
-  module RSpec
-    module Helpers
-      module Classes
-        class StubService < Support::Command
-          module Constants
-            module Triggers
-              ##
-              # @return [ConvenientService::Support::UniqueValue]
-              #
-              STUB_SERVICE = Support::UniqueValue.new("STUB_SERVICE")
-            end
-          end
-        end
-      end
-    end
-  end
-end

data/lib/convenient_service/rspec/helpers/classes/stub_service/entities/result_spec.rb

@@ -1,216 +0,0 @@
-# frozen_string_literal: true
-
-module ConvenientService
-  module RSpec
-    module Helpers
-      module Classes
-        ##
-        # @internal
-        #   TODO: Specs.
-        #
-        class StubService < Support::Command
-          module Entities
-            class ResultSpec
-              ##
-              # @param status [Symbol]
-              # @param service_class [Class]
-              # @param chain [Hash]
-              # @return [void]
-              #
-              def initialize(status:, service_class: nil, chain: {})
-                @status = status
-                @service_class = service_class
-                @chain = chain
-              end
-
-              ##
-              # @param service_class [Class]
-              # @return [ConvenientService::RSpec::Helpers::Classes::StubService::Entities::ResultSpec]
-              #
-              def for(service_class)
-                self.class.new(status: status, service_class: service_class, chain: chain)
-              end
-
-              ##
-              # @param data [Hash]
-              # @return [ConvenientService::RSpec::Helpers::Classes::StubService::Entities::ResultSpec]
-              #
-              def with_data(data)
-                chain[:data] = data
-
-                self
-              end
-
-              ##
-              # @param message [String]
-              # @return [ConvenientService::RSpec::Helpers::Classes::StubService::Entities::ResultSpec]
-              #
-              def with_message(message)
-                chain[:message] = message
-
-                self
-              end
-
-              ##
-              # @param code [String]
-              # @return [ConvenientService::RSpec::Helpers::Classes::StubService::Entities::ResultSpec]
-              #
-              def with_code(code)
-                chain[:code] = code
-
-                self
-              end
-
-              ##
-              # @param data [Hash]
-              # @return [ConvenientService::RSpec::Helpers::Classes::StubService::Entities::ResultSpec]
-              #
-              def and_data(data)
-                chain[:data] = data
-
-                self
-              end
-
-              ##
-              # @param message [String]
-              # @return [ConvenientService::RSpec::Helpers::Classes::StubService::Entities::ResultSpec]
-              #
-              def and_message(message)
-                chain[:message] = message
-
-                self
-              end
-
-              ##
-              # @param code [String]
-              # @return [ConvenientService::RSpec::Helpers::Classes::StubService::Entities::ResultSpec]
-              #
-              def and_code(code)
-                chain[:code] = code
-
-                self
-              end
-
-              ##
-              # @return [Object]
-              #
-              # @internal
-              #    TODO: Assert.
-              #
-              def calculate_value
-                service_class.__send__(status, **kwargs).copy(overrides: {kwargs: {stubbed_result: true}})
-              end
-
-              ##
-              # @param other [Object] Can be any type.
-              # @return [Boolean, nil]
-              #
-              def ==(other)
-                return unless other.instance_of?(self.class)
-
-                return false if status != other.status
-                return false if service_class != other.service_class
-                return false if chain != other.chain
-
-                true
-              end
-
-              protected
-
-              ##
-              # @!attribute [r] status
-              #   @return [Symbol]
-              #
-              attr_reader :status
-
-              ##
-              # @!attribute [r] service_class
-              #   @return [Class]
-              #
-              attr_reader :service_class
-
-              ##
-              # @!attribute [r] chain
-              #   @return [Hash]
-              #
-              attr_reader :chain
-
-              private
-
-              ##
-              # @return [Hash]
-              #
-              def kwargs
-                @kwargs ||= calculate_kwargs
-              end
-
-              ##
-              # @return [Hash]
-              #
-              def calculate_kwargs
-                kwargs = {}
-
-                kwargs[:data] = data if used_data?
-                kwargs[:message] = message if used_message?
-                kwargs[:code] = code if used_code?
-
-                kwargs[:service] = service_instance
-
-                kwargs
-              end
-
-              ##
-              # @return [Boolean]
-              #
-              def used_data?
-                chain.key?(:data)
-              end
-
-              ##
-              # @return [Boolean]
-              #
-              def used_message?
-                chain.key?(:message)
-              end
-
-              ##
-              # @return [Boolean]
-              #
-              def used_code?
-                chain.key?(:code)
-              end
-
-              ##
-              # @return [Hash]
-              #
-              def data
-                @data ||= chain[:data] || {}
-              end
-
-              ##
-              # @return [String]
-              #
-              def message
-                @message ||= chain[:message] || ""
-              end
-
-              ##
-              # @return [String]
-              #
-              def code
-                @code ||= chain[:code] || ""
-              end
-
-              ##
-              # @return [Object]
-              #
-              def service_instance
-                @service_instance ||= service_class.new_without_initialize
-              end
-            end
-          end
-        end
-      end
-    end
-  end
-end

data/lib/convenient_service/rspec/helpers/classes/stub_service/entities/stubbed_service.rb

@@ -1,97 +0,0 @@
-# frozen_string_literal: true
-
-module ConvenientService
-  module RSpec
-    module Helpers
-      module Classes
-        class StubService < Support::Command
-          module Entities
-            class StubbedService
-              include Support::DependencyContainer::Import
-
-              ##
-              # @internal
-              #   TODO: Implement shorter form in the following way:
-              #
-              #   import \
-              #     command: :SetServiceStubbedResult,
-              #     from: ConvenientService::Service::Plugins::CanHaveStubbedResults
-              #
-              import \
-                :"commands.SetServiceStubbedResult",
-                from: ConvenientService::Service::Plugins::CanHaveStubbedResults::Container
-
-              ##
-              # @param service_class [Class]
-              # @return [void]
-              #
-              def initialize(service_class:)
-                @service_class = service_class
-                @arguments = Support::Arguments.null_arguments
-              end
-
-              ##
-              # @return [ConvenientService::RSpec::Helpers::Classes::StubService::Entities::StubService]
-              #
-              def with_arguments(...)
-                @arguments = Support::Arguments.new(...)
-
-                self
-              end
-
-              ##
-              # @return [ConvenientService::RSpec::Helpers::Classes::StubService::Entities::StubService]
-              #
-              def without_arguments
-                @arguments = Support::Arguments.null_arguments
-
-                self
-              end
-
-              ##
-              # @param result_spec [ConvenientService::RSpec::Helpers::Classes::StubService::Entities::ResultSpec]
-              # @return [ConvenientService::RSpec::Helpers::Classes::StubService::Entities::StubService]
-              #
-              def to(result_spec)
-                @result_spec = result_spec
-
-                service_class.commit_config!(trigger: Constants::Triggers::STUB_SERVICE)
-
-                commands.SetServiceStubbedResult[service: service_class, arguments: arguments, result: result_value]
-
-                self
-              end
-
-              private
-
-              ##
-              # @!attribute [r] service_class
-              #   @return [Class]
-              #
-              attr_reader :service_class
-
-              ##
-              # @!attribute [r] arguments
-              #   @return [Hash]
-              #
-              attr_reader :arguments
-
-              ##
-              # @!attribute [r] result_spec
-              #   @return [ConvenientService::RSpec::Helpers::Classes::StubService::Entities::ResultSpec]
-              #
-              attr_reader :result_spec
-
-              ##
-              # @return [ConvenientService::Service::Plugins::HasJSendResult::Entities::Result]
-              #
-              def result_value
-                @result_value ||= result_spec.for(service_class).calculate_value
-              end
-            end
-          end
-        end
-      end
-    end
-  end
-end

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

@@ -1,4 +0,0 @@
-# frozen_string_literal: true
-
-require_relative "entities/stubbed_service"
-require_relative "entities/result_spec"

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

@@ -1,27 +0,0 @@
-# frozen_string_literal: true
-
-require_relative "stub_service/constants"
-require_relative "stub_service/entities"
-
-module ConvenientService
-  module RSpec
-    module Helpers
-      module Classes
-        ##
-        # TODO: Specs.
-        #
-        class StubService < Support::Command
-          attr_reader :service_class
-
-          def initialize(service_class)
-            @service_class = service_class
-          end
-
-          def call
-            Entities::StubbedService.new(service_class: @service_class)
-          end
-        end
-      end
-    end
-  end
-end

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

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

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

@@ -1,13 +0,0 @@
-# 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/primitive_helpers.rb

@@ -1,19 +0,0 @@
-# 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/primitive_matchers/classes/delegate_to/commands.rb

@@ -1,3 +0,0 @@
-# frozen_string_literal: true
-
-require_relative "commands/generate_printable_method"

data/lib/convenient_service/rspec/primitive_matchers/classes/extend_module.rb

@@ -1,40 +0,0 @@
-# frozen_string_literal: true
-
-module ConvenientService
-  module RSpec
-    module PrimitiveMatchers
-      module Classes
-        class ExtendModule
-          ##
-          # NOTE: `mod` since `module` is a keyword.
-          #
-          def initialize(mod)
-            @mod = mod
-          end
-
-          def matches?(klass)
-            @klass = klass
-
-            klass.singleton_class.included_modules.include?(mod)
-          end
-
-          def description
-            "extend module `#{mod}`"
-          end
-
-          def failure_message
-            "expected `#{klass}` to extend module `#{mod}`"
-          end
-
-          def failure_message_when_negated
-            "expected `#{klass}` NOT to extend module `#{mod}`"
-          end
-
-          private
-
-          attr_reader :klass, :mod
-        end
-      end
-    end
-  end
-end

data/lib/convenient_service/rspec/primitive_matchers/classes/have_alias_method.rb

@@ -1,48 +0,0 @@
-# frozen_string_literal: true
-
-module ConvenientService
-  module RSpec
-    module PrimitiveMatchers
-      module Classes
-        class HaveAliasMethod
-          def initialize(alias_name, original_name)
-            @alias_name = alias_name
-            @original_name = original_name
-          end
-
-          def matches?(object)
-            @object = object
-
-            ##
-            # TODO: Use `Utils::Object.duck_class` to support `have_alias_method` for classes.
-            #
-            return false unless Utils::Method.defined?(original_name, object.class, private: true)
-
-            return false unless Utils::Method.defined?(alias_name, object.class, private: true)
-
-            ##
-            # https://stackoverflow.com/a/45640516/12201472
-            #
-            object.method(alias_name).original_name == object.method(original_name).original_name
-          end
-
-          def description
-            "have alias method `#{alias_name}` for `#{original_name}`"
-          end
-
-          def failure_message
-            "expected `#{object.class}` to have alias method `#{alias_name}` for `#{original_name}`"
-          end
-
-          def failure_message_when_negated
-            "expected `#{object.class}` NOT to have alias method `#{alias_name}` for `#{original_name}`"
-          end
-
-          private
-
-          attr_reader :object, :alias_name, :original_name
-        end
-      end
-    end
-  end
-end

data/lib/convenient_service/rspec/primitive_matchers/classes/have_attr_accessor.rb

@@ -1,43 +0,0 @@
-# frozen_string_literal: true
-
-module ConvenientService
-  module RSpec
-    module PrimitiveMatchers
-      module Classes
-        ##
-        # TODO: Specs.
-        #
-        class HaveAttrAccessor
-          def initialize(attr_name)
-            @attr_name = attr_name
-          end
-
-          def matches?(object)
-            @object = object
-
-            Classes::HaveAttrReader.new(attr_name).matches?(object)
-            Classes::HaveAttrWriter.new(attr_name).matches?(object)
-
-            true
-          end
-
-          def description
-            "have attr accessor `#{attr_name}`"
-          end
-
-          def failure_message
-            "expected `#{object.class}` to have attr accessor `#{attr_name}`"
-          end
-
-          def failure_message_when_negated
-            "expected `#{object.class}` NOT to have attr accessor `#{attr_name}`"
-          end
-
-          private
-
-          attr_reader :object, :attr_name
-        end
-      end
-    end
-  end
-end

data/lib/convenient_service/rspec/primitive_matchers/classes/have_attr_reader.rb

@@ -1,47 +0,0 @@
-# frozen_string_literal: true
-
-module ConvenientService
-  module RSpec
-    module PrimitiveMatchers
-      module Classes
-        ##
-        # TODO: Specs.
-        #
-        class HaveAttrReader
-          def initialize(attr_name)
-            @attr_name = attr_name
-          end
-
-          def matches?(object)
-            @object = object
-
-            ##
-            # IMPORTANT: A copy is created in order to be thread safe.
-            #
-            copy = object.dup
-
-            copy.instance_variable_set("@#{attr_name}", :custom_value)
-
-            copy.public_send(attr_name) == :custom_value
-          end
-
-          def description
-            "have attr reader `#{attr_name}`"
-          end
-
-          def failure_message
-            "expected `#{object.class}` to have attr reader `#{attr_name}`"
-          end
-
-          def failure_message_when_negated
-            "expected `#{object.class}` NOT to have attr reader `#{attr_name}`"
-          end
-
-          private
-
-          attr_reader :object, :attr_name
-        end
-      end
-    end
-  end
-end

data/lib/convenient_service/rspec/primitive_matchers/classes/have_attr_writer.rb

@@ -1,47 +0,0 @@
-# frozen_string_literal: true
-
-module ConvenientService
-  module RSpec
-    module PrimitiveMatchers
-      module Classes
-        ##
-        # TODO: Specs.
-        #
-        class HaveAttrWriter
-          def initialize(attr_name)
-            @attr_name = attr_name
-          end
-
-          def matches?(object)
-            @object = object
-
-            ##
-            # IMPORTANT: A copy is created in order to be thread safe.
-            #
-            copy = object.dup
-
-            copy.public_send("#{attr_name}=", :custom_value)
-
-            copy.instance_variable_get("@#{attr_name}") == :custom_value
-          end
-
-          def description
-            "have attr writer `#{attr_name}`"
-          end
-
-          def failure_message
-            "expected `#{object.class}` to have attr writer `#{attr_name}`"
-          end
-
-          def failure_message_when_negated
-            "expected `#{object.class}` NOT to have attr writer `#{attr_name}`"
-          end
-
-          private
-
-          attr_reader :object, :attr_name
-        end
-      end
-    end
-  end
-end

data/lib/convenient_service/rspec/primitive_matchers/classes/include_module.rb

@@ -1,40 +0,0 @@
-# frozen_string_literal: true
-
-module ConvenientService
-  module RSpec
-    module PrimitiveMatchers
-      module Classes
-        class IncludeModule
-          ##
-          # NOTE: `mod` since `module` is a keyword.
-          #
-          def initialize(mod)
-            @mod = mod
-          end
-
-          def matches?(klass)
-            @klass = klass
-
-            klass.included_modules.include?(mod)
-          end
-
-          def description
-            "include module `#{mod}`"
-          end
-
-          def failure_message
-            "expected `#{klass}` to include module `#{mod}`"
-          end
-
-          def failure_message_when_negated
-            "expected `#{klass}` NOT to include module `#{mod}`"
-          end
-
-          private
-
-          attr_reader :klass, :mod
-        end
-      end
-    end
-  end
-end