Class: Inflecto::Inflections

Inherits:
Object
  • Object
show all
Defined in:
lib/inflecto/inflections.rb

Overview

A singleton instance of this class is yielded by Inflecto.inflections, which can then be used to specify additional inflection rules. Examples:

Inflecto.inflections do |inflect|
  inflect.plural /^(ox)$/i, '\1\2en'
  inflect.singular /^(ox)en/i, '\1'

  inflect.irregular 'octopus', 'octopi'

  inflect.uncountable "equipment"
end

New rules are added at the top. So in the example above, the irregular rule for octopus will now be the first of the pluralization and singularization rules that is runs. This guarantees that your rules run before any of the rules that may already have been loaded.

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize ⇒ undefined

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Initialize object



69
70
71
 
# File 'lib/inflecto/inflections.rb', line 69

def initialize
  @plurals, @singulars, @uncountables, @humans = [], [], [], []
end

Instance Attribute Details

#humans ⇒ Array (readonly)

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Return humans

Returns:

  • (Array) 


61
62
63
 
# File 'lib/inflecto/inflections.rb', line 61

def humans
  @humans
end

#plurals ⇒ Array (readonly)

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Return plurals

Returns:

  • (Array) 


36
37
38
 
# File 'lib/inflecto/inflections.rb', line 36

def plurals
  @plurals
end

#singulars ⇒ Array (readonly)

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Return singulars

Returns:

  • (Array) 


44
45
46
 
# File 'lib/inflecto/inflections.rb', line 44

def singulars
  @singulars
end

#uncountables ⇒ Array (readonly)

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Return uncountables

Returns:

  • (Array) 


52
53
54
 
# File 'lib/inflecto/inflections.rb', line 52

def uncountables
  @uncountables
end

Class Method Details

.instance ⇒ Inflections

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Return instance

Returns:



26
27
28
 
# File 'lib/inflecto/inflections.rb', line 26

def self.instance
  @__instance__ ||= new
end

Instance Method Details

#clear ⇒ self

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Clear all inflection rules

Examples:


Inflecto.clear

Returns:

  • (self) 


200
201
202
203
 
# File 'lib/inflecto/inflections.rb', line 200

def clear
  initialize
  self
end

#human(rule, replacement) ⇒ self

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Add humanize rule

Specifies a humanized form of a string by a regular expression rule or by a string mapping. When using a regular expression based replacement, the normal humanize formatting is called after the replacement. When a string is used, the human form should be specified as desired (example: ‘The name’, not ‘the_name’)

Examples:

Inflecto.human(/_cnt$/i, '\1_count')
Inflecto.human("legacy_col_person_name", "Name")

Parameters:

  • rule (String, Regexp)
  • replacement (String, Regexp)

Returns:

  • (self) 


185
186
187
188
 
# File 'lib/inflecto/inflections.rb', line 185

def human(rule, replacement)
  @humans.insert(0, [rule, replacement])
  self
end

#irregular(singular, plural) ⇒ self

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Add a new irregular pluralization

Specifies a new irregular that applies to both pluralization and singularization at the same time. This can only be used for strings, not regular expressions. You simply pass the irregular in singular and plural form.

Examples:


Inflecto.irregular('octopus', 'octopi')
Inflecto.irregular('person', 'people')

Parameters:

  • singular (String)
  • plural (String)

Returns:

  • (self) 


128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
 
# File 'lib/inflecto/inflections.rb', line 128

def irregular(singular, plural)
  @uncountables.delete(singular)
  @uncountables.delete(plural)

  if singular[0,1].upcase == plural[0,1].upcase
    plural(Regexp.new("(#{singular[0,1]})#{singular[1..-1]}$", "i"), '\1' + plural[1..-1])
    plural(Regexp.new("(#{plural[0,1]})#{plural[1..-1]}$", "i"), '\1' + plural[1..-1])
    singular(Regexp.new("(#{plural[0,1]})#{plural[1..-1]}$", "i"), '\1' + singular[1..-1])
  else
    plural(Regexp.new("#{singular[0,1].upcase}(?i)#{singular[1..-1]}$"), plural[0,1].upcase + plural[1..-1])
    plural(Regexp.new("#{singular[0,1].downcase}(?i)#{singular[1..-1]}$"), plural[0,1].downcase + plural[1..-1])
    plural(Regexp.new("#{plural[0,1].upcase}(?i)#{plural[1..-1]}$"), plural[0,1].upcase + plural[1..-1])
    plural(Regexp.new("#{plural[0,1].downcase}(?i)#{plural[1..-1]}$"), plural[0,1].downcase + plural[1..-1])
    singular(Regexp.new("#{plural[0,1].upcase}(?i)#{plural[1..-1]}$"), singular[0,1].upcase + singular[1..-1])
    singular(Regexp.new("#{plural[0,1].downcase}(?i)#{plural[1..-1]}$"), singular[0,1].downcase + singular[1..-1])
  end
  self
end

#plural(rule, replacement) ⇒ self

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Add a new plural role

Specifies a new pluralization rule and its replacement. The rule can either be a string or a regular expression. The replacement should always be a string that may include references to the matched data from the rule.

Parameters:

  • rule (String, Regexp)
  • replacement (String, Regexp)

Returns:

  • (self) 


85
86
87
88
89
90
 
# File 'lib/inflecto/inflections.rb', line 85

def plural(rule, replacement)
  @uncountables.delete(rule) if rule.is_a?(String)
  @uncountables.delete(replacement)
  @plurals.insert(0, [rule, replacement])
  self
end

#singular(rule, replacement) ⇒ self

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Add a new singular rule

Specifies a new singularization rule and its replacement. The rule can either be a string or a regular expression. The replacement should always be a string that may include references to the matched data from the rule.

Parameters:

  • rule (String, Regexp)
  • replacement (String, Regexp)

Returns:

  • (self) 


104
105
106
107
108
109
 
# File 'lib/inflecto/inflections.rb', line 104

def singular(rule, replacement)
  @uncountables.delete(rule) if rule.is_a?(String)
  @uncountables.delete(replacement)
  @singulars.insert(0, [rule, replacement])
  self
end

#uncountable(words) ⇒ self

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Add uncountable words

Uncountable will not be inflected

Examples:


Inflecto.uncountable "money"
Inflecto.uncountable "money", "information"
Inflecto.uncountable %w( money information rice )

Parameters:

  • words (Enumerable<String>)

Returns:

  • (self) 


163
164
165
166
 
# File 'lib/inflecto/inflections.rb', line 163

def uncountable(words)
  @uncountables.concat(words)
  self
end