adab

Adab | أدب

مكتبة بايثون مبنية على موقع adab.com، موقع الاشعار والمواضيع الادبية

التنزيل • المميزات • الاستخدام • الرخصة • تنويهات

التنزيل

سوف يتم استخدام PyPi لتنزيل المكتبة

pip3 install adab

المميزات

• البحث في موقع أدب

• استخراج محتوى البوست والمواضيع المشابها له عبر الايدي الخاص به

• استخراج بيانات انواع الكتابات او عبر الايدي الخاص بالنوع

• استخراج الطرق الكاتبية التي يمكن البحث عبرها في الموقع

• استخراج بيانات العصور (العصر الاسلامي الخ) التي يمكن البحث عبرها في الموقع

• استخراج بيانات الدول التي يمكن البحث عبرها في الموقع

• استخراج انواع المستخدمين اللذين يمكنك البحث عبرهم في الموقع

تنويهات

• لقد تم استخدام في الامثلة كائن افتراضي، يمكنك انشاء كان خاص عبر كلاس Adab

الاستخدام

البحث في موقع أدب :

from adab import adab

# البحث العام
result = adab.search()
print("General Search", result, sep="\n\n", end="\n\n")

# تخصيص البحث
result = adab.search(
    page=23, genres=[1, 2], 
        era=[2, 3, 1], user_type=[3, 2], 
            gender=['f'], writing_types=[15])
print("Custom Search", result, sep="\n\n", end="\n\n")

المخرجات

General search

