Refactor sample sentences into a new examples.py file for better organization

app.py

@@ -6,25 +6,12 @@ import json
 import uuid
 from pathlib import Path
 from typing import Optional
+from examples import SAMPLE_SENTENCES
 
 APP_NAME = "arabic-tts-arena"
 
 LEADERBOARD_FILE = Path(__file__).parent / "leaderboard.json"
 
-SAMPLE_SENTENCES = [
-    "مرحباً بكم في ساحة تقييم نماذج تحويل النص إلى كلام العربية",
-    "الذكاء الاصطناعي يغير طريقة تفاعلنا مع التكنولوجيا",
-    "اللغة العربية من أجمل اللغات وأكثرها ثراءً",
-    "التعلم الآلي يفتح آفاقاً جديدة في معالجة اللغات الطبيعية",
-    "صوت الإنسان هو أداة التواصل الأكثر تعبيراً",
-    "الشمس تشرق من الشرق وتغرب في الغرب",
-    "القراءة غذاء العقل والروح",
-    "العلم نور والجهل ظلام",
-    "الصبر مفتاح الفرج",
-    "من جد وجد ومن زرع حصد",
-]
-
-
 MAX_SYNTHESIS_RETRIES = 2  # per-model retry cap before giving up
 
 
@@ -54,6 +41,7 @@ def _get_available_models() -> dict[str, dict[str, str]]:
         print(f"✅ Available models: {', '.join(_AVAILABLE_MODELS_CACHE.keys())}")
     return _AVAILABLE_MODELS_CACHE
 
+
 def get_model_cls(model_id: str):
     """Get a Modal class by model_id using the registered class name."""
     available = _get_available_models()
@@ -269,6 +257,7 @@ def decode_audio_to_file(audio_base64: str) -> Optional[str]:
     Returns the file path (Gradio gr.Audio accepts file paths).
     """
     import tempfile
+
     try:
         wav_bytes = base64.b64decode(audio_base64)
         tmp = tempfile.NamedTemporaryFile(suffix=".wav", delete=False)
@@ -301,7 +290,11 @@ def synthesize_audio(text: str, model_id: str) -> dict:
             last_error = str(e)
             print(f"⚠️ {model_id} attempt {attempt} exception: {last_error}")
     # All retries exhausted
-    return {"success": False, "error": f"{model_id} failed after {MAX_SYNTHESIS_RETRIES} attempts: {last_error}", "model_id": model_id}
+    return {
+        "success": False,
+        "error": f"{model_id} failed after {MAX_SYNTHESIS_RETRIES} attempts: {last_error}",
+        "model_id": model_id,
+    }
 
 
 def _get_model_battle_counts() -> dict[str, int]:
@@ -409,12 +402,19 @@ def generate_comparison(text: str):
 
     # — Model A —
     yield (
-        None, None, None, None, None, None,
-        gr.update(visible=False), gr.update(visible=False),
+        None,
+        None,
+        None,
+        None,
+        None,
+        None,
+        gr.update(visible=False),
+        gr.update(visible=False),
         gr.update(visible=False),
         gr.update(value="⏳ Synthesizing…", interactive=False),
         gr.update(value="⏳ Generating audio with Model A…", visible=True),
-        "🔒 Hidden", "🔒 Hidden",  # reset model labels
+        "🔒 Hidden",
+        "🔒 Hidden",  # reset model labels
         gr.update(visible=False),  # hide next_round_btn
         gr.update(interactive=True),  # vote_a_btn
         gr.update(interactive=True),  # vote_b_btn
@@ -436,12 +436,19 @@ def generate_comparison(text: str):
 
     # — Model B —
     yield (
-        None, None, None, None, None, None,
-        gr.update(visible=False), gr.update(visible=False),
+        None,
+        None,
+        None,
+        None,
+        None,
+        None,
+        gr.update(visible=False),
+        gr.update(visible=False),
         gr.update(visible=False),
         gr.update(value="⏳ Synthesizing…", interactive=False),
         gr.update(value="⏳ Generating audio with Model B…", visible=True),
-        "🔒 Hidden", "🔒 Hidden",  # reset model labels
+        "🔒 Hidden",
+        "🔒 Hidden",  # reset model labels
         gr.update(visible=False),  # hide next_round_btn
         gr.update(interactive=True),  # vote_a_btn
         gr.update(interactive=True),  # vote_b_btn
@@ -476,8 +483,8 @@ def generate_comparison(text: str):
         model_b_id,
         result_a["audio_base64"],
         result_b["audio_base64"],
-        gr.update(visible=True),   # audio_row
-        gr.update(visible=True),   # vote_row
+        gr.update(visible=True),  # audio_row
+        gr.update(visible=True),  # vote_row
         gr.update(visible=False),  # result_display
         gr.update(value="🔊 Synthesize", interactive=True),
         gr.update(value="", visible=False),  # hide status
@@ -721,20 +728,16 @@ def refresh_leaderboard():
         """
 
         # Metadata line
