saad-tools

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

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

التثبيت

python -m pip install -U saad-tools

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

import saad

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

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

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)

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

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())

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

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.