configurate 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: b1c77311fcc9be9b8545a349cb8a9352fac266ba
-  data.tar.gz: 23cc86a4bc3e0edad45c756eb77a27a97628cb3c
+  metadata.gz: 996d3e9be532044af0c5ab4597eb547661683c3b
+  data.tar.gz: 2e9b90ac7a188be0c8624fcd5e52619b7f267b53
 SHA512:
-  metadata.gz: 0f9b04ce701034847ce8d337093a692bae175e75c8b68b30de0260bfe20520350f6d0112a0423df972d564321b23b4a91a35160d1186899fef1c3d2f61f64388
-  data.tar.gz: f48dbe835f2cb4b2102d8090a1b030612b19f52a7b2b23d517eb6cbc7bc748304a6cac4a1a6826eb90367ad77e73e783735b7bb9be02901766c8a5ea1680bf43
+  metadata.gz: 0c51c9bc229cff96e092dee805cb4f4517cdc315831b79f65b46253687b692a2db562278bb7831178433ff2768d403a4eb7c7151c9859b8884dd8e1413b08157
+  data.tar.gz: e3af9cf48b009e97fe81cd7fcbee2d5e55586d6aff33a45be88b562d9115c69a4b1157af12d52d525dc6e06d866b49586ba04576b72613e37b1a9b39649c69c5

checksums.yaml.gz.asc

@@ -1,11 +1,11 @@
 -----BEGIN PGP SIGNATURE-----
 Version: GnuPG v2
 
-iQEcBAABAgAGBQJUJcgAAAoJEPNH4OtHrHDWwu0IAIPCkoGVvTACKyK1T3wq/1MY
-/Ea17MjRfBzNZ4vagFJd8LZAIf58ZFGYPiFhvZim26o7WVIf6BGUNDQUDC+CKAg6
-iFXfbPjXXjuB3v1mylZ81ZWcfkyClda2T95LHdsdJ52s/ciar2L1QvngM/MR1+Vr
-5nmnBS9OFA3/OsQVJKWi1oKClfz4RLFCcI16Y3gyH9WrsLFlCr2McJ/lTr6U/D8x
-XLrUEcMMYWK7G7qc0C9WKD7+Y/lVLpjZSWElC+Mm9dGpK0Q5K01RbU2zd8O15uDM
-ycwtvFvOnwdKjTRUx/m+LH5ey42nawOgtFhbmDmdwfJwo0gUTtqVvltNGnqgxKo=
-=ryWj
+iQEcBAABAgAGBQJULyg7AAoJEPNH4OtHrHDWLzkIAIwwqTjkZlNOPS2D7tUOcNJY
+ZF/zxymbrSL9yjzXwvYExgKy2i1xV5LrWpWP/mCiX9RX2eLxv8LcQGlWKupCwMc9
+2ca/yy1wziXLhLY6zJhWF5j6WNOfRlJTGaAUPSHtbCeT9WOjbpnDWfWTDZKNuonb
+i1HPUCZPx+YAXb6Gzgl39FcCH1UgEZy3D3ijc3FCSHigfnwSEDcjCwQtQuMedwNu
+l1/V5UdTPDiWPBxeGMucyZLBKdN8r70wfgNKvDZ1XHolO+9HUOsmcS6St1P5OpUp
+dJ25Tm3ACv+uydyQLr/e2bPJs+Lm901rKUMb+gIozoQCYMTRnpAoNMVNqK+KRBI=
+=+ZIR
 -----END PGP SIGNATURE-----

data.tar.gz.asc

@@ -1,11 +1,11 @@
 -----BEGIN PGP SIGNATURE-----
 Version: GnuPG v2
 
