Upload folder using huggingface_hub

data/dropbox/discourses/narasimha_avatar.json

@@ -0,0 +1,27 @@
+{
+    "id": 1,
+    "topic_name": "Narasimha Avataram",
+    "description": "Discourses and references about Lord Narasimha's incarnation.",
+    "thumbnail_url": "https://img.youtube.com/vi/-AZOlc6_aMQ/hqdefault.jpg",
+    "videos": [
+        {
+            "youtube_id": "-AZOlc6_aMQ",
+            "title": "நரசிம்ம அவதாரம் | ஸ்ரீ சங்கர மடம் | Narayaniyam | Dr Venkatesh Upanyasam | Narasimha Avatar.",
+            "playlist_id": null,
+            "timestamp_tags": [
+                {
+                    "start_sec": 120,
+                    "label": "Thirumangai Azhwar - Periya Thirumozhi 2.3.8",
+                    "scripture": "divya_prabandham",
+                    "global_index": 1075
+                },
+                {
+                    "start_sec": 120,
+                    "label": "Thirumangai Azhwar - Thirunedunthandagam 4.26",
+                    "scripture": "divya_prabandham",
+                    "global_index": 2077
+                }
+            ]
+        }
+    ]
+}

data/dropbox/discourses/sahasranamam.json

@@ -0,0 +1,61 @@
+{
+  "id": 2,
+  "topic_name": "Sahasranamam",
+  "description": "Discourses and references about Sahasranamam.",
+  "thumbnail_url": "https://img.youtube.com/vi/XCHbU6KU82A/hqdefault.jpg",
+  "videos": [
+    {
+      "youtube_id": "XCHbU6KU82A",
+      "title": "VISHNU SAHASRANAMA MAHIMAI part 1 | விஷ்ணு ஸஹஸ்ரநாம மஹிமை 1 | Dr Venkatesh Upanyasam",
+      "playlist_id": null,
+      "timestamp_tags": [
+        {
+          "start_sec": 1,
+          "label": "Shuklambaradharam",
+          "scripture": "vishnu_sahasranamam",
+          "global_index": 1
+        },
+        {
+          "start_sec": 3622,
+          "label": "Sthuvantha:",
+          "scripture": "vishnu_sahasranamam",
+          "global_index": 8
+        },
+        {
+          "start_sec": 5400,
+          "end_sec": 5500,
+          "label": "Nara: Sada:",
+          "scripture": "vishnu_sahasranamam",
+          "global_index": 14
+        }
+      ]
+    },
+    {
+      "youtube_id": "YQseyjQ6kZc",
+      "title": "VISHNU SAHASRANAMA MAHIMAI part 2 | விஷ்ணு ஸஹஸ்ரநாம மகிமை 2 | Dr Venkatesh Upanyasam",
+      "playlist_id": null,
+      "timestamp_tags": [
+        {
+          "start_sec": 30,
+          "label": "Shuklambaradharam",
+          "scripture": "vishnu_sahasranamam",
+          "global_index": 30
+        },
+        {
+          "start_sec": 900,
+          "end_sec": 960,
+          "label": "Shuklambaradharam",
+          "scripture": "vishnu_sahasranamam",
+          "global_index": 40
+        },
+        {
+          "start_sec": 1800,
+          "end_sec": 1830,
+          "label": "Shuklambaradharam",
+          "scripture": "vishnu_sahasranamam",
+          "global_index": 80
+        }
+      ]
+    }
+  ]
+}

modules/dropbox/discources.py

