تصحيح مسار الرفع

Dockerfile

@@ -0,0 +1,23 @@
+# استخدم إصدارًا حديثًا ومستقرًا من Python
+FROM python:3.9-slim
+
+# قم بإنشاء مستخدم غير مسؤول (non-root) كما توصي Hugging Face
+RUN useradd -m -u 1000 user
+USER user
+ENV PATH="/home/user/.local/bin:$PATH"
+
+# قم بتعيين دليل العمل داخل الحاوية
+WORKDIR /app
+
+# انسخ ملف المتطلبات وقم بتغيير الملكية
+COPY --chown=user ./requirements.txt requirements.txt
+
+# قم بتثبيت المكتبات المطلوبة
+RUN pip install --no-cache-dir --upgrade -r requirements.txt
+
+# انسخ جميع ملفات التطبيق إلى دليل العمل
+COPY --chown=user . /app
+
+# عرّف الأمر الذي سيتم تشغيله لتشغيل التطبيق باستخدام Gunicorn
+# Hugging Face Spaces يستخدم المنفذ 7860 افتراضيًا
+CMD ["gunicorn", "--bind", "0.0.0.0:7860", "main:app"]

README.md

@@ -1,11 +1,7 @@
 ---
-title: LightNovel
-emoji: 🌍
-colorFrom: yellow
-colorTo: yellow
-sdk: docker
-pinned: false
 license: mit
+colorFrom: blue
+colorTo: purple
+sdk: docker
+app_port: 7860
 ---
-
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference

main.py

@@ -0,0 +1,96 @@
+
+import os
+from flask import Flask, request, jsonify
+from scraper import (
+    search_novel,
+    get_novel_content,
+    get_chapter_content,
+    get_latest_release_novels,
+    get_hot_novels,
+    get_completed_novels,
+    get_most_popular_novels,
+    get_genres,
+    get_novels_by_genre,
+)
+
+app = Flask(__name__)
+
+
+@app.route("/")
+def hello_world():
+    """Example Hello World route."""
+    name = os.environ.get("NAME", "World")
+    return f"Hello {name}!"
+
+
+@app.route("/search")
+def search():
+    query = request.args.get("q")
+    if not query:
+        return jsonify({"error": 'Missing query parameter "q"'}), 400
+    page = request.args.get("page", 1, type=int)
+    results = search_novel(query, page)
+    return jsonify(results)
+
+
+@app.route("/novel")
+def novel():
+    url = request.args.get("url")
+    if not url:
+        return jsonify({"error": 'Missing query parameter "url"'}), 400
+    content = get_novel_content(url)
+    return jsonify(content)
+
+
+@app.route("/chapter")
+def chapter():
+    url = request.args.get("url")
+    if not url:
+        return jsonify({"error": 'Missing query parameter "url"'}), 400
+    content = get_chapter_content(url)
+    return jsonify(content)
+
+
+@app.route("/latest")
+def latest():
+    page = request.args.get("page", 1, type=int)
+    results = get_latest_release_novels(page)
+    return jsonify(results)
+
+
+@app.route("/hot")
+def hot():
+    page = request.args.get("page", 1, type=int)
+    results = get_hot_novels(page)
+    return jsonify(results)
+
+
+@app.route("/completed")
+def completed():
+    page = request.args.get("page", 1, type=int)
+    results = get_completed_novels(page)
+    return jsonify(results)
+
+
+@app.route("/popular")
+def popular():
+    page = request.args.get("page", 1, type=int)
+    results = get_most_popular_novels(page)
+    return jsonify(results)
+
+
+@app.route("/genres")
+def genres():
+    results = get_genres()
+    return jsonify(results)
+
+
+@app.route("/genre/<genre_name>")
+def by_genre(genre_name):
+    page = request.args.get("page", 1, type=int)
+    results = get_novels_by_genre(genre_name, page)
+    return jsonify(results)
+
+
+if __name__ == "__main__":
+    app.run(debug=True, host="0.0.0.0", port=int(os.environ.get("PORT", 8080)))

requirements.txt

@@ -0,0 +1,23 @@
+autopep8==2.3.2
+beautifulsoup4==4.14.3
+blinker==1.9.0
+certifi==2026.1.4
+charset-normalizer==3.4.4
+click==8.3.1
+Flask==3.0.3
+gunicorn==22.0.0
+idna==3.11
+iniconfig==2.3.0
+itsdangerous==2.2.0
+Jinja2==3.1.6
+MarkupSafe==3.0.3
+packaging==26.0
+pluggy==1.6.0
+pycodestyle==2.14.0
+Pygments==2.19.2
+pytest==9.0.2
+requests==2.32.5
+soupsieve==2.8.3
+typing_extensions==4.15.0
+urllib3==2.6.3
+Werkzeug==3.0.6

scraper.py

