dry-core 0.7.1 → 1.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cb330574bba6050e9a3d0fd466fdbd276ce76749b2661b8091ebf6178a2ef6c9
-  data.tar.gz: c1319b83600515df992a91556000989aa092d4229f69669b8f544368d93d21a8
+  metadata.gz: 5c263a2d5bf720ac7d9e68c202b3552e4e82bba0b253ddc75a1aff5055463f9a
+  data.tar.gz: 955cdffe644913ba567129a73aaf3ea0b748b2b2fd5244b5d559da013bd05df9
 SHA512:
-  metadata.gz: 2b1967bb0c991637ea01da5d267df78daa12e4801288932372eca2ecf8aff0c5933ef2cb9cdc06d978d6223da963a31dc5e362f1ad1052490e10ebbc2b39fae6
-  data.tar.gz: 22662f066d46742cfd12d79eddcfb1e76811ab00b0080be8bac8fef53a1229fa91f5501b9f0b34f09182f5843c7bf995332fc16d1fe192daeadff186cd543cb7
+  metadata.gz: da527ac6a598046f9c8c7c2c1264b3e18c979b2ca5c2df65a6709952a3238afe733e3c52e92e0322946c46ff7b54141d986e2cdfe41ad5c0ae125bc96ad52c80
+  data.tar.gz: 64a8f1688c6781b2a10f3157747f8130c59072be29ed9b238500700166bb9c8e5d4b30e8a5493407c8354f71fd83d246dd3b9f9778dda6c23105dedcb209ae92

data/CHANGELOG.md

@@ -1,5 +1,73 @@
 <!--- DO NOT EDIT THIS FILE - IT'S AUTOMATICALLY GENERATED VIA DEVTOOLS --->
 