-iQEcBAABAgAGBQJUJcgAAAoJEPNH4OtHrHDW6fEH/1cAw0GslySQkuKPc2SvjC5r
-hc3rYNdp7P7RA+a4liD9d/qRjCYWvkV1/dg57B2/PouXT/e/D9+cCvRpgtu1E3lv
-Oecgh+mV/jR7mxfwr4xdLjGX0JajP/VnI/IEcxjLi7ht3tYkztdRACNhIzfjCqdc
-cGyV3dAbmt3bflf85YbDAUcQkkwnFOLCZQUfepgxjgv1/BBBEKXp68+5wge2q2co
-+yTmV6LXU+2B8hwDwJpjB1V6lxJKh61gwK3zNexqsYLGn5C7SjxSBdObvs2wCAAR
-9XdG9pkpavHEiYBBXQe5zjDUIWRGIP+Y2/tfVTr74sQ76k7Q4bDSAovoVUwhVQs=
-=4Tkj
+iQEcBAABAgAGBQJULyg7AAoJEPNH4OtHrHDWgO0H/jLKCQPi2kguHzfJU/k4hII8
+VITtYbNZb4ZBbHecgiam4mI+m5EvDCfQu3KEzSN3w06czUoVFW0uCABJkAqb43He
+EvITE2z36GKFb8GqfA5EXnRPjmsGTvH8EnUG8DetTRNjFkERvNSi6t3RxgfNQ8yw
+UFwtascrsmM5vjzCvgRlJ0cm1HA3LZFqoEyw/MovOLDviLTz1ECKqxNmaEULdhp9
+Fb10e5Y9XalRbbF6wSOKWp06owiEcTVY/lqNOZBJ+ZIG1RQUD73yhAGW2b7bM6rg
+tiBEAal1Tt6c5v5SvucCcMrKxd3R8CXCtwETQVFl4rxB4eYhSgx0PkFiQ3OPicY=
+=hJkd
 -----END PGP SIGNATURE-----

data/Changelog.md

@@ -1,3 +1,10 @@
+# 0.2.0
+
+* Dynamic provider listens to reset_dynamic! message and forgets all settings on it.
+* Calls ending in ! call the providers directly.
+* Added SettingPath#action?, remove is_ prefix from SettingPath methods.
+* Add implicit converters to Proxy that call the explicit converters.
+
 # 0.1.0
 
 * Dynamic provider resolves nested assignments

data/README.md

@@ -80,7 +80,7 @@ Ruby does not allow to metaprogram `false`, thus something like
 puts "yep" if Config.enable_stuff
 ```
 
-always outputs `yep`. The workaround is to append `.get` or `?` to get the
+always outputs `yep`. The workaround is to append `.get`, or `?` to get the
 real value:
 
 ```ruby
@@ -156,14 +156,15 @@ the following optional parameters, as a hash:
 
 ### Configurate::Provider::Dynamic
 
-A provider which stores the first additonal parameter if the query string ends with an equal sign and can
-return it later. This is mainly useful for testing but can be useful to temporarily overide stuff
-too. To clarify a small example:
+A provider which stores the first additional parameter if the query string ends with an equal sign and can
+return it later. This is mainly useful for testing but can be useful to temporarily override stuff too. To clarify a small example:
 
 ```ruby
 Config.foo.bar         # => nil
 Config.foo.bar = "baz"
 Config.foo.bar         # => "baz"
+Config.reset_dynamic!
+Config.foo.bar         # => nil
 ```
 
 ## Writing a provider

data/lib/configurate/lookup_chain.rb

@@ -5,7 +5,7 @@ module Configurate
     def initialize
       @provider = []
     end
-    
+
     # Adds a provider to the chain. Providers are tried in the order
     # they are added, so the order is important.
     #
@@ -17,11 +17,11 @@ module Configurate
       unless provider.respond_to?(:instance_methods) && provider.instance_methods.include?(:lookup)
         raise ArgumentError, "the given provider does not respond to lookup"
       end
-      
+
       @provider << provider.new(*args)
     end
-    
-    
+
+
     # Tries all providers in the order they were added to provide a response
     # for setting.
     #
@@ -37,13 +37,13 @@ module Configurate
           return special_value_or_string(provider.lookup(setting.clone, *args))
         rescue SettingNotFoundError; end
       end
