الصنف urllib.request.URLopener()‎‎ في بايثون

من موسوعة حسوب

ملاحظة: هذا الصنف مهمل في الإصدار 3.3 وما بعده من بايثون.

هذا هو الصنف الأساسي لفتح وقراءة عناوين URL. إن لم تكن ترغب في دعم فتح الكائنات باستخدام مخطّطات http:‎ أو ftp:‎ أو file، فستحتاج على الأرجح إلى استخدام الصنف FancyURLopener.

يرسل الصنف URLopener افتراضيًا ترويسة User-Agent من نوع urllib/VVV حيث تمثل VVV رقم إصدار urllib. يمكن للتطبيقات أن تعرّف ترويسة User-Agent الخاصّة بها عن طريق إنشاء أصناف فرعية من الصنف URLopener أو FancyURLopener وتعيين قيمة نصية ملائمة للخاصية version في تعريف الصنف المتفرّع.

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

urllib.request.URLopener(proxies=None, **x509)

المعاملات

proxies

يجب أن يكون هذا المعامل الاختياري قاموسًا يربط أسماء المخطّطات بوسائط URL، وإن كان القاموس فارغًا فلن تستخدم الوسائط على الإطلاق. يأخذ هذا المعامل القيمة None كقيمة افتراضية، وفي هذه الحالة تُستخدم إعدادات الوسيط في البيئة إن كانت موجودة وكما مرّ ذكره في تعريف الدالة urlopen()‎.

يمكن استخدام معاملات مفتاحية إضافية -تُجمع في x509- لإجراء عملية الاستيثاق على العميل عند استخدام المخطط https:‎. يمكن استخدام الكلمتين المفتاحيتين key_file و cert_file لتزويد الدالة بمفتاح SSL وشهادة واللذان تحتاجهما الدالة لدعم عملية استيثاق العميل.

تطلق كائنات URLopener الاستثناء OSError إن أعاد المخدّم شيفرة خطأ.

مصادر