Pluralize

Pluralize and singularize any word.

License	MIT License
GroupId	io.github.encryptorcode
ArtifactId	pluralize
Last Version	1.0.0
Release Date	Apr 6, 2020
Type	jar
Description	Pluralize Pluralize and singularize any word.
Project URL	https://github.com/encryptorcode/pluralize
Source Code Management	https://github.com/encryptorcode/pluralize/tree/master

Download pluralize

Filename	Size
pluralize-1.0.0.pom
pluralize-1.0.0.jar	11 KB
pluralize-1.0.0-sources.jar	6 KB
pluralize-1.0.0-javadoc.jar	411 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/io.github.encryptorcode/pluralize/ -->
<dependency>
    <groupId>io.github.encryptorcode</groupId>
    <artifactId>pluralize</artifactId>
    <version>1.0.0</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/io.github.encryptorcode/pluralize/
implementation 'io.github.encryptorcode:pluralize:1.0.0'

Gradle Kotlin

// https://jarcasting.com/artifacts/io.github.encryptorcode/pluralize/
implementation ("io.github.encryptorcode:pluralize:1.0.0")

Apache Buildr

'io.github.encryptorcode:pluralize:jar:1.0.0'

Apache Ivy

<dependency org="io.github.encryptorcode" name="pluralize" rev="1.0.0">
  <artifact name="pluralize" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='io.github.encryptorcode', module='pluralize', version='1.0.0')
)

Scala SBT

libraryDependencies += "io.github.encryptorcode" % "pluralize" % "1.0.0"

Leiningen

[io.github.encryptorcode/pluralize "1.0.0"]

Dependencies

test (2)

Group / Artifact	Type	Version
junit : junit	jar	4.13
pl.pragmatists : JUnitParams	jar	1.0.5

Project Modules

There are no modules declared in this project.

Pluralize

Pluralize and singularize any word.

Installation

Maven

<dependency>
  <groupId>io.github.encryptorcode</groupId>
  <artifactId>pluralize</artifactId>
  <version>${pluralize.version}</version>
</dependency>

Why?

This module uses a pre-defined list of rules, applied in order, to singularize or pluralize a given word. There are many cases where this is useful, such as any automation based on user input. For applications where the word(s) are known ahead of time, you can use a simple ternary (or function) which would be a much lighter alternative.

Usage

• word: string The word to pluralize
• count: number How many of the word exist
• inclusive: boolean Whether to prefix with the number (e.g. 3 ducks)

Examples:

import io.github.encryptorcode.pluralize.Pluralize;
import static io.github.encryptorcode.pluralize.Pluralize.*;

public class Example{
    public static void main(String[] args){
        pluralize("test"); //=> "tests"
        pluralize("test", 0); //=> "tests"
        pluralize("test", 1); //=> "test"
        pluralize("test", 5); //=> "tests"
        pluralize("test", 1, true); //=> "1 test"
        pluralize("test", 5, true); //=> "5 tests"
        pluralize("蘋果", 2, true); //=> "2 蘋果"

        // Example of new plural rule:
        Pluralize.plural("regex"); //=> "regexes"
        Pluralize.addPluralRule(p("gex$"), "gexii");
        Pluralize.plural("regex"); //=> "regexii"

        // Example of new singular rule:
        Pluralize.singular("singles"); //=> "single"
        Pluralize.addSingularRule(p("singles"), "singular");
        Pluralize.singular("singles"); //=> "singular"

        // Example of new irregular rule, e.g. "I" -> "we":
        Pluralize.plural("irregular"); //=> "irregulars"
        Pluralize.addIrregularRule("irregular", "regular");
        Pluralize.plural("irregular"); //=> "regular"

        // Example of uncountable rule (rules without singular/plural in context):
        Pluralize.plural("paper"); //=> "papers"
        Pluralize.addUncountableRule("paper");
        Pluralize.plural("paper"); //=> "paper"

        // Example of asking whether a word looks singular or plural:
        Pluralize.isPlural("test"); //=> false
        Pluralize.isSingular("test"); //=> true
    }
}

Credits

The actual javascript version of this library is maintained at blakeembrey/pluralize. I've only helped to translate the code to Java. Also, I assure to have the least deviations from the actual code written and maintained by @blakeembrey

License

MIT

Encryptor Code

Versions

Version
1.0.0 Apr 6, 2020