nutella 0.6 → 0.7

data/lib/nutella/core_ext/integer/format.rb

@@ -1,10 +1,12 @@
 class Integer
-  # Returns a string with the ordinal form of a given integer.
+  # Returns a string with the ordinal form of the integer.
   #
   #   1.ordinalize   # => "1st"
   #   2.ordinalize   # => "2nd"
   #   9.ordinalize   # => "9th"
   #   43.ordinalize  # => "43rd"
+  #
+  # @return [String] the ordinal form of the integer
   def ordinalize
     suffixes = { 1 => "st", 2 => "nd", 3 => "rd" }
 

data/lib/nutella/core_ext/object/aliases.rb

@@ -0,0 +1,3 @@
+class Object
+  alias_method :is_an?, :is_a?
+end

data/lib/nutella/core_ext/object/blank.rb

@@ -0,0 +1,42 @@
+class Object
+  # Returns true if the object is false, empty, or a whitespace string.
+  #
+  #   nil.blank?    # => true
+  #   false.blank?  # => true
+  #   4.blank?      # => false
+  #
+  # @example Compare with and without usage of Object#blank?
+  #   # Without:
+  #   if str.nil? || str.empty?
+  #   # With:
+  #   if str.blank?
+  #
+  # @return [Boolean] whether or not the object is blank
+  def blank?
+    respond_to?(:empty?) ? empty? : !self
+  end
+
+  # The inverse of Object#blank?.
+  #
+  # @return [Boolean] whether or not the object is not blank
+  def present?
+    !blank?
+  end
+
+  # Returns the object if it is present, returns <tt>nil</tt> if the object is
+  # blank.
+  #
+  #   "str".presence  # => "str"
+  #   "".presence     # => nil
+  #
+  # @return [Object, NilClass] the object if present, otherwise nil
+  def presence
+    self if present?
+  end
+end
+
+class String #:nodoc:
+  def blank?
+    self !~ /[^\s]/
+  end
+end

data/lib/nutella/core_ext/object.rb

@@ -0,0 +1 @@
+Dir[File.expand_path("../object/**/*.rb", __FILE__)].each { |f| require f }

data/lib/nutella/version.rb

@@ -1,4 +1,4 @@
 module Nutella
   # The current version of Nutella.
-  VERSION = "0.6"
+  VERSION = "0.7"
 end

data/spec/nutella/core_ext/integer_spec.rb

@@ -8,7 +8,7 @@ describe Integer do
   end
 
   describe "#ordinalize" do
-    it "should return the cardinal form of a given integer" do
+    it "should return the ordinal form of the integer" do
       NUMBER_FORMATS.each do |cardinal, ordinal|
         cardinal.ordinalize.should == ordinal
       end

data/spec/nutella/core_ext/object_spec.rb

@@ -0,0 +1,74 @@
+require "spec_helper"
+require "nutella/core_ext/object"
+
+describe Object do
+  describe "aliases" do
+    test_alias Object, :is_an?, :is_a?
+  end
+
+  describe "#blank?" do
+    it "should be blank when nil" do
+      nil.blank?.should be_true
+    end
+
+    it "should be blank when false" do
+      false.blank?.should be_true
+    end
+
+    it "should not be blank when true" do
+      true.blank?.should be_false
+    end
+
+    it "should not be blank when numeric" do
+      [0, 1].each { |n| n.blank?.should be_false }
+    end
+
+    context "when a string" do
+      it "should be blank if the string is empty" do
+        "".blank?.should be_true
+      end
+
+      it "should be blank if only whitespace" do
+        ["  ", "\n  \t"].each { |str| str.blank?.should be_true }
+        "  something here  ".blank?.should be_false
+      end
+
+      it "should not be blank if the string has content" do
+        "string".blank?.should be_false
+      end
+    end
+
+    context "when a collection" do
+      it "should be blank if the collection is empty" do
+        [[], {}].each { |collection| collection.blank?.should be_true }
+      end
+
+      it "should not be blank if there are elements in the collection" do
+        [[1, 2, 3], { 1 => 2, 3 => 4 }].each do |collection|
+          collection.blank?.should be_false
+        end
+      end
+    end
+  end
+
+  describe "#present?" do
+    it "should be the inverse of #blank?" do
+      [0, 1].each { |n| n.present?.should be_true }
+      [[], {}].each { |collection| collection.present?.should be_false }
+      ["", "  "].each { |str| str.present?.should be_false }
+      ["str", "  str "].each { |str| str.present?.should be_true }
+    end
+  end
+
+  describe "#presence" do
+    it "should return the object if the object is present" do
+      1.presence.should == 1
+      "str".presence.should == "str"
+    end
+
+    it "should return nil if the object is not present" do
+      "".presence.should be_nil
+      false.presence.should be_nil
+    end
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: nutella
 version: !ruby/object:Gem::Version
-  version: '0.6'
+  version: '0.7'
   prerelease: 
 platform: ruby
 authors:
@@ -118,13 +118,17 @@ files:
 - lib/nutella/input.rb
 - lib/nutella/core_ext/integer/multiples.rb
 - lib/nutella/core_ext/integer/format.rb
+- lib/nutella/core_ext/object.rb
 - lib/nutella/core_ext/string.rb
 - lib/nutella/core_ext/integer.rb
 - lib/nutella/core_ext/hash.rb
+- lib/nutella/core_ext/object/blank.rb
+- lib/nutella/core_ext/object/aliases.rb
 - lib/nutella/core_ext/enumerable.rb
 - lib/nutella/core_ext.rb
 - spec/support/alias.rb
 - spec/support/number_formats.rb
+- spec/nutella/core_ext/object_spec.rb
 - spec/nutella/core_ext/hash_spec.rb
 - spec/nutella/core_ext/enumerable_spec.rb
 - spec/nutella/core_ext/integer_spec.rb
@@ -156,7 +160,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: 3508017811840001667
+      hash: -3181334132306800521
 requirements: []
 rubyforge_project: 
 rubygems_version: 1.8.24
@@ -166,6 +170,7 @@ summary: Spread some Nutella on Ruby to sweeten up its functionality.
 test_files:
 - spec/support/alias.rb
 - spec/support/number_formats.rb
+- spec/nutella/core_ext/object_spec.rb
 - spec/nutella/core_ext/hash_spec.rb
 - spec/nutella/core_ext/enumerable_spec.rb
 - spec/nutella/core_ext/integer_spec.rb