lazier 3.3.10 → 3.4.0

data/doc/top-level-namespace.html

@@ -103,9 +103,9 @@
 </div>
 
     <div id="footer">
-  Generated on Mon Dec  2 15:35:19 2013 by
+  Generated on Sat Jan 25 11:01:53 2014 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
-  0.8.7.3 (ruby-2.0.0).
+  0.8.7.3 (ruby-2.1.0).
 </div>
 
   </body>

data/lazier.gemspec

@@ -25,9 +25,9 @@ Gem::Specification.new do |gem|
 
   gem.required_ruby_version = ">= 1.9.3"
 
-  gem.add_dependency("json", "~> 1.8.0")
+  gem.add_dependency("json", "~> 1.8.1")
   gem.add_dependency("activesupport", ">= 3.2.13") # We don't use ~> to enable use with 4.0
   gem.add_dependency("tzinfo", ">= 0.3.37") # We don't use ~> to enable use with 0.3.37 (required by activesupport 4.0) and 1.x, which is the latest available
-  gem.add_dependency("r18n-desktop", "~> 1.1.5")
+  gem.add_dependency("r18n-desktop", "~> 1.1.7")
   gem.add_dependency("hashie", "~> 2.0.5")
 end

data/lib/lazier/hash.rb

@@ -9,12 +9,49 @@ module Lazier
   module Hash
     extend ::ActiveSupport::Concern
 
+    # Returns a new hash, removing all keys which values are blank.
+    #
+    # @param validator [Proc], if present all the keys which evaluates to true will be removed. Otherwise all blank values will be removed.
+    # @return [Hash] The hash with all blank values removed.
+    def compact(&validator)
+      validator ||= ->(_, v) { v.blank? }
+      reject(&validator)
+    end
+
+    # Compacts the current hash, removing all keys which values are blank.
+    #
+    # @param validator [Proc], if present all the keys which evaluates to true will be removed. Otherwise all blank values will be removed.
+    def compact!(&validator)
+      validator ||= ->(_, v) { v.blank? }
+      reject!(&validator)
+    end
+
     # 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 = {strings: :stringify_keys, symbols: :symbolize_keys, indifferent: :with_indifferent_access, dotted: :enable_dotted_access}.fetch(access, nil)
       method ? send(method) : self
     end
+
+    # Makes sure that the hash is accessible using dotted notation. This is also applied to every embedded hash.
+    #
+    # @param readonly [Boolean] If the dotted notation is only enable for reading. `true` by default.
+    #
+    def enable_dotted_access(readonly = true)
+      extend(Hashie::Extensions::MethodReader)
+      extend(Hashie::Extensions::MethodQuery)
+      extend(Hashie::Extensions::MethodWriter) if !readonly
+
+      each do |_, value|
+        if value.is_a?(Hash) then
+          value.enable_dotted_access(readonly)
+        elsif value.respond_to?(:each) then
+          value.each do |element|
+            element.enable_dotted_access(readonly) if element.is_a?(Hash)
+          end
+        end
+      end
+    end
   end
 end

data/lib/lazier/i18n.rb

@@ -23,6 +23,7 @@ module Lazier
     # @param root [Symbol] The root level of the translation.
     # @param path [String] The path where the translations are stored.
     def i18n_setup(root, path)
+      ::I18n.enforce_available_locales = true
       @i18n_root = root.to_sym
       @i18n_locales_path = path
     end

data/lib/lazier/object.rb

@@ -50,6 +50,16 @@ module Lazier
       is_a?(::TrueClass) || !self || to_s =~ ::Lazier::Object::BOOLEAN_MATCHER
     end
 
+    # Sends a method to the object. If the objects doesn't not respond to the method, it returns `nil` instead of raising an exception.
+    #
+    # @param method [Symbol] The method to send.
+    # @param args [Array] The arguments to send.
+    # @param &block [Proc] The block to pass to the method.
+    # @return [Object|nil] The return value of the method or `nil`, if the object does not respond to the method.
+    def safe_send(method, *args, &block)
+      respond_to?(method) ? send(method, *args, &block) : nil
+    end
+
     # Makes sure that the object is set to something meaningful.
     #
     # @param default_value [String] The default value to return if the `verifier` or the block returns true.

