spanish_pluralizer 1.0.0 → 1.1.0

data/README.md

@@ -1,4 +1,54 @@
-spanish_pluralizer
-==================
+Spanish Pluralizer
+=========
 
-An alpha version of a pluralizer
+Spanish Pluralizer is a gem for converting singular spanish nouns into plural.
+It works by adding the following methods to String: [:pluralize_spanish, :spanish_pluralizer_acute, :spanish_pluralizer_unacute, :spanish_pluralizer_is_acute?].
+It can handle diphthong, hiatus and adding or removing acutes, but fails with monosyllables and rule exceptions like "régimen" => "regímenes" and "espécimen => especímenes".
+
+Usage
+------------
+
+```ruby
+require 'spanish_pluralizer' #not needed if using Gemfile
+
+'camión'.pluralize_spanish
+=> 'camiones'
+
+'caries'.pluralize_spanish
+=> 'caries'
+
+'imagen'.pluralize_spanish
+=> 'imágenes'
+
+'arroz'.pluralize_spanish
+=> 'arroces'
+```
+
+Installation
+------------
+
+Spanish Pluralizer is distributed as a gem.
+
+You can install it by running
+
+```ruby
+gem install spanish_pluralizer
+```
+
+or including the gem in your Gemfile:
+
+```ruby
+gem spanish_pluralizer
+```
+
+Credits
+-------
+
+Pablo Bianciotto.
+
+License
+-------
+
+Copyright © 2013 Pablo Bianciotto.
+
+Spanish Pluralizer is a free software, and may be redistributed under the terms specified in the MIT-LICENSE file.

data/lib/spanish_pluralizer.rb

@@ -5,94 +5,75 @@ end
 
 class String
 
-  raise AlreadyDefinedMethod.new unless (self.instance_methods(true) & [:acute, :unacute, :pluralize_spanish, :is_acute?]).empty?
+  clashing_methods = self.instance_methods(true) & [:pluralize_spanish, :spanish_pluralizer_acute, :spanish_pluralizer_unacute, :spanish_pluralizer_is_acute?]
+  raise AlreadyDefinedMethod.new("The following instance methods for String have already been defined: #{clashing_methods * ', '}. Are you calling load more than once?") unless clashing_methods.empty?
 
-  def acute
-    case self
-      when 'a'
-        'á'
-      when 'e'
-        'é'
-      when 'i'
-        'í'
-      when 'o'
-        'ó'
-      when 'u'
-        'ú'
-      else self
-    end
+  SPANISH_PLURALIZER_ACUTES = {
+    'a' => 'á',
+    'e' => 'é',
+    'i' => 'í',
+    'o' => 'ó',
+    'u' => 'ú'
+  }
+
+  def spanish_pluralizer_acute
+    SPANISH_PLURALIZER_ACUTES.fetch(self, self)
   end
 
-  def unacute
-    case self
-      when 'á'
-        'a'
-      when 'é'
-        'e'
-      when 'í'
-        'i'
-      when 'ó'
-        'o'
-      when 'ú'
-        'u'
-      else self
-    end
+  def spanish_pluralizer_unacute
+    SPANISH_PLURALIZER_ACUTES.invert.fetch(self, self)
   end
 
-  def is_acute?
-    ['á','é','í','ó','ú'].include? self
+  def spanish_pluralizer_is_acute?
+    SPANISH_PLURALIZER_ACUTES.values.include? self
   end
 
   def pluralize_spanish
     #orden por probabilidad de ocurrencia para optimizar
     case self
-      when /.*[aeiouáéó]$/
-        #caja => cajas
-        #puente => puentes
-        #papi => papis
-        #mono => monos
-        #río => ríos
-        #palabru => palabrus
-        #sofá => sofás
-        #palabré => palabrés
-        #palabró => palabrós
-        self + 's'
-      when /(?<pre>.*)(?<last_vowel>.)(?<ending>[ns])$/
-        if $~[:last_vowel].is_acute?
-          new_str = self
-          #aguda con tilde => grave sin tilde, a menos que el tilde se mantenga por existir hiato
-          new_str[-2] = new_str[-2].unacute unless new_str[-3..-1].match(/(a|e|o)(í|ú)/)
-          new_str + 'es'
-        else
-          if $~[:ending] == 's'
-            #análisis => análisis
-            self
-          else
-            #imagen => imágenes
-            #palebren => palébrenes
-            #origen => orígenes
-            #orden => órdenes
-            #resumen => resúmenes
-            ending = $~[:last_vowel] + 'nes'
-            $~[:pre].sub(/(a|e|i|o|u)(?=[^aeiou]*$)/, &:acute) + ending
-          end
-        end
-      when /.*z$/
-        #arroz => arroces
-        self[0..-2] + 'ces'
+    #caja => cajas
+    #puente => puentes
+    #papi => papis
+    #mono => monos
+    #río => ríos
+    #palabru => palabrus
+    #sofá => sofás
+    #palabré => palabrés
+    #palabró => palabrós
+    when /.*[aeiouáéó]$/ then self + 's'
+    when /(?<pre>.*)(?<last_vowel>.)(?<ending>[ns])$/
+      if $~[:last_vowel].spanish_pluralizer_is_acute?
+        new_str = self
+        #aguda con tilde => grave sin tilde, a menos que el tilde se mantenga por existir hiato
+        new_str[-2] = new_str[-2].spanish_pluralizer_unacute unless new_str[-3..-1].match(/(a|e|o)(í|ú)/)
+        new_str + 'es'
+      elsif $~[:ending] == 's'
+        #análisis => análisis
+        self
       else
-        #delantal => delantales
-        #mantel => manteles
-        #mandril => mandriles
-        #tambor => tambores
-        #gandul => gandules
-        #maní => maníes
-        #menú => menúes
-        #rey => reyes
-        #fax => faxes
-        #árbol => árboles
-        #laúd => laúdes
-        self + 'es'
+        #imagen => imágenes
+        #palebren => palébrenes
+        #origen => orígenes
+        #orden => órdenes
+        #resumen => resúmenes
+        ending = $~[:last_vowel] + 'nes'
+        $~[:pre].sub(/(a|e|i|o|u)(?=[^aeiou]*$)/, &:spanish_pluralizer_acute) + ending
+      end
+    #arroz => arroces
+    when /.*z$/ then self[0..-2] + 'ces'
+    #delantal => delantales
+    #mantel => manteles
+    #mandril => mandriles
+    #tambor => tambores
+    #gandul => gandules
+    #maní => maníes
+    #menú => menúes
+    #rey => reyes
+    #fax => faxes
+    #árbol => árboles
+    #laúd => laúdes
+    else
+     self + 'es'
     end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: spanish_pluralizer
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.1.0
   prerelease: 
 platform: ruby
 authors: