Skip to main content

GitHub issues GitHub forks GitHub stars GitHub license

Deno Plural ~ πŸ™πŸ» = 🍞 🐟

deno-plural module helps you to pluralize or singularize a given word.

πŸ“ How to use

You just need to import the singular and plural functions from deno.land:

import { plural, singular } from "https://deno.land/x/deno_plural/mod.ts";

And use it!

const pluralWord = plural(`foot`); // Will return the string  `feet`
const singularWord = singular(`feet`); // Will return the string `foot`

πŸ€“ Advanced

Add a new Language

import {
  addRules,
  plural,
  setLanguage,
  singular,
} from "https://deno.land/x/deno_plural/mod.ts";
import itRules from "./myCustomRules/it.ts";

addRules("it", itRules);

setLanguage("it");

const pluralWord = plural(`persona`); // Will return the string  `persone`
const singularWord = singular(`persone`); // Will return the string `persona`

Don’t forget to also augment the type definition or Typescript will complain!

declare module "https://deno.land/x/deno_plural/mod.ts" {
  interface Languages {
    it: string;
  }
}

Use another language one-time

import { plural, singular } from "https://deno.land/x/deno_plural/mod.ts";

const pluralWord = plural(`persona`, "it"); // Will return the string  `persone`
const singularWord = singular(`people`); // Will return the string `person`

πŸŽ“ Example

import { plural, singular } from "https://deno.land/x/deno_plural/mod.ts";

const singulars = ["foot", "computer"];

let plurals: string[] = [];

console.log("Testing singular --> plural");
singulars.forEach((word) => {
  const pluralWord = plural(word);
  plurals.push(pluralWord);
  console.log(`The plural of ${word} is ${pluralWord}`);
});
console.log("---------------------------");
console.log("Testing plural --> singular");
plurals.forEach((word) => {
  console.log(`The singular of ${word} is ${singular(word)}`);
});

The output of this simple code will be:

Testing singular --> plural
The plural of foot is feet
The plural of computer is computers
---------------------------
Testing plural --> singular
The singular of feet is foot
The singular of computers is computer

πŸ™ Thanks

This project could not exist without the work of pluralize.