Class: SleepingKingStudios::Tools::Toolbox::Inflector::Rules

Inherits:
Object
  • Object
show all
Defined in:
lib/sleeping_king_studios/tools/toolbox/inflector/rules.rb

Overview

Rules for inflecting words.

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(irregular_words: nil, plural_rules: nil, singular_rules: nil, uncountable_words: nil) ⇒ Rules

Returns a new instance of Rules.

Parameters:

  • irregular_words (Hash{String => String}) (defaults to: nil) —

    irregular word pairs in singular => plural order, e.g. “child” => “children”.

  • plural_rules (Array<Array<Regexp, String>>) (defaults to: nil) —

    rules for pluralizing words.

  • singular_rules (Array<Array<Regexp, String>>) (defaults to: nil) —

    rules for singularizing words.

  • uncountable_words (Array<String>) (defaults to: nil) —

    uncountable words e.g. “data”.



15
16
17
18
19
20
21
22
23
24
25
26
27
28
 
# File 'lib/sleeping_king_studios/tools/toolbox/inflector/rules.rb', line 15

def initialize(
  irregular_words:   nil,
  plural_rules:      nil,
  singular_rules:    nil,
  uncountable_words: nil
)
  @plural_rules      = plural_rules    || default_plural_rules
  @singular_rules    = singular_rules  || default_singular_rules
  @irregular_words   = irregular_words || default_irregular_words
  @uncountable_words =
    Set.new(uncountable_words || default_uncountable_words)

  @irregular_words_reversed = reverse_hash(@irregular_words)
end

Instance Attribute Details

#irregular_words ⇒ Array<Array<String, String>> (readonly)

Returns irregular word pairs in singular => plural order.

Returns:

  • (Array<Array<String, String>>) —

    irregular word pairs in singular => plural order.



32
33
34
 
# File 'lib/sleeping_king_studios/tools/toolbox/inflector/rules.rb', line 32

def irregular_words
  @irregular_words
end

#irregular_words_reversed ⇒ Array<Array<String, String>> (readonly)

Returns irregular word pairs in plural => singular order.

Returns:

  • (Array<Array<String, String>>) —

    irregular word pairs in plural => singular order.



36
37
38
 
# File 'lib/sleeping_king_studios/tools/toolbox/inflector/rules.rb', line 36

def irregular_words_reversed
  @irregular_words_reversed
end

#plural_rules ⇒ Array<Array<Regexp, String>> (readonly)

Returns rules for pluralizing words.

Returns:

  • (Array<Array<Regexp, String>>) —

    rules for pluralizing words.



39
40
41
 
# File 'lib/sleeping_king_studios/tools/toolbox/inflector/rules.rb', line 39

def plural_rules
  @plural_rules
end

#singular_rules ⇒ Array<Array<Regexp, String>> (readonly)

Returns rules for singularizing words.

Returns:

  • (Array<Array<Regexp, String>>) —

    rules for singularizing words.



42
43
44
 
# File 'lib/sleeping_king_studios/tools/toolbox/inflector/rules.rb', line 42

def singular_rules
  @singular_rules
end

#uncountable_words ⇒ Array<String> (readonly)

Returns uncountable words.

Returns:

  • (Array<String>) —

    uncountable words.



45
46
47
 
# File 'lib/sleeping_king_studios/tools/toolbox/inflector/rules.rb', line 45

def uncountable_words
  @uncountable_words
end

Instance Method Details

#define_irregular_word(singular, plural) ⇒ self

Defines an irregular word pair.

Parameters:

  • singular (String) —

    the singular form of the word.

  • plural (String) —

    the plural form of the word.

Returns:

  • (self) —

    the rules object.



53
54
55
56
57
58
59
60
61
 
# File 'lib/sleeping_king_studios/tools/toolbox/inflector/rules.rb', line 53

def define_irregular_word(singular, plural)
  validate_string(singular)
  validate_string(plural)

  @irregular_words[singular]        = plural
  @irregular_words_reversed[plural] = singular

  self
end

#define_plural_rule(pattern, replace) ⇒ self

Defines a pluralization rule.

Parameters:

  • pattern (Regexp) —

    the pattern to match.

  • replace (String) —

    the string to replace.

Returns:

  • (self) —

    the rules object.



69
70
71
72
73
74
75
76
 
# File 'lib/sleeping_king_studios/tools/toolbox/inflector/rules.rb', line 69

def define_plural_rule(pattern, replace)
  validate_pattern(pattern)
  validate_string(replace, as: 'replace')

  @plural_rules.unshift([pattern, replace])

  self
end

#define_singular_rule(pattern, replace) ⇒ self

Defines a singularization rule.

Parameters:

  • pattern (Regexp) —

    the pattern to match.

  • replace (String) —

    the string to replace.

Returns:

  • (self) —

    the rules object.



84
85
86
87
88
89
90
91
 
# File 'lib/sleeping_king_studios/tools/toolbox/inflector/rules.rb', line 84

def define_singular_rule(pattern, replace)
  validate_pattern(pattern)
  validate_string(replace, as: 'replace')

  @singular_rules.unshift([pattern, replace])

  self
end

#define_uncountable_word(word) ⇒ self

Defines an uncountable word.

Parameters:

  • word (String) —

    the uncountable word.

Returns:

  • (self) —

    the rules object.



98
99
100
101
102
103
104
 
# File 'lib/sleeping_king_studios/tools/toolbox/inflector/rules.rb', line 98

def define_uncountable_word(word)
  validate_string(word)

  @uncountable_words << word

  self
end

#inspect ⇒ String

Returns a human-readable representation of the rules object.

Returns:

  • (String) —

    a human-readable representation of the rules object.



107
108
109
 
# File 'lib/sleeping_king_studios/tools/toolbox/inflector/rules.rb', line 107

def inspect
  "#<SleepingKingStudios::Tools::Toolbox::Inflector::Rules:#{object_id}>"
end