-      
+
       nil
     end
     alias_method :[], :lookup
-    
-    private 
-    
+
+    private
+
     def special_value_or_string(value)
       if [TrueClass, FalseClass, NilClass, Array, Hash].include?(value.class)
         return value

data/lib/configurate/provider/dynamic.rb

@@ -2,14 +2,21 @@ module Configurate; module Provider
   # This provider knows nothing upon initialization, however if you access
   # a setting ending with +=+ and give one argument to that call it remembers
   # that setting, stripping the +=+ and will return it on the next call
-  # without +=+.
+  # without +=+. Sending +reset_dynamic!+ to it will make it forget all
+  # settings. Also assigning nil will have the effect of it forgetting
+  # a setting.
   class Dynamic < Base
     def initialize
       @settings = {}
     end
 
     def lookup_path(setting_path, *args)
-      if setting_path.is_setter? && args.length > 0
+      if setting_path.to_s == "reset_dynamic!"
+        @settings = {}
+        return
+      end
+
+      if setting_path.setter? && args.length > 0
         value = args.first
         value = value.get if value.respond_to?(:_proxy?) && value._proxy?
         *root, key = setting_path.to_a

data/lib/configurate/proxy.rb

@@ -18,40 +18,53 @@ module Configurate
       @lookup_chain = lookup_chain
       @setting_path = SettingPath.new
     end
-    
+
     def !
       !target
     end
-    
-    [:!=, :==, :eql?].each do |method|
+
+    [:!=, :==, :eql?, :coerce].each do |method|
       define_method method do |other|
         target.public_send method, target_or_object(other)
       end
     end
-    
+
+    {
+      :to_int => :to_i,
+      :to_hash => :to_h,
+      :to_str => :to_s,
+      :to_ary => :to_a
+    }.each do |method, converter|
+      define_method method do
+        value = target
+        return value.public_send converter if value.respond_to? converter
+        value.public_send method
+      end
+    end
+
     def _proxy?
       true
     end
-    
+
     def respond_to? method, include_private=false
       method == :_proxy? || target_respond_to?(method, include_private)
     end
-    
+
     def send *args, &block
       __send__(*args, &block)
     end
     alias_method :public_send, :send
-    
+
     def method_missing setting, *args, &block
       return target.public_send(setting, *args, &block) if target_respond_to? setting
 
       @setting_path << setting
-      
-      return target(*args) if @setting_path.is_question_or_setter?
-      
+
+      return target(*args) if @setting_path.question_action_or_setter?
+
       self
     end
-    
+
     # Get the setting at the current path, if found.
     # (see LookupChain#lookup)
     def target *args
@@ -60,7 +73,7 @@ module Configurate
       @lookup_chain.lookup @setting_path, *args
     end
     alias_method :get, :target
-    
+
     private
     COMMON_KEY_NAMES = [:key, :method]
 

data/lib/configurate/setting_path.rb

@@ -19,17 +19,22 @@ module Configurate
     def_delegators :@path, :empty?, :length, :size, :hsh
 
     # Whether the current path looks like a question or setter method
-    def is_question_or_setter?
-      is_question? || is_setter?
+    def question_action_or_setter?
+      question? || action? || setter?
     end
 
     # Whether the current path looks like a question method
-    def is_question?
+    def question?
       @path.last.to_s.end_with?("?")
     end
 
+    # Whether the current path looks like an action method
+    def action?
+      @path.last.to_s.end_with?("!")
+    end
+
     # Whether the current path looks like a setter method
-    def is_setter?
+    def setter?
       @path.last.to_s.end_with?("=")
     end
 
@@ -61,7 +66,7 @@ module Configurate
     end
 
     def inspect
-      "<SettingPath:#{object_id.to_s(16)} path=#{to_s}:#{@path.object_id.to_s(16)} setter=#{is_setter?} question=#{is_question?}>"
+      "<SettingPath:#{object_id.to_s(16)} path=#{to_s}:#{@path.object_id.to_s(16)} question=#{question?} action=#{action?} setter=#{setter?}>"
     end
 
     private

