عرض مصدر Python/cgitb/enable

<noinclude>{{DISPLAYTITLE:الدالة <code>cgitb.enable()‎‎</code> في بايثون}}</noinclude>

يؤدّي استدعاء هذه الدالة إلى تولّي وحدة <code>cgitb</code> مسؤولية معالجة الاستثناءات عوضًا عن أداة المعالجة الافتراضية في مفسّر بايثون وذلك بتعيين قيمة للدالة <code>sys.excepthook()‎</code>.

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

<syntaxhighlight lang="python3">
cgitb.enable(display=1, logdir=None, context=5, format="html")
</syntaxhighlight>

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

=== ‎<code>display</code> ===
معامل اختياري، يأخذ القيمة الافتراضية <code>1</code>، ويمكن أن يأخذ القيمة <code>0</code> وبذلك تُمنع الدالة من إرسال رسالة الخطأ إلى متصفّح الويب.

=== <code>logdir</code> ===
إن كان المعامل <code>logdir</code> موجودًا، فإنّ رسالة الخطأ ستُكتب إلى ملف، وقيمة هذا المعامل هو المجلّد الذي سيحتوي على هذه الملفات.

=== <code>context</code> ===

معامل اختياري، يحدّد عدد الأسطر التي ستُعرض في رسالة الخطأ والتي تحيط بالسطر الذي يحتوي على الخطأ في الشيفرة المصدرية، ويأخذ هذا المعامل القيمة الافتراضية <code>5</code>.

=== <code>format</code> ===
معامل اختياري، يأخذ القيمة الافتراضية <code>"html"</code> والتي تعني أن المخرجات ستكون منسّقة بصيغة [[HTML]]، أما إذا أخذ هذا المعامل أيّ قيمة أخرى فإنّ المخرجات ستكون نصوصًا صرفة.

== مصادر ==
* [https://docs.python.org/3/library/cgitb.html#cgitb.enable صفحة Traceback manager for CGI scripts في توثيق بايثون الرسمي.]

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