عرض مصدر Python/urllib/request/URLopener

<noinclude>{{DISPLAYTITLE:الصنف <code>urllib.request.URLopener()‎‎</code> في بايثون}}</noinclude>
'''ملاحظة:''' هذا الصنف مهمل في الإصدار 3.3 وما بعده من بايثون.

هذا هو الصنف الأساسي لفتح وقراءة عناوين URL. إن لم تكن ترغب في دعم فتح الكائنات باستخدام مخطّطات <code>http:</code>‎ أو <code>ftp:‎</code> أو <code>file</code>، فستحتاج على الأرجح إلى استخدام الصنف <code>[[Python/urllib/request/FancyURLopener|FancyURLopener]]</code>.

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

<syntaxhighlight lang="python3">
urllib.request.URLopener(proxies=None, **x509)
</syntaxhighlight>

== المعاملات ==

=== <code>proxies</code> ===

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

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

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

== خصائص الصنف <code>URLopener</code> ==
تمتلك كائنات URLopener خاصية وحيدة هي:

=== الخاصية <code>version</code> ===
متغيّر يحدّد وكيل المستخدم لكائن الفتح. يمكن استخدام هذا المتغيّر في صنف فرعي أو في الدالة البانية قبل استدعاء الدالة البانية الأساسية، لتُخبر وحدة <code>urllib</code> المخدّم بوجود وكيل مستخدم خاص.

== توابع الصنف <code>URLopener</code> ==
تقدّم كائنات <code>URLopener</code> التوابع التالية:

=== التابع <code>[[Python/urllib/request/URLopener/open|open()]]‎</code> ===
يفتح التابع عنوان URL الكامل المعطى باستخدام البروتوكول المناسب.

=== التابع <code>[[Python/urllib/request/URLopener/open unknown|open_unknown()]]‎</code> ===
واجهة قابلة للتعديل لفتح عناوين URL مجهولة النوع.

=== التابع <code>[[Python/urllib/request/URLopener/retrieve|retrieve()]]‎</code> ===
يجلب التابع محتويات عنوان URL المعطى ويضعها في الملف المعطى.

== مصادر ==
* [https://docs.python.org/3/library/urllib.request.html#urllib.request.URLopener صفحة Extensible library for opening URLs في توثيق بايثون الرسمي.]

[[تصنيف:Python]]
[[تصنيف:Python Modules]]
[[تصنيف:Python Methods]]