data/spec/configurate/provider/dynamic_spec.rb

@@ -23,5 +23,11 @@ describe Configurate::Provider::Dynamic do
       subject.lookup_path Configurate::SettingPath.new(["find_me", "later="]), {"a" => "b"}
       expect(subject.lookup_path Configurate::SettingPath.new(["find_me", "later", "a"])).to eq "b"
     end
+
+    it "clears out all overrides on reset_dynamic!" do
+      subject.lookup_path Configurate::SettingPath.new(["find_me", "later="]), "there"
+      subject.lookup_path Configurate::SettingPath.new(["reset_dynamic!"])
+      expect(subject.lookup_path Configurate::SettingPath.new(["find_me", "later"]) ).to_not eq "there"
+    end
   end
 end

data/spec/configurate/proxy_spec.rb

@@ -6,7 +6,7 @@ describe Configurate::Proxy do
 
   describe "in case statements" do
     it "acts like the target" do
-      pending "If anyone knows a way to overwrite ===, please tell me :P"
+      pending "If anyone knows a sane way to overwrite Module#===, please tell me :P"
       result = case proxy
                when String
                 "string"
@@ -23,6 +23,11 @@ describe Configurate::Proxy do
       proxy.method_missing(:enable?)
     end
 
+    it "calls #target if the method ends with a !" do
+      expect(lookup_chain).to receive(:lookup).and_return(false)
+      proxy.method_missing(:do_it!)
+    end
+
     it "calls #target if the method ends with a =" do
       expect(lookup_chain).to receive(:lookup).and_return(false)
       proxy.method_missing(:url=)
@@ -49,7 +54,7 @@ describe Configurate::Proxy do
   end
 
   describe "#target" do
