الصنف 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
إن أعاد المخدّم شيفرة خطأ.