Skip to content

✍ A tiny pluralizer for English nouns

License

Notifications You must be signed in to change notification settings

kwaimind/tinyplural

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

27 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

✍ tinyplural

bundlephobia npm version Run Jest Tests CodeQL

A tiny pluralizer for English nouns

tinyplural is an easy to use utility function that converts your strings into their relevant plurals dynamically. Comes with 0 dependencies.

Demo

import tinyplural from 'tinyplural';

const formattedDate = tinyplural('day', 2);

return (
  <>
    <p>Next payment due in {formattedDate}</p>
  </>
);

// => Next payment due in 2 days

It's fully written in TypeScript, with a test-suite to go with it.

The library is available as an npm package. To install the package run:

npm install tinyplural --save
# or with yarn
yarn add tinyplural

Want to get involved! Read our Contributors' Guide for details.

Found a bug or a rule that doesn't work? Open a bug report ticket.

Got a feature to add? Fork the repo, add your changes, and make a pull request.

Info

Say you need to present a promocode that ends in a number of days. Using tinyplural, you can just give the singular noun and the value and it will return the correct plural version.

Noun Plural
day days
hero heroes
goose geese
fish fish

Resources

These are some good guides explaining the rules behind plural nouns in English: