possessify 1.0.1 → 1.0.2

data/README.rdoc

@@ -1,6 +1,10 @@
 = Possessify
 
-Possessify extends the Ruby String class adding functionality to make strings possessive and non-possessive.  It also provides a possessive? checker method.
+Possessify extends the Ruby String class adding functionality to make strings possessive and non-possessive.  It also provides possessive? and non_possessive? checker methods.
+
+== Installation
+
+  gem install possessify
 
 == Examples
 
@@ -12,6 +16,9 @@ Possessify extends the Ruby String class adding functionality to make strings po
 
   "Dave's".possessive?      #=> true
   "Dave".possessive?        #=> false
+  
+  "Dave's".non_possessive?  #=> false
+  "Dave".non_possessive?    #=> true
 
 
 Copyright (c) 2011 David Busse, released under the MIT license

data/Rakefile

@@ -21,6 +21,6 @@ Rake::RDocTask.new(:rdoc) do |rdoc|
   rdoc.rdoc_dir = 'rdoc'
   rdoc.title    = 'Possessify'
   rdoc.options << '--line-numbers' << '--inline-source'
-  rdoc.rdoc_files.include('README')
+  rdoc.rdoc_files.include('README.rdoc')
   rdoc.rdoc_files.include('lib/**/*.rb')
 end

data/lib/possessify/possessify.rb

@@ -1,14 +1,28 @@
 module Possessify
 
   String.class_eval do
+    
+    ##
+    # :call-seq:
+    #   str.possessive => new_str
+    #
+    # Returns a new string that is the possessive form of <i>str</i>.
+    #   "Dave".possessive     #=> "Dave's"
+    #   "Xerxes".possessive   #=> "Xerxes'"
     def possessive
-      str = self
-      unless str.possessive? || str.blank?
-        str = str + (str[-1,1] && str[-1,1].downcase == "s" ? "'" : "'s")
+      unless self.possessive? || self.blank?
+        str = self + (self[-1,1] && self[-1,1].downcase == "s" ? "'" : "'s")
       end
-      str
+      str || self
     end
-  
+    
+    ##
+    # :call-seq:
+    #   str.non_possessive => new_str
+    #
+    # Returns a new string that is the non-possessive form of <i>str</i>.
+    #   "Dave's".non_possessive     #=> "Dave"
+    #   "Xerxes'".non_possessive   #=> "Xerxes"
     def non_possessive
       if self.possessive?
         unless self.chomp!("'s")
@@ -18,9 +32,28 @@ module Possessify
       self
     end
   
+    ##
+    # :call-seq:
+    #   str.possessive? => true or false
+    #
+    # Returns <code>true</code> if <i>str</i> is possessive.
+    #   "Dave's".possessive?     #=> true
+    #   "Dave".possessive?       #=> false
     def possessive?
       self[-2,2] && (self[-2,2].downcase == "'s" || self[-2,2].downcase == "s'")
     end
+    
+    ##
+    # :call-seq:
+    #   str.non_possessive? => true or false
+    #
+    # Returns <code>true</code> if <i>str</i> is not in possessive form.
+    #   "Dave's".non_possessive?     #=> false
+    #   "Dave".non_possessive?       #=> true
+    def non_possessive?
+      !self.possessive?
+    end
+    
   end
   
 end

data/lib/possessify/version.rb

@@ -1,3 +1,3 @@
 module Possessify
-  VERSION = "1.0.1"
+  VERSION = "1.0.2"
 end

data/test/possessify_test.rb

@@ -1,36 +1,50 @@
 require 'test_helper'
 
 class PossessifyTest < ActiveSupport::TestCase
-  test "string not ending in s possessive" do
+
+  # tests for possessive method
+  test "should make singular string possessive" do
     assert_equal "Dave's", "Dave".possessive
   end
   
-  test "string ending in s possessive" do
-    assert_equal "James'", "James".possessive
-    assert_equal "JameS'", "JameS".possessive
-  end
-  
-  test "string already possessive" do
-    assert_equal "Dave's", "Dave's".possessive
-    assert_equal "James'", "James'".possessive
+  test "should make string ending in s possessive" do
+    assert_equal "Xerxes'", "Xerxes".possessive
+    assert_equal "XerxeS'", "XerxeS".possessive
   end
   
-  test "short string" do
+  test "should make single character string possesive" do
     assert_equal "D's", "D".possessive
     assert_equal "S'", "S".possessive
   end
   
-  test "blanks string" do
+  test "should do nothing if string already possessive" do
+    assert_equal "Dave's", "Dave's".possessive
+    assert_equal "Xerxes'", "Xerxes'".possessive
+  end
+  
+  test "should do nothing if string is empty" do
     assert_equal "", "".possessive
   end
   
-  test "possesive string non_possesive" do
+  # tests for non_possessive method
+  test "should make singular possessive string non-possesive" do
     assert_equal "Dave", "Dave's".non_possessive
   end
   
-  test "plural possesive string non_possesive" do
-    assert_equal "James", "James'".non_possessive
-    assert_equal "JameS", "JameS'".non_possessive
+  test "should make possesive string ending in s non_possesive" do
+    assert_equal "Xerxes", "Xerxes'".non_possessive
+    assert_equal "XerxeS", "XerxeS'".non_possessive
+  end
+  
+  # tests for possessive? method
+  test "should return true for possessive string" do
+    assert_equal true, "Dave's".possessive?
+    assert_equal true, "Xerxes'".possessive?
+  end
+  
+  test "should return false for non-possessive string" do
+    assert_equal false, "Dave".possessive?
+    assert_equal false, "Xerxes".possessive?
   end
   
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: possessify
 version: !ruby/object:Gem::Version 
-  hash: 21
+  hash: 19
   prerelease: 
   segments: 
   - 1
   - 0
-  - 1
-  version: 1.0.1
+  - 2
+  version: 1.0.2
 platform: ruby
 authors: 
 - David Busse
@@ -15,7 +15,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-01-31 00:00:00 -06:00
+date: 2011-02-01 00:00:00 -06:00
 default_executable: 
 dependencies: []