@@ -0,0 +1,132 @@
+
+import requests
+from bs4 import BeautifulSoup
+
+HEADERS = {
+    'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/58.0.3029.110 Safari/537.36'
+}
+
+def _scrape_novel_list_page(page_url):
+    response = requests.get(page_url, headers=HEADERS)
+    soup = BeautifulSoup(response.content, 'html.parser')
+
+    results = []
+    main_content = soup.find('div', class_='col-truyen-main')
+    if main_content:
+        for row in main_content.find_all('div', class_='row'):
+            title_element = row.find('h3', class_='truyen-title')
+            if title_element and title_element.find('a'):
+                title_anchor = title_element.find('a')
+                title = title_anchor.text
+                url = title_anchor['href']
+                
+                author_element = row.find('span', class_='author')
+                author = author_element.text.strip() if author_element else 'N/A'
+
+                results.append({
+                    'title': title,
+                    'url': f"https://novelfull.net{url}",
+                    'author': author
+                })
+    return results
+
+def search_novel(query, page=1):
+    search_url = f"https://novelfull.net/search?keyword={query}&page={page}"
+    return _scrape_novel_list_page(search_url)
+
+def get_latest_release_novels(page=1):
+    url = f"https://novelfull.net/latest-release-novel?page={page}"
+    return _scrape_novel_list_page(url)
+
+def get_hot_novels(page=1):
+    url = f"https://novelfull.net/hot-novel?page={page}"
+    return _scrape_novel_list_page(url)
+
+def get_completed_novels(page=1):
+    url = f"https://novelfull.net/completed-novel?page={page}"
+    return _scrape_novel_list_page(url)
+
+def get_most_popular_novels(page=1):
+    url = f"https://novelfull.net/most-popular?page={page}"
+    return _scrape_novel_list_page(url)
+
+def get_genres():
+    return [
+        "Shounen", "Horror", "Slice of Life",
+        "Harem", "Drama", "Seinen",
+        "Comedy", "Tragedy", "Lolicon",
+        "Martial Arts", "Supernatural", "Adult",
+        "School Life", "Ecchi", "Josei",
+        "Mystery", "Xuanhuan", "Sports",
+        "Shoujo", "Adventure", "Smut",
+        "Romance", "Action", "Mecha",
+        "Sci-fi", "Psychological", "Yaoi",
+        "Gender Bender", "Xianxia", "Shounen Ai",
+        "Mature", "Wuxia", "Magical Realism",
+        "Fantasy", "Historical", "Video Games"
+    ]
+
+def get_novels_by_genre(genre_name, page=1):
+    genre_slug = genre_name.replace(' ', '-')
+    genre_url = f"https://novelfull.net/genre/{genre_slug}?page={page}"
+    return _scrape_novel_list_page(genre_url)
+
+def get_novel_content(url):
+    response = requests.get(url, headers=HEADERS)
+    soup = BeautifulSoup(response.content, 'html.parser')
+
+    title_element = soup.find('h3', class_='title')
+    title = title_element.text if title_element else 'N/A'
+
+    author = 'N/A'
+    info_div = soup.find('div', class_='info')
+    if info_div:
+        author_div = info_div.find('h3', text='Author:')
+        if author_div and author_div.find_next_sibling('a'):
+            author = author_div.find_next_sibling('a').text
+
+    image_url = 'N/A'
+    book_div = soup.find('div', class_='book')
+    if book_div and book_div.find('img'):
+        image_tag = book_div.find('img')
+        if 'src' in image_tag.attrs:
+            src = image_tag['src']
+            if src.startswith('/'):
+                image_url = f"https://novelfull.net{src}"
+            else:
+                image_url = src
+
+    chapters = []
+    list_chapter_div = soup.find('div', id='list-chapter')
+    if list_chapter_div:
+        chapter_lists = list_chapter_div.select('.list-chapter')
+        for chapter_list in chapter_lists:
+            for chapter_item in chapter_list.find_all('a'):
+                chapters.append({
+                    'title': chapter_item.get('title', chapter_item.text.strip()),
+                    'url': f"https://novelfull.net{chapter_item['href']}"
+                })
+
+    return {
+        'title': title,
+        'author': author,
+        'image_url': image_url,
+        'chapters': chapters
+    }
+
+def get_chapter_content(url):
+    response = requests.get(url, headers=HEADERS)
+    soup = BeautifulSoup(response.content, 'html.parser')
+    
+    content_element = soup.find('div', id='chapter-content')
+    content = ''
+    if content_element:
+        paragraphs = content_element.find_all('p')
+        if paragraphs:
+            content = '\n\n'.join(p.get_text() for p in paragraphs)
+        else:
+            content = content_element.get_text(separator='\n\n')
+
+    return {
+        'content': content.strip() if content else 'N/A'
+    }

sharh.txt

