This module provides english singular <-> plural noun inflections.
Clear all rules.
# File lib/english/inflect.rb, line 174 def clear(type = :all) if type == :singular || type == :all @singular_of = {} @singular_rules = [] @singularization_rules, @singularization_regex = nil, nil end if type == :plural || type == :all @singular_of = {} @singular_rules = [] @singularization_rules, @singularization_regex = nil, nil end end
Convert an English word from singular to plurel.
"boy".plural #=> boys "tomato".plural #=> tomatoes
# File lib/english/inflect.rb, line 152 def plural(word) return "" if word == "" if result = plural_of[word] return result.dup end #return self.dup if /s$/ =~ self # ??? result = word.dup regex, hash = pluralization_rules result.sub!(regex) {|m| hash[m]} plural_of[word] = result return result #pluralization_rules.each do |(match, replacement)| # break if result.gsub!(match, replacement) #end #return result end
# File lib/english/inflect.rb, line 119 def plural_of ; @plural_of ; end
Define a plurualization rule.
# File lib/english/inflect.rb, line 72 def plural_rule(singular, plural) @plural_rules << [singular, plural] end
Define a pluralization exception.
# File lib/english/inflect.rb, line 55 def plural_word(singular, plural) @plural_of[singular] = plural @plural_of[singular.capitalize] = plural.capitalize end
Read prepared pluralization rules.
# File lib/english/inflect.rb, line 97 def pluralization_rules if defined?(@pluralization_regex) && @pluralization_regex return [@pluralization_regex, @pluralization_hash] end @pluralization_regex = Regexp.new("(" + @plural_rules.map {|s,p| s}.join("|") + ")$", "i") @pluralization_hash = Hash[*@plural_rules.flatten] [@pluralization_regex, @pluralization_hash] end
Define a general rule.
# File lib/english/inflect.rb, line 61 def rule(singular, plural) singular_rule(singular, plural) plural_rule(singular, plural) end
Convert an English word from plurel to singular.
"boys".singular #=> boy "tomatoes".singular #=> tomato
# File lib/english/inflect.rb, line 126 def singular(word) return "" if word == "" if result = singular_of[word] return result.dup end result = word.dup regex, hash = singularization_rules result.sub!(regex) {|m| hash[m]} singular_of[word] = result return result #singularization_rules.each do |(match, replacement)| # break if result.gsub!(match, replacement) #end #return result end
# File lib/english/inflect.rb, line 116 def singular_of ; @singular_of ; end
Define a singularization rule.
# File lib/english/inflect.rb, line 67 def singular_rule(singular, plural) @singular_rules << [singular, plural] end
Define a singularization exception.
# File lib/english/inflect.rb, line 49 def singular_word(singular, plural) @singular_of[plural] = singular @singular_of[plural.capitalize] = singular.capitalize end
Read prepared singularization rules.
# File lib/english/inflect.rb, line 77 def singularization_rules if defined?(@singularization_regex) && @singularization_regex return [@singularization_regex, @singularization_hash] end # No sorting needed: Regexen match on longest string @singularization_regex = Regexp.new("(" + @singular_rules.map {|s,p| p}.join("|") + ")$", "i") @singularization_hash = Hash[*@singular_rules.flatten].invert [@singularization_regex, @singularization_hash] end
Define a general two-way exception.
This also defines a general rule, so foo_child will correctly become foo_children.
Whole words also work if they are capitalized (Goose => Geese).
# File lib/english/inflect.rb, line 41 def word(singular, plural=nil) plural = singular unless plural singular_word(singular, plural) plural_word(singular, plural) rule(singular, plural) end