الفرق بين المراجعتين لصفحة: «Python/urllib/request/URLopener»
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:الصنف <code>urllib.request.URLopener()</code> في بايثون}}</noinclude> '''ملاحظة:''' هذا الصنف مهمل في ا...' |
لا ملخص تعديل |
||
| سطر 2: | سطر 2: | ||
'''ملاحظة:''' هذا الصنف مهمل في الإصدار 3.3 وما بعده من بايثون. | '''ملاحظة:''' هذا الصنف مهمل في الإصدار 3.3 وما بعده من بايثون. | ||
هذا هو الصنف الأساسي لفتح وقراءة عناوين URL. إن لم تكن ترغب في دعم فتح الكائنات باستخدام مخطّطات http: أو ftp: أو | هذا هو الصنف الأساسي لفتح وقراءة عناوين URL. إن لم تكن ترغب في دعم فتح الكائنات باستخدام مخطّطات <code>http:</code> أو <code>ftp:</code> أو <code>file</code>، فستحتاج على الأرجح إلى استخدام الصنف <code>[[Python/urllib/request/FancyURLopener|FancyURLopener]]</code>. | ||
يرسل الصنف <code>URLopener</code> افتراضيًا ترويسة User-<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> في تعريف الصنف المتفرّع. | |||
== البنية العامة == | == البنية العامة == | ||
| سطر 17: | سطر 15: | ||
=== <code>proxies</code> === | === <code>proxies</code> === | ||
يجب أن يكون هذا المعامل الاختياري قاموسًا يربط أسماء المخطّطات بوسائط URL، وإن كان القاموس فارغًا فلن تستخدم الوسائط على الإطلاق. يأخذ هذا المعامل القيمة None كقيمة افتراضية، وفي هذه الحالة تُستخدم إعدادات الوسيط في البيئة إن كانت موجودة وكما مرّ ذكره في تعريف الدالة urlopen(). | يجب أن يكون هذا المعامل الاختياري قاموسًا يربط أسماء المخطّطات بوسائط URL، وإن كان القاموس فارغًا فلن تستخدم الوسائط على الإطلاق. يأخذ هذا المعامل القيمة <code>None</code> كقيمة افتراضية، وفي هذه الحالة تُستخدم إعدادات الوسيط في البيئة إن كانت موجودة وكما مرّ ذكره في تعريف الدالة <code>[[Python/urllib/request/urlopen|urlopen()]]</code>. | ||
يمكن استخدام معاملات مفتاحية إضافية -تُجمع في x509- لإجراء عملية الاستيثاق على العميل عند استخدام المخطط https:. يمكن استخدام الكلمتين المفتاحيتين key_file و cert_file لتزويد الدالة بمفتاح SSL وشهادة واللذان تحتاجهما الدالة لدعم عملية استيثاق العميل. | يمكن استخدام معاملات مفتاحية إضافية -تُجمع في <code>x509</code>- لإجراء عملية الاستيثاق على العميل عند استخدام المخطط <code>https:</code>. يمكن استخدام الكلمتين المفتاحيتين <code>key_file</code> و <code>cert_file</code> لتزويد الدالة بمفتاح SSL وشهادة واللذان تحتاجهما الدالة لدعم عملية استيثاق العميل. | ||
تطلق كائنات URLopener الاستثناء OSError إن أعاد المخدّم شيفرة خطأ. | تطلق كائنات <code>URLopener</code> الاستثناء <code>OSError</code> إن أعاد المخدّم شيفرة خطأ. | ||
== مصادر == | == مصادر == | ||
مراجعة 04:34، 3 فبراير 2019
ملاحظة: هذا الصنف مهمل في الإصدار 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 إن أعاد المخدّم شيفرة خطأ.