@@ -0,0 +1,110 @@
+
+مرحبًا بك في شرح استخدام الواجهة البرمجية (API)
+
+هذا الدليل سيساعدك على فهم كيفية استخدام نقاط النهاية (Endpoints) المختلفة لجلب معلومات عن الروايات، بدءًا من البحث وحتى قراءة المحتوى.
+
+---
+
+### الخطوة الأولى: البحث عن رواية
+
+للبدء، تحتاج إلى العثور على الرواية التي تهمك. يمكنك القيام بذلك باستخدام نقطة النهاية التالية:
+
+**نقطة النهاية (Endpoint):** `/search`
+
+**الطريقة (Method):** `GET`
+
+**المعاملات (Parameters):**
+- `q` (إلزامي): هو مصطلح البحث الذي تريد استخدامه (مثل اسم الرواية).
+- `page` (اختياري): رقم الصفحة في حال كانت نتائج البحث متعددة. القيمة الافتراضية هي `1`.
+
+**مثال على الاستخدام:**
+للبحث عن رواية تحتوي على كلمة "love"، يمكنك استخدام الرابط التالي:
+`http://127.0.0.1:8080/search?q=love`
+
+**النتيجة المتوقعة:**
+ستعود لك هذه النقطة بقائمة من الروايات التي تطابق بحثك. كل عنصر في القائمة سيحتوي على:
+- `title`: عنوان الرواية.
+- `author`: اسم المؤلف.
+- `url`: رابط فريد خاص بالرواية، وهو مهم جدًا للخطوة التالية.
+
+```json
+[
+  {
+    "author": "Nilphy",
+    "title": "I Love Destroying Worlds' Plot [BL]",
+    "url": "https://novelfull.net/i-love-destroying-worlds-plot-bl.html"
+  },
+  ...
+]
+```
+
+---
+
+### الخطوة الثانية: الحصول على تفاصيل الرواية وفصولها
+
+بعد أن تحصل على `url` الرواية من الخطوة الأولى، يمكنك استخدامه لجلب كافة تفاصيل الرواية، بما في ذلك قائمة بجميع فصولها.
+
+**نقطة النهاية (Endpoint):** `/novel`
+
+**الطريقة (Method):** `GET`
+
+**المعاملات (Parameters):**
+- `url` (إلزامي): هو رابط الرواية الذي حصلت عليه من نقطة النهاية `/search`.
+
+**مثال على الاستخدام:**
+`http://127.0.0.1:8080/novel?url=https://novelfull.net/i-love-destroying-worlds-plot-bl.html`
+
+**النتيجة المتوقعة:**
+ستعود لك هذه النقطة بمعلومات مفصلة عن الرواية، وأهمها قائمة الفصول `chapters`. كل فصل في القائمة سيكون له:
+- `title`: عنوان الفصل.
+- `url`: رابط فريد خاص بالفصل، وهو ما ستحتاجه للخطوة الأخيرة.
+
+```json
+{
+  "title": "I Love Destroying Worlds' Plot [BL]",
+  "author": "Nilphy",
+  "image_url": "...",
+  "chapters": [
+    {
+      "title": "Chapter 1 - 1.0 Prologue",
+      "url": "https://novelfull.net/i-love-destroying-worlds-plot-bl/chapter-1-10-prologue-in-the-system-space-before-the-first-world.html"
+    },
+    ...
+  ]
+}
+```
+
+---
+
+### الخطوة الثالثة: قراءة محتوى فصل معين
+
+أخيرًا، بعد حصولك على رابط الفصل (`url`) من الخطوة الثانية، يمكنك استخدامه لجلب المحتوى النصي الكامل لهذا الفصل.
+
+**نقطة النهاية (Endpoint):** `/chapter`
+
+**الطريقة (Method):** `GET`
+
+**المعاملات (Parameters):**
+- `url` (إلزامي): هو رابط الفصل الذي حصلت عليه من نقطة النهاية `/novel`.
+
+**مثال على الاستخدام:**
+`http://127.0.0.1:8080/chapter?url=https://novelfull.net/i-love-destroying-worlds-plot-bl/chapter-1-10-prologue-in-the-system-space-before-the-first-world.html`
+
+**النتيجة المتوقعة:**
+ستعود لك هذه النقطة بمحتوى الفصل على شكل نص.
+
+```json
+{
+  "content": "Hei Anjing is a person who is extremely lazy that he dies from excessive sleeping and never wakes up anymore..."
+}
+```
+
+---
+### ملخص نقاط النهاية الأخرى:
+
+- `/latest`: للحصول على أحدث الروايات المضافة.
+- `/hot`: للحصول على الروايات الأكثر رواجًا.
+- `/completed`: للحصول على قائمة بالروايات المكتملة.
+- `/popular`: للحصول على الروايات الأكثر شهرة.
+- `/genres`: لعرض جميع الأنواع الأدبية المتاحة.
+- `/genre/<genre_name>`: لتصفح الروايات حسب نوع معين (مثال: `/genre/Shounen`).