convenient_service 0.5.0 → 0.6.0

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

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

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

@@ -6,6 +6,10 @@
 module ConvenientService
   module Utils
     module Object
+      ##
+      # Can be used instead of `return @ivar if defined? @ivar`.
+      # @see https://www.justinweiss.com/articles/4-simple-memoization-patterns-in-ruby-and-one-gem/
+      #
       class InstanceVariableFetch < Support::Command
         ##
         # @!attribute [r] object

data/lib/convenient_service/utils/object.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
+require_relative "object/instance_variable_delete"
 require_relative "object/instance_variable_fetch"
 require_relative "object/resolve_type"
 
@@ -7,6 +8,14 @@ module ConvenientService
   module Utils
     module Object
       class << self
+        ##
+        # @example
+        #   ConvenientService::Utils::Object.instance_variable_delete("abc", :@foo)
+        #
+        def instance_variable_delete(...)
+          InstanceVariableDelete.call(...)
+        end
+
         ##
         # @example
         #   ConvenientService::Utils::Object.instance_variable_fetch("abc", :@foo) { :bar }

data/lib/convenient_service/utils/proc/display.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module ConvenientService
+  module Utils
+    module Proc
+      class Display < Support::Command
+        ##
+        # @!attribute [r] proc
+        #   @return [Proc]
+        #
+        attr_reader :proc
+
+        ##
+        # @param proc [Proc]
+        # @return [void]
+        #
+        def initialize(proc)
+          @proc = proc
+        end
+
+        ##
+        # @return [Object] Can be any type.
+        #
+        # @internal
+        #   NOTE: An example of how RSpec extracts block source, but they marked it as private.
+        #   https://github.com/rspec/rspec-expectations/blob/311aaf245f2c5493572bf683b8c441cb5f7e44c8/lib/rspec/matchers/built_in/change.rb#L437
+        #
+        #   TODO: `printable_block_expectation` when `method_source` is available.
+        #   https://github.com/banister/method_source
+        #
+        #   def printable_block_expectation
+        #     @printable_block_expectation ||= block_expectation.source
+        #   end
+        #
+        #   TODO: Generic util to print blocks.
+        #
+        def call
+          "{ ... }"
+        end
+      end
+    end
+  end
+end

data/lib/convenient_service/utils/proc.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require_relative "proc/conjunct"
+require_relative "proc/display"
 require_relative "proc/exec_config"
 
 module ConvenientService
@@ -11,6 +12,10 @@ module ConvenientService
           Conjunct.call(...)
         end
 
+        def display(...)
+          Display.call(...)
+        end
+
         def exec_config(...)
           ExecConfig.call(...)
         end

data/lib/convenient_service/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: convenient_service
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.6.0
 platform: ruby
 authors:
 - Marian Kostyk
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-01-19 00:00:00.000000000 Z
+date: 2023-01-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: appraisal
@@ -94,6 +94,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: paint
   requirement: !ruby/object:Gem::Requirement
@@ -170,14 +184,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: 3.11.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: 3.11.0
 - !ruby/object:Gem::Dependency
   name: rubocop
   requirement: !ruby/object:Gem::Requirement
@@ -262,6 +276,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: webrick
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: yard
   requirement: !ruby/object:Gem::Requirement
@@ -495,6 +523,42 @@ files:
 - lib/convenient_service/examples/standard/gemfile/services/read_file_content.rb
 - lib/convenient_service/examples/standard/gemfile/services/run_shell.rb
 - lib/convenient_service/examples/standard/gemfile/services/strip_comments.rb
