Delete

tests/.env.example

@@ -1,25 +0,0 @@
-# إعدادات عامة
-APP_NAME=HF Chat Backend
-APP_ENV=development
-DEBUG=false
-
-# إعدادات Hugging Face
-# احصل على التوكن من: https://huggingface.co/settings/tokens
-HF_API_TOKEN=hf_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
-# معرّف النموذج على Hugging Face (أو رابط Inference Endpoint المخصص)
-HF_MODEL_ID=meta-llama/Llama-3.1-8B-Instruct
-# اتركه فارغاً لاستخدام Hugging Face Inference API الافتراضي
-# أو حدد مزود متوافق مثل: together, fireworks-ai, replicate, sambanova
-HF_PROVIDER=
-HF_TIMEOUT_SECONDS=60
-
-# إعدادات التوليد الافتراضية
-DEFAULT_MAX_NEW_TOKENS=512
-DEFAULT_TEMPERATURE=0.7
-DEFAULT_TOP_P=0.95
-
-# مفتاح لحماية الباكند نفسه (اتركه فارغاً لتعطيل الحماية)
-BACKEND_API_KEY=
-
-# CORS - افصل بفواصل أو استخدم * للسماح للجميع
-CORS_ALLOW_ORIGINS=*

tests/Dockerfile

@@ -1,19 +0,0 @@
-FROM python:3.12-slim
-
-WORKDIR /app
-
-ENV PYTHONDONTWRITEBYTECODE=1 \
-    PYTHONUNBUFFERED=1
-
-COPY requirements.txt .
-RUN pip install --no-cache-dir -r requirements.txt
-
-COPY app ./app
-
-EXPOSE 8000
-
-# Healthcheck بسيط
-HEALTHCHECK --interval=30s --timeout=5s --start-period=10s --retries=3 \
-    CMD python -c "import urllib.request; urllib.request.urlopen('http://localhost:8000/health')" || exit 1
-
-CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "7860"]

tests/README.md