-        meta_html = (
-            f'<div class="lb-meta">'
-            f'Last updated {updated_str}'
-            f'</div>'
-        )
+        meta_html = f'<div class="lb-meta">Last updated {updated_str}</div>'
 
         # Column labels
         col_header = (
             '<div class="lb-colheader">'
-            '<span>Rank</span>'
-            '<span>Model</span>'
-            '<span>Score</span>'
-            '<span>Votes</span>'
-            '</div>'
+            "<span>Rank</span>"
+            "<span>Model</span>"
+            "<span>Score</span>"
+            "<span>Votes</span>"
+            "</div>"
         )
 
         # Build rows
@@ -753,7 +756,9 @@ def refresh_leaderboard():
             rank_cls = tier_rank.get(rank, "")
 
             if model_url:
-                name_el = f'<a class="lb-name" href="{model_url}" target="_blank">{name}</a>'
+                name_el = (
+                    f'<a class="lb-name" href="{model_url}" target="_blank">{name}</a>'
+                )
             else:
                 name_el = f'<span class="lb-name">{name}</span>'
 
@@ -762,17 +767,17 @@ def refresh_leaderboard():
             items_html += (
                 f'<div class="lb-item {row_cls}">'
                 f'<div class="lb-rank {rank_cls}">{rank}</div>'
-                f'<div>{name_el}</div>'
+                f"<div>{name_el}</div>"
                 f'<div class="lb-score">{elo:.0f}</div>'
                 f'<div class="lb-votes">{votes_text}</div>'
-                f'</div>'
+                f"</div>"
             )
 
         return (
             f'<div class="lb-container">'
-            f'{style_block}{meta_html}{col_header}'
+            f"{style_block}{meta_html}{col_header}"
             f'<div class="lb-list">{items_html}</div>'
-            f'</div>'
+            f"</div>"
         )
 
     except Exception as e:
@@ -956,7 +961,9 @@ def create_demo():
                     )
 
                 # — Status indicator (shown during synthesis) —
-                status_display = gr.HTML(value="", visible=False, elem_classes=["status-msg"])
+                status_display = gr.HTML(
+                    value="", visible=False, elem_classes=["status-msg"]
+                )
 
                 # — Audio players (hidden until synthesis) —
                 with gr.Row(visible=False, equal_height=True) as audio_row:

examples.py

