lazier 3.2.7 → 3.3.0

data/doc/top-level-namespace.html

@@ -103,7 +103,7 @@
 </div>
 
     <div id="footer">
-  Generated on Sat Jul 20 12:56:18 2013 by
+  Generated on Sat Jul 20 13:22:19 2013 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.6.2 (ruby-1.9.3).
 </div>

data/lib/lazier/hash.rb

@@ -8,5 +8,13 @@ module Lazier
   # Extensions for Hash objects.
   module Hash
     extend ::ActiveSupport::Concern
+
+    # Makes sure that the keys of the hash are accessible in the desired way.
+    #
+    # @param access [Symbol|NilClass] The requested access for the keys. Can be `:strings`, `:symbols` or `:indifferent`. If `nil` the keys are not modified.
+    def ensure_access(access)
+      method = {strings: :stringify_keys, symbols: :symbolize_keys, indifferent: :with_indifferent_access}.fetch(access, nil)
+      method ? send(method) : self
+    end
   end
 end

data/lib/lazier/object.rb

@@ -90,10 +90,13 @@ module Lazier
 
     # Makes sure that the object is an hash. For non hash objects, return an hash basing on the `default_value` parameter.
     #
-    # @param default_value [Hash|Object|NilClass] The default value to use. If it is an `Hash`, it is returned as value otherwise it is used to build as a key to build an hash with the current object as only value (everything but strings and symbols are mapped to `key`).
+    # @param access [Symbol|NilClass] The requested access for the keys of the returned object. Can be `:strings`, `:symbols` or `indifferent`. If `nil` the keys are not modified.
+    # @param default_value [Hash|String|Symbol|NilClass] The default value to use. If it is an `Hash`, it is returned as value otherwise it is used to build as a key to build an hash with the current object as only value (everything but strings and symbols are mapped to `key`). Passing `nil` is equal to pass an empty Hash.
     # @param sanitizer [Symbol|nil] If not `nil`, the method to use to sanitize values of the hash. *Ignored if a block is present.*
     # @return [Hash] If the object is an hash, then the object itself, a hash with the object as single value otherwise.
-    def ensure_hash(default_value = {}, sanitizer = nil)
+    def ensure_hash(access = nil, default_value = nil, sanitizer = nil)
+      default_value = {} if default_value.nil?
+
       rv = if is_a?(::Hash) then
         self
       elsif default_value.is_a?(::Hash) then
@@ -104,13 +107,13 @@ module Lazier
       end
 
       if block_given? || sanitizer then
-        rv.inject({}) {|h, (k, v)|
+        rv = rv.inject({}) {|h, (k, v)|
           h[k] = block_given? ? yield(v) : v.send(sanitizer)
           h
         }
-      else
-        rv
       end
+
+      rv.ensure_access(access)
     end
 
     # Converts the object to a boolean.

data/lib/lazier/settings.rb

@@ -88,7 +88,7 @@ module Lazier
     def setup_date_formats(formats = nil, replace = false)
       @date_formats = HashWithIndifferentAccess.new if replace || !@date_formats
 
-      @date_formats.merge!(formats.ensure_hash({ct_date: "%Y-%m-%d", ct_time: "%H:%M:%S", ct_date_time: "%F %T", ct_iso_8601: "%FT%T%z" }))
+      @date_formats.merge!(formats.ensure_hash(nil, {ct_date: "%Y-%m-%d", ct_time: "%H:%M:%S", ct_date_time: "%F %T", ct_iso_8601: "%FT%T%z" }))
       ::Time::DATE_FORMATS.merge!(@date_formats)
 
       @date_formats

data/lib/lazier/version.rb

@@ -13,10 +13,10 @@ module Lazier
     MAJOR = 3
 
     # The minor version.
-    MINOR = 2
+    MINOR = 3
 
     # The patch version.
-    PATCH = 7
+    PATCH = 0
 
     # The current version of lazier.
     STRING = [MAJOR, MINOR, PATCH].compact.join(".")

data/spec/lazier/hash_spec.rb

@@ -26,4 +26,17 @@ describe Lazier::Hash do
       expect(reference["b"]["f"]).to eq(4)
     end
   end
+
+  describe "#ensure_access" do
+    it "should make sure that the requested access is granted" do
+      expect({"a" => "b"}.ensure_access(:strings)).to eq({"a" => "b"})
+      expect({"a" => "b"}.ensure_access(:symbols)).to eq({a: "b"})
+      expect({"a" => "b"}.ensure_access(:indifferent)).to be_a(::HashWithIndifferentAccess)
+      expect({"a" => "b"}.ensure_access(:other)).to eq({"a" => "b"})
+      expect({a: "b"}.ensure_access(:strings)).to eq({"a" => "b"})
+      expect({a: "b"}.ensure_access(:symbols)).to eq({a: "b"})
+      expect({a: "b"}.ensure_access(:indifferent)).to be_a(::HashWithIndifferentAccess)
+      expect({a: "b"}.ensure_access(:other)).to eq({a: "b"})
+    end
+  end
 end

data/spec/lazier/object_spec.rb

@@ -162,17 +162,24 @@ describe Lazier::Object do
   describe "#ensure_hash" do
     it "should return an hash" do
       expect({a: "b"}.ensure_hash).to eq({a: "b"})
-      expect(nil.ensure_hash({a: "b"})).to eq({a: "b"})
+      expect(nil.ensure_hash(nil, {a: "b"})).to eq({a: "b"})
 
       expect(1.ensure_hash).to eq({})
-      expect(1.ensure_hash(:test)).to eq({test: 1})
-      expect(1.ensure_hash("test")).to eq({"test" => 1})
-      expect(1.ensure_hash(2)).to eq({key: 1})
+      expect(1.ensure_hash(nil, :test)).to eq({test: 1})
+      expect(1.ensure_hash(nil, "test")).to eq({"test" => 1})
+      expect(1.ensure_hash(nil, 2)).to eq({key: 1})
     end
 
     it "should sanitize values" do
-      expect(" 1 ".ensure_hash(nil, &:strip)).to eq({key: "1"})
-      expect(1.ensure_hash(nil) { |v| v * 2 }).to eq({key: 2})
+      expect(" 1 ".ensure_hash(nil, :key, &:strip)).to eq({key: "1"})
+      expect(1.ensure_hash(nil, :key) { |v| v * 2 }).to eq({key: 2})
+    end
+
+    it "should grant access" do
+      reference = {a: "b"}
+
+      expect(reference).to receive(:ensure_access).with("ACCESS")
+      reference.ensure_hash("ACCESS")
     end
   end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: lazier
 version: !ruby/object:Gem::Version
-  version: 3.2.7
+  version: 3.3.0
   prerelease: 
 platform: ruby
 authors:
@@ -191,7 +191,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: -1967236641489505845
+      hash: 1071624567568461025
 requirements: []
 rubyforge_project: lazier
 rubygems_version: 1.8.25