pluraljs

PluralJS

A micro library to produce any singular noun into plural

💡 Motive

I was curious to learn about how to build a library, what are the thought-processes behind it, what are the technical stuff you need to know etc. This was the primary reason PluralJS came into conception.

📥 Installation

via npm

npm install pluraljs --save

via yarn

yarn add pluraljs

via CDN direct link

<script src="https://cdn.jsdelivr.net/npm/pluraljs/dist/pluraljs.umd.min.js"></script>
<!-- or -->
<script src="https://unpkg.com/pluraljs/dist/pluraljs.umd.min.js"></script>

direct download

curl -o https://unpkg.com/pluraljs/dist/pluraljs.umd.min.js

📑 Usage

The PluralJS is single responsibility library. It takes only a noun (with optional count parameter) and produce plural noun out of it.

API

Node

const pluralJs = require('pluraljs');
console.log(pluralJs('cat')); // cats
 
console.log(pluralJs('cat', 1)); // cat
console.log(pluralJs('cat', 3)); // cats

ES6

import pluraJs from 'pluraljs';
console.log(pluralJs('cat')); // cats
 
console.log(pluralJs('cat', -4)); // cat

Browser

<script src="https://cdn.jsdelivr.net/npm/pluraljs/dist/pluraljs.umd.min.js"></script>
<script>
    console.log(pluralJs('cat')); // cats
    console.log(pluralJs('cat', '4')); // cats
</script> 

🧡 Show little more care in your product

Product without words pluralization	Product using PluralJS

📋 Changelog

1.1.0

• ENHANCEMENT Added ability to pass count parameter

1.0.0

• FEATURE Released first stable version

💂‍♂️Maintainer

Kalpesh Singh (@knowkalpesh)

🙇 Credits

• The core logic and testing file are borrowed from Blake Embrey's Pluralize
• Card screenshot used from Chakra UI
• Those lovely cats artwork used for branding is from Undraw

⚖️ License

kalpeshsingh/PluralJS is licensed under the MIT license.