عرض مصدر Python/interactive-mode

{{DISPLAYTITLE:الوضع التفاعلي}}

== التعامل مع الأخطاء ==
يطبَع المُفسِر - مُفسِر بايثون - رسالة خطأ ورصة تتبُّع (stack trace) عند حدوث خطأ ما. يرجع بعدها المُفسِر، في الوضع التفاعلي، إلى المُحِث الرئيسي (primary prompt)، وذلك نقيض ما يَحدُث عندما يُشغِّل المُفسِر ملفاً؛ حيث يوقِف المُفسِر التشغيل ويخرج برمز خروج غير مُصفَّر (nonzero exit status) بعد طباعته لرصة التتبُّع (لاحظ أنَّ الأخطاء الناتجة عن الشيفرات المحصورة بالعبارة [[Python/exceptions#.D8.A7.D9.84.D8.AA.D8.B9.D8.A7.D9.85.D9.84 .D9.85.D8.B9 .D8.A7.D9.84.D8.A7.D8.B3.D8.AA.D8.AB.D9.86.D8.A7.D8.A1.D8.A7.D8.AA .D8.A8.D8.A7.D8.B3.D8.AA.D8.AE.D8.AF.D8.A7.D9.85 .D8.B9.D8.A8.D8.A7.D8.B1.D8.A9 try-except|try … except]] مُستثناة من سياقنا). بعض الأخطاء غير فادحة (fatal) ولكنها تسبب الخروج برمز خروج غير مُصفَّر (مثل الأخطاء الناتجة عن عدم تناسيق داخلي، والأخطاء الناتجة عن نفاذ الذاكرة). تُرسَل جميع رسائل الأخطاء إلى مجرى الأخطاء القياسي (standard error steam)، بينما تُرسَل المُخرجات العادية الناتجة عن تنفيذ الشيفرات إلى مجرى الخرج القياسي (standard output).
يؤدي ضغط أحد مفاتيح المُقاطعة (interrupt character) (عادةً Control-C أو Delete)، في المُحث الرئيسي أو الثانوي (secondary prompt)، إلى إلغاء المُدخَل والرجوع إلى المُحث الرئيسي. بينما يؤدي ضغط أحد مفاتيح المُقاطعة أثناء تنفيذ أمر (أو مجموعة أوامر) إلى إطلاق الاستثناء [[Python/built-in exceptions#KeyboardInterrupt|KeyboardInterrupt]] (يُمكِن التعامل مع ذلك باستخدام العبارة [[Python/exceptions#.D8.A7.D9.84.D8.AA.D8.B9.D8.A7.D9.85.D9.84 .D9.85.D8.B9 .D8.A7.D9.84.D8.A7.D8.B3.D8.AA.D8.AB.D9.86.D8.A7.D8.A1.D8.A7.D8.AA .D8.A8.D8.A7.D8.B3.D8.AA.D8.AE.D8.AF.D8.A7.D9.85 .D8.B9.D8.A8.D8.A7.D8.B1.D8.A9 try-except|try … except]]).

== جعل البرمجيات تنفيذيّة ==
يمكن جعل برمجيات بايثون، في الأنظمة الشبيهة بيونكس، تنفيذيّة (executable) عبر إضافة السطر:<syntaxhighlight lang="python3">
‎‎#!/usr/bin/env python3.5
</syntaxhighlight>في بداية شيفرة البرمجيّة (على افتراض أنَّ مسار المُفسِر موجود في متغيّر البيئة <code>PATH</code>)، وإعطاءها صلاحيات التنفيذ بعد ذلك. ينبغي أن يوضَع المحرفين(<code>!#‎‎</code>) في بداية الملف حصرًا. في بعض الأنظمة، ينبغي أن ينتهي هذا السطر بِمحرَف السطر الجديد الخاص بأنظمة يونكس (<code>'‎‎'\n</code>)، وليس الخاص بنظام ويندوز (<code>'‎‎\r\n'</code>). لاحظ أنَّ المحرف <code>'#'</code> يُستخدم في بايثون لكتابة التعليقات.

يُمكِن إعطاء صلاحيات التنفيذ للبرمجيّة باستخدام الأمر <code>chmod</code>، كما أدناه:<syntaxhighlight lang="bash">
$ chmod +x myscript.py
</syntaxhighlight>لا يوجد في نظام ويندوز مفهوم "الوضع التنفيذي (executable mode)". سيقوم مُثبِّت بايثون تلقائيًا بربط الملفات ذات اللاحقة <code>‎.py‎</code> بالمُفسِر (الملف <code>python.exe</code>)، أي أنَّه بِمُجرَد الضغط المزدوج على ملف بايثون سيعمل كبرمجيّة مباشرةً. يتعرَّف المُفسِر على ملفات باللاحقة <code>‎.pyw‎</code> أيضًا، ولكن بهذه الحالة لن يظهر موجِّه الأوامر (console) عند تنفيذ البرمجيّة.

== ملفات بدء التشغيل في الوضع التفاعلي ==
من المفيد كثيرًا تنفيذ بعد الأوامر القياسيّة في كل مرَّة تدخل فيها إلى الوضع التفاعلي. يمكنك إعداد شيء كهذا باستخدام ملفات بدء التشغيل (start-up files)؛ وذلك عبر إسناد مسار الملف الذي يحتوي على تلك الأوامر إلى مُتغيّر البيئة <code>PYTHONSTARTUP</code>. هذا مماثِل لاستخدام الملف <code>‎.profile‎</code> في صدفة يونكس (UNIX shell).

يُقرأ هذا الملف فقط في جلسات الوضع التفاعلي، وليس عندما يقرأ المُفسِر الشيفرات من ملف (أي برمجيّة)، وأيضًا ليس عندما تُمرَّر الشيفرات من <code>‎/dev/tty‎</code> بشكل صريح (سيُقرأ الملف كما لو كان في جلسة تفاعليّة إن لم يُصرَّح بذلك). تُتفَّذ الأوامر في ملف بدء التشغيل في نفس مجال الأسماء الذي تُنفَّذ فيه الأوامر في الوضع التفاعلي، ما يعني أنَّه يُمكِن استخدام الكائِنات التي عُرِّفَت أو استورِدت - في ملف بدء التشغيل - مباشرةً - من دون تكرار تعريفها أو استيرادها - في الوضع التفاعلي. يُمكِنُك أيضًا تغيير شكل المُحِث الرئيسي (المُخزَّن بالمُتغيّر <code>sys.ps1</code>) والمُحِث الثانوي (المُخزَّن بالمُتغيّر <code>sys.ps2</code>) في ملف بدء التشغيل.

إذا أردتَ قراءة ملف بدء تشغيل إضافي، يمكنك برمجة ذلك في الملف الأساسي (الذي سيُسنَد مساره للمتغيّر <code>PYTHONSTARTUP</code>) باستخدام شيفرة مثل:<syntaxhighlight lang="python3">
‎‎if os.path.isfile('.pythonrc.py'):
    exec(open('.pythonrc.py').read())
</syntaxhighlight>إذا أردت استخدام ملف بدء تشغيل في برمجيّتك، فعليك كتابة ذلك بشكل صريح في شيفرة البرمجيّة:<syntaxhighlight lang="python3">
‎‎import os
filename = os.environ.get('PYTHONSTARTUP')
if filename and os.path.isfile(filename):
    with open(filename) as fobj:
        startup_file = fobj.read()
    exec(startup_file)
</syntaxhighlight>

== وحدات تخصيص المُفسِر ==
يتوفر في بايثون وحدتين لتخصيص المُفسِر: الوحدة <code>sitecustomize</code> و <code>usercustomize</code>. لرؤية آلية عملهم، عليك بدايةً معرفة مسار دليل حزم المُستخدِم (site-package directory). افتح المُفسِر ونفِّذ الأوامر التالية للقيام بذلك:<syntaxhighlight lang="python3">
‎‎>>> import site
>>> site.getusersitepackages()
'/home/user/.local/lib/python3.5/site-packages'
</syntaxhighlight>يمكنك الآن إنشاء ملف بالاسم <code>usercustomize.py</code> في ذلك الدليل ووضع ما ترغب به هناك. سيعمل هذا الملف في كل مرَّة يتم استدعاء فيها المُفسِر ما لم يُستدعَ مع الخيار <code>‎‎-s</code> المُخصَّص لتعطيل الاستيراد التلقائي.

تعمل الوحدة <code>sitecustomize</code> بشكل مُشابِه، إلا أنَّها توضَع عادةً من قبل مدير النظام في دليل الحزم العام، كما يتم استدعاءها قبل استدعاء الوحدة <code>usercustomize</code>. راجع توثيق الوحدة <code>[[Python/site|site]]</code> للمزيد من التفاصيل.

== مصادر ==
* صفحة [https://docs.python.org/3/tutorial/appendix.html#tut-interac Interactive Mode] في توثيق بايثون الرسمي.
[[تصنيف:Python]]