transliterate 1.10.2

Simple usage

Required imports

from transliterate import translit, get_available_language_codes

Original text

text = "Lorem ipsum dolor sit amet"

Transliteration to Armenian

print(translit(text, 'hy'))

# Լօրեմ իպսում դօլօր սիտ ամետ

Transliteration to Georgian

print(translit(text, 'ka'))

# ლორემ იპსუმ დოლორ სით ამეთ

Transliteration to Greek

print(translit(text, 'el'))

# Λορεμ ιψθμ δολορ σιτ αμετ

Transliteration to Russian

print(translit(text, 'ru'))

# Лорем ипсум долор сит амет

List of available (registered) languages

print(get_available_language_codes())

# ['el', 'hy', 'ka', 'ru']

Reversed transliterations are transliterations made from target language to source language (in terms they are defined in language packs). In case of reversed transliterations, you may leave out the language_code attribute, although if you know it on beforehand, specify it since it works faster that way.

Reversed transliteration from Armenian

print(translit(u"Լօրեմ իպսում դօլօր սիտ ամետ", 'hy', reversed=True))

# Lorem ipsum dolor sit amet

Reversed transliteration from Armenian with language_code argument left out

print(translit(u"Լօրեմ իպսում դօլօր սիտ ամետ", reversed=True))

# Lorem ipsum dolor sit amet

Reversed transliteration from Georgian

print(translit(u"ლორემ იპსუმ დოლორ სით ამეთ", 'ka', reversed=True))

# Lorem ipsum dolor sit amet

Reversed transliteration from Georgian with language_code argument left out

print(translit(u"ლორემ იპსუმ დოლორ სით ამეთ", reversed=True))

# Lorem ipsum dolor sit amet

Reversed transliteration from Greek

print(translit(u"Λορεμ ιψθμ δολορ σιτ αμετ", 'el', reversed=True))

# Lorem ipsum dolor sit amet

Reversed transliteration from Greek with language_code argument left out

print(translit(u"Λορεμ ιψθμ δολορ σιτ αμετ", reversed=True))

# Lorem ipsum dolor sit amet

Reversed transliteration from Russian (Cyrillic)

print(translit(u"Лорем ипсум долор сит амет", 'ru', reversed=True))

# Lorеm ipsum dolor sit amеt

Reversed transliteration from Russian (Cyrillic) with language_code argument left out

print(translit(u"Лорем ипсум долор сит амет", reversed=True))

# Lorem ipsum dolor sit amet

Testing the decorator

from transliterate.decorators import transliterate_function

@transliterate_function(language_code='hy')
def decorator_test(text):
    return text

print(decorator_test(u"Lorem ipsum dolor sit amet"))

# Լօրեմ իպսում դօլօր սիտ ամետ

Working with large amounts of data

If you know which language pack shall be used for transliteration, especially when working with large amounts of data, it makes sense to get the transliteration function in the following way:

from transliterate import get_translit_function

translit_hy = get_translit_function('hy')

print(translit_hy(u"Լօրեմ իպսում դօլօր սիտ ամետ", reversed=True))
# Lorem ipsum dolor sit amet

print(translit_hy(u"Lorem ipsum dolor sit amet"))
# Լօրեմ իպսում դօլօր սիտ ամետ

Registering a custom language pack

from transliterate.discover import autodiscover
autodiscover()

from transliterate.base import TranslitLanguagePack, registry

class ExampleLanguagePack(TranslitLanguagePack):
    language_code = "example"
    language_name = "Example"
    mapping = (
        u"abcdefghij",
        u"1234567890",
    )

registry.register(ExampleLanguagePack)

print(get_available_language_codes())

# ['el', 'hy', 'ka', 'ru', 'example']

print(translit(text, 'example'))

# Lor5m 9psum 4olor s9t 1m5t

registry.register(ExampleLanguagePack, force=True)

Using the lorem ipsum generator

Note, that due to incompatibility of the original lorem-ipsum-generator package with Python 3, when used with Python 3 transliterate uses its’ own simplified fallback lorem ipsum generator (which still does the job).

Required imports

from transliterate.contrib.apps.translipsum import TranslipsumGenerator

Generating paragraphs in Armenian

g_am = TranslipsumGenerator(language_code='hy')
print(g_am.generate_paragraph())

# Մագնա տրիստիքուե ֆաուցիբուս ֆամես նետուս նետուս օրցի մաուրիս,
# սուսցիպիտ. Դապիբուս րիսուս սեդ ադիպիսցինգ դիցտում. Ֆերմենտում ուրնա
# նատօքուե ատ. Uլտրիցես եգետ, տացիտի. Լիտօրա ցլասս ցօնուբիա պօսուերե
# մալեսուադա ին իպսում իդ պեր վե.

Generating sentense in Georgian

g_ka = TranslipsumGenerator(language_code='ka')
print(g_ka.generate_sentence())

# გგეთ ყუამ არსუ ვულფუთათე რუთრუმ აუთორ.

Generating sentense in Greek

g_el = TranslipsumGenerator(language_code='el')
print(g_el.generate_sentence())

# Νεc cρασ αμετ, ελιτ vεστιβθλθμ εθ, αενεαν ναμ, τελλθσ vαριθσ.

Generating sentense in Russian (Cyrillic)

g_ru = TranslipsumGenerator(language_code='ru')
print(g_ru.generate_sentence())

# Рисус cонсеcтетуер, фусcе qуис лаореет ат ерос пэдэ фелис магна.

Language detection

Required imports

from transliterate import detect_language

Detect Armenian text

detect_language(u'Լօրեմ իպսում դօլօր սիտ ամետ')

# hy

Detect Georgian text

detect_language(u'ლორემ იპსუმ დოლორ სით ამეთ')

# ka

Detect Greek text

detect_language(u'Λορεμ ιψθμ δολορ σιτ αμετ')

# el

Detect Russian (Cyrillic) text

detect_language(u'Лорем ипсум долор сит амет')

# ru

Slugify

Required imports

from transliterate import slugify

Slugify Armenian text

slugify(u'Լօրեմ իպսում դօլօր սիտ ամետ')

# lorem-ipsum-dolor-sit-amet

Slugify Georgian text

slugify(u'ლორემ იპსუმ დოლორ სით ამეთ')

# lorem-ipsum-dolor-sit-amet

Slugify Greek text

slugify(u'Λορεμ ιψθμ δολορ σιτ αμετ')

# lorem-ipsum-dolor-sit-amet

Slugify Russian (Cyrillic) text

slugify(u'Лорем ипсум долор сит амет')

# lorem-ipsum-dolor-sit-amet