hedayat-media 1.6.6

یک کتابخانه جامع برای دسترسی به احادیث، قرآن، ذکر و اطلاعات جغرافیایی مساجد

HedayatMedia 📖✨

کتابخانه HedayatMedia ابزاری جامع برای کار با داده‌های اسلامی است:

• 📜 احادیث
• 📖 قرآن (آیات، سوره‌ها، اجزاء)
• 🕋 اذکار روزانه
• 🌍 مکان‌یابی مساجد
• اوقات شرعی شهروکشور -چت باهوش مصنوعی مذهبی میربات

---

نمونه ها

from hedayat_media import HedayatMedia

# نمونه‌سازی
media = HedayatMedia()

# دریافت یک حدیث تصادفی
print(media.get_random_hadith())

# دریافت یک آیه تصادفی
print(media.get_random_ayah())

# دریافت ذکر روز
print(media.get_zeker())


hadith = media.get_random_hadith()
print(hadith["text_arabic"])

# آیه تصادفی از جزء 5
ayah = media.fetch_random_ayah(juz_number=5)
print(ayah)

# کل سوره بقره
surah = media.get_surah(2)
print(surah["name_ar"], surah["number_of_ayahs"])


print(media.get_zeker())

lat, lon = media.get_coordinates("Mashhad")
bbox = media.get_bounding_box(lat, lon, radius_km=5)
data = media.get_overpass_data(bbox)
mosques = media.process_data(data)

for m in mosques:
    print(m["name"], m["map_link"])


print(media.get_prayer_times("Mashhad","IR"))

---

📖 API Reference

HedayatMedia.load_hadiths()

بارگذاری احادیث از فایل JSON.

HedayatMedia.get_random_hadith()

یک حدیث تصادفی برمی‌گرداند.

HedayatMedia.fetch_random_ayah(juz_number: int)

آیه تصادفی از یک جزء مشخص.

HedayatMedia.get_random_ayah()

آیه تصادفی از کل قرآن.

HedayatMedia.get_all_surahs()

لیست همه سوره‌ها.

HedayatMedia.get_surah(surah_number: int)

جزئیات یک سوره شامل متن و صوت.

HedayatMedia.get_zeker()

ذکر روز هفته.

HedayatMedia.get_coordinates(place_name: str)

مختصات یک مکان (شهر/محله).

HedayatMedia.get_bounding_box(lat, lon, radius_km=10)

ایجاد محدوده جغرافیایی برای جستجو.

HedayatMedia.get_overpass_data(bbox)

دریافت داده مساجد از Overpass API.

HedayatMedia.process_data(data)

پردازش داده API و برگرداندن لیست مساجد.

HedayatMedia.get_prayer_times(city,country) به دست اوردن اوقات شرعی که ورودی های شهروکشوردارد

HedayatMedia.get_response_from_chat(text,api_key) چت با هوش مصنوعی مذهبی

---

نمونه کد کامل از تمامی متد های کتابخانه

from hedayat_media import HedayatMedia

def main():
    media = HedayatMedia()

    print("📜 حدیث تصادفی:")
    print(media.get_random_hadith())
    print("="*60)

    print("📖 آیه تصادفی از کل قرآن:")
    print(media.get_random_ayah())
    print("="*60)

    print("📖 آیه تصادفی از جزء 5:")
    print(media.fetch_random_ayah(juz_number=5))
    print("="*60)

    print("📖 لیست همه سوره‌ها (فقط چندتا):")
    surahs = media.get_all_surahs()
    if isinstance(surahs, list):
        for s in surahs[:5]:
            print(f"{s['number']}. {s['englishName']} ({s['name']})")
    print("="*60)

    print("📖 دریافت سوره بقره:")
    surah = media.get_surah(2)
    print(f"{surah['name_ar']} - تعداد آیات: {surah['number_of_ayahs']}")
    print("="*60)

    print("🕋 ذکر امروز:")
    print(media.get_zeker())
    print("="*60)

    print("🌍 جغرافیا (مساجد مشهد):")
    coords = media.get_coordinates("Mashhad")
    if coords:
        lat, lon = coords
        bbox = media.get_bounding_box(lat, lon, radius_km=2)
        mosques_data = media.get_overpass_data(bbox)
        mosques = media.process_data(mosques_data)
        for m in mosques[:3]:
            print(f"{m['name']} → {m['map_link']}")
    print("="*60)

if __name__ == "__main__":
    main()

🔑 پیش‌نیاز

1. ثبت‌نام در لیارا و دریافت API Key: https://console.liara.ir/ai

نمونه استفاده از چت باهوش مصنوعی مذهبی

from hedayat_media import  HedayatMedia



m = HedayatMedia()


text = input("enter the mesage :")


api_key = ""

result = m.get_response_from_chat(text,api_key=api_key)

print(result)

درباره کلاس Maddahi

کلاس Maddahi یک موتور جستجوی تخصصی برای محتوای مذهبی (مداحی، مولودی، نوحه، مناجات) است که امکان کشف و دسترسی به محتوای مذهبی فارسی را فراهم می‌کند.

نمونه استفاده ازکلاس :Maddahi

ورودی ها: page= شماره صفحه results_per_page = چقدر پاسخ بگیره

import asyncio
from hedayat_media import Maddahi


async def main():
    text =  input("enter the text>=")
    
    maddahi = Maddahi(text)
    
    await maddahi.search(page=1,results_per_page=2)
    



asyncio.run(main=main())

📦 نصب

pip install --upgrade hedayat-media