الصنف urllib.request.AbstractBasicAuthHandler في بايثون

من موسوعة حسوب
< Python‏ | urllib‏ | request
اذهب إلى التنقل اذهب إلى البحث

صنف مخلوط mixin class يساعد في عمليات استيثاق HTTP لكلٍّ من المضيف البعيد remote host والوسيط proxy.

البنية العامة

urllib.request.AbstractBasicAuthHandler(password_mgr=None)

المعاملات

password_mgr

معامل اختياري، ويجب أن تكون قيمته متوافقة مع الصنف HTTPPasswordMgr. راجع قسم كائنات HTTPPasswordMgr للاطلاع على معلومات مفصّلة حول الواجهة التي يجب أن تكون مدعومة.

إن كانت قيمة passwd_mgr تقدّم التابعين is_authenticated و update_authenticated (راجع كائنات HTTPPasswordMgrWithPriorAuth) فإنّ الصنف المعالج سيستخدم نتيجة استدعاء التابع is_authenticated لعنوان URI معين لتحديد ما إذا ستُرسل معلومات الاستيثاق مع الطلب أم لا.

إن أعاد التابع is_authenticated القيمة True لعنوان URI، فإنّ معلومات الاستيثاق ستُرسل مع الطلب، وإن أعطى القيمة False فلن ترسل المعلومات مع الطلب وإن كانت الإجابة حينئذٍ هي 401 فإن الطلب سيُرسل مرة أخرى مع معلومات الاستيثاق. يُستدعى التابع update_authenticated عند نجاح عملية الاستيثاق لتعين القيمة True للتابع is_authenticated لعنوان URI، وبهذا ستتضمّن الطلبات اللاحقة لهذا العنوان أو أيّ عناوين علوية super-URIs معلومات الاستيثاق بصورة تلقائية.

ملاحظة: أضيف دعم is_authenticated في الإصدار 3.5 من بايثون.

مصادر