natural amharic

app/bot/handlers/errors.py

@@ -9,7 +9,7 @@ from app.config import get_settings
 
 log = logging.getLogger(__name__)
 _last_notified: dict[str, float] = {}
-NOTICE = "⚠️ ችግር ተፈጥሯል፣ እባክዎ እንደገና ይሞክሩ።\nSomething went wrong, please try again."
+NOTICE = "⚠️ ውይ፣ ችግር ተፈጠረ። እባካችሁ እንደገና ሞክሩ።\nSomething went wrong, please try again."
 
 
 async def on_error(event: ErrorEvent, bot: Bot) -> bool:

app/bot/keyboards/library.py

@@ -5,18 +5,12 @@ from aiogram.types import InlineKeyboardButton, InlineKeyboardMarkup
 from app.core.catalog import KINDS
 from app.core.i18n import t
 from app.db.models import Course, Material
+from app.core.labels import clip, course_label as _course_label
 from app.services.classifier import display_title
 
 
-def clip(text: str, n: int = 48) -> str:
-    return text if len(text) <= n else text[: n - 1] + "…"
-
-
 def course_label(c: Course) -> str:
-    """Short enough for one button line: "code · name" when it fits, else just the name."""
-    if c.code and len(c.code) + 3 + len(c.name) <= 36:
-        return f"{c.code} · {c.name}"
-    return clip(c.name, 36)
+    return _course_label(c.code, c.name)
 
 
 def course_icon(c: Course) -> str:

app/core/labels.py

@@ -0,0 +1,12 @@
+"""Short labels for buttons (pure, so they can be tested without Telegram)."""
+
+
+def clip(text: str, n: int = 48) -> str:
+    return text if len(text) <= n else text[: n - 1] + "…"
+
+
+def course_label(code, name: str) -> str:
+    """One button line: "code · name" when it fits, else just the name."""
+    if code and len(code) + 3 + len(name) <= 36:
+        return f"{code} · {name}"
+    return clip(name, 36)

locales/am.json

