convenient_service 0.2.1 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 70d36eabeb3ea9598979a7158d06e0bfc627398066abc5180411f13fce9142e8
-  data.tar.gz: 6c6ea0ce690bb915c32f2e810afe70f87e74961f7a3c01b4e3a6389b8f98b1dc
+  metadata.gz: b6eab7876ae6995ff2a0f2f4322a972ad05aae9b4ef3beea93daee900779dc39
+  data.tar.gz: 11d7e604831dda483449dc2b2513c0fc5817fd6172740836e5e3929b7d6fbcd4
 SHA512:
-  metadata.gz: aa610f3ac041e97849914d6bf15e626cceef9d8abd9aed0e5244b112595c89c9ac1eb91438bf67a84065bc8b90e91ebd8fff19cbcfb3c4a77e9b1246100b25fd
-  data.tar.gz: d704307543e1a14efa13f2701a109ee2748af75ed2260bbf9e4e64bc06b5bbe2a23ac208eabea1ec2d536578c9b9ec97c76541fa79181b9e896f4f844594d743
+  metadata.gz: b422032aa3b32d20579fdcc7e540a5d48e6dd18b3b69182b4b7bc456bbd8a381dd1cdab5654662e1074e095a124d15751aa001d15a36c21518dba0a1683f7130
+  data.tar.gz: bc8142c8d9df3971efb3476131608aae89477a46ecbe2efe42e31555f52e2425930c122ff93f8d941f4b44aa1c81b291079b5e11ea0249cfea0d0dd47a0846b7