@@ -0,0 +1,72 @@
+SAMPLE_SENTENCES = [
+    # --- Greetings & Welcome ---
+    "مرحباً بكم في ساحة تقييم نماذج تحويل النص إلى كلام العربية",
+    "أهلاً وسهلاً بكم في هذا التطبيق التفاعلي",
+    "السلام عليكم ورحمة الله وبركاته",
+
+    # --- Technology & AI ---
+    "الذكاء الاصطناعي يغير طريقة تفاعلنا مع التكنولوجيا",
+    "التعلم الآلي يفتح آفاقاً جديدة في معالجة اللغات الطبيعية",
+    "تطوير تقنيات الكلام العربي يشهد تقدماً ملحوظاً في السنوات الأخيرة",
+    "الحوسبة السحابية غيرت مفهوم تخزين البيانات ومعالجتها",
+    "الروبوتات الذكية أصبحت جزءاً من حياتنا اليومية",
+    "تطبيقات الهاتف الذكي سهلت كثيراً من المهام اليومية",
+    "البيانات الضخمة تساعد الشركات على اتخاذ قرارات أفضل",
+    "الأمن السيبراني أصبح ضرورة لا رفاهية في العصر الرقمي",
+
+    # --- Arabic Language & Culture ---
+    "اللغة العربية من أجمل اللغات وأكثرها ثراءً",
+    "صوت الإنسان هو أداة التواصل الأكثر تعبيراً",
+    "الخط العربي فن عريق يجمع بين الجمال والإبداع",
+    "الشعر العربي ديوان العرب وسجل تاريخهم",
+    "الأدب العربي يزخر بروائع خالدة عبر العصور",
+    "اللهجات العربية المتنوعة تعكس غنى الثقافة العربية",
+    "القرآن الكريم حفظ اللغة العربية على مر العصور",
+    "المعلقات السبع من أعظم ما أنتجه الشعر العربي القديم",
+
+    # --- Proverbs & Wisdom ---
+    "القراءة غذاء العقل والروح",
+    "العلم نور والجهل ظلام",
+    "الصبر مفتاح الفرج",
+    "من جد وجد ومن زرع حصد",
+    "العقل السليم في الجسم السليم",
+    "أطلبوا العلم من المهد إلى اللحد",
+    "خير الكلام ما قل ودل",
+    "إذا هبت رياحك فاغتنمها",
+    "رحلة الألف ميل تبدأ بخطوة واحدة",
+    "لا تؤجل عمل اليوم إلى الغد",
+    "الوقت كالسيف إن لم تقطعه قطعك",
+    "من لم يتعلم من التاريخ محكوم عليه بتكراره",
+
+    # --- Nature & Science ---
+    "الشمس تشرق من الشرق وتغرب في الغرب",
+    "الماء أساس الحياة على كوكب الأرض",
+    "الفضاء الخارجي مليء بالأسرار التي لم نكتشفها بعد",
+    "المحيطات تغطي أكثر من سبعين بالمئة من سطح الأرض",
+    "التنوع البيولوجي ضروري لاستمرار الحياة على كوكبنا",
+    "الطاقة المتجددة هي مستقبل العالم في مواجهة التغير المناخي",
+    "النجوم التي نراها في الليل قد تكون أبعد مما نتخيل",
+    "الجبال أوتاد الأرض وتلعب دوراً مهماً في توازن المناخ",
+
+    # --- Daily Life & Society ---
+    "التعليم هو السلاح الأقوى لتغيير العالم",
+    "الأسرة هي اللبنة الأولى في بناء المجتمع",
+    "السفر يوسع المدارك ويفتح الآفاق",
+    "الرياضة تقوي الجسم وتنشط العقل",
+    "الموسيقى لغة عالمية يفهمها الجميع",
+    "الطبخ العربي يتميز بنكهاته الغنية وتوابله الفريدة",
+    "الضيافة العربية معروفة بكرمها وحفاوتها",
+    "القهوة العربية رمز للكرم والأصالة",
+    "الأسواق الشعبية تحكي قصص المدن وتاريخها",
+    "شهر رمضان المبارك يجمع العائلات على مائدة واحدة",
+
+    # --- Longer / More Complex ---
+    "يقول المثل العربي إن الكتاب يُقرأ من عنوانه، لكن الحقيقة أن المحتوى هو الأهم",
+    "في عالم سريع التغير، يبقى التعلم المستمر هو المفتاح للنجاح والتميز",
+    "تحويل النص إلى كلام هو أحد أهم تطبيقات الذكاء الاصطناعي في مجال اللغويات",
+    "المدن العربية القديمة مثل القاهرة وبغداد ودمشق شهدت حضارات عريقة",
+    "التواصل الفعال يتطلب الاستماع الجيد قبل التحدث",
+    "الابتكار والإبداع هما أساس التقدم في أي مجتمع يسعى للتطور",
+    "اللغة العربية تحتوي على أكثر من اثني عشر مليون كلمة بدون تكرار",
+    "الترجمة الآلية تطورت كثيراً لكنها لا تزال بحاجة إلى تحسين في اللغة العربية",
+]