dgetahun473 / fidel

Python package that can change Amharic language that written in English alphabet to Amharic alphabet character.

Fidel / ፊደል

What is Fidel / ፊደል ?

Fidel is a python package that can change Amharic language that written in English alphabet to Amharic alphabet character.
| For example: abebe beso bela -> አበበ በሶ በላ

Dependencies

• Symspellpy

Installation

pip install fidel

Upgrade

pip install --upgrade fidel

Usage

Basic Usage

from fidel import Translate
text = "bexam xru sew new"
translated = Translate(text).translate()
print(translated)

output

በጣም ጥሩ ሰው ነው

Autocorrect

from fidel import Translate
text = "betam tiru sew nw"
translated = Translate(text=text,autoCorrect=False).translate() # The default is False
corrected = Translate(text=text,autoCorrect=True).translate()
print(f"Translated : {translated}")
print(f"Corrected: {corrected}")

output

Translated : በታም ቲሩ ሰው ንው
Corrected: በጣም ጥሩ ሰው ነው

Amharic Symbol

from fidel import Translate
text = "abebe, kebede ena ayele bexam xru sew nachew."
symbol_true = Translate(text=text,symbol=True).translate() # The default is True
symbol_false = Translate(text=text,symbol=False).translate()
print(f"True symbol: {symbol_true}")
print(f"False symbol: {symbol_false}")

output

True symbol:  አበበ፣ ከበደ እና አየለ በጣም ጥሩ ሰው ናቸው።
False symbol: አበበ, ከበደ እና አየለ በጣም ጥሩ ሰው ናቸው.

Exclude words and split words

Exclude words from being translated.

• To prevent words from being translate, put the words inside "``"

from fidel import Translate
text = "`Alex` xru sew new"
translated = Translate(text).translate()
print(translated)

output

Alex ጥሩ ሰው ነው

Split words

• To prevent words from being ዲቃላ (The eigth letters) we should put "|" between consonants.

from fidel import Translate
text = "ljtua t|sewer" # Without "|" the output is "ልጅቷ ጸወር"
translated = Translate(text).translate()
print(translated)

output

ልጅቷ ትሰወር

Reverse Translate

from fidel import Reverse
text = "በጣም ጥሩ ሰው ነው።"
reversed = Reverse(text, symbol=True) # The default symbol value is True 
print(reversed)

output

betam xru sew nw.

Rules

There are some rules that should be apply when writing the text.

1. For 1st alphabets (ለግዕዝ) use "e" example: "le" - ለ
2. For 2nd alphabets (ለካእብ) use "u" example: "lu" - ሉ
3. For 3rd alphabets (ለሳልስ) use "i" example: "li" - ሊ
4. For 4rh alphabets (ለራዕብ) use "a" example: "la" - ላ
5. For 5th alphabets (ለሀምስ) use "ie" example: "lie" - ሌ
6. For 6th alphabets (ለሳድስ) use only vowel example: "l" - ል
7. For 7th alphabets (ለሳብዕ) use "o" example: "lo" - ሎ
8. For 8th alphabets(ለዲቃላ ቃላት) use "ua" example: "ua" - ሏ

Note The above rules may violate for some alphabets family check out ambiguous alphabets.

Ambiguous alphabets

ግዕዝ	ካእብ	ሳልስ	ራዕብ	ሀምስ	ሳድስ	ሳብዕ
ሀ	ሁ	ሂ	ሀ	ሄ	ህ	ሆ
ha	hu	hi	ha	hie	h	ho
አ	ኡ	ኢ	ኣ	ኤ	እ	ኦ
a	u	i	a	ie	e	o
ተ	ቱ	ቲ	ታ	ቴ	ት	ቶ
te	tu	ti	ta	tie	t	to
ጠ	ጡ	ጢ	ጣ	ጤ	ጥ	ጦ
xe	xu	xi	xa	xie	x	xo
ቸ	ቹ	ቺ	ቻ	ቼ	ች	ቾ
che	chu	chi	cha	chie	ch	cho
ጨ	ጩ	ጪ	ጫ	ጬ	ጭ	ጮ
ce	cu	ci	ca	cie	c	co
ጰ	ጱ	ጲ	ጳ	ጴ	ጵ	ጶ
phe	phu	phi	pha	phie	ph	pho
ፐ	ፑ	ፒ	ፓ	ፔ	ፕ	ፖ
pe	pu	pi	pa	pie	p	po

Addition

Alphabets	ሸ	ኘ	ዥ	ጸ
Prefix	sh	gn	zh	ts