Pluralize

[![NPM version][npm-image]][npm-url]
[![NPM downloads][downloads-image]][downloads-url]
[![Build Status][build-image]][build-url]
[![GitHub Super-Linter][superlint-image]][superlint-url]
![File Size][filesize-url]

> Pluralize and singularize any word.
> A fork of [pluralize]

Installation

``shell npm install pluralize-esm`

`$3`

`javascript var pluralize = require('pluralize-esm')`

`$3`

`javascript import pluralize from 'pluralize-esm'`

`Why?`

This module uses a predefined list of rules, applied in order, to singularize or pluralize a given word. There are many cases where this is useful, such as any automation based on user input. For applications where the word(s) are known ahead of time, you can use a simple ternary (or function) which would be a much lighter alternative.

`Usage`

- word: stringThe word to pluralize -count: numberHow many of the word exist -inclusive: boolean Whether to prefix with the number (e.g. 3 ducks)

Examples:

`javascript pluralize('test') //=> "tests" pluralize('test', 0) //=> "tests" pluralize('test', 1) //=> "test" pluralize('test', 5) //=> "tests" pluralize('test', 1, true) //=> "1 test" pluralize('test', 5, true) //=> "5 tests" pluralize('蘋果', 2, true) //=> "2 蘋果"

// Example of new plural rule: pluralize.plural('regex') //=> "regexes" pluralize.addPluralRule(/gex$/i, 'gexii') pluralize.plural('regex') //=> "regexii"

// Example of new singular rule: pluralize.singular('singles') //=> "single" pluralize.addSingularRule(/singles$/i, 'singular') pluralize.singular('singles') //=> "singular"

// Example of new irregular rule, e.g. "I" -> "we": pluralize.plural('irregular') //=> "irregulars" pluralize.addIrregularRule('irregular', 'regular') pluralize.plural('irregular') //=> "regular"

// Example of uncountable rule (rules without singular/plural in context): pluralize.plural('paper') //=> "papers" pluralize.addUncountableRule('paper') pluralize.plural('paper') //=> "paper"

// Example of asking whether a word looks singular or plural: pluralize.isPlural('test') //=> false pluralize.isSingular('test') //=> true``

License

MIT

[npm-image]: https://img.shields.io/npm/v/pluralize-esm.svg?style=flat
[npm-url]: https://npmjs.org/package/pluralize-esm
[downloads-image]: https://img.shields.io/npm/dm/pluralize-esm.svg?style=flat
[downloads-url]: https://npmjs.org/package/pluralize-esm
[filesize-url]: https://img.shields.io/bundlephobia/minzip/pluralize-esm?label=size
[pluralize]: https://npmjs.org/package/pluralize
[superlint-image]: https://github.com/stipsan/pluralize-esm/workflows/lint/badge.svg
[superlint-url]: https://github.com/marketplace/actions/super-linter
[build-image]: https://github.com/stipsan/pluralize-esm/workflows/build/badge.svg
[build-url]: https://github.com/stipsan/pluralize-esm/actions

Why?

This module uses a predefined list of rules, applied in order, to singularize or pluralize a given word. There are many cases where this is useful, such as any automation based on user input. For applications where the word(s) are known ahead of time, you can use a simple ternary (or function) which would be a much lighter alternative.

Usage

- word: string

 The word to pluralize
-

count: number

 How many of the word exist
-

inclusive: boolean Whether to prefix with the number (e.g. 3 ducks)

Examples:

javascript
pluralize('test') //=> "tests"
pluralize('test', 0) //=> "tests"
pluralize('test', 1) //=> "test"
pluralize('test', 5) //=> "tests"
pluralize('test', 1, true) //=> "1 test"
pluralize('test', 5, true) //=> "5 tests"
pluralize('蘋果', 2, true) //=> "2 蘋果"

// Example of new plural rule:
pluralize.plural('regex') //=> "regexes"
pluralize.addPluralRule(/gex$/i, 'gexii')
pluralize.plural('regex') //=> "regexii"

// Example of new singular rule:
pluralize.singular('singles') //=> "single"
pluralize.addSingularRule(/singles$/i, 'singular')
pluralize.singular('singles') //=> "singular"

// Example of new irregular rule, e.g. "I" -> "we":
pluralize.plural('irregular') //=> "irregulars"
pluralize.addIrregularRule('irregular', 'regular')
pluralize.plural('irregular') //=> "regular"

// Example of uncountable rule (rules without singular/plural in context):
pluralize.plural('paper') //=> "papers"
pluralize.addUncountableRule('paper')
pluralize.plural('paper') //=> "paper"

// Example of asking whether a word looks singular or plural:
pluralize.isPlural('test') //=> false
pluralize.isSingular('test') //=> true

License

MIT