@@ -1,126 +0,0 @@
-# HF Chat Backend
-
-باكند بسيط ومنظّم مبني بـ **FastAPI** يستدعي نموذج **LLM/Chatbot** مستضاف على **Hugging Face** (عبر Inference API أو Inference Endpoint أو أي مزود متوافق) ويعرضه كـ REST API جاهز للاستخدام من أي تطبيق أو Agent.
-
-## البنية
-
-```
-hf-chat-backend/
-├── app/
-│   ├── main.py              # نقطة الدخول + إعداد FastAPI
-│   ├── config.py            # الإعدادات (تُقرأ من .env)
-│   ├── schemas.py           # Pydantic Schemas
-│   ├── dependencies.py      # Dependency Injection + حماية بمفتاح API
-│   ├── logging_config.py    # Logging مهيكل بصيغة JSON
-│   ├── services/
-│   │   └── hf_client.py     # طبقة الاتصال بـ Hugging Face
-│   └── routers/
-│       ├── health.py        # GET /health
-│       └── chat.py          # POST /chat (رد كامل أو بث SSE)
-├── tests/                   # اختبارات pytest
-├── requirements.txt
-├── requirements-dev.txt
-├── Dockerfile
-├── docker-compose.yml
-├── .env.example
-└── pyproject.toml
-```
-
-## 1) الإعداد المحلي
-
-```bash
-cd hf-chat-backend
-python -m venv .venv && source .venv/bin/activate
-pip install -r requirements-dev.txt
-cp .env.example .env
-# عدّل .env وضع HF_API_TOKEN و HF_MODEL_ID الخاصين بك
-```
-
-### متغيرات البيئة الأساسية (.env)
-
-| المتغير | الوصف |
-|---|---|
-| `HF_API_TOKEN` | التوكن من https://huggingface.co/settings/tokens |
-| `HF_MODEL_ID` | معرّف النموذج، مثال: `meta-llama/Llama-3.1-8B-Instruct` |
-| `HF_PROVIDER` | اتركه فارغاً لاستخدام hf-inference الافتراضي، أو حدد مزود مثل `together`، `fireworks-ai` |
-| `BACKEND_API_KEY` | اختياري: لحماية الباكند نفسه بمفتاح `X-API-Key` |
-
-### التشغيل
-
-```bash
-uvicorn app.main:app --reload
-```
-
-ثم افتح: `http://localhost:8000/docs` لتوثيق Swagger التفاعلي.
-
-## 2) الاختبارات والجودة
-
-```bash
-pytest -v
-ruff check app tests
-mypy app
-```
-
-## 3) الاستخدام عبر Docker
-
-```bash
-docker compose up --build
-```
-
-## 4) استدعاء الـ API
-
-### رد كامل (بدون بث)
-
-```bash
-curl -X POST http://localhost:8000/chat \
-  -H "Content-Type: application/json" \
-  -d '{
-    "messages": [
-      {"role": "system", "content": "أنت مساعد ذكي ومفيد."},
-      {"role": "user", "content": "اشرح لي ما هو FastAPI باختصار"}
-    ]
-  }'
-```
-
-### رد ببث لحظي (Server-Sent Events)
-
-```bash
-curl -N -X POST http://localhost:8000/chat \
-  -H "Content-Type: application/json" \
-  -d '{
-    "messages": [{"role": "user", "content": "اكتب قصة قصيرة"}],
-    "stream": true
-  }'
-```
-
-### مع حماية بمفتاح API
-
-إذا فعّلت `BACKEND_API_KEY` في `.env`، أضف الهيدر:
-
-```bash
--H "X-API-Key: your-secret-key"
-```
-
-## 5) النشر على Hugging Face
-
-عندك خياران رئيسيان حسب مكان استضافة **النموذج نفسه**:
-
-### الخيار أ: النموذج مستضاف بالفعل على HF (Inference API / Endpoint)
-هذا الباكند لا يحتاج لاستضافة النموذج — فقط يستدعيه عبر الشبكة. يمكنك نشر هذا الباكند في أي مكان (Render, Railway, VPS, Docker, Fly.io...) طالما ضبطت `HF_API_TOKEN` و `HF_MODEL_ID`.
-
-### الخيار ب: نشر الباكند نفسه كـ Hugging Face Space
-1. أنشئ Space جديد من نوع **Docker** على https://huggingface.co/new-space
-2. ارفع محتويات هذا المجلد كاملة (بما فيها `Dockerfile`)
-3. من إعدادات الـ Space أضف Secret باسم `HF_API_TOKEN` وقيمته توكنك
-4. عدّل `HF_MODEL_ID` حسب النموذج المطلوب (Variable وليس Secret)
-5. Hugging Face Spaces يستخدم المنفذ `7860` افتراضياً — عدّل `Dockerfile` وضع:
-   ```dockerfile
-   EXPOSE 7860
-   CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "7860"]
-   ```
-
-## 6) ملاحظات إنتاجية
-
-- **الأمان**: فعّل `BACKEND_API_KEY` دائماً في الإنتاج، ولا تضع `HF_API_TOKEN` في الكود مطلقاً — استخدم Secrets فقط.
-- **Rate Limiting**: هذا المشروع بسيط ومخصص للانطلاق السريع؛ إذا احتجت Rate Limiting متقدم أو RBAC كامل أو Plugins متعددة (PDF, Media, Network...) أخبرني وأبني لك نسخة موسّعة على مراحل.
-- **CORS**: بشكل افتراضي مفتوح للجميع (`*`) — قيّده بدومينات تطبيقك الفعلية في الإنتاج عبر `CORS_ALLOW_ORIGINS`.

tests/conftest.py

@@ -1,12 +0,0 @@
-"""
-Shared test fixtures.
-"""
-import pytest
-from fastapi.testclient import TestClient
-
-from app.main import app
-
-
-@pytest.fixture
-def client():
-    return TestClient(app)

tests/docker-compose.yml

@@ -1,8 +0,0 @@
-services:
-  api:
-    build: .
-    ports:
-      - "7860:7860"
-    env_file:
-      - .env
-    restart: unless-stopped

tests/requirements.txt

@@ -1,7 +0,0 @@
-fastapi==0.115.6
-uvicorn[standard]==0.34.0
-pydantic==2.10.4
-pydantic-settings==2.7.1
-huggingface_hub==1.21.0
-python-multipart==0.0.20
-httpx==0.28.1

