الفرق بين المراجعتين لصفحة: «Python/wsgiref/util»

من موسوعة حسوب
طلا ملخص تعديل
 
(1 مراجعات متوسطة بواسطة نفس المستخدم غير معروضة)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE:الوحدة <code>wsgiref.util()‎‎</code> في بايثون}}</noinclude>
<noinclude>{{DISPLAYTITLE:الوحدة <code>wsgiref.util()‎‎</code> في بايثون}}</noinclude>


تقدّم هذه الوحدة مجموعة متنوعة من الدوال التي تساعد في التعامل مع بيئات WSGI. بيئة WSGI هي قاموس يتضمّن متغيرات طلب HTTP وبحسب ما هو موصوف في PEP 3333. تتوقع جميع الدوال التي تأخذ المعامل environ تزويدها بقاموس متوافق مع WSGI. يمكن مراجعة [https://www.python.org/dev/peps/pep-3333 PEP 3333] للاطلاع على المزيد من التفاصيل.
تقدّم هذه الوحدة مجموعة متنوعة من الدوال التي تساعد في التعامل مع بيئات WSGI. بيئة WSGI هي قاموس يتضمّن متغيرات طلب HTTP وبحسب ما هو موصوف في [https://www.python.org/dev/peps/pep-3333 PEP 3333].  تأخذ جميع الدوال المعامل <code>environ</code> وهو عبارة عن <nowiki/>[[Python/dict|قاموس]] متوافق مع WSGI. يمكن مراجعة [https://www.python.org/dev/peps/pep-3333 PEP 3333] للاطلاع على المزيد من التفاصيل.


== دوال الوحدة <code>wsgiref.util</code> ==
== دوال الوحدة <code>wsgiref.util</code> ==


=== الدالة <code>[[Python/wsgiref/util/guess scheme|wsgiref.util.guess_scheme()‎]]</code> ===
=== الدالة <code>[[Python/wsgiref/util/guess scheme|wsgiref.util.guess_scheme()‎]]</code> ===
تخمّن الدالة ما يجب أن تكون عليه قيمة wsgi.url_scheme، إمّا "http" أو "https"، وذلك بالتحقق من قيمة متغير البيئة HTTPS في القاموس المعطى.
تخمّن الدالة ما يجب أن تكون عليه قيمة <code>wsgi.url_scheme</code> وذلك بالتحقق من قيمة متغير البيئة <code>HTTPS</code> في القاموس المعطى.


=== الدالة <code>[[Python/wsgiref/util/request uri|wsgiref.util.request_uri()]]</code>‎ ===
=== الدالة <code>[[Python/wsgiref/util/request uri|wsgiref.util.request_uri()]]</code>‎ ===
تعيد الدالة معرّف URI الكامل في الطلب باستخدام الخوارزمية الموجودة في قسم "إعادة بناء عنوان URL" في PEP 3333.
تعيد الدالة معرّف URI الكامل في الطلب باستخدام الخوارزمية الموجودة في قسم "URL Reconstruction" في[https://www.python.org/dev/peps/pep-3333 PEP 3333].


=== الدالة <code>[[Python/wsgiref/util/application uri|wsgiref.util.application_uri()‎]]</code> ===
=== الدالة <code>[[Python/wsgiref/util/application uri|wsgiref.util.application_uri()‎]]</code> ===
هذه الدالة مشابهة للدالة request_uri()‎ باستثناء أنّ هذه الدالة تتجاهل المتغيّرين PATH_INFO و QUERY_STRING. 
هذه الدالة مشابهة للدالة <code>request_uri()‎</code> باستثناء أنّ هذه الدالة تتجاهل المتغيّرين <code>PATH_INFO</code> و <code>QUERY_STRING</code>


=== الدالة <code>[[Python/wsgiref/util/shift path info|wsgiref.util.shift_path_info()‎]]</code> ===
=== الدالة <code>[[Python/wsgiref/util/shift path info|wsgiref.util.shift_path_info()‎]]</code> ===
تنقل الدالة اسمًا منفردًا من PATH_INFO إلى SCRIPT_NAME وتعيد الاسم المنقول.
تنقل الدالة اسمًا منفردًا من <code>PATH_INFO</code> إلى <code>SCRIPT_NAME</code> وتعيد الاسم المنقول.


=== الدالة <code>[[Python/wsgiref/util/setup testing defaults|wsgiref.util.setup_testing_defaults()‎]]</code> ===
=== الدالة <code>[[Python/wsgiref/util/setup testing defaults|wsgiref.util.setup_testing_defaults()‎]]</code> ===
سطر 21: سطر 21:


=== الدالة <code>[[Python/wsgiref/util/is hop by hop|wsgiref.util.is_hop_by_hop()‎]]</code> ===
=== الدالة <code>[[Python/wsgiref/util/is hop by hop|wsgiref.util.is_hop_by_hop()‎]]</code> ===
تعيد الدالة القيمة <code>True</code> إن كان اسم الترويسة <code>'header-name'</code> هو HTTP/1.0 "Hop-by-Hop"‎ وبحسب ما هو معرّف في [[rfc:2616.html|RFC 2616]].
تعيد الدالة القيمة <code>True</code> إن كان اسم الترويسة المعطى هو HTTP/1.0 "Hop-by-Hop"‎ وبحسب ما هو معرّف في [[rfc:2616.html|RFC 2616]].


== أصناف الوحدة <code>wsgiref.util</code> ==
== أصناف الوحدة <code>wsgiref.util</code> ==

المراجعة الحالية بتاريخ 21:24، 26 ديسمبر 2018


تقدّم هذه الوحدة مجموعة متنوعة من الدوال التي تساعد في التعامل مع بيئات WSGI. بيئة WSGI هي قاموس يتضمّن متغيرات طلب HTTP وبحسب ما هو موصوف في PEP 3333.  تأخذ جميع الدوال المعامل environ وهو عبارة عن قاموس متوافق مع WSGI. يمكن مراجعة PEP 3333 للاطلاع على المزيد من التفاصيل.

دوال الوحدة wsgiref.util

الدالة wsgiref.util.guess_scheme()‎

تخمّن الدالة ما يجب أن تكون عليه قيمة wsgi.url_scheme وذلك بالتحقق من قيمة متغير البيئة HTTPS في القاموس المعطى.

الدالة wsgiref.util.request_uri()

تعيد الدالة معرّف URI الكامل في الطلب باستخدام الخوارزمية الموجودة في قسم "URL Reconstruction" فيPEP 3333.

الدالة wsgiref.util.application_uri()‎

هذه الدالة مشابهة للدالة request_uri()‎ باستثناء أنّ هذه الدالة تتجاهل المتغيّرين PATH_INFO و QUERY_STRING

الدالة wsgiref.util.shift_path_info()‎

تنقل الدالة اسمًا منفردًا من PATH_INFO إلى SCRIPT_NAME وتعيد الاسم المنقول.

الدالة wsgiref.util.setup_testing_defaults()‎

تحدّث الدالة البيئة المعطاة بإضافة قيم افتراضية لغرض التجربة.

الدالة wsgiref.util.is_hop_by_hop()‎

تعيد الدالة القيمة True إن كان اسم الترويسة المعطى هو HTTP/1.0 "Hop-by-Hop"‎ وبحسب ما هو معرّف في RFC 2616.

أصناف الوحدة wsgiref.util

الصنف wsgiref.util.FileWrapper

صنف تغليف wrapper يحوّل كائنًا شبيهًا بالملف file-like object إلى مكرّر iterator.

مصادر