Metadata-Version: 2.1
Name: adab
Version: 1.0.4
Summary: مكتبة بايثون مبنية على موقع adab.com، موقع الاشعار والمواضيع الادبية
Home-page: https://github.com/Awiteb/adab
Author: Awiteb
Author-email: Awiteb@hotmail.com
License: UNKNOWN
Description: <h1 align="center">
          <br>
          <a><img src="https://mir-s3-cdn-cf.behance.net/project_modules/1400_opt_1/995c5a64557221.5ad77047dd227.png" alt="adab.com - img"></a>
          <br>
          Adab | أدب
          <br>
        </h1>
        
        <div dir="rtl">
        
        <p align="center">مكتبة بايثون مبنية على موقع <a href=https://adab.com>adab.com</a>، موقع الاشعار والمواضيع الادبية
        <p align="center">
          <a href="https://pypi.org/project/adab/">
            <img alt="اصدارات بايثون" src="https://img.shields.io/pypi/pyversions/adab?color=9cf">
          </a>
          <a href="https://pypi.org/project/adab/">
            <img alt="PyPI" src="https://img.shields.io/pypi/v/adab?color=9cf">
          </a>
          <a href="https://www.gnu.org/licenses/gpl-3.0.html">
            <img src="https://img.shields.io/pypi/l/Adab?color=9cf&label=License" alt="الرخصة">
          </a>
        </p>
        
        
        
        <p align="center">
          <a href="#التنزيل">التنزيل</a>
          •
          <a href="#المميزات">المميزات</a>
          •
          <a href="#الاستخدام">الاستخدام</a>
          •
          <a href="#الرخصة">الرخصة</a>
          •
          <a href="#تنويهات">تنويهات</a>
        </p>
        
        
        
        ## التنزيل
        
        سوف يتم استخدام [PyPi](https://pypi.org) لتنزيل المكتبة
        
        <div dir="ltr">
        
        ```bash
        pip3 install adab
        ```
        <div dir="rtl">
        
        
        ## المميزات
        
        * البحث في موقع [أدب](adab.com)
        
        * استخراج محتوى البوست والمواضيع المشابها له عبر الايدي الخاص به
        
        * استخراج بيانات انواع الكتابات او عبر الايدي الخاص بالنوع
        
        * استخراج الطرق الكاتبية التي يمكن البحث عبرها في الموقع
        
        * استخراج بيانات العصور (العصر الاسلامي الخ) التي يمكن البحث عبرها في الموقع
        
        * استخراج بيانات الدول التي يمكن البحث عبرها في الموقع
        
        * استخراج انواع المستخدمين اللذين يمكنك البحث عبرهم في الموقع
        
        <br>
        
        ## تنويهات
        
        * لقد تم استخدام في الامثلة كائن افتراضي، يمكنك انشاء كان خاص عبر كلاس Adab
        
        <br>
        
        ## الاستخدام
        
        **البحث في موقع أدب :**
        <div dir="ltr">
        
        ```python
        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")
        ```
        <div dir="rtl">
        
        <details>
        <summary>المخرجات</summary>
        
        <div dir="ltr">
        
        ```bash
        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فقُبحْتَ م...'}, ...
        
        ```
        <div dir="rtl">
        </details>
        <br><br>
        
        **استخراج محتوى البوست والمواضيع المشابها له عبر الايدي الخاص به :**
        <div dir="ltr">
        
        ```python
        from adab import adab
        result = adab.post(post_id=15107)
        print(result)
        ```
        <div dir="rtl">
        
        <details>
        <summary>المخرجات</summary>
        
        <div dir="ltr">
        
        ```json
        {
            "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": "بلا عنوان..."}]
            }
        
        
        ```
        <div dir="rtl">
        </details>
        <br><br>
        
        **استخراج انواع الكتابات:**
        <div dir="ltr">
        
        ```python
        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")
        ```
        <div dir="rtl">
        
        <details>
        <summary>المخرجات</summary>
        
        <div dir="ltr">
        
        ```bash
        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'}]
        
        ```
        <div dir="rtl">
        </details>
        <br><br>
        
        **استخراج الطرق الكاتبية:**
        <div dir="ltr">
        
        ```python
        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")
        ```
        <div dir="rtl">
        
        <details>
        <summary>المخرجات</summary>
        
        <div dir="ltr">
        
        ```bash
        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'}]
        
        ```
        <div dir="rtl">
        </details>
        <br><br>
        
        **استخراج العصور:**
        <div dir="ltr">
        
        ```python
        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")
        ```
        <div dir="rtl">
        
        <details>
        <summary>المخرجات</summary>
        
        <div dir="ltr">
        
        ```bash
        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'}]
        
        ```
        <div dir="rtl">
        </details>
        <br><br>
        
        **استخراج الدول التي يمكن البحث من خلالها :**
        <div dir="ltr">
        
        ```python
        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")
        ```
        <div dir="rtl">
        
        <details>
        <summary>المخرجات</summary>
        
        <div dir="ltr">
        
        ```bash
        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'}]
        
        
        
        ```
        <div dir="rtl">
        </details>
        <br><br>
        
        **استخراج المستخدمين اللذين يمكنك البحث عبرهم :**
        <div dir="ltr">
        
        ```python
        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")
        ```
        <div dir="rtl">
        
        <details>
        <summary>المخرجات</summary>
        
        <div dir="ltr">
        
        ```bash
        All
        
        [{'id': 3, 'name': 'موثق'}, {'id': 2, 'name': 'معتمد'}, {'id': 1, 'name': 'مشارك'}]
        
        By id
        
        [{'id': 3, 'name': 'موثق'}]
        
        ```
        <div dir="rtl">
        </details>
        <br><br>
        
        
        
        
        ## الرخصة
        [رخصة جنو العمومية الاصدار 3](https://www.gnu.org/licenses/gpl-3.0.html)
Keywords: adab,adab.com,arabic,poetry,Arabic poetry
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Operating System :: OS Independent
Requires-Python: >=3.7
Description-Content-Type: text/markdown