tests/test_api.py

@@ -1,82 +0,0 @@
-"""
-Tests for health and tools endpoints.
-"""
-import pytest
-
-
-def test_health(client):
-    resp = client.get("/health")
-    assert resp.status_code == 200
-    data = resp.json()
-    assert data["status"] == "ok"
-    assert data["tools_count"] > 0
-
-
-def test_list_tools(client):
-    resp = client.get("/tools")
-    assert resp.status_code == 200
-    data = resp.json()
-    assert data["total"] > 0
-    names = [t["name"] for t in data["tools"]]
-    assert "pdf_merge" in names
-    assert "image_resize" in names
-    assert "dns_lookup" in names
-    assert "chat_completion" in names
-
-
-def test_list_tools_by_category(client):
-    resp = client.get("/tools/category/document")
-    assert resp.status_code == 200
-    data = resp.json()
-    assert len(data) > 0
-    assert all(t["category"] == "document" for t in data)
-
-
-def test_openai_schema(client):
-    resp = client.get("/tools/openai-schema")
-    assert resp.status_code == 200
-    data = resp.json()
-    assert len(data) > 0
-    assert data[0]["type"] == "function"
-
-
-def test_unknown_tool(client):
-    resp = client.post("/tools/execute", json={"tool": "nonexistent", "params": {}})
-    assert resp.status_code == 200
-    data = resp.json()
-    assert data["success"] is False
-    assert "Unknown tool" in data["error"]
-
-
-def test_pdf_create(client):
-    resp = client.post("/pdf/create", json={"content": "Hello World", "title": "Test"})
-    assert resp.status_code == 200
-    data = resp.json()
-    assert data["success"] is True
-    assert data["result"]["file_id"] is not None
-
-
-def test_hash_generate(client):
-    resp = client.post("/crypto/hash", json={"text": "hello", "algorithm": "sha256"})
-    assert resp.status_code == 200
-    data = resp.json()
-    assert data["success"] is True
-    assert len(data["result"]["hash"]) == 64
-
-
-def test_password_generate(client):
-    resp = client.post("/crypto/password-gen", json={"length": 32})
-    assert resp.status_code == 200
-    data = resp.json()
-    assert data["success"] is True
-    assert len(data["result"]["password"]) == 32
-
-
-def test_base64(client):
-    enc = client.post("/crypto/base64/encode", json={"text": "hello world"})
-    assert enc.status_code == 200
-    encoded = enc.json()["result"]["encoded"]
-
-    dec = client.post("/crypto/base64/decode", json={"encoded": encoded})
-    assert dec.status_code == 200
-    assert dec.json()["result"]["decoded"] == "hello world"

tests/test_chat.py

@@ -1,38 +0,0 @@
-from unittest.mock import AsyncMock
-
-from fastapi.testclient import TestClient
-
-from app.dependencies import get_hf_service
-from app.main import app
-
-client = TestClient(app)
-
-
-def _override_hf_service(reply: str = "مرحباً! كيف أقدر أساعدك؟"):
-    mock_service = AsyncMock()
-    mock_service.chat_completion.return_value = (reply, "stop")
-    app.dependency_overrides[get_hf_service] = lambda: mock_service
-    return mock_service
-
-
-def teardown_function():
-    app.dependency_overrides.clear()
-
-
-def test_chat_returns_reply_from_model():
-    _override_hf_service(reply="أهلاً بك")
-
-    response = client.post(
-        "/chat",
-        json={"messages": [{"role": "user", "content": "مرحبا"}]},
-    )
-
-    assert response.status_code == 200
-    body = response.json()
-    assert body["reply"] == "أهلاً بك"
-    assert body["finish_reason"] == "stop"
-
-
-def test_chat_rejects_empty_messages():
-    response = client.post("/chat", json={"messages": []})
-    assert response.status_code == 422

tests/test_health.py

@@ -1,13 +0,0 @@
-from fastapi.testclient import TestClient
-
-from app.main import app
-
-client = TestClient(app)
-
-
-def test_health_check_returns_ok():
-    response = client.get("/health")
-    assert response.status_code == 200
-    body = response.json()
-    assert body["status"] == "ok"
-    assert "model" in body