dry-configurable 0.11.5

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: f0faa56dea70f112144295394747175b526e116cdfd09d3ccfa047b85dd06b11
+  data.tar.gz: 48fc6304ef41ea05076765bbe8f7286e90ed69ee54b388650d3654b74b4ebfda
+SHA512:
+  metadata.gz: 9c6c284433350053c27e745a8bcb0a0c000c22d4fe684c39eeb20340d026b764f8d80ee155a30ba88af66f4e9ba1022e1572accfa5aff4657b463978534d964e
+  data.tar.gz: ed4d650fb3f2d7f92d05bad9575c452bf67138489a734e91ccc4fb6d9fa5932a6dee72430a84c7b2994b8d28bb42a6d7c4dda8e5b82e9ce51ac588a0888f1b2b

data/CHANGELOG.md

@@ -0,0 +1,177 @@
+## 0.11.5 2020-03-23
+
+
+### Fixed
+
+- When settings are copied or cloned, unevaluated values will no longer be copied. This prevents unintended crashes when settings have constructors expecting a certain type of value, but that value is yet to be provided (Fixed via #87) (@timriley)
+
+
+[Compare v0.11.4...v0.11.5](https://github.com/dry-rb/dry-configurable/compare/v0.11.4...v0.11.5)
+
+## 0.11.4 2020-03-16
+
+
+### Fixed
+
+- `Config#update` returns `self` again (issue #60 fixed via #92) (@solnic)
+
+### Changed
+
+- `Setting#inspect` no longer uses its value - this could cause crashes when inspecting settings that are yet to have a value applied (e.g. when they have a constructor that expects a value to be present) (@timriley)
+
+[Compare v0.11.3...v0.11.4](https://github.com/dry-rb/dry-configurable/compare/v0.11.3...v0.11.4)
+
+## 0.11.3 2020-02-22
+
+
+### Fixed
+
+- Retrieving settings by a string name works again (issue #82) (@waiting-for-dev)
+
+
+[Compare v0.11.2...v0.11.3](https://github.com/dry-rb/dry-configurable/compare/v0.11.2...v0.11.3)
+
+## 0.11.2 2020-02-20
+
+
+### Fixed
+
+- Warning about redefined `Setting#value` is gone (@solnic)
+
+
+[Compare v0.11.1...v0.11.2](https://github.com/dry-rb/dry-configurable/compare/v0.11.1...v0.11.2)
+
+## 0.11.1 2020-02-18
+
+
+### Fixed
+
+- You can use `:settings` as a config key again (issue #80) (@solnic)
+- Setting value is lazy-evaluated now, which fixes some cases where a constructor could crash with a `nil` value (@solnic)
+
+
+[Compare v0.11.0...v0.11.1](https://github.com/dry-rb/dry-configurable/compare/v0.11.0...v0.11.1)
+
+## 0.11.0 2020-02-15
+
+Complete rewrite of the library while keeping the public API intact. See #78 for a detailed overview.
+
+### Changed
+
+- Accessing config in a parent class no longer prevents you from adding more settings in a child class (@solnic)
+- (internal) New low-level Setting and Config API (@solnic)
+- (internal) `config` objects use method_missing now (@solnic)
+
+[Compare v0.10.0...v0.11.0](https://github.com/dry-rb/dry-configurable/compare/v0.10.0...v0.11.0)
+
+## 0.10.0 2020-01-31
+
+YANKED because the change also broke inheritance for classes that used `configured` before other classes inherited from them.
+
+### Changed
+
+- Inheriting settings no longer defines the config object. This change fixed a use case where parent class that already used its config would prevent a child class from adding new settings (@solnic)
+
+[Compare v0.9.0...v0.10.0](https://github.com/dry-rb/dry-configurable/compare/v0.9.0...v0.10.0)
+
+## 0.9.0 2019-11-06
+
+
+### Fixed
+
+- Support for reserved names in settings. Some Kernel methods (`public_send` and `class` specifically) are not available if you use access settings via method call. Same for methods of the `Config` class. You can still access them with `[]` and `[]=`. Ruby keywords are fully supported. Invalid names containing special symbols (including `!` and `?`) are rejected. Note that these changes don't affect the `reader` option, if you define a setting named `:class` and pass `reader: true` ... well ... (flash-gordon)
+- Settings can be redefined in subclasses without a warning about overriding exsting methods (flash-gordon)
+- Fix warnings about using keyword arguments in 2.7 (koic)
+
+
+[Compare v0.8.3...v0.9.0](https://github.com/dry-rb/dry-configurable/compare/v0.8.3...v0.9.0)
+
+## 0.8.3 2019-05-29
+
+
+### Fixed
+
+- `Configurable#dup` and `Configurable#clone` make a copy of instance-level config so that it doesn't get mutated/shared across instances (flash-gordon)
+
+
+[Compare v0.8.2...v0.8.3](https://github.com/dry-rb/dry-configurable/compare/v0.8.2...v0.8.3)
+
+## 0.8.2 2019-02-25
+
+
+### Fixed
+
+- Test interface support for modules ([Neznauy](https://github.com/Neznauy))
+
+
+[Compare v0.8.1...v0.8.2](https://github.com/dry-rb/dry-configurable/compare/v0.8.1...v0.8.2)
+
+## 0.8.1 2019-02-06
+
+
+### Fixed
+
+- `.configure` doesn't require a block, this makes the behavior consistent with the previous versions ([flash-gordon](https://github.com/flash-gordon))
+
+
+[Compare v0.8.0...v0.8.1](https://github.com/dry-rb/dry-configurable/compare/v0.8.0...v0.8.1)
+
+## 0.8.0 2019-02-05
+
+
+### Added
+
+- Support for instance-level configuration landed. For usage, `include` the module instead of extending ([flash-gordon](https://github.com/flash-gordon))
+
+  ```ruby
+  class App
+    include Dry::Configurable
+
+    setting :database
+  end
+
+  production = App.new
+  production.config.database = ENV['DATABASE_URL']
+  production.finalize!
+
+  development = App.new
+  development.config.database = 'jdbc:sqlite:memory'
+  development.finalize!
+  ```
+- Config values can be set from a hash with `.update`. Nested settings are supported ([flash-gordon](https://github.com/flash-gordon))
+
+  ```ruby
+  class App
+    extend Dry::Configurable
+
+    setting :db do
+      setting :host
+      setting :port
+    end
+
+    config.update(YAML.load(File.read("config.yml")))
+  end
+  ```
+
+### Fixed
+
+- A number of bugs related to inheriting settings from parent class were fixed. Ideally, new behavior will be :100: predictable but if you observe any anomaly, please report ([flash-gordon](https://github.com/flash-gordon))
+
+### Changed
+
+- [BREAKING] Minimal supported Ruby version is set to 2.3 ([flash-gordon](https://github.com/flash-gordon))
+
+[Compare v0.7.0...v0.8.0](https://github.com/dry-rb/dry-configurable/compare/v0.7.0...v0.8.0)
+
+## 0.7.0 2017-04-25
+
+
+### Added
+
+- Introduce `Configurable.finalize!` which freezes config and its dependencies ([qcam](https://github.com/qcam))
+
+### Fixed
+
+- Allow for boolean false as default setting value ([yuszuv](https://github.com/yuszuv))
+- Convert nested configs to nested hashes with `Config#to_h` ([saverio-kantox](https://github.com/saverio-kantox))
+- Disallow modification on frozen config ([qcam](https://github.com/qcam))

data/LICENSE

@@ -0,0 +1,20 @@
+The MIT License (MIT)
+
+Copyright (c) 2015-2020 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
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+the Software, and to permit persons to whom the Software is furnished to do so,
+subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,29 @@
+[gem]: https://rubygems.org/gems/dry-configurable
+[actions]: https://github.com/dry-rb/dry-configurable/actions
+[codacy]: https://www.codacy.com/gh/dry-rb/dry-configurable
+[chat]: https://dry-rb.zulipchat.com
+[inchpages]: http://inch-ci.org/github/dry-rb/dry-configurable
+
+# dry-configurable [![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-configurable.svg)][gem]
+[![CI Status](https://github.com/dry-rb/dry-configurable/workflows/ci/badge.svg)][actions]
+[![Codacy Badge](https://api.codacy.com/project/badge/Grade/0276a97990e04eb0ac722b3e7f3620b5)][codacy]
+[![Codacy Badge](https://api.codacy.com/project/badge/Coverage/0276a97990e04eb0ac722b3e7f3620b5)][codacy]
+[![Inline docs](http://inch-ci.org/github/dry-rb/dry-configurable.svg?branch=master)][inchpages]
+
+## Links
+
+* [User documentation](http://dry-rb.org/gems/dry-configurable)
+* [API documentation](http://rubydoc.info/gems/dry-configurable)
+
+## Supported Ruby versions
+
+This library officially supports the following Ruby versions:
+
+* MRI >= `2.4`
+* jruby >= `9.2`
+
+## License
+
+See `LICENSE` file.

data/dry-configurable.gemspec

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+# this file is managed by dry-rb/devtools project
+
+lib = File.expand_path('lib', __dir__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'dry/configurable/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'dry-configurable'
+  spec.authors       = ["Andy Holland"]
+  spec.email         = ["andyholland1991@aol.com"]
+  spec.license       = 'MIT'
+  spec.version       = Dry::Configurable::VERSION.dup
+
+  spec.summary       = "A mixin to add configuration functionality to your classes"
+  spec.description   = spec.summary
+  spec.homepage      = 'https://dry-rb.org/gems/dry-configurable'
+  spec.files         = Dir["CHANGELOG.md", "LICENSE", "README.md", "dry-configurable.gemspec", "lib/**/*"]
+  spec.bindir        = 'bin'
+  spec.executables   = []
+  spec.require_paths = ['lib']
+
+  spec.metadata['allowed_push_host'] = 'https://rubygems.org'
+  spec.metadata['changelog_uri']     = 'https://github.com/dry-rb/dry-configurable/blob/master/CHANGELOG.md'
+  spec.metadata['source_code_uri']   = 'https://github.com/dry-rb/dry-configurable'
+  spec.metadata['bug_tracker_uri']   = 'https://github.com/dry-rb/dry-configurable/issues'
+
+  spec.required_ruby_version = ">= 2.4.0"
+
+  # to update dependencies edit project.yml
+  spec.add_runtime_dependency "concurrent-ruby", "~> 1.0"
+  spec.add_runtime_dependency "dry-core", "~> 0.4", ">= 0.4.7"
+  spec.add_runtime_dependency "dry-equalizer", "~> 0.2"
+
+  spec.add_development_dependency "bundler"
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency "rspec"
+end

data/lib/dry-configurable.rb

@@ -0,0 +1,3 @@
+# frozen_string_literal: true
+
+require 'dry/configurable'

data/lib/dry/configurable.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+require 'concurrent/array'
+
+require 'dry/configurable/constants'
+require 'dry/configurable/class_methods'
+require 'dry/configurable/instance_methods'
+require 'dry/configurable/config'
+require 'dry/configurable/setting'
+
+module Dry
+  # A simple configuration mixin
+  #
+  # @example class-level configuration
+  #
+  #   class App
+  #     extend Dry::Configurable
+  #
+  #     setting :database do
+  #       setting :dsn, 'sqlite:memory'
+  #     end
+  #   end
+  #
+  #   App.config.database.dsn = 'jdbc:sqlite:memory'
+  #   App.config.database.dsn
+  #     # => "jdbc:sqlite:memory"
+  #
+  # @example instance-level configuration
+  #
+  #   class App
+  #     include Dry::Configurable
+  #
+  #     setting :database
+  #   end
+  #
+  #   production = App.new
+  #   production.config.database = ENV['DATABASE_URL']
+  #   production.finalize!
+  #
+  #   development = App.new
+  #   development.config.database = 'jdbc:sqlite:memory'
+  #   development.finalize!
+  #
+  # @api public
+  module Configurable
+    # @api private
+    def self.extended(klass)
+      super
+      klass.extend(ClassMethods)
+    end
+
+    # @api private
+    def self.included(klass)
+      super
+      klass.class_eval do
+        extend(ClassMethods)
+        include(InstanceMethods)
+
+        class << self
+          undef :config
+          undef :configure
+        end
+      end
+    end
+  end
+end

data/lib/dry/configurable/class_methods.rb

@@ -0,0 +1,103 @@
+# frozen_string_literal: true
+
+require 'set'
+
+require 'dry/configurable/constants'
+require 'dry/configurable/dsl'
+require 'dry/configurable/methods'
+require 'dry/configurable/settings'
+
+module Dry
+  module Configurable
+    module ClassMethods
+      include Methods
+
+      # @api private
+      def inherited(klass)
+        super
+
+        parent_settings = (respond_to?(:config) ? config._settings : _settings)
+
+        klass.instance_variable_set('@_settings', parent_settings)
+      end
+
+      # Add a setting to the configuration
+      #
+      # @param [Mixed] key
+      #   The accessor key for the configuration value
+      # @param [Mixed] default
+      #   The default config value
+      #
+      # @yield
+      #   If a block is given, it will be evaluated in the context of
+      #   a new configuration class, and bound as the default value
+      #
+      # @return [Dry::Configurable::Config]
+      #
+      # @api public
+      def setting(*args, &block)
+        setting = __config_dsl__.setting(*args, &block)
+
+        _settings << setting
+
+        __config_reader__.define(setting.name) if setting.reader?
+
+        self
+      end
+
+      # Return declared settings
+      #
+      # @return [Set<Symbol>]
+      #
+      # @api public
+      def settings
+        @settings ||= Set[*_settings.map(&:name)]
+      end
+
+      # Return declared settings
+      #
+      # @return [Settings]
+      #
+      # @api public
+      def _settings
+        @_settings ||= Settings.new
+      end
+
+      # Return configuration
+      #
+      # @return [Config]
+      #
+      # @api public
+      def config
+        @config ||= Config.new(_settings)
+      end
+
+      # @api private
+      def __config_dsl__
+        @dsl ||= DSL.new
+      end
+
+      # @api private
+      def __config_reader__
+        @__config_reader__ ||=
+          begin
+            reader = Module.new do
+              def self.define(name)
+                define_method(name) do
+                  config[name]
+                end
+              end
+            end
+
+            if included_modules.include?(InstanceMethods)
+              include(reader)
+            end
+
+            extend(reader)
+
+            reader
+          end
+      end
+    end
+  end
+end

data/lib/dry/configurable/compiler.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+require 'dry/configurable/setting'
+require 'dry/configurable/settings'
+
+module Dry
+  module Configurable
+    # Setting compiler used internally by the DSL
+    #
+    # @api private
+    class Compiler
+      def call(ast)
+        Settings.new.tap do |settings|
+          ast.each do |node|
+            settings << visit(node)
+          end
+        end
+      end
+
+      # @api private
+      def visit(node)
+        type, rest = node
+        public_send(:"visit_#{type}", rest)
+      end
+
+      # @api private
+      def visit_constructor(node)
+        setting, constructor = node
+        visit(setting).with(constructor: constructor)
+      end
+
+      # @api private
+      def visit_setting(node)
+        name, default, opts = node
+        Setting.new(name, **opts, default: default)
+      end
+
+      # @api private
+      def visit_nested(node)
+        parent, children = node
+        visit(parent).nested(call(children))
+      end
+    end
+  end
+end

data/lib/dry/configurable/config.rb

@@ -0,0 +1,129 @@
+# frozen_string_literal: true
+
+require 'concurrent/map'
+
+require 'dry/equalizer'
+
+require 'dry/configurable/constants'
+require 'dry/configurable/errors'
+
+module Dry
+  module Configurable
+    # Config exposes setting values through a convenient API
+    #
+    # @api public
+    class Config
+      include Dry::Equalizer(:values)
+
+      # @api private
+      attr_reader :_settings
+
+      # @api private
+      attr_reader :_resolved
+
+      # @api private
+      def initialize(settings)
+        @_settings = settings.dup
+        @_resolved = Concurrent::Map.new
+      end
+
+      # Get config value by a key
+      #
+      # @param [String,Symbol] name
+      #
+      # @return Config value
+      def [](name)
+        name = name.to_sym
+        raise ArgumentError, "+#{name}+ is not a setting name" unless _settings.key?(name)
+
+        _settings[name].value
+      end
+
+      # Set config value.
+      # Note that finalized configs cannot be changed.
+      #
+      # @param [String,Symbol] name
+      # @param [Object] value
+      def []=(name, value)
+        public_send(:"#{name}=", value)
+      end
+
+      # Update config with new values
+      #
+      # @param values [Hash] A hash with new values
+      #
+      # @return [Config]
+      #
+      # @api public
+      def update(values)
+        values.each do |key, value|
+          case value
+          when Hash
+            self[key].update(value)
+          else
+            self[key] = value
+          end
+        end
+        self
+      end
+
+      # Dump config into a hash
+      #
+      # @return [Hash]
+      #
+      # @api public
+      def values
+        _settings
+          .map { |setting| [setting.name, setting.value] }
+          .map { |key, value| [key, value.is_a?(self.class) ? value.to_h : value] }
+          .to_h
+      end
+      alias_method :to_h, :values
+      alias_method :to_hash, :values
+
+      # @api private
+      def finalize!
+        _settings.freeze
+        freeze
+      end
+
+      # @api private
+      def pristine
+        self.class.new(_settings.pristine)
+      end
+
+      # @api private
+      def respond_to_missing?(meth, include_private = false)
+        super || _settings.key?(resolve(meth))
+      end
+
+      private
+
+      # @api private
+      def method_missing(meth, *args)
+        setting = _settings[resolve(meth)]
+
+        super unless setting
+
+        if setting.writer?(meth)
+          raise FrozenConfig, 'Cannot modify frozen config' if frozen?
+
+          _settings << setting.with(input: args[0])
+        else
+          setting.value
+        end
+      end
+
+      # @api private
+      def resolve(meth)
+        _resolved.fetch(meth) { _resolved[meth] = meth.to_s.tr('=', '').to_sym }
+      end
+
+      # @api private
+      def initialize_copy(source)
+        super
+        @_settings = source._settings.dup
+      end
+    end
+  end
+end

data/lib/dry/configurable/constants.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require 'dry/core/constants'
+
+module Dry
+  # Shared constants
+  #
+  # @api private
+  module Configurable
+    include Dry::Core::Constants
+  end
+end

data/lib/dry/configurable/dsl.rb

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+
+require 'dry/configurable/constants'
+require 'dry/configurable/setting'
+require 'dry/configurable/settings'
+require 'dry/configurable/compiler'
+require 'dry/configurable/dsl/args'
+
+module Dry
+  module Configurable
+    # Setting DSL used by the class API
+    #
+    # @api private
+    class DSL
+      VALID_NAME = /\A[a-z_]\w*\z/i.freeze
+
+      # @api private
+      attr_reader :compiler
+
+      # @api private
+      attr_reader :ast
+
+      # @api private
+      def initialize(&block)
+        @compiler = Compiler.new
+        @ast = []
+        instance_exec(&block) if block
+      end
+
+      # Register a new setting node and compile it into a setting object
+      #
+      # @see ClassMethods.setting
+      # @api public
+      # @return Setting
+      def setting(name, *args, &block)
+        unless VALID_NAME.match?(name.to_s)
+          raise ArgumentError, "#{name} is not a valid setting name"
+        end
+
+        args = Args.new(args)
+
+        args.ensure_valid_options
+
+        default, opts = args
+
+        node = [:setting, [name.to_sym, default, opts == default ? EMPTY_HASH : opts]]
+
+        if block
+          if block.arity.zero?
+            ast << [:nested, [node, DSL.new(&block).ast]]
+          else
+            ast << [:constructor, [node, block]]
+          end
+        else
+          ast << node
+        end
+
+        compiler.visit(ast.last)
+      end
+    end
+  end
+end

data/lib/dry/configurable/dsl/args.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+require 'dry/configurable/constants'
+require 'dry/configurable/setting'
+
+module Dry
+  module Configurable
+    class DSL
+      # @api private
+      class Args
+        # @api private
+        attr_reader :args
+
+        # @api private
+        attr_reader :size
+
+        # @api private
+        attr_reader :opts
+
+        # @api private
+        def initialize(args)
+          @args = args
+          @size = args.size
+          @opts = Setting::OPTIONS
+        end
+
+        # @api private
+        def ensure_valid_options
+          return unless options
+
+          keys = options.keys - opts
+          raise ArgumentError, "Invalid options: #{keys.inspect}" unless keys.empty?
+        end
+
+        # @api private
+        def to_ary
+          [default, options || EMPTY_HASH]
+        end
+
+        # @api private
+        def default
+          if size.equal?(1) && options.nil?
+            args[0]
+          elsif size > 1 && options
+            args[0]
+          else
+            Undefined
+          end
+        end
+
+        # @api private
+        def options
+          args.detect { |arg| arg.is_a?(Hash) && (opts & arg.keys).any? }
+        end
+      end
+    end
+  end
+end

data/lib/dry/configurable/errors.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Dry
+  # Shared errors
+  #
+  # @api public
+  module Configurable
+    Error = Class.new(::StandardError)
+    FrozenConfig = ::Class.new(Error)
+  end
+end

data/lib/dry/configurable/instance_methods.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+require 'dry/configurable/config'
+require 'dry/configurable/methods'
+
+module Dry
+  module Configurable
+    # Instance-level API when `Dry::Configurable` is included in a class
+    #
+    # @api public
+    module InstanceMethods
+      include Methods
+
+      # Return object's configuration
+      #
+      # @return [Config]
+      #
+      # @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
+      def finalize!
+        return self if frozen?
+
+        super
+        freeze
+      end
+
+      private
+
+      # @api public
+      def initialize_copy(source)
+        super
+        @config = source.config.dup
+      end
+    end
+  end
+end

data/lib/dry/configurable/methods.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+require 'dry/configurable/errors'
+
+module Dry
+  module Configurable
+    # Common API for both classes and instances
+    #
+    # @api public
+    module Methods
+      # @api public
+      def configure(&block)
+        raise FrozenConfig, 'Cannot modify frozen config' if frozen?
+
+        yield(config) if block
+        self
+      end
+
+      # Finalize and freeze configuration
+      #
+      # @return [Dry::Configurable::Config]
+      #
+      # @api public
+      def finalize!
+        return self if config.frozen?
+
+        config.finalize!
+        self
+      end
+    end
+  end
+end

data/lib/dry/configurable/setting.rb

@@ -0,0 +1,130 @@
+# frozen_string_literal: true
+
+require 'set'
+
+require 'dry/equalizer'
+
+require 'dry/configurable/constants'
+require 'dry/configurable/config'
+
+module Dry
+  module Configurable
+    # This class represents a setting and is used internally.
+    #
+    # @api private
+    class Setting
+      include Dry::Equalizer(:name, :value, :options, inspect: false)
+
+      OPTIONS = %i[input default reader constructor settings].freeze
+
+      DEFAULT_CONSTRUCTOR = -> v { v }.freeze
+
+      CLONABLE_VALUE_TYPES = [Array, Hash, Set, Config].freeze
+
+      # @api private
+      attr_reader :name
+
+      # @api private
+      attr_reader :writer_name
+
+      # @api private
+      attr_reader :input
+
+      # @api private
+      attr_reader :default
+
+      # @api private
+      attr_reader :options
+
+      # Specialized Setting which includes nested settings
+      #
+      # @api private
+      class Nested < Setting
+        CONSTRUCTOR = Config.method(:new)
+
+        # @api private
+        def pristine
+          with(input: input.pristine)
+        end
+
+        # @api private
+        def constructor
+          CONSTRUCTOR
+        end
+      end
+
+      # @api private
+      def initialize(name, input: Undefined, default: Undefined, **options)
+        @name = name
+        @writer_name = :"#{name}="
+        @input = input.equal?(Undefined) ? default : input
+        @default = default
+        @options = options
+      end
+
+      # @api private
+      def input_defined?
+        !input.equal?(Undefined)
+      end
+
+      # @api private
+      def value
+        @value ||= evaluate
+      end
+
+      # @api private
+      def evaluated?
+        instance_variable_defined?(:@value)
+      end
+
+      # @api private
+      def nested(settings)
+        Nested.new(name, input: settings, **options)
+      end
+
+      # @api private
+      def pristine
+        with(input: Undefined)
+      end
+
+      # @api private
+      def with(new_opts)
+        self.class.new(name, input: input, default: default, **options, **new_opts)
+      end
+
+      # @api private
+      def constructor
+        options[:constructor] || DEFAULT_CONSTRUCTOR
+      end
+
+      # @api private
+      def reader?
+        options[:reader].equal?(true)
+      end
+
+      # @api private
+      def writer?(meth)
+        writer_name.equal?(meth)
+      end
+
+      # @api private
+      def clonable_value?
+        CLONABLE_VALUE_TYPES.any? { |type| value.is_a?(type) }
+      end
+
+      private
+
+      # @api private
+      def initialize_copy(source)
+        super
+        @value = source.value.dup if source.input_defined? && source.clonable_value?
+        @options = source.options.dup
+      end
+
+      # @api private
+      def evaluate
+        @value = constructor[input.equal?(Undefined) ? nil : input]
+      end
+    end
+  end
+end

data/lib/dry/configurable/settings.rb

@@ -0,0 +1,72 @@
+# frozen_string_literal: true
+
+require 'concurrent/map'
+
+require 'dry/equalizer'
+require 'dry/configurable/constants'
+
+module Dry
+  module Configurable
+    # A settings map
+    #
+    # @api private
+    class Settings
+      include Dry::Equalizer(:elements)
+
+      include Enumerable
+
+      # @api private
+      attr_reader :elements
+
+      # @api private
+      def initialize(elements = EMPTY_ARRAY)
+        initialize_elements(elements)
+      end
+
+      # @api private
+      def <<(setting)
+        elements[setting.name] = setting
+        self
+      end
+
+      # @api private
+      def [](name)
+        elements[name]
+      end
+
+      # @api private
+      def key?(name)
+        keys.include?(name)
+      end
+
+      # @api private
+      def keys
+        elements.keys
+      end
+
+      # @api private
+      def each(&block)
+        elements.values.each(&block)
+      end
+
+      # @api private
+      def pristine
+        self.class.new(map(&:pristine))
+      end
+
+      private
+
+      # @api private
+      def initialize_copy(source)
+        initialize_elements(source.map(&:dup))
+      end
+
+      # @api private
+      def initialize_elements(elements)
+        @elements = elements.each_with_object(Concurrent::Map.new) { |s, m|
+          m[s.name] = s
+        }
+      end
+    end
+  end
+end

data/lib/dry/configurable/test_interface.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module Dry
+  module Configurable
+    # Methods meant to be used in a testing scenario
+    module TestInterface
+      # Resets configuration to default values
+      #
+      # @return [Dry::Configurable::Config]
+      #
+      # @api public
+      def reset_config
+        @config = config.pristine
+      end
+    end
+
+    # Mixes in test interface into the configurable module
+    #
+    # @api public
+    def enable_test_interface
+      extend Dry::Configurable::TestInterface
+    end
+  end
+end

data/lib/dry/configurable/version.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module Dry
+  module Configurable
+    # @api public
+    VERSION = '0.11.5'
+  end
+end

metadata

@@ -0,0 +1,156 @@
+--- !ruby/object:Gem::Specification
+name: dry-configurable
+version: !ruby/object:Gem::Version
+  version: 0.11.5
+platform: ruby
+authors:
+- Andy Holland
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2020-03-23 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: concurrent-ruby
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: dry-core
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.4'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.4.7
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.4'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.4.7
+- !ruby/object:Gem::Dependency
+  name: dry-equalizer
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  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: rake
+  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: rspec
+  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'
+description: A mixin to add configuration functionality to your classes
+email:
+- andyholland1991@aol.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE
+- README.md
+- dry-configurable.gemspec
+- lib/dry-configurable.rb
+- lib/dry/configurable.rb
+- lib/dry/configurable/class_methods.rb
+- lib/dry/configurable/compiler.rb
+- lib/dry/configurable/config.rb
+- lib/dry/configurable/constants.rb
+- lib/dry/configurable/dsl.rb
+- lib/dry/configurable/dsl/args.rb
+- lib/dry/configurable/errors.rb
+- lib/dry/configurable/instance_methods.rb
+- lib/dry/configurable/methods.rb
+- lib/dry/configurable/setting.rb
+- lib/dry/configurable/settings.rb
+- lib/dry/configurable/test_interface.rb
+- lib/dry/configurable/version.rb
+homepage: https://dry-rb.org/gems/dry-configurable
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+  changelog_uri: https://github.com/dry-rb/dry-configurable/blob/master/CHANGELOG.md
+  source_code_uri: https://github.com/dry-rb/dry-configurable
+  bug_tracker_uri: https://github.com/dry-rb/dry-configurable/issues
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.4.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.0.3
+signing_key: 
+specification_version: 4
+summary: A mixin to add configuration functionality to your classes
+test_files: []