@@ -1,66 +1,66 @@
 {
-  "welcome": "👋 ሰላም <b>{name}</b>!\nወደ <b>DBU Central</b> እንኳን በደህና መጡ።",
-  "gate_text": "ቦቱን ለመጠቀም መጀመሪያ ቻናሉን እና የውይይት ፎረሙን ይቀላቀሉ 👇\nከዚያ «✅ ተቀላቅያለሁ» ይጫኑ።",
-  "gate_join_btn": "📢 ቻናሉን ተቀላቀል",
+  "welcome": "👋 ሰላም <b>{name}</b>!\nወደ <b>DBU Central</b> እንኳን ደህና መጣችሁ 🎓",
+  "gate_text": "ቦቱን ለመጠቀም ቻናላችንንና የውይይት ግሩፓችንን መቀላቀል ያስፈልጋል 👇\nከዛ በኋላ «✅ ተቀላቅያለሁ» ንኩ።",
+  "gate_join_btn": "📢 ቻናሉን ተቀላቀሉ",
   "gate_check_btn": "✅ ተቀላቅያለሁ",
-  "gate_not_yet": "ገና ቻናሉን አልተቀላቀሉም። መጀመሪያ ይቀላቀሉ።",
-  "choose_stream": "የትኛው ዘርፍ ላይ ነዎት?",
+  "gate_not_yet": "ገና አልተቀላቀላችሁም፤ መጀመሪያ ተቀላቀሉ።",
+  "choose_stream": "ዘርፋችሁ የትኛው ነው? 🎓",
   "stream_natural": "🔬 ተፈጥሮ ሳይንስ",
   "stream_social": "📖 ማህበራዊ ሳይንስ",
-  "choose_year": "የትኛው ዓመት ላይ ነዎት?",
+  "choose_year": "ስንተኛ ዓመት ተማሪ ናችሁ?",
   "year_label": "{n}ኛ ዓመት",
-  "onboarded": "✅ ተመዝግበዋል! ከታች ካለው ምናሌ ይምረጡ።",
-  "menu_title": "ዋና ምናሌ 👇",
-  "btn_library": "📚 ቤተ-መጻሕፍት",
+  "onboarded": "✅ ተመዝግባችኋል! ከታች ካለው ሜኑ የፈለጋችሁትን ምረጡ 👇",
+  "menu_title": "ምን ላግዛችሁ? 👇",
+  "btn_library": "📚 ማቴሪያሎች",
   "btn_gpa": "🧮 GPA ማስያ",
-  "btn_invite": "👥 ጓደኛ ጋብዝ",
+  "btn_invite": "👥 ጓደኛ ጋብዙ",
   "btn_lang": "🌐 ቋንቋ",
-  "soon": "🚧 ይህ ክፍል በቅርቡ ይመጣል።",
-  "invite_text": "🔗 የእርስዎ መጋበዣ ሊንክ፦\n{link}\n\nየጋበዙት: <b>{count}</b> · ንቁ የሆኑ: <b>{qualified}</b>\nXP: <b>{points}</b>\n\nጓደኛዎ ቢያንስ 3 ቀን ንቁ ሲሆን ትልቁ ጉርሻ ይከፈላል።",
-  "referral_reward": "👥 አዲስ ጓደኛ በሊንክዎ ተቀላቅሏል! +{points} XP\nጓደኛው ንቁ ተማሪ ሲሆን ተጨማሪ ይከፈላል።",
-  "lang_changed": "✅ ቋንቋ ወደ አማርኛ ተቀይሯል።",
-  "banned": "⛔ መለያዎ ታግዷል።",
-  "btn_profile": "👤 ፕሮፋይል",
+  "soon": "🚧 ይሄ ገና እየተሠራ ነው፣ በቅርቡ ይደርሳችኋል!",
+  "invite_text": "🔗 ጓደኞቻችሁን የምትጋብዙበት ሊንክ፦\n{link}\n\n👥 የጋበዛችሁት፦ <b>{count}</b> · በደንብ እየተጠቀሙ ያሉት፦ <b>{qualified}</b>\n⭐ XP፦ <b>{points}</b>\n\nጓደኛችሁ ቢያንስ ለ3 ቀን ቦቱን ከተጠቀመ ትልቁ ጉርሻ ይሰጣችኋል 🎁",
+  "referral_reward": "👥 አንድ ጓደኛችሁ በሊንካችሁ ገብቷል! +{points} XP 🎉\nጓደኛችሁ ቦቱን መጠቀም ሲቀጥል ተጨማሪ ትቀበላላችሁ።",
+  "lang_changed": "✅ እሺ፣ አሁን በአማርኛ ነው!",
+  "banned": "⛔ አካውንታችሁ ታግዷል።",
+  "btn_profile": "👤 ፕሮፋይሌ",
   "btn_top": "🏆 ደረጃ",
   "btn_back": "◀️ ተመለስ",
   "btn_prev": "⬅️",
   "btn_next": "➡️",
-  "kind_slide": "📑 ስላይድ",
-  "kind_exam": "📝 ያለፈ ፈተና",
-  "kind_note": "🗒 ማስታወሻ",
-  "kind_book": "📘 መጽሐፍ",
-  "lib_courses": "📚 <b>ኮርሶች</b>\nኮርስ ይምረጡ፣ ወይም የኮርስ ስም ጽፈው ይፈልጉ 🔍",
-  "lib_no_courses": "ለእርስዎ ዘርፍ እና ዓመት ገና ኮርስ አልተጨመረም።\nየኮርስ ስም ጽፈው ይፈልጉ 🔍",
-  "lib_kinds": "📘 <b>{course}</b>\nምን ይፈልጋሉ?",
-  "lib_no_materials": "ለዚህ ኮርስ ገና ፋይል አልተጨመረም።",
+  "kind_slide": "📑 ስላይዶች",
+  "kind_exam": "📝 የድሮ ፈተናዎች",
+  "kind_note": "🗒 ኖት / ሞጁል",
+  "kind_book": "📘 መጻሕፍት",
+  "lib_courses": "📚 <b>ኮርሶች</b>\nኮርስ ምረጡ፣ ወይም የኮርሱን ስም ጽፋችሁ ፈልጉ 🔍",
+  "lib_no_courses": "ለዘርፋችሁና ለዓመታችሁ ገና ማቴሪያል አልገባም።\nየኮርሱን ስም ጽፋችሁ ፈልጉ 🔍",
+  "lib_kinds": "📘 <b>{course}</b>\nምን ልላክላችሁ?",
+  "lib_no_materials": "ለዚህ ኮርስ ገና ምንም ማቴሪያል የለም፤ በቅርቡ እንጨምራለን!",
   "lib_materials": "📘 <b>{course}</b> · {kind}",
-  "file_missing": "ይህ ፋይል አልተገኘም።",
-  "search_none": "🔍 ምንም አልተገኘም። ሌላ ቃል ይሞክሩ (የኮርስ ስም ወይም ኮድ)።",
-  "search_results": "🔍 <b>ውጤቶች</b> ለ «{q}»",
-  "profile_text": "👤 <b>{name}</b>\n🎓 {stream} · {year}\n\n🏅 ደረጃ {level}: <b>{title}</b>\n⭐ ጠቅላላ XP: <b>{points}</b> ({to_next})\n📅 የዚህ ሳምንት XP: <b>{week_xp}</b> · {week_rank}\n🔥 ተከታታይ ቀን: <b>{streak}</b> (ምርጥ {best})\n👥 የጋበዟቸው: <b>{refs}</b> (ንቁ የሆኑ {refs_q})",
-  "top_text": "🏆 <b>የሳምንቱ ደረጃ</b> · ቀሪ {days} ቀን\n{rows}\n\n📍 የእርስዎ: <b>{rank}</b> · {week_xp} XP\n⚔️ {n_label}: <b>{natural}</b> · {s_label}: <b>{social}</b>{prize}\n\nℹ️ ህጎች: /rules",
-  "inline_open_bot": "📚 ቦቱን ክፈት",
-  "prize_block": "\n\n💰 <b>ሳምንታዊ ሽልማት</b> (የአየር ጊዜ ካርድ፣ ብር)፦\n{lines}\n🎟 እጣ፦ {raffle} ብር (ለሌሎች ብቁ ተወዳዳሪዎች)\nብቁ ለመሆን፦ በሳምንቱ ቢያንስ {days} ቀን መግባት እና {xp} XP",
-  "to_next": "ለቀጣዩ ደረጃ {n} XP ይቀራል",
-  "max_level": "ከፍተኛ ደረጃ 🎉",
-  "levelup": "🎉 ደረጃ {level} ደርሰዋል: <b>{title}</b>!",
-  "streak_bonus": "🔥 {streak} ቀን ተከታታይ! +{xp} XP ጉርሻ",
-  "referral_qualified": "🎉 የጋበዙት ጓደኛ ንቁ ተማሪ ሆኗል! +{xp} XP",
-  "season_win": "🏅 ባለፈው ሳምንት #{rank} ወጥተዋል ({xp} XP)! እንኳን ደስ አለዎት።",
-  "season_win_prize": "\n💰 ሽልማት፦ {birr} ብር የአየር ጊዜ ካርድ። አድሚኑ በ Telegram ያገኝዎታል።",
-  "season_raffle": "🎟 በሳምንታዊ እጣ አሸንፈዋል!",
-  "rules_text": "📜 <b>ህጎች</b>\n\n<b>XP እንዴት ይገኛል</b>\n• በየቀኑ መግባት: 3-7 XP (ተከታታይ ቀን ሲጨምር ይጨምራል)\n• ፋይል ማውረድ: +1 (በቀን እስከ 3)\n• ጓደኛ መጋበዝ: ሲቀላቀል +5፣ ንቁ ተማሪ ሲሆን (3+ ቀን) +30 (በሳምንት እስከ 5)\n• ለጠቃሚ አስተዋጽኦ አድሚን ልዩ XP ሊሰጥ ይችላል\n• ከራስ-ሰር ምንጮች በቀን እስከ {cap} XP\n\n<b>ሳምንታዊ ውድድር</b>\nሰኞ ይጀምራል፣ እሁድ ይዘጋል (የኢትዮጵያ ሰዓት)።\nሽልማት ሲኖር ለመወዳደር፦ በሳምንቱ ቢያንስ {days} ቀን መግባት፣ ቢያንስ {xp} XP፣ ቻናሉ ውስጥ መቆየት፣ እና የታማኝነት ነጥብ በቂ መሆን አለበት።\n\n<b>ፍትሃዊነት</b>\n• ሁሉም XP በማይለወጥ መዝገብ ይመዘገባል፤ ተመሳሳይ ድርጊት ሁለት ጊዜ አይከፈልም።\n• አጠራጣሪ እንቅስቃሴ (የውሸት አካውንት፣ ያልተለመደ ብዙ ጋባዥነት) በአድሚን ይመረመራል፤ ነጥብ ሊሰረዝ ወይም ሊታገድ ይችላል።\n• ሽልማቶች ሊለወጡ ይችላሉ፤ የአድሚን ውሳኔ የመጨረሻ ነው።\n• ለመሳተፍ ምንም ክፍያ አያስፈልግም።",
-  "level_1": "አዲስ ተማሪ",
+  "file_missing": "ይሄ ፋይል አልተገኘም 😕",
+  "search_none": "🔍 ምንም አላገኘሁም። ሌላ ቃል ሞክሩ፣ ለምሳሌ የኮርሱን ስም ወይም ኮድ።",
+  "search_results": "🔍 <b>ለ «{q}» ያገኘሁት</b>",
+  "profile_text": "👤 <b>{name}</b>\n🎓 {stream} · {year}\n\n🏅 ደረጃ {level}፦ <b>{title}</b>\n⭐ ጠቅላላ XP፦ <b>{points}</b> ({to_next})\n📅 የዚህ ሳምንት XP፦ <b>{week_xp}</b> · {week_rank}\n🔥 ተከታታይ ቀናት፦ <b>{streak}</b> (ከፍተኛው {best})\n👥 የጋበዛችኋቸው፦ <b>{refs}</b> (ንቁ {refs_q})",
+  "top_text": "🏆 <b>የሳምንቱ ደረጃ</b> · {days} ቀን ቀርቷል\n{rows}\n\n📍 እናንተ፦ <b>{rank}</b> · {week_xp} XP\n⚔️ {n_label}፦ <b>{natural}</b> · {s_label}፦ <b>{social}</b>{prize}\n\nℹ️ ህጎቹ፦ /rules",
+  "inline_open_bot": "📚 ቦቱን ክፈቱ",
+  "prize_block": "\n\n💰 <b>የሳምንቱ ሽልማት</b> (የሞባይል ካርድ)፦\n{lines}\n🎟 እጣ፦ {raffle} ብር (ለቀሩት ብቁ ተወዳዳሪዎች)\nለመወዳደር፦ በሳምንቱ ቢያንስ {days} ቀን መግባትና {xp} XP መሰብሰብ ያስፈልጋል",
+  "to_next": "ለቀጣዩ ደረጃ {n} XP ቀርቷል",
+  "max_level": "ከፍተኛው ደረጃ ላይ ደርሳችኋል 🏆",
+  "levelup": "🎉 ደረጃ {level} ላይ ደርሳችኋል፦ <b>{title}</b>!",
+  "streak_bonus": "🔥 {streak} ቀን ሳታቋርጡ መጥታችኋል! +{xp} XP ጉርሻ",
+  "referral_qualified": "🎉 የጋበዛችሁት ጓደኛ ቦቱን በደንብ እየተጠቀመ ነው! +{xp} XP",
+  "season_win": "🏅 ባለፈው ሳምንት #{rank} ወጥታችኋል ({xp} XP)! እንኳን ደስ አላችሁ 🎉",
+  "season_win_prize": "\n💰 ሽልማታችሁ፦ {birr} ብር የሞባይል ካርድ። አድሚኑ በ Telegram ያገኛችኋል።",
+  "season_raffle": "🎟 በሳምንታዊው እጣ አሸንፋ���ኋል! 🎉",
+  "rules_text": "📜 <b>ህጎች</b>\n\n<b>XP እንዴት ይገኛል?</b>\n• በየቀኑ ቦቱን ስትከፍቱ፦ 3-7 XP (ቀን ሳታቋርጡ ስትመጡ ይጨምራል)\n• ፋይል ስታወርዱ፦ +1 (በቀን እስከ 3)\n• ጓደኛ ስትጋብዙ፦ ሲገባ +5፣ ቢያንስ ለ3 ቀን ከተጠቀመ +30 (በሳምንት እስከ 5 ጓደኛ)\n• ለሚጠቅም አስተዋጽኦ አድሚኑ ልዩ XP ሊሰጥ ይችላል\n• በራስ-ሰር የሚገኝ XP በቀን ከ{cap} አይበልጥም\n\n<b>የሳምንቱ ውድድር</b>\nሰኞ ይጀምራል፣ እሁድ ይዘጋል (በኢትዮጵያ ሰዓት)።\nሽልማት ሲኖር ለመወዳደር፦ በሳምንቱ ቢያንስ {days} ቀን መግባት፣ ቢያንስ {xp} XP ማግኘት፣ ቻናሉ ውስጥ መቆየት፣ እና የታማኝነት ነጥባችሁ ጤናማ መሆን አለበት።\n\n<b>ፍትሃዊነት</b>\n• እያንዳንዱ XP በማይለወጥ መዝገብ ይመዘገባል፤ አንድ ድርጊት ሁለት ጊዜ አይከፈልም።\n• አጠራጣሪ ነገር (የውሸት አካውንት፣ ያልተለመደ ብዙ ጋባዥነት) አድሚኑ ይመረምረዋል፤ ነጥብ ሊቀነስ ወይም አካውንት ሊታገድ ይችላል።\n• ሽልማቶች ሊቀየሩ ይችላሉ፤ የአድሚኑ ውሳኔ የመጨረሻ ነው።\n• ለመሳተፍ ምንም ክፍያ አያስፈልግም።",
+  "level_1": "አዲስ ገቢ",
   "level_2": "ጀማሪ",
-  "level_3": "ጎበዝ",
-  "level_4": "ትጉህ",
-  "level_5": "ብልሃተኛ",
+  "level_3": "ጎበዝ ተማሪ",
+  "level_4": "ትጉ",
+  "level_5": "ብልጥ",
   "level_6": "ምሁር",
   "level_7": "አማካሪ",
   "level_8": "ኮከብ",
-  "level_9": "ጀግና",
+  "level_9": "ሻምፒዮን",
   "level_10": "ሊቅ",
-  "gate_missing": "ገና ያልተቀላቀሉት፦ {list}",
-  "gate_join_one": "📢 {name} ተቀላቀል",
-  "gate_not_yet_list": "ገና አልተቀላቀሉም፦ {list}"
+  "gate_missing": "ገና ያልተቀላቀላችሁት፦ {list}",
+  "gate_join_one": "📢 {name} ተቀላቀሉ",
+  "gate_not_yet_list": "ገና አልተቀላቀላችሁም፦ {list}"
 }

