String pluralization

[jodosha]

Feature

Introduce pluralization for strings.

How

It adds a new public API method: Utils::String#pluralize, which returns a new pluralized instance of the same type.

string = Lotus::Utils::String.new("flower")
string.pluralize       # => "flowers"
string.pluralize.class # => Lotus::Utils::String

The implementation is delegated to a new module: Lotus::Utils::Inflector. It exposes .pluralize which works with Ruby's String.

Lotus::Utils::Inflector.pluralize("flower")       # => "flowers"
Lotus::Utils::Inflector.pluralize("flower").class # => String

Pluralization is idempotent.

Lotus::Utils::Inflector.pluralize(
  Lotus::Utils::Inflector.pluralize("cars")
) # => "cars"

It respects the case:

Lotus::Utils::Inflector.pluralize("Application") # => "Applications"

Exceptions

English is a really hard language to pluralize. This implementation takes care of a lot of exceptions.

Singular	Plural
radix	radices
alumnus	alumni
criterion	criteria
vertebra	vertebrae
hero	heroes
lumen	lumina
stigma	stigmata
iris	irides
impetus	impetuses
lens	lenses
bureau	bureaux

Benchmark

TL;DR: ActiveSupport pluralization is 2x faster.

  Calculating -------------------------------------
                 utils     8.000  i/100ms
                    AS    20.000  i/100ms
  -------------------------------------------------
                 utils     82.743  (± 2.4%) i/s -    416.000
                    AS    199.489  (± 4.5%) i/s -      1.000k

https://gist.github.com/jodosha/55bafdd83a89741258fd

---

Ref hanami/router#51