Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/sarathkcm/pluralize.net

:blue_book: Pluralize or singularize any English word.
https://github.com/sarathkcm/pluralize.net

dotnet dotnet-core dotnet-standard english nuget plural pluralize pluralizer singular singularize singularizer

Last synced: 4 days ago
JSON representation

:blue_book: Pluralize or singularize any English word.

Host: GitHub
URL: https://github.com/sarathkcm/pluralize.net
Owner: sarathkcm
License: mit
Created: 2017-03-21T16:28:30.000Z (almost 8 years ago)
Default Branch: master
Last Pushed: 2022-03-15T11:03:17.000Z (almost 3 years ago)
Last Synced: 2025-01-30T08:18:32.409Z (5 days ago)
Topics: dotnet, dotnet-core, dotnet-standard, english, nuget, plural, pluralize, pluralizer, singular, singularize, singularizer
Language: C#
Homepage:
Size: 1.35 MB
Stars: 61
Watchers: 4
Forks: 22
Open Issues: 2
Metadata Files:
- Readme: README.md

Awesome Lists containing this project

README

        [![GitHub license](https://img.shields.io/github/license/sarathkcm/Pluralize.NET.svg)](https://github.com/sarathkcm/Pluralize.NET/blob/master/LICENCE) [![Build status](https://ci.appveyor.com/api/projects/status/orkh8wfdq6rk3pyo?svg=true)](https://ci.appveyor.com/project/sarathkcm/pluralize-net)  [![Coverage Status](https://coveralls.io/repos/github/sarathkcm/Pluralize.NET/badge.svg?branch=master&v=1)](https://coveralls.io/github/sarathkcm/Pluralize.NET?branch=master) 

[![NuGet](https://img.shields.io/nuget/v/Pluralize.NET.svg)](https://www.nuget.org/packages/Pluralize.NET/)

[![NuGet](https://img.shields.io/nuget/dt/Pluralize.NET.svg)](https://www.nuget.org/packages/Pluralize.NET/)

# What is it?

This is a C# port of Blake Embrey's [pluralize](https://github.com/blakeembrey/pluralize) library which helps in pluralizing or singularizing any English word. 

> Changes reflect commits up to https://github.com/blakeembrey/pluralize/commit/0265e4d131ecad8e11c420fa4be98b75dc92c33d from May 25, 2019.

# Why

I could not find a good C# alternative for converting words from singular to plural and vice versa. [System.Data.Entity.Design.PluralizationServices.PluralizationService](https://msdn.microsoft.com/en-us/library/system.data.entity.design.pluralizationservices.pluralizationservice(v=vs.110).aspx) and [Humanizer](http://humanizr.net/) library did not meet the expectations (try 'shoes' or 'toes'). However this small but awesome Javascript libray [pluralize](https://github.com/blakeembrey/pluralize) worked very well for me and I decided to convert the code to C# and use it.

# How

**Install from NuGet**

Using Package manager console

```

Install-Package Pluralize.NET

```

Using dotnet CLI

```

dotnet add package Pluralize.NET

```

Using paket CLI

```

paket add Pluralize.NET

```

**Include using directive**

```C#

using Pluralize.NET

```

**Write code**

```C#

IPluralize pluralizer = new Pluralizer();

pluralizer.Singularize("Horses");  //=> "Horse"

pluralizer.Pluralize("Horse");  //=> "Horses"

// Example of new plural rule:

pluralizer.Pluralize("regex"); //=> "regexes"

pluralizer.AddPluralRule(new Regex("gex$"), "gexii");

pluralizer.Pluralize("regex"); //=> "regexii"

// Example of new singular rule:

pluralizer.Singularize('singles'); //=> "single"

pluralizer.AddSingularRule(new Regex("singles"), 'singular');

pluralizer.Singularize('singles'); //=> "singular"

// Example of new irregular rule, e.g. "I" -> "we":

pluralizer.Pluralize('irregular'); //=> "irregulars"

pluralizer.AddIrregularRule('irregular', 'regular');

pluralizer.Pluralize('irregular'); //=> "regular"

// Example of uncountable rule (rules without singular/plural in context):

pluralizer.Pluralize('paper'); //=> "papers"

pluralizer.AddUncountableRule('paper');

pluralizer.Pluralize('paper'); //=> "paper"

// Example of asking whether a word looks singular or plural:

pluralizer.IsPlural('test'); //=> false

pluralizer.IsSingular('test'); //=> true

// Example of formatting a word based on count

pluralizer.Format(5, "dog"); // => "dogs"

pluralizer.Format(5, "dog", inclusive: true); // => "5 dogs"

```

**Profit!**

# Supported .NET Versions

The Nuget package supports the following .NET versions. This pretty much covers versions 4.0 and above. Please open an issue if you want to support any .NET version in particular.

* .NET 4.0

* .NET Standard 1.1

* .NET 4.5.1

* .NET 4.6

* .NET Standard 2.0

# Licence

[MIT](https://github.com/sarathkcm/Pluralize.NET/blob/master/LICENCE) - because the original project is MIT

## Contributors ✨

  

    
_{Sarath Kumar CM}
💻

    
_{Daniel Destouche}
💻

    
_{Dennis Pražák}
💻

  

This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!