feat: add pluralizer package

contracts/support/pluralizer/inflector.go

@@ -0,0 +1,8 @@
+package pluralizer
+
+type Inflector interface {
+	Language() Language
+	Plural(word string) string
+	SetLanguage(language Language) Inflector
+	Singular(word string) string
+}

contracts/support/pluralizer/language.go

@@ -0,0 +1,26 @@
+package pluralizer
+
+type Language interface {
+	Name() string
+	SingularRuleset() Ruleset
+	PluralRuleset() Ruleset
+}
+
+type Transformation interface {
+	Apply(word string) string
+}
+
+type Pattern interface {
+	Matches(word string) bool
+}
+
+type Substitution interface {
+	From() string
+	To() string
+}
+
+type Transformations []Transformation
+
+type Patterns []Pattern
+
+type Substitutions []Substitution

contracts/support/pluralizer/rules.go

@@ -0,0 +1,9 @@
+package pluralizer
+
+type Ruleset interface {
+	AddIrregular(substitutions ...Substitution) Ruleset
+	AddUninflected(words ...string) Ruleset
+	Regular() Transformations
+	Uninflected() Patterns
+	Irregular() Substitutions
+}

errors/list.go

@@ -136,6 +136,11 @@ var (
 	PackageRegistrationDuplicate = New("'%s' had been registered")
 	PackageRegistrationNotFound  = New("'%s' not found, cannot insert before it")
 
+	PluralizerLanguageNotFound     = New("language %s not found").SetModule(ModulePluralizer)
+	PluralizerEmptyLanguageName    = New("language name cannot be empty").SetModule(ModulePluralizer)
+	PluralizerNoSubstitutionsGiven = New("no substitutions provided").SetModule(ModulePluralizer)
+	PluralizerNoWordsGiven         = New("no words provided").SetModule(ModulePluralizer)
+
 	QueueDriverFailedToPop           = New("failed to pop job from %s queue: %v")
 	QueueDriverInvalid               = New("%s doesn't implement contracts/queue/driver")
 	QueueDriverNoJobFound            = New("no job found in %s queue")

errors/modules.go

@@ -18,6 +18,7 @@ var (
 	ModuleMigration  = "migration"
 	ModuleOrm        = "orm"
 	ModulePackages   = "packages"
+	ModulePluralizer = "pluralizer"
 	ModuleQueue      = "queue"
 	ModuleRoute      = "route"
 	ModuleSchema     = "schema"