data/lib/lazier/version.rb

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

data/spec/lazier/hash_spec.rb

@@ -38,6 +38,36 @@ describe Lazier::Hash do
     end
   end
 
+  describe "#compact" do
+    it "should remove blank keys" do
+      expect({a: 1, b: nil}.compact).to eq({a: 1})
+    end
+
+    it "should use a custom validator" do
+      expect({a: 1, b: nil, c: 3}.compact {|k, v| v == 1 || k == :c}).to eq({b: nil})
+    end
+
+    it "should not be destructive" do
+      reference = {a: 1, b: nil}
+      reference.compact
+      expect(reference).to eq({a: 1, b: nil})
+    end
+  end
+
+  describe "#compact!" do
+    it "should remove blank keys" do
+      reference = {a: 1, b: nil}
+      reference.compact!
+      expect(reference).to eq({a: 1})
+    end
+
+    it "should use a custom validator" do
+      reference = {a: 1, b: nil, c: 3}
+      reference.compact! {|k, v| v == 1 || k == :c}
+      expect(reference).to eq({b: nil})
+    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"})
@@ -48,6 +78,26 @@ describe Lazier::Hash do
       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"})
+
+      reference.ensure_access(:dotted)
+      expect(reference.a).to eq(1)
+      expect(reference.b.c).to eq(2)
+    end
+  end
+
+  describe "#with_dotted_access" do
+    it "should recursively enable dotted access on a hash" do
+      reference = {a: 1, b: {c: 3}, c: [1, {f: {g: 1}}]}
+
+      reference.enable_dotted_access
+      expect(reference.b.c).to eq(3)
+      expect(reference.c[1].f.g).to eq(1)
+    end
+
+    it "should also provide write access if asked" do
+      reference.enable_dotted_access(false)
+      expect { reference.b.f = 4 }.not_to raise_error
+      expect(reference["b"]["f"]).to eq(4)
     end
   end
 end

data/spec/lazier/object_spec.rb

@@ -96,6 +96,17 @@ describe Lazier::Object do
     end
   end
 
+  describe "#safe_send" do
+    it "should run the method by default" do
+      expect("STRING".safe_send(:gsub, "T", "E")).to eq("SERING")
+      expect("STRING".safe_send(:gsub, "T") { "E" }).to eq("SERING")
+    end
+
+    it "should silently fail if the method is not supported" do
+      expect("STRING".safe_send(:invalid_gsub, "T", "E")).to be_nil
+    end
+  end
+
   describe "#ensure" do
     it "should assign a default value to an object" do
       expect(nil.ensure("VALUE")).to eq("VALUE")

metadata

@@ -1,83 +1,83 @@
 --- !ruby/object:Gem::Specification
 name: lazier
 version: !ruby/object:Gem::Version
-  version: 3.3.10
+  version: 3.4.0
 platform: ruby
 authors:
 - Shogun
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-12-02 00:00:00.000000000 Z
+date: 2014-01-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: json
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.8.0
+        version: 1.8.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.8.0
+        version: 1.8.1
 - !ruby/object:Gem::Dependency
   name: activesupport
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: 3.2.13
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: 3.2.13
 - !ruby/object:Gem::Dependency
   name: tzinfo
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: 0.3.37
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: 0.3.37
 - !ruby/object:Gem::Dependency
   name: r18n-desktop
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.1.5
+        version: 1.1.7
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.1.5
+        version: 1.1.7
 - !ruby/object:Gem::Dependency
   name: hashie
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: 2.0.5
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: 2.0.5
 description: Several Ruby object enhancements.
@@ -87,10 +87,10 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- .gitignore
-- .travis-gemfile
-- .travis.yml
-- .yardopts
+- ".gitignore"
+- ".travis-gemfile"
+- ".travis.yml"
+- ".yardopts"
 - CHANGELOG.md
 - Gemfile
 - README.md
@@ -170,17 +170,17 @@ require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: 1.9.3
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
 rubyforge_project: lazier
-rubygems_version: 2.0.6
+rubygems_version: 2.2.0
 signing_key: 
 specification_version: 4
 summary: Several Ruby object enhancements.