الدالة wsgiref.util.setup_testing_defaults()‎‎ في بايثون

من موسوعة حسوب
< Python‏ | wsgiref‏ | util


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

تضيف هذه الدالة عددًا من المعاملات المطلوبة في WSGI وهي HTTP_POST و SERVER_NAME و SERVER_PORT و REQUEST_METHOD و SCRIPT_NAME و PATH_INFO وجميع المتغيرات wsgi.*‎ المعرّفة في PEP 3333. تقدّم الدالة القيم الافتراضية فقط، ولا تستبدل أي إعدادات مسبقة لهذه المتغيرات.

إن الهدف من هذه الدالة هو تسهيل إجراء اختبارات الوحدات unit tests لمخدّمات وتطبيقات WSGI وذلك لتهيئة بيئات مؤقتة dummy environments؛ لهذا لا يجوز أن تستخدم من قبل مخدّمات وتطبيقات WSGI حقيقية، لأنّ البيانات غير صحيحة.

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

wsgiref.util.setup_testing_defaults(environ)

المعاملات

environ

قاموس متوافق مع WSGI. يمكن مراجعة PEP 3333 للاطلاع على المزيد من التفاصيل.

أمثلة

يبين المثال التالي طريقة عمل الدالة:

from wsgiref.util import setup_testing_defaults
from wsgiref.simple_server import make_server

# تطبيق بسيط نسبيًا، مهمّته طباعة قاموس البيئة
# بعد تحديثه بواسطة الدالة
def simple_app(environ, start_response):
    setup_testing_defaults(environ)

    status = '200 OK'
    headers = [('Content-type', 'text/plain; charset=utf-8')]

    start_response(status, headers)

    ret = [("%s: %s\n" % (key, value)).encode("utf-8")
           for key, value in environ.items()]
    return ret

with make_server('', 8000, simple_app) as httpd:
    print("Serving on port 8000...")
    httpd.serve_forever()

مصادر