mixlib-config 2.2.11 → 2.2.12

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c764853ffe7576f6b9568775541cc9358cc6a392a26997af52ae0c9dcde1611e
-  data.tar.gz: 19713a0e41d1c407510483d11df8f6ac83e8645d5607890b5b7181fcf0e51689
+  metadata.gz: e49d199c25ed417933cc95a2868d154e4f0fbc631aef9d1c5f05310ebbdbbe56
+  data.tar.gz: 4307e6ce5ff263812c96055084d328901587139f82ca213a2ec1272208931150
 SHA512:
-  metadata.gz: 99c7c6639a2f2a1de69db7970d99ea5ca2a54fba04ac544967aba9a1552f3541a856b4d447098ee73364ac1094da33e7d5bdda92a87296e19d1d2dbbc5656ae2
-  data.tar.gz: 95be61fa365942dc7a0a7a1d1bcc5b0eff1e9a362ed9207a138e1dc362a7051c8a546d6b1bc1c2a40113bf93d83571a2fde96473ae1fe576e013faa0bdc3c78e
+  metadata.gz: cdfcc6a831af4bd63216614a7e191152cd5f9dee67e7e87a2775d5d7c766b7c6e8f667ec45062400688e2cc746e2936041087f4e1de85e72f91b10c71c7a36de
+  data.tar.gz: ac0b067a839675c594663b0fa5a91cd66059dc807775dfaacceae62f77efb975d3f26db0ca1781571bfd73c97c5b09bea921fe04fc7e0cf3af48e617917241f5

data/README.md

@@ -248,6 +248,18 @@ This allows the user to quickly specify a number of values with one default, whi
   print_network_requests false
 ```
 
+You can also inspect if the values are still their defaults or not:
+
+```ruby
+MyConfig.is_default?(:verbosity)  # == true
+MyConfig[:verbosity] = 5
+MyConfig.is_default?(:verbosity)  # == false
+MyConfig[:verbosity] = 1
+MyConfig.is_default?(:verbosity)  # == true
+```
+
+Trying to call `is_default?` on a config context or a config which does not have a declared default is an error and will raise.
+
 ## Strict Mode
 
 Misspellings are a common configuration problem, and Mixlib::Config has an answer: `config_strict_mode`. Setting `config_strict_mode` to `true` will cause any misspelled or incorrect configuration option references to throw `Mixlib::Config::UnknownConfigOptionError`.

data/lib/mixlib/config.rb

@@ -158,6 +158,15 @@ module Mixlib
 
     alias_method :has_key?, :key?
 
+    def is_default?(key)
+      symbol = key.to_sym
+      if configurables.has_key?(symbol)
+        configurables[symbol].is_default?(configuration)
+      else
+        raise ArgumentError, "config option must exist, and not be a context to check for default values"
+      end
+    end
+
     # Resets a config option to its default.
     #
     # === Parameters

data/lib/mixlib/config/configurable.rb

@@ -1,6 +1,6 @@
 #
 # Author:: John Keiser (<jkeiser@chef.io>)
-# Copyright:: Copyright (c) 2013-2016 Chef Software, Inc.
+# Copyright:: Copyright (c) 2013-2018, Chef Software Inc.
 # License:: Apache License, Version 2.0
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
@@ -19,20 +19,31 @@
 module Mixlib
   module Config
     class Configurable
+      attr_reader :symbol
+      attr_reader :default_value
+      attr_reader :default_block
+
       def initialize(symbol)
         @symbol = symbol
-        @default_block = nil
-        @has_default = false
-        @default_value = nil
-        @writes_value = nil
       end
 
-      attr_reader :has_default
+      def has_default?
+        instance_variable_defined?(:@default_value)
+      end
+
+      def writes_value?
+        instance_variable_defined?(:@writes_value)
+      end
+
+      def default_block?
+        instance_variable_defined?(:@default_block)
+      end
+
+      alias_method :has_default, :has_default?
 
       def defaults_to(default_value = nil, &block)
-        @has_default = true
-        @default_block = block
         @default_value = default_value
+        @default_block = block if block_given?
         self
       end
 
@@ -42,32 +53,38 @@ module Mixlib
       end
 
       def get(config)
-        if config.has_key?(@symbol)
-          config[@symbol]
-        elsif @default_block
-          @default_block.call
+        if config.key?(symbol)
+          config[symbol]
+        elsif default_block?
+          default_block.call
         else
-          begin
-            # Some things cannot be dup'd, and you won't know this till after the fact
-            # because all values implement dup
-            config[@symbol] = @default_value.dup
-          rescue TypeError
-            @default_value
-          end
+          config[symbol] = safe_dup(default_value)
         end
       end
 
       def set(config, value)
-        config[@symbol] = @writes_value ? @writes_value.call(value) : value
+        config[symbol] = writes_value? ? @writes_value.call(value) : value
       end
 
       def default
-        if @default_block
-          @default_block.call
+        if default_block?
+          default_block.call
         else
-          @default_value
+          default_value
         end
       end
+
+      def is_default?(config)
+        !config.key?(symbol) || config[symbol] == default_value
+      end
+
+      private
+
+      def safe_dup(e)
+        e.dup
+      rescue TypeError
+        e
+      end
     end
   end
 end

data/lib/mixlib/config/version.rb

@@ -19,7 +19,7 @@
 module Mixlib
   module Config
 
-    VERSION = "2.2.11"
+    VERSION = "2.2.12"
 
   end
 end

data/spec/mixlib/config_spec.rb

@@ -235,6 +235,23 @@ describe Mixlib::Config do
       expect(@klass.respond_to?("z=".to_sym)).to be false
     end
 
+    it "returns true for is_default? for a default value" do
+      expect(@klass[:a]).to eql(1)
+      expect(@klass.is_default?(:a)).to be true
+    end
+
+    it "returns true for is_default? for an overwritten default value" do
+      @klass[:a] = 1
+      expect(@klass[:a]).to eql(1)
+      expect(@klass.is_default?(:a)).to be true
+    end
+
+    it "returns false for is_default? for a value that is not the default" do
+      @klass[:a] = 2
+      expect(@klass[:a]).to eql(2)
+      expect(@klass.is_default?(:a)).to be false
+    end
+
     describe "and extra methods have been dumped into Object" do
       class NopeError < StandardError
       end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: mixlib-config
 version: !ruby/object:Gem::Version
-  version: 2.2.11
+  version: 2.2.12
 platform: ruby
 authors:
 - Chef Software, Inc.
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-07-02 00:00:00.000000000 Z
+date: 2018-07-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: tomlrb