Kapitalize

Kapitalize is a library to capitalize people's names.

At the time of writing the library supports namecases that includes: Mc, Mac, al, el, ap, da, de, delle, della, di, du, del, der, la, le, lo, van and von.

Kapitalize correctly deals with names which contain apostrophies and hyphens too.

There are "special rules" for the following languages: Italian, Spanish and Hebrew.

Kapitlize is not perfect and never will, some names may be incorrectly capitalized.

Getting started

Compile from sources

git clone or download this repo.
Open a terminal in the directory where the sources are stored.
Execute gradlew assemble .

Add to your project

Kapitalize can be easily added to your existing project through Maven or Gradle.

Maven

Add the JitPack repository

<repositories>
	<repository>
            <id>jitpack.io</id>
	    <url>https://jitpack.io</url>
	</repository>
</repositories>

Add the dependency

<dependency>
    <groupId>com.github.LithiumSR</groupId>
    <artifactId>Kapitalize</artifactId>
    <version>1.6.0</version>
</dependency>

Gradle

Add it in your root build.gradle at the end of repositories:

allprojects {
    repositories {
		maven { url 'https://jitpack.io' }
	}
}

Add the dependency

dependencies {
    implementation 'com.github.LithiumSR:Kapitalize:1.6.0'
}

Examples

// Create a kapitalize object to analyze english language with no special rules
val kapitalize = Kapitalize()
// Create a kapitalize object with italian-specific rules
val kapitalizeItalian = Kapitalize(EnglishLanguage(SpecialRules.ITALIAN)


// Capitalize everything!
println(kapitalize.capitalize("hEnRy vIi") // output: "Henry VIII"
println(kapitalize.capitalize("AP LLWYD DAFYDD") // output: "ap Llwyd Dafydd"
println(kapitalize.capitalize("O'CALLAGHAN") // output: "O'Callaghan"
println(kapitalize.capitalize(" mckenna ") // output: "McKenna"
println(kapitalize.capitalize("LEIGH-WILLIAMS ") // output: "Leigh-Williams"
println(kapitalizeItalian.capitalize("silvio dei giudici") // output: "Silvio Dei Giudici"

Acknowledgments