data/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [0.3.0](https://github.com/marian13/convenient_service/compare/v0.2.1...v0.3.0) (2022-12-17)
+
+
+### Features
+
+* **stub_service:** stub_service supports stubbing with different arguments ([766eb5a](https://github.com/marian13/convenient_service/commit/766eb5a25cfbd49b699ca5c0c0ffa5524dc46548))
+
 ## [0.2.1](https://github.com/marian13/convenient_service/compare/v0.2.0...v0.2.1) (2022-12-14)
 
 

data/ROADMAP.md

@@ -51,5 +51,7 @@
 | Medium | 🚧 | User friendly `raise` that removes lib backtrace from caller | Should have a `debug` mode. Should work well with examples. Check RSpec `CallerFilter.first_non_rspec_line` |
 | High | 🚧 | A plugin that catches `StandardError` and returns `failure` | Should be the lowest in the stack |
 | High | 🚧 | `Support::Command` alias | Should be visible to the end user |
+| Low | 🚧 | Parallel steps | A killer feature |
+| Medium | 🚧 | Add Ruby 3.2 support to Docker and CI |  |
 
 Search for `TODO`s in the codebase for more tasks.

data/lib/convenient_service/configs/standard.rb

@@ -81,6 +81,10 @@ module ConvenientService
           use Plugins::Service::HasResultShortSyntax::Error::Middleware
         end
 
+        middlewares :result, scope: :class do
+          use Plugins::Common::NormalizesEnv::Middleware
+        end
+
         middlewares :step, scope: :class do
           use Plugins::Common::NormalizesEnv::Middleware
 
@@ -202,6 +206,18 @@ module ConvenientService
             end
           end
         end
+
+        if Dependencies.rspec.loaded?
+          concerns do
+            insert_before 0, Plugins::Service::CanHaveStubbedResult::Concern
+          end
+
+          middlewares :result, scope: :class do
+            insert_after \
+              Plugins::Common::NormalizesEnv::Middleware,
+              Plugins::Service::CanHaveStubbedResult::Middleware
+          end
+        end
       end
       # rubocop:enable Lint/ConstantDefinitionInBlock
     end

data/lib/convenient_service/dependencies/built_in.rb

@@ -28,6 +28,14 @@ require "logger"
 #
 require "ostruct"
 
+##
+# @internal
+#   - https://ruby-doc.org/stdlib-2.7.0/libdoc/rubygems/rdoc/Gem/Version.html
+#   - https://github.com/rubygems/rubygems
+#   - https://github.com/rubygems/rubygems/blob/master/lib/rubygems/version.rb
+#
+require "rubygems"
+
 ##
 # @internal
 #   - https://ruby-doc.org/stdlib-2.7.0/libdoc/singleton/rdoc/Singleton.html

data/lib/convenient_service/dependencies.rb

@@ -42,10 +42,23 @@ module ConvenientService
         require_relative "common/plugins/has_attributes/using_active_model_attributes"
       end
 
+      ##
+      # @return [Boolean]
+      # @api private
+      #
+      def support_has_result_params_validations_using_active_model_validations?
+        return false unless active_model.loaded?
+        return false if ruby.version >= 3.0 && active_model.version < 6.0
+
+        true
+      end
+
       ##
       # @return [Boolean]
       # @note Expected to be called from app entry points like `initializers` in Rails.
       #
+      # @see https://marian13.github.io/convenient_service_docs/troubleshooting/i18n_translate_wrong_number_of_arguments
+      #
       def require_has_result_params_validations_using_active_model_validations
         require "active_model"
 
@@ -129,6 +142,30 @@ module ConvenientService
 
         require_relative "examples/dry/gemfile"
       end
+
+      ##
+      # @return [ConvenientService::Support::Ruby]
+      # @api private
+      #
+      def ruby
+        Support::Ruby
+      end
+
+      ##
+      # @return [ConvenientService::Support::RSpec]
+      # @api private
+      #
+      def rspec
+        Support::Gems::RSpec
+      end
+
+      ##
+      # @return [ConvenientService::Support::Gems::ActiveModel]
+      # @api private
+      #
+      def active_model
+        Support::Gems::ActiveModel
+      end
     end
   end
 end

data/lib/convenient_service/examples/rails/gemfile/services/assert_file_exists.rb

@@ -10,7 +10,7 @@ module ConvenientService
 
             attribute :path, :string
 
-            validates :path, presence: true
+            validates :path, presence: true if ConvenientService::Dependencies.support_has_result_params_validations_using_active_model_validations?
 
             def result
               return error("File with path `#{path}` does NOT exist") unless ::File.exist?(path)

data/lib/convenient_service/examples/rails/gemfile/services/assert_file_not_empty.rb

@@ -10,7 +10,7 @@ module ConvenientService
 
             attribute :path, :string
 
-            validates :path, presence: true
+            validates :path, presence: true if ConvenientService::Dependencies.support_has_result_params_validations_using_active_model_validations?
 
             def result
               return error(message: "File with path `#{path}` is empty") if ::File.zero?(path)

data/lib/convenient_service/examples/rails/gemfile/services/assert_npm_package_available.rb

@@ -15,7 +15,7 @@ module ConvenientService
 
             attribute :name, :string
 
-            validates :name, presence: true
+            validates :name, presence: true if ConvenientService::Dependencies.support_has_result_params_validations_using_active_model_validations?
 
             step Services::AssertNodeAvailable
 

data/lib/convenient_service/examples/rails/gemfile/services/parse_content.rb

@@ -42,7 +42,7 @@ module ConvenientService
 
             attribute :content, :string
 
-            validates :content, presence: true
+            validates :content, presence: true if ConvenientService::Dependencies.support_has_result_params_validations_using_active_model_validations?
 
             step Services::AssertValidRubySyntax, in: :content
             step :result, in: :content, out: :parsed_content

data/lib/convenient_service/examples/rails/gemfile/services/print_shell_command.rb

@@ -16,7 +16,7 @@ module ConvenientService
             attribute :text, :string
             attribute :out, default: $stdout
 
-            validates :text, presence: true
+            validates :text, presence: true if ConvenientService::Dependencies.support_has_result_params_validations_using_active_model_validations?
 
             def result
               out.puts

data/lib/convenient_service/examples/rails/gemfile/services/read_file_content.rb

@@ -10,7 +10,7 @@ module ConvenientService
 
             attribute :path, :string
 
-            validates :path, presence: true
+            validates :path, presence: true if ConvenientService::Dependencies.support_has_result_params_validations_using_active_model_validations?
 
             step Services::AssertFileExists, in: :path
             step Services::AssertFileNotEmpty, in: :path

data/lib/convenient_service/examples/rails/gemfile/services/run_shell.rb

@@ -11,7 +11,7 @@ module ConvenientService
             attribute :command, :string
             attribute :debug, :boolean, default: false
 
-            validates :command, presence: true
+            validates :command, presence: true if ConvenientService::Dependencies.support_has_result_params_validations_using_active_model_validations?
 
             def result
               Services::PrintShellCommand.result(text: command) if debug

data/lib/convenient_service/examples/rails/gemfile/services/strip_comments.rb

@@ -15,7 +15,7 @@ module ConvenientService
 
             attribute :content, :string
 
-            validates :content, presence: true
+            validates :content, presence: true if ConvenientService::Dependencies.support_has_result_params_validations_using_active_model_validations?
 
             alias_method :content_with_comments, :content
 

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

@@ -109,7 +109,21 @@ module ConvenientService
                 service_class.__send__(status, **kwargs)
               end
 
-              private
+              ##
+              # @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
@@ -129,6 +143,8 @@ module ConvenientService
               #
               attr_reader :chain
 
+              private
+
               ##
               # @return [Hash]
               #

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

@@ -6,90 +6,84 @@ module ConvenientService
       module Custom
         class StubService < Support::Command
           module Entities
-            ##
-            # TODO: Specs.
-            #
             class StubbedService < Support::Command
               ##
-              # NOTE: `include ::RSpec::Matchers`.
-              # - https://github.com/rspec/rspec-expectations/blob/v3.11.0/lib/rspec/matchers.rb
-              # - https://github.com/rspec/rspec-expectations/blob/main/lib/rspec/matchers.rb
+              # @param service_class [Class]
+              # @return [void]
               #
-              include ::RSpec::Matchers
+              def initialize(service_class:)
+                @service_class = service_class
+                @arguments = {args: [], kwargs: {}, block: nil}
+              end
 
               ##
-              # NOTE: `include ::RSpec::Mocks::ExampleMethods`.
-              # - https://github.com/rspec/rspec-mocks/blob/v3.11.1/lib/rspec/mocks/example_methods.rb
-              # - https://github.com/rspec/rspec-mocks/blob/main/lib/rspec/mocks/example_methods.rb
+              # @param args [Array]
+              # @param kwargs [Hash]
+              # @param block [Block]
+              # @return [ConvenientService::RSpec::Helpers::Custom::StubService::Entities::StubService]
               #
-              include ::RSpec::Mocks::ExampleMethods
+              def with_arguments(*args, **kwargs, &block)
+                @arguments = {args: args, kwargs: kwargs, block: block}
 
-              def initialize(service_class:)
-                @service_class = service_class
+                self
               end
 
-              def with_arguments(*args, **kwargs, &block)
-                chain[:with_arguments] = {args: args, kwargs: kwargs, block: block}
+              ##
+              # @return [ConvenientService::RSpec::Helpers::Custom::StubService::Entities::StubService]
+              #
+              def without_arguments
+                @arguments = {args: [], kwargs: {}, block: nil}
 
                 self
               end
 
+              ##
+              # @param result_spec [ConvenientService::RSpec::Helpers::Custom::StubService::Entities::ResultSpec]
+              # @return [ConvenientService::RSpec::Helpers::Custom::StubService::Entities::StubService]
+              #
               def to(result_spec)
                 @result_spec = result_spec
 
                 service_class.commit_config!
 
-                if used_with_arguments?
-                  allow(service_class).to receive(:result).and_wrap_original do |original, *actual_args, **actual_kwargs, &actual_block|
-                    expect(actual_args).to eq(expected_args)
-                    expect(actual_kwargs).to eq(expected_kwargs)
-                    expect(actual_block).to eq(expected_block)
+                service_class.stubbed_results[key] = result_value
 
-                    result_value
-                  end
-                else
-                  allow(service_class).to receive(:result).and_return(result_value)
-                end
+                self
               end
 
               private
 
-              attr_reader :service_class, :result_spec
-
-              def result_value
-                @result_value ||= result_spec.for(service_class).calculate_value
-              end
-
-              def used_with_arguments?
-                chain.key?(:with_arguments)
-              end
-
-              def chain
-                @chain ||= {}
-              end
+              ##
+              # @!attribute [r] service_class
+              #   @return [Class]
+              #
+              attr_reader :service_class
 
-              def args
-                @args ||= chain.dig(:with_arguments, :args) || []
-              end
+              ##
+              # @!attribute [r] arguments
+              #   @return [Hash]
+              #
+              attr_reader :arguments
 
-              alias_method :expected_args, :args
+              ##
+              # @!attribute [r] result_spec
+              #   @return [ConvenientService::RSpec::Helpers::Custom::StubService::Entities::ResultSpec]
+              #
+              attr_reader :result_spec
 
-              def kwargs
-                @kwargs ||= chain.dig(:with_arguments, :kwargs) || {}
+              ##
+              # @return [ConvenientService::Service::Plugins::HasResult::Entities::Result]
+              #
+              def result_value
+                @result_value ||= result_spec.for(service_class).calculate_value
               end
 
-              alias_method :expected_kwargs, :kwargs
-
               ##
-              # NOTE: `if defined?` is used in order to cache `nil` if needed.
+              # @return [ConvenientService::Support::Cache::Key]
               #
-              def block
-                return @block if defined? @block
-
-                @block = chain.dig(:with_arguments, :block)
+              def key
+                @key ||= service_class.stubbed_results.keygen(*arguments[:args], **arguments[:kwargs], &arguments[:block])
               end
-
-              alias_method :expected_block, :block
             end
           end
         end

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

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module ConvenientService
+  module Service
+    module Plugins
+      module CanHaveStubbedResult
+        module Concern
+          include Support::Concern
+
+          class_methods do
+            ##
+            # @return [ConvenientService::Support::Cache]
+            #
+            # @internal
+            #   `::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://relishapp.com/rspec/rspec-core/docs/metadata/current-example
+            #
+            #   TODO: Mutex for thread-safety when parallel steps will be supported.
+            #
+            def stubbed_results
+              cache = Utils::Object.instance_variable_fetch(::RSpec.current_example, :@__convenient_service_stubbed_results__) { Support::Cache.new }
+
+              cache.scope(self)
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+module ConvenientService
+  module Service
+    module Plugins
+      module CanHaveStubbedResult
+        class Middleware < Core::MethodChainMiddleware
+          ##
+          # @param args [Array]
+          # @param kwargs [Hash]
+          # @param block [Proc]
+          # @return [Object] Can be any type.
+          #
+          def next(*args, **kwargs, &block)
+            key_with_arguments = cache.keygen(*args, **kwargs, &block)
+            key_without_arguments = cache.keygen
+
+            return cache[key_with_arguments] if cache.exist?(key_with_arguments)
+            return cache[key_without_arguments] if cache.exist?(key_without_arguments)
+
+            chain.next(*args, **kwargs, &block)
+          end
+
+          private
+
+          ##
+          # @return [ConvenientService::Support::Cache]
+          #
+          def cache
+            entity.stubbed_results
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+require_relative "can_have_stubbed_result/concern"
+require_relative "can_have_stubbed_result/middleware"

data/lib/convenient_service/service/plugins.rb

@@ -4,6 +4,7 @@
 # NOTE: Order matters.
 #
 require_relative "plugins/can_recalculate_result"
+require_relative "plugins/can_have_stubbed_result"
 require_relative "plugins/has_inspect"
 require_relative "plugins/has_result"
 require_relative "plugins/has_result_method_steps"

data/lib/convenient_service/support/cache.rb

@@ -21,6 +21,16 @@ module ConvenientService
         end
       end
 
+      ##
+      # @return [Boolean]
+      #
+      # @internal
+      #   https://ruby-doc.org/core-2.7.0/Hash.html#method-i-empty-3F
+      #
+      def empty?
+        hash.empty?
+      end
+
       ##
       # @return [Boolean]
       #
@@ -100,6 +110,22 @@ module ConvenientService
         exist?(key) ? read(key) : write(key, block.call)
       end
 
+      ##
+      # @return [ConvenientService::Support::Cache]
+      #
+      def clear
+        hash.clear
+
+        self
+      end
+
+      ##
+      # @return [ConvenientService::Support::Cache]
+      #
+      def scope(key)
+        fetch(key) { Support::Cache.new }
+      end
+
       ##
       # @return [ConvenientService::Support::Cache::Key]
       #

data/lib/convenient_service/support/gems/active_model.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+module ConvenientService
+  module Support
+    module Gems
+      ##
+      # @api private
+      #
+      class ActiveModel
+        class << self
+          ##
+          # @return [Boolean]
+          #
+          # @internal
+          #   `Style/TernaryParentheses` is disabled since `defined?` has too low priority without parentheses.
+          #
+          # rubocop:disable Style/TernaryParentheses
+          def loaded?
+            (defined? ::ActiveModel) ? true : false
+          end
+          # rubocop:enable Style/TernaryParentheses
+
+          ##
+          # @return [ConvenientService::Support::Version]
+          #
+          # @internal
+          #   https://github.com/rails/rails/blob/main/activemodel/lib/active_model/version.rb
+          #
+          def version
+            loaded? ? Support::Version.new(::ActiveModel.version) : Support::Version.null_version
+          end
+        end
+      end
+    end
+  end
+end

data/lib/convenient_service/support/gems/rspec.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+module ConvenientService
+  module Support
+    module Gems
+      ##
+      # @api private
+      #
+      class RSpec
+        class << self
+          ##
+          # @return [Boolean]
+          #
+          # @internal
+          #   `Style/TernaryParentheses` is disabled since `defined?` has too low priority without parentheses.
+          #
+          # rubocop:disable Style/TernaryParentheses
+          def loaded?
+            (defined? ::RSpec) ? true : false
+          end
+          # rubocop:enable Style/TernaryParentheses
+
+          ##
+          # @return [ConvenientService::Support::Version]
+          #
+          # @internal
+          #   https://github.com/rspec/rspec-core/blob/main/lib/rspec/core/version.rb
+          #
+          def version
+            loaded? ? Support::Version.new(::RSpec::Core::Version::STRING) : Support::Version.null_version
+          end
+        end
+      end
+    end
+  end
+end

data/lib/convenient_service/support/gems.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+require_relative "gems/active_model"
+require_relative "gems/rspec"

data/lib/convenient_service/support/ruby.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module ConvenientService
+  module Support
+    ##
+    # @api private
+    #
+    class Ruby
+      class << self
+        ##
+        # @return [ConvenientService::Support::Version]
+        #
+        # @internal
+        #   https://ruby-doc.org/core-2.7.2/doc/globals_rdoc.html
+        #
+        def version
+          @version ||= Support::Version.new(::RUBY_VERSION)
+        end
+      end
+    end
+  end
+end

data/lib/convenient_service/support/version/null_version.rb

@@ -0,0 +1,78 @@
+# frozen_string_literal: true
+
+module ConvenientService
+  module Support
+    class Version
+      ##
+      # @api private
+      #
+      # @internal
+      #   - https://thoughtbot.com/blog/rails-refactoring-example-introduce-null-object
+      #   - https://avdi.codes/null-objects-and-falsiness/
+      #
+      class NullVersion
+        ##
+        # @return [nil]
+        #
+        def gem_version
+          nil
+        end
+
+        ##
+        # @param other [Object] Can be any type.
+        # @return [nil]
+        #
+        def <=>(other)
+          nil
+        end
+
+        ##
+        # @param other [Object] Can be any type.
+        # @return [nil]
+        #
+        def <(other)
+          nil
+        end
+
+        ##
+        # @param other [Object] Can be any type.
+        # @return [nil]
+        #
+        def <=(other)
+          nil
+        end
+
+        ##
+        # @param other [Object] Can be any type.
+        # @return [nil]
+        #
+        def ==(other)
+          nil
+        end
+
+        ##
+        # @param other [Object] Can be any type.
+        # @return [nil]
+        #
+        def >(other)
+          nil
+        end
+
+        ##
+        # @param other [Object] Can be any type.
+        # @return [nil]
+        #
+        def >=(other)
+          nil
+        end
+
+        ##
+        # @return [String]
+        #
+        def to_s
+          ""
+        end
+      end
+    end
+  end
+end

data/lib/convenient_service/support/version.rb

@@ -0,0 +1,65 @@
+# frozen_string_literal: true
+
+require_relative "version/null_version"
+
+module ConvenientService
+  module Support
+    class Version
+      include ::Comparable
+
+      undef_method :between?
+
+      undef_method :clamp
+
+      ##
+      # @param value [String]
+      # @return [void]
+      #
+      def initialize(value)
+        @value = value
+      end
+
+      class << self
+        ##
+        # @return [ConvenientService::Support::Version::NullVersion]
+        #
+        def null_version
+          @null_version ||= NullVersion.new
+        end
+      end
+
+      ##
+      # @return [Gem::Version, nil]
+      #
+      def gem_version
+        cast_gem_version(value)
+      end
+
+      ##
+      # @param other [Object] Can be any type.
+      # @return [Boolean, nil]
+      #
+      def <=>(other)
+        gem_version <=> cast_gem_version(other)
+      end
+
+      ##
+      # @return [String]
+      #
+      def to_s
+        gem_version.to_s
+      end
+
+      private
+
+      attr_reader :value
+
+      ##
+      # @return [Gem::Version, nil]
+      #
+      def cast_gem_version(value)
+        ::Gem::Version.create(value.to_s) if ::Gem::Version.correct?(value.to_s)
+      end
+    end
+  end
+end

data/lib/convenient_service/support.rb

@@ -9,4 +9,7 @@ require_relative "support/command"
 require_relative "support/copyable"
 require_relative "support/delegate"
 require_relative "support/finite_loop"
+require_relative "support/gems"
 require_relative "support/middleware"
+require_relative "support/ruby"
+require_relative "support/version"

data/lib/convenient_service/utils/object/instance_variable_fetch.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+##
+#
+#
+module ConvenientService
+  module Utils
+    module Object
+      class InstanceVariableFetch < Support::Command
+        ##
+        # @!attribute [r] object
+        #   @return [Object]
+        #
+        attr_reader :object
+
+        ##
+        # @!attribute [r] ivar_name
+        #   @return [Symbol, String]
+        #
+        attr_reader :ivar_name
+
+        ##
+        # @!attribute [r] fallback_block
+        #   @return [Proc, nil]
+        #
+        attr_reader :fallback_block
+
+        ##
+        # @param object [Object]
+        # @param ivar_name [Symbol]
+        # @param fallback_block [Proc]
+        # @return [void]
+        #
+        def initialize(object, ivar_name, &fallback_block)
+          @object = object
+          @ivar_name = ivar_name
+          @fallback_block = fallback_block
+        end
+
+        ##
+        # @return [Object] Value of ivar. Can be any type.
+        #
+        def call
+          return object.instance_variable_get(ivar_name) if object.instance_variable_defined?(ivar_name)
+
+          return object.instance_variable_set(ivar_name, fallback_block.call) if fallback_block
+
+          nil
+        end
+      end
+    end
+  end
+end

data/lib/convenient_service/utils/object.rb

@@ -1,11 +1,20 @@
 # frozen_string_literal: true
 
+require_relative "object/instance_variable_fetch"
 require_relative "object/resolve_type"
 
 module ConvenientService
   module Utils
     module Object
       class << self
+        ##
+        # @example
+        #   ConvenientService::Utils::Object.instance_variable_fetch("abc", :@foo) { :bar }
+        #
+        def instance_variable_fetch(...)
+          InstanceVariableFetch.call(...)
+        end
+
         ##
         # @example
         #   ConvenientService::Utils::Object.resolve_type("foo")

data/lib/convenient_service/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ConvenientService
-  VERSION = "0.2.1"
+  VERSION = "0.3.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: convenient_service
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.3.0
 platform: ruby
 authors:
 - Marian Kostyk
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-12-14 00:00:00.000000000 Z
+date: 2022-12-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: appraisal
@@ -548,6 +548,9 @@ files:
 - lib/convenient_service/service.rb
 - lib/convenient_service/service/plugins.rb
 - lib/convenient_service/service/plugins/aliases.rb
+- lib/convenient_service/service/plugins/can_have_stubbed_result.rb
+- lib/convenient_service/service/plugins/can_have_stubbed_result/concern.rb
+- lib/convenient_service/service/plugins/can_have_stubbed_result/middleware.rb
 - lib/convenient_service/service/plugins/can_recalculate_result.rb
 - lib/convenient_service/service/plugins/can_recalculate_result/concern.rb
 - lib/convenient_service/service/plugins/has_inspect.rb
@@ -694,8 +697,14 @@ files:
 - lib/convenient_service/support/copyable.rb
 - lib/convenient_service/support/delegate.rb
 - lib/convenient_service/support/finite_loop.rb
+- lib/convenient_service/support/gems.rb
+- lib/convenient_service/support/gems/active_model.rb
+- lib/convenient_service/support/gems/rspec.rb
 - lib/convenient_service/support/middleware.rb
 - lib/convenient_service/support/middleware/stack_builder.rb
+- lib/convenient_service/support/ruby.rb
+- lib/convenient_service/support/version.rb
+- lib/convenient_service/support/version/null_version.rb
 - lib/convenient_service/utils.rb
 - lib/convenient_service/utils/array.rb
 - lib/convenient_service/utils/array/contain_exactly.rb
@@ -720,6 +729,7 @@ files:
 - lib/convenient_service/utils/module/has_own_instance_method.rb
 - lib/convenient_service/utils/module/instance_method_defined.rb
 - lib/convenient_service/utils/object.rb
+- lib/convenient_service/utils/object/instance_variable_fetch.rb
 - lib/convenient_service/utils/object/resolve_type.rb
 - lib/convenient_service/utils/proc.rb
 - lib/convenient_service/utils/proc/conjunct.rb