+- lib/convenient_service/examples/standard/request_params.rb
+- lib/convenient_service/examples/standard/request_params/constants.rb
+- lib/convenient_service/examples/standard/request_params/entities.rb
+- lib/convenient_service/examples/standard/request_params/entities/description.rb
+- lib/convenient_service/examples/standard/request_params/entities/format.rb
+- lib/convenient_service/examples/standard/request_params/entities/id.rb
+- lib/convenient_service/examples/standard/request_params/entities/logger.rb
+- lib/convenient_service/examples/standard/request_params/entities/request.rb
+- lib/convenient_service/examples/standard/request_params/entities/source.rb
+- lib/convenient_service/examples/standard/request_params/entities/tag.rb
+- lib/convenient_service/examples/standard/request_params/entities/title.rb
+- lib/convenient_service/examples/standard/request_params/services.rb
+- lib/convenient_service/examples/standard/request_params/services/apply_default_param_values.rb
+- lib/convenient_service/examples/standard/request_params/services/cast_params.rb
+- lib/convenient_service/examples/standard/request_params/services/extract_params_from_body.rb
+- lib/convenient_service/examples/standard/request_params/services/extract_params_from_path.rb
+- lib/convenient_service/examples/standard/request_params/services/filter_out_unpermitted_params.rb
+- lib/convenient_service/examples/standard/request_params/services/log_request_params.rb
+- lib/convenient_service/examples/standard/request_params/services/merge_params.rb
+- lib/convenient_service/examples/standard/request_params/services/prepare.rb
+- lib/convenient_service/examples/standard/request_params/services/validate_casted_params.rb
+- lib/convenient_service/examples/standard/request_params/services/validate_uncasted_params.rb
+- lib/convenient_service/examples/standard/request_params/utils.rb
+- lib/convenient_service/examples/standard/request_params/utils/array.rb
+- lib/convenient_service/examples/standard/request_params/utils/array/wrap.rb
+- lib/convenient_service/examples/standard/request_params/utils/http.rb
+- lib/convenient_service/examples/standard/request_params/utils/http/request.rb
+- lib/convenient_service/examples/standard/request_params/utils/http/request/parse_body.rb
+- lib/convenient_service/examples/standard/request_params/utils/http/request/parse_path.rb
+- lib/convenient_service/examples/standard/request_params/utils/integer.rb
+- lib/convenient_service/examples/standard/request_params/utils/integer/safe_parse.rb
+- lib/convenient_service/examples/standard/request_params/utils/json.rb
+- lib/convenient_service/examples/standard/request_params/utils/json/safe_parse.rb
+- lib/convenient_service/examples/standard/request_params/utils/object.rb
+- lib/convenient_service/examples/standard/request_params/utils/object/blank.rb
+- lib/convenient_service/examples/standard/request_params/utils/object/present.rb
 - lib/convenient_service/logger.rb
 - lib/convenient_service/rspec.rb
 - lib/convenient_service/rspec/helpers.rb
@@ -522,6 +586,27 @@ files:
 - lib/convenient_service/rspec/matchers/custom/cache_its_value.rb
 - lib/convenient_service/rspec/matchers/custom/call_chain_next.rb
 - lib/convenient_service/rspec/matchers/custom/delegate_to.rb
+- lib/convenient_service/rspec/matchers/custom/delegate_to/entities.rb
+- lib/convenient_service/rspec/matchers/custom/delegate_to/entities/matcher.rb
+- lib/convenient_service/rspec/matchers/custom/delegate_to/entities/matcher/commands.rb
+- lib/convenient_service/rspec/matchers/custom/delegate_to/entities/matcher/commands/generate_printable_method.rb
+- lib/convenient_service/rspec/matchers/custom/delegate_to/entities/matcher/entities.rb
+- lib/convenient_service/rspec/matchers/custom/delegate_to/entities/matcher/entities/chainings.rb
+- lib/convenient_service/rspec/matchers/custom/delegate_to/entities/matcher/entities/chainings/sub_matchers/arguments.rb
+- lib/convenient_service/rspec/matchers/custom/delegate_to/entities/matcher/entities/chainings/sub_matchers/arguments/commands.rb
+- lib/convenient_service/rspec/matchers/custom/delegate_to/entities/matcher/entities/chainings/sub_matchers/arguments/commands/apply_stub_to_track_delegations.rb
+- lib/convenient_service/rspec/matchers/custom/delegate_to/entities/matcher/entities/chainings/sub_matchers/arguments/commands/generate_printable_arguments.rb
+- lib/convenient_service/rspec/matchers/custom/delegate_to/entities/matcher/entities/chainings/sub_matchers/base.rb
+- lib/convenient_service/rspec/matchers/custom/delegate_to/entities/matcher/entities/chainings/sub_matchers/return_its_value.rb
+- lib/convenient_service/rspec/matchers/custom/delegate_to/entities/matcher/entities/chainings/sub_matchers/with_any_arguments.rb
+- lib/convenient_service/rspec/matchers/custom/delegate_to/entities/matcher/entities/chainings/sub_matchers/with_concrete_arguments.rb
+- lib/convenient_service/rspec/matchers/custom/delegate_to/entities/matcher/entities/chainings/sub_matchers/without_arguments.rb
+- lib/convenient_service/rspec/matchers/custom/delegate_to/entities/matcher/entities/chainings/values/base.rb
+- lib/convenient_service/rspec/matchers/custom/delegate_to/entities/matcher/entities/chainings/values/with_calling_original.rb
+- lib/convenient_service/rspec/matchers/custom/delegate_to/entities/matcher/entities/chainings/values/without_calling_original.rb
+- lib/convenient_service/rspec/matchers/custom/delegate_to/entities/matcher/entities/chainings_collection.rb
+- lib/convenient_service/rspec/matchers/custom/delegate_to/entities/matcher/entities/chainings_collection/errors.rb
+- lib/convenient_service/rspec/matchers/custom/delegate_to/entities/matcher/entities/delegation.rb
 - lib/convenient_service/rspec/matchers/custom/extend_module.rb
 - lib/convenient_service/rspec/matchers/custom/have_abstract_method.rb
 - lib/convenient_service/rspec/matchers/custom/have_alias_method.rb