{'page': 0, 'text': '', 'post_count': '75634', 'result': [{'username': 'أبو فراس الحمداني', 'user_url': 'https://adab.com/Abu_Firas_Alhamdani', 'user_img': 'https://adab.com/assets/uploads/images/daba776289f67907b34241ae437bc76c.png', 'post_url': 'https://adab.com/post/view_post/16557', 'post_id': '16557', 'post_title': 'أرَاكَ عَصِيَّ الدّمعِ شِيمَتُكَ الصّبرُ', 'post_views': '1701995', 'post_short_text': 'أرَاكَ عَصِيَّ الدّمعِ شِيمَتُكَ الصّبرُ،\nأما للهوى نهيٌّ عليكَ ولا أمرُ ؟\nبلى أنا مشتاقٌ وعنديَ لوع...'}, ...

Custom Search

{'page': 23, 'text': '', 'post_count': '246', 'result': [
{'username': 'علية بنت المهدي', 'user_url': 'https://adab.com/Ulayya_Bint_Almahdi', 'user_img': None, 'post_url': 'https://adab.com/post/view_post/17697', 'post_id': '17697', 'post_title': 'بني الحبُّ على الجورِ فلو', 'post_views': '7464', 'post_short_text': 'بني الحبُّ على الجورِ فلو\nأنصَفَ المعشوقُ فيهِ لَسَمَجْ\nليسَ يستحسنُ في وصفِ الهوى\nعاشقٌ يَعْرِفُ تَ...'},
{'username': 'ليلى الأخيلية', 'user_url': 'https://adab.com/Layla_AlAkheeliyya', 'user_img': None, 'post_url': 'https://adab.com/post/view_post/15107', 'post_id': '15107', 'post_title': 'جَزَى اللُّه شَرّا قابِضاً بصنيعه', 'post_views': '7036', 'post_short_text': 'جَزَى اللُّه شَرّا قابِضاً بصنيعه\nوكل امرىء يجزى بما كان ساعيا\nدعا قابضاً والمرهفات يردنه\nفقُبحْتَ م...'}, ...

استخراج محتوى البوست والمواضيع المشابها له عبر الايدي الخاص به :

from adab import adab
result = adab.post(post_id=15107)
print(result)

المخرجات

{
    "username": "ليلى الأخيلية", 
    "user_url": "https://adab.com/Layla_AlAkheeliyya", 
    "user_img": null,
    "post_id": 15107,
    "title": "جَزَى اللُّه شَرّا قابِضاً بصنيعه",
    "post_content": 
        "جَزَى اللُّه شَرّا قابِضاً بصنيعه\n
        وكل امرىء يجزى بما كان ساعيا\n
        دعا قابضاً والمرهفات يردنه\n
        فقُبحْتَ مدعّوا، ولبّيك داعيَا\n
        فَليْتَ عُبيدَ اللِّه كانَ مكانَه\n
        صَرِيعا؛ولم أسمَعْ لتوبة َ ناعِيَا\n",
    "releted_posts": [
        {"id": "76128", "title": "لن أرثيَ للشجر"},
        {"id": "76127", "title": "العشب.."},
        {"id": "76126", "title": "محاولة للبوح"},
        {"id": "76125", "title": "لوجة الصرخة"},
        {"id": "76124", "title": "بلا عنوان..."}]
    }

استخراج انواع الكتابات:

from adab import adab

# جميعها
result = adab.genres()
print("All", result, sep="\n\n", end="\n\n")

# عبر الايدي
result = adab.genres(genre_id=1)
print("By id", result, sep="\n\n", end="\n\n")

المخرجات

All

[{'id': 1, 'arabic_title': 'شعر', 'post_count': '74635'}, {'id': 2, 'arabic_title': 'مقال', 'post_count': '507'}, {'id': 3, 'arabic_title': 'سرد', 'post_count': '488'}]

By id

[{'id': 1, 'arabic_title': 'شعر', 'post_count': '74635'}]

استخراج الطرق الكاتبية:

from adab import adab

# جميعها
result = adab.writing_types()
print("All", result, sep="\n\n", end="\n\n")

# عبر الايدي
result = adab.writing_types(type_id=15)
print("By id", result, sep="\n\n", end="\n\n")

المخرجات

All

[{'id': 15, 'arabic_title': 'فصحى', 'post_count': '61509'},
{'id': 16, 'arabic_title': 'عامّي', 'post_count': '10730'}, 
{'id': 17, 'arabic_title': 'مترجم للعربية', 'post_count': '2829'},
{'id': 20, 'arabic_title': 'مترجم للإنجليزية', 'post_count': '566'}]

By id

[{'id': 15, 'arabic_title': 'فصحى', 'post_count': '61509'}]

استخراج العصور:

from adab import adab

# جميعها
result = adab.era()
print("All", result, sep="\n\n", end="\n\n")

# عبر الايدي
result = adab.era(era_id=3)
print("By id", result, sep="\n\n", end="\n\n")

المخرجات

All

[{'id': 2, 'arabic_title': 'العصر الجاهلي', 'post_count': '1473'}, {'id': 3, 'arabic_title': 'العصر الإسلامي', 'post_count': '3977'}, {'id': 1, 'arabic_title': 'العصر العباسي', 'post_count': '18023'}, {'id': 4, 'arabic_title': 'العصر الأندلسي', 'post_count': '6350'}, {'id': 55, 'arabic_title': 'عصرالدول المتتابعة', 'post_count': '1572'}, {'id': 29, 'arabic_title': 'العصر الحديث', 'post_count': '44551'}]

By id

[{'id': 3, 'arabic_title': 'العصر الإسلامي', 'post_count': '3977'}]

استخراج الدول التي يمكن البحث من خلالها :

from adab import adab

# جميعها
result = adab.country()
print("All", result, sep="\n\n", end="\n\n")

# عبر الايدي
result = adab.country(country_id=191)
print("By id", result, sep="\n\n", end="\n\n")

المخرجات

All

[{'id': 1, 'name': 'Afghanistan', 'arabic_name': 'أفغانستان', 'sortname': 'AF'}, {'id': 3, 'name': 'Algeria', 'arabic_name': 'الجزائر', 'sortname': 'DZ'}, {'id': 6, 'name': 'Angola', 'arabic_name': 'أنغولا', 'sortname': 'AO'}, {'id': 10, 'name': 'Argentina', 'arabic_name': 'الأرجنتين', 'sortname': 'AR'}, {'id': 11, 'name': 'Armenia', 'arabic_name': 'أرمينيا', 'sortname': 'AM'}, ... 

By id

[{'id': 191, 'name': 'Saudi Arabia', 'arabic_name': 'المملكة العربية السعودية', 'sortname': 'SA'}]

استخراج المستخدمين اللذين يمكنك البحث عبرهم :

from adab import adab

# جميعها
result = adab.user_type()
print("All", result, sep="\n\n", end="\n\n")

# عبر الايدي
result = adab.user_type(type_id=3)
print("By id", result, sep="\n\n", end="\n\n")

المخرجات

All

[{'id': 3, 'name': 'موثق'}, {'id': 2, 'name': 'معتمد'}, {'id': 1, 'name': 'مشارك'}]

By id

[{'id': 3, 'name': 'موثق'}]

الرخصة

رخصة جنو العمومية الاصدار 3