convenient_service 0.7.0 → 0.9.0

data/lib/convenient_service/support/dependency_container/export.rb

@@ -6,6 +6,14 @@ module ConvenientService
       module Export
         include Support::Concern
 
+        ##
+        # @param klass [Class, Module]
+        # @return [Module]
+        #
+        included do |klass|
+          raise Errors::NotModule.new(klass: klass) unless klass.instance_of?(::Module)
+        end
+
         class_methods do
           ##
           # @param full_name [String, Symbol]

data/lib/convenient_service/support/undefined.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module ConvenientService
+  module Support
+    UNDEFINED = ::Object.new.tap do |object|
+      object.define_singleton_method(:inspect) { "undefined" }
+    end
+  end
+end

data/lib/convenient_service/support.rb

@@ -1,6 +1,8 @@
 # frozen_string_literal: true
 
 require_relative "support/not_passed"
+require_relative "support/undefined"
+
 require_relative "support/concern"
 
 require_relative "support/abstract_method"

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

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+##
+#
+#
+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/
+      #
+      # @note: `false` and `nil` are the only values that are considered `falsy` in Ruby.
+      # @see https://riptutorial.com/ruby/example/2092/truthy-and-falsy-values
+      # @see https://www.ruby-lang.org/en/documentation/faq/6/
+      #
+      # @internal
+      #   NOTE: `falsy` is probably more common than `falsey`.
+      #   - https://developer.mozilla.org/en-US/docs/Glossary/Falsy
+      #
+      class MemoizeIncludingFalsyValues < Support::Command
+        ##
+        # @!attribute [r] object
+        #   @return [Object]
+        #
+        attr_reader :object
+
+        ##
+        # @!attribute [r] ivar_name
+        #   @return [Symbol, String]
+        #
+        attr_reader :ivar_name
+
+        ##
+        # @!attribute [r] value_block
+        #   @return [Proc, nil]
+        #
+        attr_reader :value_block
+
+        ##
+        # @param object [Object]
+        # @param ivar_name [Symbol]
+        # @param value_block [Proc]
+        # @return [void]
+        #
+        def initialize(object, ivar_name, &value_block)
+          @object = object
+          @ivar_name = ivar_name
+          @value_block = value_block
+        end
+
+        ##
+        # @return [Object] Value of ivar. Can be any type.
+        #
+        def call
+          Utils::Object.instance_variable_fetch(object, ivar_name, &value_block)
+        end
+      end
+    end
+  end
+end

data/lib/convenient_service/utils/object.rb

@@ -2,6 +2,7 @@
 
 require_relative "object/instance_variable_delete"
 require_relative "object/instance_variable_fetch"
+require_relative "object/memoize_including_falsy_values"
 require_relative "object/resolve_type"
 
 module ConvenientService
@@ -24,6 +25,16 @@ module ConvenientService
           InstanceVariableFetch.call(...)
         end
 
+        ##
+        # @example
+        #   object = Object.new.tap { |object| object.instance_eval { self.class.attr_reader :foo } }
+        #
+        #   ConvenientService::Utils::Object.memoize_including_falsy_values(object, :@foo) { false }
+        #
+        def memoize_including_falsy_values(...)
+          MemoizeIncludingFalsyValues.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.7.0"
+  VERSION = "0.9.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: convenient_service
 version: !ruby/object:Gem::Version
-  version: 0.7.0
+  version: 0.9.0
 platform: ruby
 authors:
 - Marian Kostyk
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-02-13 00:00:00.000000000 Z
+date: 2023-02-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: appraisal
@@ -427,6 +427,7 @@ files:
 - lib/convenient_service/common/plugins/normalizes_env/middleware.rb
 - lib/convenient_service/configs.rb
 - lib/convenient_service/configs/aliases.rb
+- lib/convenient_service/configs/minimal.rb
 - lib/convenient_service/configs/standard.rb
 - lib/convenient_service/core.rb
 - lib/convenient_service/core/aliases.rb
@@ -727,7 +728,6 @@ files:
 - lib/convenient_service/service/plugins/has_result/entities/result/plugins/has_jsend_status_and_attributes/structs/jsend_attributes.rb
 - lib/convenient_service/service/plugins/has_result/entities/result/plugins/has_result_short_syntax.rb
 - lib/convenient_service/service/plugins/has_result/entities/result/plugins/has_result_short_syntax/concern.rb
-- lib/convenient_service/service/plugins/has_result/entities/result/plugins/has_result_short_syntax/concern/instance_methods.rb
 - lib/convenient_service/service/plugins/has_result/entities/result/plugins/has_step.rb
 - lib/convenient_service/service/plugins/has_result/entities/result/plugins/has_step/concern.rb
 - lib/convenient_service/service/plugins/has_result/entities/result/plugins/has_step/initialize.rb
@@ -825,6 +825,14 @@ files:
 - lib/convenient_service/service/plugins/raises_on_double_result.rb
 - lib/convenient_service/service/plugins/raises_on_double_result/errors.rb
 - lib/convenient_service/service/plugins/raises_on_double_result/middleware.rb
+- lib/convenient_service/service/plugins/rescues_result_unhandled_exceptions.rb
+- lib/convenient_service/service/plugins/rescues_result_unhandled_exceptions/commands.rb
+- lib/convenient_service/service/plugins/rescues_result_unhandled_exceptions/commands/format_backtrace.rb
+- lib/convenient_service/service/plugins/rescues_result_unhandled_exceptions/commands/format_cause.rb
+- lib/convenient_service/service/plugins/rescues_result_unhandled_exceptions/commands/format_exception.rb
+- lib/convenient_service/service/plugins/rescues_result_unhandled_exceptions/commands/format_line.rb
+- lib/convenient_service/service/plugins/rescues_result_unhandled_exceptions/constants.rb
+- lib/convenient_service/service/plugins/rescues_result_unhandled_exceptions/middleware.rb
 - lib/convenient_service/service/plugins/wraps_result_in_db_transaction.rb
 - lib/convenient_service/service/plugins/wraps_result_in_db_transaction/middleware.rb
 - lib/convenient_service/services.rb
@@ -867,6 +875,7 @@ files:
 - lib/convenient_service/support/not_passed.rb
 - lib/convenient_service/support/raw_value.rb
 - lib/convenient_service/support/ruby.rb
+- lib/convenient_service/support/undefined.rb
 - lib/convenient_service/support/version.rb
 - lib/convenient_service/support/version/null_version.rb
 - lib/convenient_service/utils.rb
@@ -897,6 +906,7 @@ files:
 - 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/memoize_including_falsy_values.rb
 - lib/convenient_service/utils/object/resolve_type.rb
 - lib/convenient_service/utils/proc.rb
 - lib/convenient_service/utils/proc/conjunct.rb

data/lib/convenient_service/service/plugins/has_result/entities/result/plugins/has_result_short_syntax/concern/instance_methods.rb

@@ -1,28 +0,0 @@
-# frozen_string_literal: true
-
-module ConvenientService
-  module Service
-    module Plugins
-      module HasResult
-        module Entities
-          class Result
-            module Plugins
-              module HasResultShortSyntax
-                module Concern
-                  module InstanceMethods
-                    ##
-                    # NOTE: `Support::Delegate` is NOT used intentionally in order to NOT pollute the public interface.
-                    #
-                    def [](key)
-                      data[key]
-                    end
-                  end
-                end
-              end
-            end
-          end
-        end
-      end
-    end
-  end
-end