dry-configurable 0.12.0 → 0.12.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 102cb0a4fe42ebde6835f50b7e75826dbc4b98c78cca9fcee5c5863c1c47651f
-  data.tar.gz: f5da17ecfb79edfa42c0d6c9a0d05d3e4cce2297533ec3151afafc9e6d4151b3
+  metadata.gz: 38b75c91290021054add38bdd9e3313f17aa133e219330a9b02a83227abd101c
+  data.tar.gz: 4b808bd3880c35e2e80a702e4577f2b2da35ef2b31667f4314accc3cf0c20470
 SHA512:
-  metadata.gz: 7d6dac8ebf7eddf6eb8b61da5cef0a434769270fc5ad2ab13ea7a4c5d093c047681b1bc85da4ba09190cfcf17ef023293dc4ccdb2f8dd2ac7eae19dbb4c69706
-  data.tar.gz: be0be051c79c2ef527d678cb9f839d6cabf40669b19864d38a735fe428a277068504897bd289baf69e0da26f470e35e0c2e73bc99f62dd16286fa7148a35572c
+  metadata.gz: efdd98ed5f60acf8090296954942f01c21702c29fa60c1edea21e0fbbb185955963b268191cb042ee33cc4651f4350419e7cbc2b7125c36103dce2733d137fa4
+  data.tar.gz: 21d278a4f9f4a90d530145408585c30e004ce2830d5777a408bd9ea83bdfd5cba2ce58f1a1ca46f1212d0e8d5967891a25467f39e59a8af20291cf5ca1beff3f

data/CHANGELOG.md

@@ -1,5 +1,37 @@
 <!--- DO NOT EDIT THIS FILE - IT'S AUTOMATICALLY GENERATED VIA DEVTOOLS --->
 
+## 0.12.1 2021-02-15
+
+
+### Added
+
+- Settings may be specified with a `cloneable` option, e.g.
+
+```ruby
+setting :component_dirs, Configuration::ComponentDirs.new, cloneable: true
+```
+
+This change makes it possible to provide “rich” config values that carry their own
+configuration interface.
+
+In the above example, `ComponentDirs` could provide its own API for adding component
+dirs and configuring aspects of their behavior at the same time. By being passed to
+the setting along with `cloneable: true`, dry-configurable will ensure the setting's
+values are cloned along with the setting at all the appropriate times.
+
+A custom cloneable setting value should provide its own `#initialize_copy` (used by
+`Object#dup`) with the appropriate logic. (@timriley in #102)
+
+### Fixed
+
+- Only `#initialize` instance method is prepended, leaving the rest of the instance
+methods to be included as normal again. This allows classes including
+`Dry::Configurable` to override instance methods with their own methods as required
+(@adam12 in #103)
+
+
+[Compare v0.12.0...v0.12.1](https://github.com/dry-rb/dry-configurable/compare/v0.12.0...v0.12.1)
+
 ## 0.12.0 2020-12-26
 
 

data/LICENSE

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2015-2020 dry-rb team
+Copyright (c) 2015-2021 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/lib/dry/configurable.rb

@@ -57,7 +57,8 @@ module Dry
       super
       klass.class_eval do
         extend(ClassMethods)
-        prepend(InstanceMethods)
+        include(InstanceMethods)
+        prepend(Initializer)
 
         class << self
           undef :config

data/lib/dry/configurable/instance_methods.rb

@@ -5,6 +5,18 @@ require 'dry/configurable/methods'
 
 module Dry
   module Configurable
+    # Initializer method which is prepended when `Dry::Configurable`
+    # is included in a class
+    #
+    # @api private
+    module Initializer
+      # @api private
+      def initialize(*)
+        @config = Config.new(self.class._settings.dup)
+        super
+      end
+    end
+
     # Instance-level API when `Dry::Configurable` is included in a class
     #
     # @api public
@@ -18,12 +30,6 @@ module Dry
       # @api public
       attr_reader :config
 
-      # @api private
-      def initialize(*)
-        @config = Config.new(self.class._settings.dup)
-        super
-      end
-
       # Finalize the config and freeze the object
       #
       # @api public

data/lib/dry/configurable/setting.rb

@@ -15,11 +15,11 @@ module Dry
     class Setting
       include Dry::Equalizer(:name, :value, :options, inspect: false)
 
-      OPTIONS = %i[input default reader constructor settings].freeze
+      OPTIONS = %i[input default reader constructor cloneable settings].freeze
 
       DEFAULT_CONSTRUCTOR = -> v { v }.freeze
 
-      CLONABLE_VALUE_TYPES = [Array, Hash, Set, Config].freeze
+      CLONEABLE_VALUE_TYPES = [Array, Hash, Set, Config].freeze
 
       # @api private
       attr_reader :name
@@ -54,8 +54,8 @@ module Dry
       end
 
       # @api private
-      def self.clonable_value?(value)
-        CLONABLE_VALUE_TYPES.any? { |type| value.is_a?(type) }
+      def self.cloneable_value?(value)
+        CLONEABLE_VALUE_TYPES.any? { |type| value.is_a?(type) }
       end
 
       # @api private
@@ -114,15 +114,32 @@ module Dry
         writer_name.equal?(meth)
       end
 
+      # @api private
+      def cloneable?
+        if options.key?(:cloneable)
+          # Return cloneable option if explicitly set
+          options[:cloneable]
+        else
+          # Otherwise, infer cloneable from any of the input, default, or value
+          Setting.cloneable_value?(input) || Setting.cloneable_value?(default) || (
+            evaluated? && Setting.cloneable_value?(value)
+          )
+        end
+      end
+
       private
 
       # @api private
       def initialize_copy(source)
         super
-        @input = source.input.dup if Setting.clonable_value?(source.input)
-        @default = source.default.dup if Setting.clonable_value?(source.default)
-        @value = source.value.dup if source.evaluated? && Setting.clonable_value?(source.value)
+
         @options = source.options.dup
+
+        if source.cloneable?
+          @input = source.input.dup
+          @default = source.default.dup
+          @value = source.value.dup if source.evaluated?
+        end
       end
 
       # @api private

data/lib/dry/configurable/version.rb

@@ -3,6 +3,6 @@
 module Dry
   module Configurable
     # @api public
-    VERSION = '0.12.0'
+    VERSION = '0.12.1'
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: dry-configurable
 version: !ruby/object:Gem::Version
-  version: 0.12.0
+  version: 0.12.1
 platform: ruby
 authors:
 - Andy Holland
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-12-26 00:00:00.000000000 Z
+date: 2021-02-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: concurrent-ruby