+## 1.0.1 2023-08-06
+
+
+### Fixed
+
+- [equalizer] Add `Dry::Core.Equalizer` method to make `include Dry::Core.Equalizer(...)` work as documented (via #79) (@timriley)
+
+  Users of Equalizer should now only need to `require "dry/core"` first.
+
+
+
+[Compare v1.0.0...v1.0.1](https://github.com/dry-rb/dry-core/compare/v1.0.0...v1.0.1)
+
+## 1.0.0 2022-11-04
+
+
+### Added
+
+- Import dry-container as `Dry::Core::Container` (via #77) (@solnic)
+
+
+[Compare v0.9.1...v1.0.0](https://github.com/dry-rb/dry-core/compare/v0.9.1...v1.0.0)
+
+## 0.9.1 2022-10-18
+
+
+### Changed
+
+- Correct missing constant for IDENTITY (issue #75 fixed via #76) (@poloka)
+
+[Compare v0.9.0...v0.9.1](https://github.com/dry-rb/dry-core/compare/v0.9.0...v0.9.1)
+
+## 0.9.0 2022-10-15
+
+
+### Changed
+
+- dry-core now uses zeitwerk for autoloading (@solnic)
+
+[Compare v0.8.1...v0.9.0](https://github.com/dry-rb/dry-core/compare/v0.8.1...v0.9.0)
+
+## 0.8.1 2022-07-27
+
+
+### Fixed
+
+- [memoizable] plays better with inheritance.
+There were cases when cached values from base claesses were used, see #70 (@flash-gordon)
+
+
+
+[Compare v0.8.0...v0.8.1](https://github.com/dry-rb/dry-core/compare/v0.8.0...v0.8.1)
+
+## 0.8.0 2022-07-15
+
+
+### Added
+
+- `Dry::Core::BasicObject` ported from hanami-utils (@jodosha)
+
+### Changed
+
+- [BREAKING] [descendants tracker] switch to using `Class#subclasses` on Ruby 3.1+.
+This changes the order of returned subclasses (immediate subclasses now go first) (@flash-gordon)
+
+
+[Compare v0.7.1...v0.8.0](https://github.com/dry-rb/dry-core/compare/v0.7.1...v0.8.0)
+
 ## 0.7.1 2021-07-10
 
 
@@ -43,7 +111,7 @@ has unnamed params (e.g. happens when the new `...` syntax is used) (@flash-gord
 
 [Compare v0.5.0...v0.6.0](https://github.com/dry-rb/dry-core/compare/v0.5.0...v0.6.0)
 
-## 0.5.0 2012-12-12
+## 0.5.0 2020-12-12
 
 
 ### Added

data/LICENSE

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2015-2021 dry-rb team
+Copyright (c) 2015-2023 dry-rb team
 
 Permission is hereby granted, free of charge, to any person obtaining a copy of
 this software and associated documentation files (the "Software"), to deal in

data/README.md

@@ -1,29 +1,21 @@
 <!--- this file is synced from dry-rb/template-gem project -->
 [gem]: https://rubygems.org/gems/dry-core
 [actions]: https://github.com/dry-rb/dry-core/actions
-[codacy]: https://www.codacy.com/gh/dry-rb/dry-core
-[chat]: https://dry-rb.zulipchat.com
-[inchpages]: http://inch-ci.org/github/dry-rb/dry-core
 
-# dry-core [![Join the chat at https://dry-rb.zulipchat.com](https://img.shields.io/badge/dry--rb-join%20chat-%23346b7a.svg)][chat]
-
-[![Gem Version](https://badge.fury.io/rb/dry-core.svg)][gem]
-[![CI Status](https://github.com/dry-rb/dry-core/workflows/ci/badge.svg)][actions]
-[![Codacy Badge](https://api.codacy.com/project/badge/Grade/40946292b9094624beec604a149a6023)][codacy]
-[![Codacy Badge](https://api.codacy.com/project/badge/Coverage/40946292b9094624beec604a149a6023)][codacy]
-[![Inline docs](http://inch-ci.org/github/dry-rb/dry-core.svg?branch=master)][inchpages]
+# dry-core [![Gem Version](https://badge.fury.io/rb/dry-core.svg)][gem] [![CI Status](https://github.com/dry-rb/dry-core/workflows/ci/badge.svg)][actions]
 
 ## Links
 
 * [User documentation](https://dry-rb.org/gems/dry-core)
 * [API documentation](http://rubydoc.info/gems/dry-core)
+* [Forum](https://discourse.dry-rb.org)
 
 ## Supported Ruby versions
 
 This library officially supports the following Ruby versions:
 
-* MRI `>= 2.6.0`
-* ~~jruby~~ `>= 9.3` (we are waiting for [2.6 support](https://github.com/jruby/jruby/issues/6161))
+* MRI `>= 3.0.0`
+* jruby `>= 9.4` (not tested on CI)
 
 ## License
 

data/dry-core.gemspec

@@ -22,14 +22,15 @@ Gem::Specification.new do |spec|
   spec.require_paths = ["lib"]
 
   spec.metadata["allowed_push_host"] = "https://rubygems.org"
-  spec.metadata["changelog_uri"]     = "https://github.com/dry-rb/dry-core/blob/master/CHANGELOG.md"
+  spec.metadata["changelog_uri"]     = "https://github.com/dry-rb/dry-core/blob/main/CHANGELOG.md"
   spec.metadata["source_code_uri"]   = "https://github.com/dry-rb/dry-core"
   spec.metadata["bug_tracker_uri"]   = "https://github.com/dry-rb/dry-core/issues"
 
-  spec.required_ruby_version = ">= 2.6.0"
+  spec.required_ruby_version = ">= 3.0.0"
 
   # to update dependencies edit project.yml
   spec.add_runtime_dependency "concurrent-ruby", "~> 1.0"
+  spec.add_runtime_dependency "zeitwerk", "~> 2.6"
 
   spec.add_development_dependency "bundler"
   spec.add_development_dependency "rake"

data/lib/dry/core/basic_object.rb

@@ -0,0 +1,144 @@
+# frozen_string_literal: true
+
+# This implementation was imported from `hanami-utils` gem.
+module Dry
+  module Core
+    # BasicObject
+    #
+    # @since 0.8.0
+    class BasicObject < ::BasicObject
+      # Lookups constants at the top-level namespace, if they are missing in the
+      # current context.
+      #
+      # @param name [Symbol] the constant name
+      #
+      # @return [Object, Module] the constant
+      #
+      # @raise [NameError] if the constant cannot be found
+      #
+      # @since 0.8.0
+      # @api private
+      #
+      # @see https://ruby-doc.org/core/Module.html#method-i-const_missing
+      def self.const_missing(name)
+        ::Object.const_get(name)
+      end
+
+      # Returns the class for debugging purposes.
+      #
+      # @since 0.8.0
+      #
+      # @see http://ruby-doc.org/core/Object.html#method-i-class
+      def class
+        (class << self; self; end).superclass
+      end
+
+      # Bare minimum inspect for debugging purposes.
+      #
+      # @return [String] the inspect string
+      #
+      # @since 0.8.0
+      #
+      # @see http://ruby-doc.org/core/Object.html#method-i-inspect
+      inspect_method = ::Kernel.instance_method(:inspect)
+      define_method(:inspect) do
+        original = inspect_method.bind_call(self)
+        "#{original[0...-1]}#{__inspect}>"
+      end
+
+      # @!macro [attach] instance_of?(class)
+      #
+      # Determines if self is an instance of given class or module
+      #
+      # @param class [Class,Module] the class of module to verify
+      #
+      # @return [TrueClass,FalseClass] the result of the check
+      #
+      # @raise [TypeError] if the given argument is not of the expected types
+      #
+      # @since 0.8.0
+      #
+      # @see http://ruby-doc.org/core/Object.html#method-i-instance_of-3F
+      define_method :instance_of?, ::Object.instance_method(:instance_of?)
+
+      # @!macro [attach] is_a?(class)
+      #
+      # Determines if self is of the type of the object class or module
+      #
+      # @param class [Class,Module] the class of module to verify
+      #
+      # @return [TrueClass,FalseClass] the result of the check
+      #
+      # @raise [TypeError] if the given argument is not of the expected types
+      #
+      # @since 0.8.0
+      #
+      # @see http://ruby-doc.org/core/Object.html#method-i-is_a-3F
+      define_method :is_a?, ::Object.instance_method(:is_a?)
+
+      # @!macro [attach] kind_of?(class)
+      #
+      # Determines if self is of the kind of the object class or module
+      #
+      # @param class [Class,Module] the class of module to verify
+      #
+      # @return [TrueClass,FalseClass] the result of the check
+      #
+      # @raise [TypeError] if the given argument is not of the expected types
+      #
+      # @since 0.8.0
+      #
+      # @see http://ruby-doc.org/core/Object.html#method-i-kind_of-3F
+      define_method :kind_of?, ::Object.instance_method(:kind_of?)
+
+      # Alias for __id__
+      #
+      # @return [Fixnum] the object id
+      #
+      # @since 0.8.0
+      #
+      # @see http://ruby-doc.org/core/Object.html#method-i-object_id
+      def object_id
+        __id__
+      end
+
+      # Interface for pp
+      #
+      # @param printer [PP] the Pretty Printable printer
+      # @return [String] the pretty-printable inspection of the object
+      #
+      # @since 0.8.0
+      #
+      # @see https://ruby-doc.org/stdlib/libdoc/pp/rdoc/PP.html
+      def pretty_print(printer)
+        printer.text(inspect)
+      end
+
+      # Returns true if responds to the given method.
+      #
+      # @return [TrueClass,FalseClass] the result of the check
+      #
+      # @since 0.8.0
+      #
+      # @see http://ruby-doc.org/core/Object.html#method-i-respond_to-3F
+      def respond_to?(method_name, include_all = false) # rubocop:disable Style/OptionalBooleanParameter
+        respond_to_missing?(method_name, include_all)
+      end
+
+      private
+
+      # Must be overridden by descendants
+      #
+      # @since 0.8.0
+      # @api private
+      def respond_to_missing?(_method_name, _include_all)
+        ::Kernel.raise ::NotImplementedError
+      end
+
+      # @since 0.8.0
+      # @api private
+      def __inspect # rubocop:disable Style/EmptyMethod
+      end
+    end
+  end
+end

data/lib/dry/core/cache.rb

@@ -60,8 +60,8 @@ module Dry
         # @yield An arbitrary block
         #
         # @return [Object] block's return value
-        def fetch_or_store(*args, &block)
-          self.class.fetch_or_store(*args, &block)
+        def fetch_or_store(...)
+          self.class.fetch_or_store(...)
         end
       end
     end

data/lib/dry/core/class_attributes.rb

@@ -1,7 +1,6 @@
 # frozen_string_literal: true
 
 require "dry/core/constants"
-require "dry/core/errors"
 
 module Dry
   module Core
@@ -10,7 +9,6 @@ module Dry
     # @api public
     module ClassAttributes
       include Constants
-
       # Specify what attributes a class will use
       #
       # @example
@@ -80,13 +78,13 @@ module Dry
               if Undefined.equal?(value)
                 if instance_variable_defined?(ivar)
                   instance_variable_get(ivar)
-                else # rubocop:disable Style/EmptyElse
+                else
                   nil
                 end
               elsif type === value # rubocop:disable Style/CaseEquality
                 instance_variable_set(ivar, coerce.call(value))
               else
-                raise InvalidClassAttributeValue.new(name, value)
+                raise InvalidClassAttributeValueError.new(name, value)
               end
             end
           end

data/lib/dry/core/constants.rb

@@ -62,7 +62,7 @@ module Dry
         #     1 + Undefined.default(val, 2)
         #   end
         #
-        def undefined.default(x, y = self) # rubocop:disable Naming/MethodParameterName
+        def undefined.default(x, y = self)
           if equal?(x)
             if equal?(y)
               yield

data/lib/dry/core/container/config.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module Dry
+  module Core
+    class Container
+      # @api public
+      class Config
+        DEFAULT_NAMESPACE_SEPARATOR = "."
+        DEFAULT_RESOLVER = Resolver.new
+        DEFAULT_REGISTRY = Registry.new
+
+        # @api public
+        attr_accessor :namespace_separator
+
+        # @api public
+        attr_accessor :resolver
+
+        # @api public
+        attr_accessor :registry
+
+        # @api private
+        def initialize(
+          namespace_separator: DEFAULT_NAMESPACE_SEPARATOR,
+          resolver: DEFAULT_RESOLVER,
+          registry: DEFAULT_REGISTRY
+        )
+          @namespace_separator = namespace_separator
+          @resolver = resolver
+          @registry = registry
+        end
+      end
+    end
+  end
+end

data/lib/dry/core/container/configuration.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+module Dry
+  module Core
+    class Container
+      # @api public
+      module Configuration
+        # Use dry/configurable if it's available
+        begin
+          require "dry/configurable"
+
+          # @api private
+          def self.extended(klass)
+            super
+            klass.class_eval do
+              extend Dry::Configurable
+
+              setting :namespace_separator, default: Config::DEFAULT_NAMESPACE_SEPARATOR
+              setting :resolver, default: Config::DEFAULT_RESOLVER
+              setting :registry, default: Config::DEFAULT_REGISTRY
+            end
+          end
+        rescue LoadError
+          # @api private
+          def config
+            @config ||= Container::Config.new
+          end
+        end
+
+        # @api private
+        def configure
+          yield config
+        end
+      end
+    end
+  end
+end

data/lib/dry/core/container/item/callable.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Dry
+  module Core
+    class Container
+      class Item
+        # Callable class to returns a item call
+        #
+        # @api public
+        #
+        class Callable < Item
+          # Returns the result of item call or item
+          #
+          # @return [Mixed]
+          def call
+            callable? ? item.call : item
+          end
+        end
+      end
+    end
+  end
+end

data/lib/dry/core/container/item/factory.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module Dry
+  module Core
+    class Container
+      class Item
+        # Factory for create an Item to register inside of container
+        #
+        # @api public
+        class Factory
+          # Creates an Item Memoizable or Callable
+          # @param [Mixed] item
+          # @param [Hash] options
+          #
+          # @raise [Dry::Core::Container::Error]
+          #
+          # @return [Dry::Core::Container::Item::Base]
+          def call(item, options = {})
+            if options[:memoize]
+              Item::Memoizable.new(item, options)
+            else
+              Item::Callable.new(item, options)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/dry/core/container/item/memoizable.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+module Dry
+  module Core
+    class Container
+      class Item
+        # Memoizable class to store and execute item calls
+        #
+        # @api public
+        #
+        class Memoizable < Item
+          # @return [Mutex] the stored mutex
+          attr_reader :memoize_mutex
+
+          # Returns a new Memoizable instance
+          #
+          # @param [Mixed] item
+          # @param [Hash] options
+          #
+          # @raise [Dry::Core::Container::Error]
+          #
+          # @return [Dry::Core::Container::Item::Base]
+          def initialize(item, options = {})
+            super
+            raise_not_supported_error unless callable?
+
+            @memoize_mutex = ::Mutex.new
+          end
+
+          # Returns the result of item call using a syncronized mutex
+          #
+          # @return [Dry::Core::Container::Item::Base]
+          def call
+            memoize_mutex.synchronize do
+              @memoized_item ||= item.call
+            end
+          end
+
+          private
+
+          # @private
+          def raise_not_supported_error
+            raise ::Dry::Core::Container::Error, "Memoize only supported for a block or a proc"
+          end
+        end
+      end
+    end
+  end
+end

data/lib/dry/core/container/item.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+module Dry
+  module Core
+    class Container
+      # Base class to abstract Memoizable and Callable implementations
+      #
+      # @api abstract
+      #
+      class Item
+        # @return [Mixed] the item to be solved later
+        attr_reader :item
+
+        # @return [Hash] the options to memoize, call or no.
+        attr_reader :options
+
+        # @api abstract
+        def initialize(item, options = {})
+          @item = item
+          @options = {
+            call: item.is_a?(::Proc) && item.parameters.empty?
+          }.merge(options)
+        end
+
+        # @api abstract
+        def call
+          raise NotImplementedError
+        end
+
+        # @private
+        def value?
+          !callable?
+        end
+
+        # @private
+        def callable?
+          options[:call]
+        end
+
+        # Build a new item with transformation applied
+        #
+        # @private
+        def map(func)
+          if callable?
+            self.class.new(-> { func.(item.call) }, options)
+          else
+            self.class.new(func.(item), options)
+          end
+        end
+      end
+    end
+  end
+end