pig-latinizer
Version:
Translates English text to Pig Latin, with proper handling of capitalization, punctuation, and hyphenated phrases
59 lines (35 loc) • 2.67 kB
Markdown
# pig-latinizer
Translates English text to Pig Latin, with proper handling of capitalization, punctuation, and hyphenated phrases.
*Igpay Atinlay orfay ouryay AvaScriptjay/YpeScript-tay ojectpray. Atwhay ouldcay ebay etterbay? (Exceptyay aconbay, ofyay oursecay.)*
[](https://travis-ci.org/jakshin/pig-latinizer) [](https://coveralls.io/github/jakshin/pig-latinizer?branch=master)
### Why?
Other Pig-Latin translators exist, but none of them worked as well as I wanted, so I created this one. Highlights:
* It preserves all punctuation and whitespace perfectly, including tabs and line breaks.
* It splits input words on whitespace, slashes, underscores, and dashes (not just whitespace), so `perfectly-fried bacon and/or ham is _so_tasty_` translates to `erfectlypay-iedfray aconbay andyay/oryay amhay isyay _osay_astytay_`.
* It handles capitalization and all-caps nicely, so `Bacon is AWESOME!` translates to `Aconbay isyay AWESOMEYAY!`.
* It knows that `Y` is a consonant at the beginning of a word, and a vowel otherwise, so `yellow` becomes `ellowyay` and `bytes` becomes `ytesbay`.
* It hyphenates when needed to prevent hard-to-read repeated consonants from appearing at the end of translated words, so `sheesh` and `peep` become `eesh-shay` and `eep-pay`.
* It removes apostrophes in possessives and contractions to avoid mangling them, while still preserving leading and trailing apostrophes, e.g. `A pig's ears aren't tasty, don't eat 'em` translates to `Ayay igspay earsyay arentyay astytay, ontday eatyay 'emyay` - no awkward `ig'spay`, `aren'tyay`, or `on'tday`.
* It doesn't mangle words for which there is no rational Pig Latin translation, such as `HTML`, `Odd13`, and `v1.0` - they're passed though as-is.
* It allows words to be added to an exclusions list; excluded words will be passed through without translation.
* It has no dependencies, so it won't bloat up your bundle.
* It comes with TypeScript bindings.
### Install/Uninstall
```sh
yarn add pig-latinizer
yarn remove pig-latinizer
```
### Usage in TypeScript
```typescript
import PigLatin from "pig-latinizer"
const pigLatin: PigLatin = new PigLatin()
pigLatin.exclusions.push("woot")
const translated: string = pigLatin.translate("Bacon, woot!") // Aconbay, woot!
```
### Usage in Node
```javascript
const PigLatin = require("pig-latinizer").default
const pigLatin = new PigLatin()
pigLatin.exclusions.push("woot")
const translated = pigLatin.translate("Bacon, woot!") // Aconbay, woot!
```