@@ -538,6 +623,7 @@ files:
 - lib/convenient_service/rspec/matchers/custom/results/be_not_failure.rb
 - lib/convenient_service/rspec/matchers/custom/results/be_not_success.rb
 - lib/convenient_service/rspec/matchers/custom/results/be_success.rb
+- lib/convenient_service/rspec/matchers/custom/singleton_prepend_module.rb
 - lib/convenient_service/rspec/matchers/delegate_to.rb
 - lib/convenient_service/rspec/matchers/extend_module.rb
 - lib/convenient_service/rspec/matchers/have_abstract_method.rb
@@ -554,6 +640,7 @@ files:
 - lib/convenient_service/rspec/matchers/results/be_not_failure.rb
 - lib/convenient_service/rspec/matchers/results/be_not_success.rb
 - lib/convenient_service/rspec/matchers/results/be_success.rb
+- lib/convenient_service/rspec/matchers/singleton_prepend_module.rb
 - lib/convenient_service/service.rb
 - lib/convenient_service/service/plugins.rb
 - lib/convenient_service/service/plugins/aliases.rb
@@ -662,6 +749,9 @@ files:
 - lib/convenient_service/service/plugins/has_result_steps/entities/method/entities/callers/base.rb
 - lib/convenient_service/service/plugins/has_result_steps/entities/method/entities/callers/proc.rb
 - lib/convenient_service/service/plugins/has_result_steps/entities/method/entities/callers/raw.rb
+- lib/convenient_service/service/plugins/has_result_steps/entities/method/entities/callers/reassignment.rb
+- lib/convenient_service/service/plugins/has_result_steps/entities/method/entities/callers/reassignment/commands.rb
+- lib/convenient_service/service/plugins/has_result_steps/entities/method/entities/callers/reassignment/commands/define_method_in_container.rb
 - lib/convenient_service/service/plugins/has_result_steps/entities/method/entities/callers/usual.rb
 - lib/convenient_service/service/plugins/has_result_steps/entities/method/entities/directions.rb
 - lib/convenient_service/service/plugins/has_result_steps/entities/method/entities/directions/base.rb
@@ -669,6 +759,8 @@ files:
 - lib/convenient_service/service/plugins/has_result_steps/entities/method/entities/directions/output.rb
 - lib/convenient_service/service/plugins/has_result_steps/entities/method/entities/key.rb
 - lib/convenient_service/service/plugins/has_result_steps/entities/method/entities/name.rb
+- lib/convenient_service/service/plugins/has_result_steps/entities/method/entities/values.rb
+- lib/convenient_service/service/plugins/has_result_steps/entities/method/entities/values/reassignment.rb
 - lib/convenient_service/service/plugins/has_result_steps/entities/method/errors.rb
 - lib/convenient_service/service/plugins/has_result_steps/entities/service.rb
 - lib/convenient_service/service/plugins/has_result_steps/entities/service/class_methods.rb
@@ -695,6 +787,8 @@ files:
 - lib/convenient_service/support.rb
 - lib/convenient_service/support/abstract_method.rb
 - lib/convenient_service/support/abstract_method/errors.rb
+- lib/convenient_service/support/arguments.rb
+- lib/convenient_service/support/arguments/null_arguments.rb
 - lib/convenient_service/support/cache.rb
 - lib/convenient_service/support/cache/key.rb
 - lib/convenient_service/support/castable.rb
@@ -705,6 +799,7 @@ files:
 - lib/convenient_service/support/delegate.rb
 - lib/convenient_service/support/dependency_container.rb
 - lib/convenient_service/support/dependency_container/commands.rb
+- lib/convenient_service/support/dependency_container/commands/assert_valid_scope.rb
 - lib/convenient_service/support/dependency_container/commands/create_methods_module.rb
 - lib/convenient_service/support/dependency_container/commands/import_method.rb
 - lib/convenient_service/support/dependency_container/constants.rb
@@ -753,10 +848,12 @@ files:
 - lib/convenient_service/utils/module/include_module.rb
 - lib/convenient_service/utils/module/instance_method_defined.rb
 - lib/convenient_service/utils/object.rb
+- lib/convenient_service/utils/object/instance_variable_delete.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
+- lib/convenient_service/utils/proc/display.rb
 - lib/convenient_service/utils/proc/exec_config.rb
 - lib/convenient_service/utils/string.rb
 - lib/convenient_service/utils/string/camelize.rb