-    [:to_str, :to_s, :to_xml, :respond_to?, :present?, :!=, :eql?,
+    [:to_s, :to_xml, :respond_to?, :present?, :!=, :eql?,
      :each, :try, :size, :length, :count, :==, :=~, :gsub, :blank?, :chop,
      :start_with?, :end_with?].each do |method|
       it "is called for accessing #{method} on the proxy" do
@@ -72,5 +77,25 @@ describe Configurate::Proxy do
     it "returns nil if no setting is given" do
       expect(proxy.target).to be_nil
     end
+
+    it "converts to a string" do
+      allow(lookup_chain).to receive(:lookup).and_return("bar")
+      expect("foo"+proxy.something).to eq "foobar"
+    end
+
+    it "converts to a number" do
+      allow(lookup_chain).to receive(:lookup).and_return(1)
+      expect(2+proxy.something).to eq 3
+    end
+
+    it "converts to an array" do
+      allow(lookup_chain).to receive(:lookup).and_return([1, 2])
+      expect([:a, :b].zip(proxy.something)).to eq [[:a, 1], [:b, 2]]
+    end
+
+    it "converts to a hash" do
+      allow(lookup_chain).to receive(:lookup).and_return({:a => :b})
+      expect({c: :d}.merge(proxy.something)).to eq({:a => :b, :c => :d})
+    end
   end
 end

data/spec/configurate/setting_path_spec.rb

@@ -3,6 +3,7 @@ require 'spec_helper'
 describe Configurate::SettingPath do
   let(:normal_path) { described_class.new([:foo]) }
   let(:question_path) { described_class.new([:foo?]) }
+  let(:action_path) { described_class.new([:foo!]) }
   let(:setter_path) { described_class.new([:foo=]) }
   let(:long_path) { described_class.new(["foo", "bar?"]) }
 
@@ -14,26 +15,38 @@ describe Configurate::SettingPath do
     end
   end
 
-  describe "#is_question?" do
+  describe "#question?" do
     context "with a question signature as setting" do
-      subject { question_path.is_question? }
+      subject { question_path.question? }
       it { should be_truthy }
     end
 
     context "with a normal path as setting" do
-      subject { normal_path.is_question? }
+      subject { normal_path.question? }
       it { should be_falsey }
     end
   end
 
-  describe "#is_setter?" do
+  describe "#action?" do
+    context "with a action signature as setting" do
+      subject { action_path.action? }
+      it { should be_truthy }
+    end
+
+    context "with a normal path as setting" do
+      subject { normal_path.action? }
+      it { should be_falsey }
+    end
+  end
+
+  describe "#setter?" do
     context "with a setter signature as setting" do
-      subject { setter_path.is_setter? }
+      subject { setter_path.setter? }
       it { should be_truthy }
     end
 
     context "with a normal path as setting" do
-      subject { normal_path.is_setter? }
+      subject { normal_path.setter? }
       it { should be_falsey }
     end
   end
@@ -49,19 +62,24 @@ describe Configurate::SettingPath do
   end
 
 
-  describe "#is_question_or_setter?" do
+  describe "#question_action_or_setter?" do
     context "with a question signature as setting" do
-      subject { question_path.is_question_or_setter? }
+      subject { question_path.question_action_or_setter? }
+      it { should be_truthy }
+    end
+
+    context "with an action signature as setting" do
+      subject { action_path.question_action_or_setter? }
       it { should be_truthy }
     end
 
     context "with a setter signature as setting" do
-      subject { setter_path.is_question_or_setter? }
+      subject { setter_path.question_action_or_setter? }
       it { should be_truthy }
     end
 
     context "with a normal path as setting" do
-      subject { normal_path.is_question_or_setter? }
+      subject { normal_path.question_action_or_setter? }
       it { should be_falsey }
     end
   end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: configurate
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Jonne Haß
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-09-26 00:00:00.000000000 Z
+date: 2014-10-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake

metadata.gz.asc

@@ -1,11 +1,11 @@
 -----BEGIN PGP SIGNATURE-----
 Version: GnuPG v2
 
-iQEcBAABAgAGBQJUJcgAAAoJEPNH4OtHrHDWGi0H/1bZoFxs/WNJhIvM/NciG/lx
-VNgn9R/R46sRZqjCU4EXUAicWAOggNhF78d6XAbdQJSE2aiokBxQrE/tci6q4iDU
-I1LLbcahSmZle9fR2JsUpGtT7A8hyKYpCDUjUG7TY2Ktfas9qL1GEsDtPKVjmQNS
-l0GTg1JQ7XZHSkRAdBWHn9geGnQBQ7AqAqREIK/6+zSAaN7QNtBijIg9h4EyBWXb
-SDZILyvkgj6bt+eE+o32jrNleLMfJbGU9zlNl92l4O1bb5TspUKwq9JkpSR4ZRzd
-jkt5H+gXfwF0/zltejfLlkp50fwF3XnWgy9cEAh/BNTVPzT0HgfJzq3YBPlM7Vo=
-=QI26
+iQEcBAABAgAGBQJULyg7AAoJEPNH4OtHrHDWD0IH/0e90hWnDOQqWhUnKY3JM+gf
+wOdHXiyB4p7cPIoO6QFsZq0Mm4t+bYLADI3adDq9kQAtIjo6s3jUJzK84QNjnsNS
+8Sc1OWNFYLrMVi/7rkJfyjiV6rMHYyB9O76vxH3w7/CZAl7fscadF4BW1PTqcti8
+z4IoXtBs5KVxk1U3vtpPLaYitYIx/mc2voL0Z5wEuMeBhTYHjx4XraLrNzuSh6yN
+cRnItaD70Z2uIvRF6bSyazDLWEO2cUfH/kTjsjHja4xwa4yYm3/ZkFZ2YZAXJNvU
+P5mtnv5cCcJKZy1uNKV5DRj9zATL+yrzgSaSKV1O9BPW7zL3eHeu156TOxIRW48=
+=sUo3
 -----END PGP SIGNATURE-----