countable-inflections: Countable Text Inflections

[ library, mit, text ] [ Propose Tags ] [ Report a vulnerability ]

Provides methods for singularizing and pluralizing text. The library is based on Rails' inflections.


[Skip to Readme]

Flags

Manual Flags

NameDescriptionDefault
dev

Turn on development settings.

Disabled

Use -f <flag> to enable a flag, or -f -<flag> to disable that flag. More info

Downloads

Maintainer's Corner

Package maintainers

For package maintainers and hackage trustees

Candidates

Versions [RSS] 0.0.1, 0.1.0, 0.2.0, 0.3.0
Change log CHANGELOG.md
Dependencies base (>=4.8 && <5), bytestring, exceptions, pcre-utils, regex-pcre-builtin, text [details]
License MIT
Copyright 2016 Brady Ouren
Author Brady Ouren <brady.ouren@gmail.com>
Maintainer Brady Ouren <brady.ouren@gmail.com>
Category Text
Home page https://github.com/tippenein/countable-inflections
Bug tracker https://github.com/tippenein/countable-inflections/issues
Source repo head: git clone https://github.com/tippenein/countable-inflections.git
Uploaded by tippenein at 2020-12-22T18:26:31Z
Distributions NixOS:0.3.0
Reverse Dependencies 1 direct, 0 indirect [details]
Downloads 2520 total (10 in the last 30 days)
Rating (no votes yet) [estimated by Bayesian average]
Your Rating
  • λ
  • λ
  • λ
Status Docs available [build log]
Last success reported on 2020-12-22 [all 1 reports]

Readme for countable-inflections-0.3.0

[back to package description]

Countable Inflections

License MIT Hackage Stackage LTS Build Status

This library implements pluralization and singularization in a similar way to the rails inflectors

It uses regexes to define the non-standard transformations and therefore doesn't provide much safety. If you need to provide the same pluralization and singularization which rails does out of the box, this will work the same. If you want more you should be using inflections-hs which uses megaparsec to give you more guarantees

Usage

λ: pluralize "person"
"people"

λ: singularize "branches"
"branch"

These can also be given custom inflection matchers

λ: :t singularizeWith
[Inflection] -> Text -> Text

There are 3 different types of transformations:

Match

Takes a PCRE regex and a replacement string.

λ: :t makeMatchMapping
[(RegexPattern, RegexReplace)] -> [Inflection]

λ: let mapping = makeMatchMapping [("(octop)us", "\\1i")]
λ: pluralizeWith mapping "octopus"
"octopi"

Irregular

From singular to plural with no greater pattern.

λ: :t makeIrregularMapping
[(Singular, Plural)] -> [Inflection]

λ: let mapping = makeIrregularMapping [("zombie","zombies")]
λ: pluralizeWith mapping "zombie"
"zombies"

Uncountable

Doesn't have a mapping, word stays the same) so it has the type:

[Text] -> [Inflection]

Inflect

In general you can input a number and singularize or pluralize based on the count, for example:

setReport = do
  sets <- getSets
  n <- length sets
  print $ show n ++ " " ++ inflect "sets" n

This way it'll list as "1 set" or "5 sets" based on the input.

License

MIT - see the LICENSE file.