tests/test_logic.py

@@ -338,13 +338,29 @@ def test_display_title_cleans_old_titles_but_not_manual_ones():
 
 
 def test_course_label_fits_one_line():
-    from app.bot.keyboards.library import course_label
+    from app.core.labels import course_label
 
-    assert course_label(NS(code="Math1003", name="Calculus")) == "Math1003 · Calculus"
-    long_ = course_label(NS(code="FLEn1001", name="Communicative English Language Skills I"))
+    assert course_label("Math1003", "Calculus") == "Math1003 · Calculus"
+    assert course_label(None, "General Biology") == "General Biology"
+    long_ = course_label("FLEn1001", "Communicative English Language Skills I")
     assert len(long_) <= 36 and long_.startswith("Communicative English")
 
 
+def test_locales_stay_in_sync():
+    """Every Amharic string must keep the same keys, {placeholders} and HTML tags as the English one,
+    otherwise the bot crashes (KeyError) the first time that message is sent."""
+    import json
+    import re
+
+    root = Path(__file__).resolve().parents[1] / "locales"
+    am = json.loads((root / "am.json").read_text(encoding="utf-8"))
+    en = json.loads((root / "en.json").read_text(encoding="utf-8"))
+    assert set(am) == set(en)
+    for key in en:
+        assert sorted(re.findall(r"\{(\w+)\}", am[key])) == sorted(re.findall(r"\{(\w+)\}", en[key])), key
+        assert sorted(re.findall(r"</?\w+>", am[key])) == sorted(re.findall(r"</?\w+>", en[key])), key
+
+
 if __name__ == "__main__":
     for name, fn in list(globals().items()):
         if name.startswith("test_"):