Metadata-Version: 2.4
Name: saad-tools
Version: 0.2.0
Summary: A lightweight requests-compatible HTTP client facade named saad
Author: SAAD
License: MIT
Project-URL: Homepage, https://pypi.org/project/saad-tools/
Keywords: saad,requests,http,api,client
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Classifier: Environment :: Console
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests>=2.20
Dynamic: license-file

# saad-tools

مكتبة Python خفيفة باسم **saad**، وتعمل كواجهة متوافقة مع أسلوب مكتبة `requests`. الهدف هو أن تنتقل من `requests` إلى `saad` مع أقل تغييرات ممكنة في الكود.

> ملاحظة: saad لا تعيد كتابة محرك HTTP من الصفر؛ بل تستخدم requests كمحرك موثوق وتعيد تصدير واجهته. لذلك تحتاج الحزمة إلى اعتماد `requests`.

## التثبيت

```bash
python -m pip install -U saad-tools
```

## الاستخدام الأساسي

```python
import saad

response = saad.get("https://example.com", timeout=15)
print(response.status_code)
print(response.text)
```

## الطرق الأساسية

```python
import saad

saad.get(url, params={"page": 1}, timeout=15)
saad.post(url, json={"name": "SAAD"}, timeout=15)
saad.put(url, data={"enabled": True})
saad.patch(url, json={"enabled": False})
saad.delete(url)
saad.head(url)
saad.options(url)
saad.request("GET", url)
```

## الجلسات والرؤوس

```python
import saad

session = saad.Session()
session.headers.update({"User-Agent": "SAAD/0.2.0"})
response = session.get("https://example.com", timeout=15)
response.raise_for_status()
print(response.json())
```

## معالجة الأخطاء

```python
import saad

try:
    response = saad.get("https://example.com", timeout=10)
    response.raise_for_status()
except saad.Timeout:
    print("انتهت مهلة الطلب")
except saad.RequestException as error:
    print("حدث خطأ في الطلب:", error)
```

## التوافق

الإصدار 0.2.0 يوفّر الدوال `get` و`post` و`put` و`patch` و`delete` و`head` و`options` و`request`، إضافة إلى `Session` و`Response` والاستثناءات الأساسية والوحدات الشائعة مثل `auth` و`cookies` و`adapters` و`utils`. السمات غير المعرّفة مباشرة في saad تُمرّر إلى requests عند الحاجة.

## الترخيص

MIT.
