Pluralize.NET

KO | EN

gitlite — search

#javascript #react #ai #typescript #golang #android #deep-learning #linux #docker #awesome #cli #kubernetes #mcp #openai

(★ 65)

:blue_book: Pluralize or singularize any English word.

Pluralize.NET Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

[![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 ✨

<table>
 <tr>
 <td align="center"><a href="https://github.com/sarathkcm"><img src="https://avatars0.githubusercontent.com/u/14143311?v=4" width="100px;" alt=""/> Sarath Kumar CM</a> <a href="https://github.com/sarathkcm/Pluralize.NET/commits?author=sarathkcm" title="Code">💻</a></td>
 <td align="center"><a href="https://www.linkedin.com/in/daniel-destouche/"><img src="https://avatars3.githubusercontent.com/u/2773690?v=4" width="100px;" alt=""/> Daniel Destouche</a> <a href="https://github.com/sarathkcm/Pluralize.NET/commits?author=ghost1face" title="Code">💻</a></td>
 <td align="center"><a href="https://sorashi.github.io"><img src="https://avatars0.githubusercontent.com/u/6270283?v=4" width="100px;" alt=""/> Dennis Pražák</a> <a href="https://github.com/sarathkcm/Pluralize.NET/commits?author=sorashi" title="Code">💻</a></td>
 </tr>
</table>

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

Pluralize.NET

Pluralize.NET Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Pluralize.NET

Pluralize.NET Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README