httpx

کلاینت HTTP مدرن با پشتیبانی async

۴.۷۹ از ۵ پایتون

این کتابخانه چیست و چه می‌کند؟

httpx همان API ساده requests را می‌دهد اما مدرن: پشتیبانی HTTP/2، کلاینت‌های sync و async، تایم‌اوت دقیق و تایپ‌هینت کامل. چون API آن شبیه requests است، مهاجرت تقریباً بدون تغییر کد است و برای پروژه‌های async و FastAPI انتخاب طبیعی است.

قابلیت‌های کلیدی

  • کلاینت sync و async با یک API
  • پشتیبانی HTTP/1.1 و HTTP/2
  • تایم‌اوت دقیق روی اتصال و خواندن
  • استریم پاسخ و آپلود فایل

مثال کاربردی واقعی

قابل اجرا
import httpx

with httpx.Client(timeout=10) as client:
    resp = client.get('https://api.github.com/repos/encode/httpx')
    print(resp.status_code, resp.json()['stargazers_count'])

    resp = client.post('https://httpbin.org/post', json={'ok': True})
    print(resp.json()['json'])

توضیح مثال: همیشه از Client استفاده کنید تا اتصال‌ها reuse شوند و هدرها یک‌جا ست شوند؛ تایم‌اوت پیش‌فرض ۵ ثانیه است و بدون آن درخواست ممکن است معلق بماند.

نکات حرفه‌ای

  • برای تعداد زیاد درخواست از httpx.AsyncClient و asyncio.gather استفاده کنید.
  • با response.raise_for_status() خطاهای 4xx و 5xx را استثنا کنید.