pygoruut 0.6.1

A Python wrapper for the goruut phonemization tool

pygoruut

Getting started

from pygoruut.pygoruut import Pygoruut

pygoruut = Pygoruut()

print(str(pygoruut.phonemize(language="English", sentence="fast racing car")))

# Prints: fˈæst ɹˈeɪsɪŋ kˈɑɹ

# Now, convert it back

print(str(pygoruut.phonemize(language="English", sentence="fˈæst ɹˈeɪsɪŋ kˈɑɹ", is_reverse=True)))

# Prints: fast racing car

Uyghur language, our highest quality language

print(str(pygoruut.phonemize(language="Uyghur", sentence="قىزىل گۈل ئاتا")))

# Prints: qizil gyl ʔɑtɑ

# Now, convert it back

print(str(pygoruut.phonemize(language="Uyghur", sentence="qizil gyl ʔɑtɑ", is_reverse=True)))

# Prints: قىزىل گۈل ئاتا

The quality of translation varies accros the 136 supported languages.

Advanced Use

Multi lingual sentences handling

Use comma (,) separated languages in language (the first language is the preferred language):

print(pygoruut.phonemize(language="English,Slovak", sentence="hello world ahojte notindictionary!!!!"))

# Prints: həlˈoʊ wəld aɦɔjcɛ nɔtɪndɪktˈɪoʊŋɑɹi!!!!

Numerics handling (English, Arabic)

print(str(pygoruut.phonemize(language="English", sentence="100 bottles")))

# Prints: wæn ˈhʌndəd bˈɑtəlz

Homograph handling (English)

print(str(pygoruut.phonemize(language="English", sentence="He dove into the pool to join the dove")))

# Prints: hˈi 'doʊv ˈɪntu ðə pˈul tə dʒˈɔɪn ðə 'dʌv

No punctuation

' '.join([w.Phonetic for w in pygoruut.phonemize(language="English", sentence="hello world!!!!").Words])

Force a specific version

A certain version is frozen, it will translate all words in the same way forever

from pygoruut.pygoruut import Pygoruut

pygoruut = Pygoruut(version='v0.6.1')

Configure a model download directory for faster startup

For faster startup, the model can be cached in the user-provided directory

from pygoruut.pygoruut import Pygoruut

pygoruut = Pygoruut(writeable_bin_dir='/home/john/')

If you want to cache it in user's home subdir .goruut, use:

from pygoruut.pygoruut import Pygoruut

pygoruut = Pygoruut(writeable_bin_dir='')