Marc Mintel
5397309103
Some checks failed
Build & Deploy / 🔍 Prepare (push) Successful in 20s
Build & Deploy / 🧪 QA (push) Failing after 34s
Build & Deploy / 🏗️ Build (push) Has started running
Build & Deploy / 🚀 Deploy (push) Has been cancelled
Build & Deploy / 🧪 Smoke Test (push) Has been cancelled
Build & Deploy / ⚡ Lighthouse (push) Has been cancelled
Build & Deploy / 🔔 Notify (push) Has been cancelled
101 lines
3.0 KiB
Plaintext
101 lines
3.0 KiB
Plaintext
# Pluralize
|
|
|
|
[![NPM version][npm-image]][npm-url]
|
|
[![NPM downloads][downloads-image]][downloads-url]
|
|
[![Build status][travis-image]][travis-url]
|
|
[![Test coverage][coveralls-image]][coveralls-url]
|
|
![File Size][filesize-url]
|
|
[![CDNJS][cdnjs-image]][cdnjs-url]
|
|
|
|
> Pluralize and singularize any word.
|
|
|
|
## Installation
|
|
|
|
```
|
|
npm install pluralize --save
|
|
yarn add pluralize
|
|
bower install pluralize --save
|
|
```
|
|
|
|
### Node
|
|
|
|
```javascript
|
|
var pluralize = require('pluralize')
|
|
```
|
|
|
|
### AMD
|
|
|
|
```javascript
|
|
define(function (require, exports, module) {
|
|
var pluralize = require('pluralize')
|
|
})
|
|
```
|
|
|
|
### `<script>` tag
|
|
|
|
```html
|
|
<script src="pluralize.js"></script>
|
|
```
|
|
|
|
## Why?
|
|
|
|
This module uses a pre-defined 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
|
|
|
|
[npm-image]: https://img.shields.io/npm/v/pluralize.svg?style=flat
|
|
[npm-url]: https://npmjs.org/package/pluralize
|
|
[downloads-image]: https://img.shields.io/npm/dm/pluralize.svg?style=flat
|
|
[downloads-url]: https://npmjs.org/package/pluralize
|
|
[travis-image]: https://img.shields.io/travis/blakeembrey/pluralize.svg?style=flat
|
|
[travis-url]: https://travis-ci.org/blakeembrey/pluralize
|
|
[coveralls-image]: https://img.shields.io/coveralls/blakeembrey/pluralize.svg?style=flat
|
|
[coveralls-url]: https://coveralls.io/r/blakeembrey/pluralize?branch=master
|
|
[filesize-url]: https://img.shields.io/github/size/blakeembrey/pluralize/pluralize.js.svg?style=flat
|
|
[cdnjs-image]: https://img.shields.io/cdnjs/v/pluralize.svg
|
|
[cdnjs-url]: https://cdnjs.com/libraries/pluralize
|