@@ -0,0 +1,114 @@
+import os
+import json
+
+def fetch_all_discourses(folder_path="data/dropbox/discourses"):
+    """
+    Loads all JSON discourse files from the specified folder and returns
+    them as a list of Python dictionaries.
+
+    Each file should contain a valid JSON object representing one topic.
+    """
+    discourses = []
+
+    if not os.path.exists(folder_path):
+        print(f"⚠️ Folder not found: {folder_path}")
+        return discourses
+
+    for filename in os.listdir(folder_path):
+        if filename.lower().endswith(".json"):
+            file_path = os.path.join(folder_path, filename)
+            try:
+                with open(file_path, "r", encoding="utf-8") as f:
+                    data = json.load(f)
+                    discourses.append(data)
+            except Exception as e:
+                print(f"❌ Error loading {filename}: {e}")
+
+    return discourses
+
+def get_discourse_summaries(folder_path="data/dropbox/discourses", page=1, per_page=10):
+    """
+    Returns a paginated list of discourse topic summaries.
+    
+    Each summary contains:
+      - id
+      - topic_name
+      - thumbnail_url
+    
+    The results are sorted alphabetically by topic_name.
+
+    Args:
+        folder_path (str): Path to the folder containing JSON files.
+        page (int): Page number (1-indexed).
+        per_page (int): Number of items per page.
+    """
+    summaries = []
+
+    if not os.path.exists(folder_path):
+        print(f"⚠️ Folder not found: {folder_path}")
+        return []
+
+    # Load and extract only minimal info
+    for filename in os.listdir(folder_path):
+        if filename.lower().endswith(".json"):
+            file_path = os.path.join(folder_path, filename)
+            try:
+                with open(file_path, "r", encoding="utf-8") as f:
+                    data = json.load(f)
+                    summaries.append({
+                        "id": data.get("id"),
+                        "topic_name": data.get("topic_name"),
+                        "thumbnail_url": data.get("thumbnail_url")
+                    })
+            except Exception as e:
+                print(f"❌ Error loading {filename}: {e}")
+
+    # Sort by topic name
+    summaries.sort(key=lambda x: (x.get("topic_name") or "").lower())
+
+    # Pagination logic
+    total_items = len(summaries)
+    total_pages = (total_items + per_page - 1) // per_page  # ceil division
+
+    if page < 1 or page > total_pages:
+        print(f"⚠️ Invalid page number {page}. Must be between 1 and {total_pages}.")
+        return []
+
+    start = (page - 1) * per_page
+    end = start + per_page
+
+    paginated = summaries[start:end]
+
+    return {
+        "page": page,
+        "per_page": per_page,
+        "total_pages": total_pages,
+        "total_items": total_items,
+        "data": paginated
+    }
+
+
+import os
+import json
+
+def get_discourse_by_id(topic_id: int, folder_path="data/dropbox/discourses"):
+    """
+    Returns the full discourse JSON for a given topic_id.
+    Returns None if not found.
+    """
+    if not os.path.exists(folder_path):
+        print(f"⚠️ Folder not found: {folder_path}")
+        return None
+
+    for filename in os.listdir(folder_path):
+        if filename.lower().endswith(".json"):
+            file_path = os.path.join(folder_path, filename)
+            try:
+                with open(file_path, "r", encoding="utf-8") as f:
+                    data = json.load(f)
+                    if data.get("id") == topic_id:
+                        return data
+            except Exception as e:
+                print(f"❌ Error loading {filename}: {e}")
+
+    return None

server.py

@@ -4,7 +4,7 @@ import random
 import traceback
 from typing import List, Optional
 import uuid
-from fastapi import APIRouter, Request, Query
+from fastapi import APIRouter, HTTPException, Request, Query
 from fastapi.responses import JSONResponse
 import pycountry
 from pydantic import BaseModel
@@ -15,6 +15,7 @@ from metadata import MetadataWhereClause
 from modules.audio.model import AudioRequest, AudioType
 from modules.audio.service import svc_get_audio_urls, svc_get_indices_with_audio
 from modules.config.categories import get_scripture_categories
+from modules.dropbox.discources import fetch_all_discourses, get_discourse_by_id, get_discourse_summaries
 from modules.languages.get_v2 import handle_fetch_languages_v2
 from modules.quiz.answer_validator import validate_answer
 from modules.quiz.models import Question
@@ -563,4 +564,29 @@ def route_get_donation_product_ids(include_tests: bool = False):
             {"id": "android.test.refunded"},
             {"id": "android.test.item_unavailable"},
         ]
-    return products
+    return products
+
+@router.get("/discourse/list")
+def get_all_discourses(
+    page: int = Query(1, ge=1, description="Page number (1-indexed)"),
+    per_page: int = Query(10, ge=1, le=100, description="Number of items per page")
+):
+    """
+    Returns a paginated list of discourse topics.
+    Each topic includes:
+      - id
+      - topic_name
+      - thumbnail_url
+    """
+    result = get_discourse_summaries(page=page, per_page=per_page)
+    return result
+
+@router.get("/discourse/find/{topic_id}")
+def get_discourse_detail(topic_id: int):
+    """
+    Returns the full details of a discourse topic by its unique ID.
+    """
+    topic = get_discourse_by_id(topic_id)
+    if not topic:
+        raise HTTPException(status_code=404, detail="Discourse topic not found")
+    return topic