convenient_service 0.4.0 → 0.6.0

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/conjunct.rb

@@ -29,7 +29,7 @@ module ConvenientService
         # - https://en.wikipedia.org/wiki/Logical_conjunction
         #
         def call
-          return ->(item) { true } if procs.none?
+          return ->(item) {} if procs.none?
 
           return procs.first if procs.one?
 

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/utils/string/split.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+module ConvenientService
+  module Utils
+    module String
+      class Split < Support::Command
+        ##
+        # @!attribute [r] string
+        #   @return [#to_s]
+        #
+        attr_reader :string
+
+        ##
+        # @!attribute [r] delimiters
+        #   @return [Array<String>]
+        #
+        attr_reader :delimiters
+
+        ##
+        # @param string [Symbol, String]
+        # @param delimiters [Array<String>]
+        # @return [void]
+        #
+        def initialize(string, *delimiters)
+          @string = string
+          @delimiters = delimiters
+        end
+
+        ##
+        # @return [String]
+        #
+        # @internal
+        #   https://stackoverflow.com/a/51380514/12201472
+        #
+        def call
+          string.to_s.split(::Regexp.union(delimiters))
+        end
+      end
+    end
+  end
+end

data/lib/convenient_service/utils/string.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require_relative "string/camelize"
+require_relative "string/split"
 
 module ConvenientService
   module Utils
@@ -9,6 +10,10 @@ module ConvenientService
         def camelize(...)
           Camelize.call(...)
         end
+
+        def split(...)
+          Split.call(...)
+        end
       end
     end
   end

data/lib/convenient_service/version.rb

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

data/lib/convenient_service.rb

@@ -29,3 +29,9 @@ require_relative "convenient_service/core"
 require_relative "convenient_service/common"
 require_relative "convenient_service/service"
 require_relative "convenient_service/configs"
+
+##
+# @internal
+#   Convenient Service Aliases.
+#
+require_relative "convenient_service/aliases"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: convenient_service
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.6.0
 platform: ruby
 authors:
 - Marian Kostyk
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-01-03 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,28 +184,28 @@ 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
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 1.40.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 1.40.0
 - !ruby/object:Gem::Dependency
   name: rubocop-rspec
   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
@@ -331,6 +359,7 @@ files:
 - docker/3.1/Dockerfile
 - env.rb
 - lib/convenient_service.rb
+- lib/convenient_service/aliases.rb
 - lib/convenient_service/common.rb
 - lib/convenient_service/common/plugins.rb
 - lib/convenient_service/common/plugins/aliases.rb
@@ -494,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
@@ -521,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
@@ -537,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
@@ -553,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
@@ -661,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
@@ -668,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
@@ -694,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
@@ -702,12 +797,27 @@ files:
 - lib/convenient_service/support/concern.rb
 - lib/convenient_service/support/copyable.rb
 - 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
+- lib/convenient_service/support/dependency_container/entities.rb
+- lib/convenient_service/support/dependency_container/entities/method.rb
+- lib/convenient_service/support/dependency_container/entities/method_collection.rb
+- lib/convenient_service/support/dependency_container/entities/namespace.rb
+- lib/convenient_service/support/dependency_container/entities/namespace_collection.rb
+- lib/convenient_service/support/dependency_container/errors.rb
+- lib/convenient_service/support/dependency_container/export.rb
+- lib/convenient_service/support/dependency_container/import.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/not_passed.rb
 - lib/convenient_service/support/raw_value.rb
 - lib/convenient_service/support/ruby.rb
 - lib/convenient_service/support/version.rb
@@ -731,18 +841,23 @@ files:
 - lib/convenient_service/utils/method/defined.rb
 - lib/convenient_service/utils/module.rb
 - lib/convenient_service/utils/module/class_method_defined.rb
+- lib/convenient_service/utils/module/fetch_own_const.rb
 - lib/convenient_service/utils/module/get_own_const.rb
 - lib/convenient_service/utils/module/get_own_instance_method.rb
 - lib/convenient_service/utils/module/has_own_instance_method.rb
+- 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
+- lib/convenient_service/utils/string/split.rb
 - lib/convenient_service/version.rb
 - logo.png
 homepage: https://github.com/marian13/convenient_service