# مسار الصورة ذو المسافات يفشل في العملية الفرعية: مرّر قائمة الوسائط

> **الرابط:** https://aiseza.com/575/python-subprocess-path-spaces-argument-list/
> **الكاتب:** INESSE MOUSBIR
> **النشر:** 2026-11-06
> **آخر تحديث:** 2026-11-06

## الإجابة المختصرة

يبقى المسار وسيطاً واحداً عند تمريره عنصراً واحداً من القائمة. يعيد المثال إنتاج الخطأ الذي يحدث عند بناء سلسلة وتقسيمها بالمسافات ثم يفحص ما قرأه برنامج فرعي مملوك للمشروع.

رمز الخروج 2 كان أول فرق بين الاستدعاءين. الملف التجريبي نفسه بقي في مكانه، لكن المشغّل في الحالة الأولى جمع خيار `–input` مع المسار في سلسلة ثم قسمها بالمسافات. في الحالة الثانية وضع الخيار في عنصر من قائمة ووضع المسار الكامل في عنصر آخر. استلم البرنامج الفرعي القيمة، وقرأ 13 بايتاً، وأعاد رمز الخروج 0. يبيّن هذا الفرق أين تبدأ المشكلة قبل أن تفكر في تغيير اسم المجلد.

أُعيدت التجربة محلياً على Windows باستخدام Python 3.12.3. يعمل المثال بملفين صغيرين مملوكين للمشروع. `launch_probe.py` يختار طريقة بناء الوسائط، و`probe_child.py` يقرأ الملف ويطبع ما استلمه. لم يشغّل المثال برنامج تحويل صور أو فيديو. الهدف أن تتمكن من رؤية ما استلمه طرف آخر بدلاً من الاستدلال عليه من شكل أمر مطبوع في سجل.

## قارن قائمة العناصر قبل أن تبدأ العملية الفرعية

افترض أن الملف المطلوب يقع تحت مجلد اسمه `My Photos`. إذا صُنعت سلسلة تبدأ بـ`–input` ثم ضُم المسار إليها، تبدو السلسلة عند طباعتها مألوفة. لكنها لا تحمل في بنيتها تمييزاً بين الفراغ الذي يفصل الخيار عن قيمته والفراغ الذي يقع داخل اسم المجلد. عند استدعاء `.split()` ستنشأ عناصر متعددة. يبقى `–input` عنصراً، بينما قد يصبح المسار قطعتين أو أكثر بحسب أجزائه. لا يفحص التقسيم وجود الملف ولا يسأل أي فراغ ينتمي إليه.

تحدث هذه التجزئة في Python، قبل أن يبدأ تشغيل البرنامج الفرعي. يسهل أن تضيع هذه النقطة في التشخيص إذا كان السجل لا يعرض إلا سلسلة قابلة للنسخ. بدلاً من طباعة سطر موحد، اطبع قائمة الوسائط في تجربة محلية على مسار لا يحوي معلومات خاصة. تستطيع رؤية كل عنصر على حدة. إذا كان المطلوب من `–input` أن يتلقى قيمة واحدة، قارِن العنصر الذي يليه بالمسار الأصلي. إذا كان لا يحمل إلا جزءاً منه، فقد وجدت سبباً يمكن اختباره دون فتح الملف أصلاً.

تتيح قائمة الوسائط تمرير الاسم والمسار كعناصر مستقلة، وتوصي الوثائق بالقائمة حين يمكن استخدامها. [Python 3.12 subprocess reference](https://docs.python.org/3.12/library/subprocess.html)

في النسخة المعطوبة تُبنى الوسائط بالتعبير `('–input ' + str(path)).split()`. في النسخة المصححة تُبنى القائمة `['–input', str(path)]`. لا تضف علامات اقتباس حرفية حول العنصر الثاني لمجرد أن المسار يحوي فراغاً. في القائمة، القيمة التي تريد أن يستلمها البرنامج هي النص الكامل للمسار. علامات الاقتباس التي تظهر عند وصف أمر في واجهة تفاعلية تؤدي دوراً في صياغة ذلك الأمر. ليست جزءاً من اسم الملف الذي يستخدمه مثالنا.

قد يعمل مسار بسيط في النسخة المعطوبة. هذا ما يسجله اختبار الاسم `plain.txt` في مجلد العينة. يمر الاستدعاء المعتاد وتخرج العملية بنجاح. النتيجة تفسر لماذا قد يبقى الخطأ مخفياً في مشروع استعمل دائماً مجلدات لا تحوي فراغات. وجود ملف باسم مختلف لا يكفي لإعادة الفشل. تحتاج حالة اختبار تجعل الفراغ جزءاً من المسار الذي يعبر بين الدالتين.

## تابع الخيار إلى البرنامج الذي يقرأه

تبدأ `run_probe` بتكوين `Path` من المدخل. تتحقق من أنه مطلق وترفع `ValueError` إن كان نسبياً. ثم تحدد الملف الفرعي بجوار ملف المشغّل وتستعمل `sys.executable` لاختيار مفسر Python الحالي. يبدأ الاستدعاء بعنصر للمفسر وعنصر للبرنامج، ثم يضيف قائمة وسائط الإدخال. وجود المفسر في عنصر مستقل مهم أيضاً إذا كان مساره يتضمن فراغات. هذه البنية تجعل الجزء الذي يختار البرنامج منفصلاً عن الجزء الذي يمرر قيمته.

في الجهة الأخرى يعلن `probe_child.py` أن `–input` خيار مطلوب باستخدام `argparse`. يكوّن `Path` من القيمة التي أعادها المحلل، ثم يقرأ محتواه بـ`read_bytes`. يطبع كائن JSON فيه `received` لقيمة المسار و`bytes` لعدد البايتات. إذا قُسّم المسار قبل الاستدعاء، قد يتلقى محلل الوسائط قيمة ناقصة وعناصر زائدة لا يتوقعها. في حالة مجلد `My Photos` أعاد الاستدعاء المعطوب 2. لم تكن النتيجة قراءة عدد أقل من 13 بايتاً من الملف الصحيح، بل تعثر المسار قبل تلك القراءة.

في تشغيل العينة المحفوظة جُمعت المسافات في اسم المجلد واسم الملف. يظهر تحت `My Photos` ملف اسمه `مشهد أصلي.txt`. قرأه الاستدعاء المصحح وظهر 13 في الحقل المخصص للحجم. يُقارن اختبار النجاح أيضاً الحقل `received` بالنص الذي سلّمه المستدعي، لا بمجرد وجود هذا الحقل. يمكن أن ينجح فتح ملف خاطئ إذا كان هناك ملف آخر بالحجم نفسه. مقارنة النص وعدد البايتات معاً تجعل الاختبار أقرب إلى السؤال عن وصول القيمة المطلوبة.

يجعل المشغّل `shell=False` صريحاً. الاختبار لا يحتاج إلى صياغة سلسلة أوامر لسطر تشغيل تفاعلي. يطلب من `subprocess.run` تشغيل المفسر المعروف بالوسائط المجهزة. لهذا المثال أيضاً بيئة محددة. يُضبط `CREATE_NO_WINDOW` عند Windows حتى تعمل العمليات الفرعية التجريبية دون نوافذ منبثقة. هذا الإعداد يخص ظهور نافذة العملية، ولا يغير قاعدة فصل المسار في القائمة. على أنظمة أخرى يكون الخيار في الشيفرة 0، ولم تُشغّل المجموعة هناك.

يعود المشغّل بقيمة `CompletedProcess`. يستطيع المستدعي أن يقرأ رمز الخروج والمخرجات القياسية ورسائل الخطأ. لا تمرر الشيفرة `check=True`، ولذلك يعيد المسار الذي انتهى برمز غير صفري كائن نتيجة ما دام إنشاء العملية نفسه نجح. يميّز الاختبار بين فشل يحصل بعد بدء البرنامج الفرعي وخطأ المسار النسبي الذي يرفضه المشغّل قبل ذلك. احتفظ بهذا الفرق عند نقل الفكرة إلى تطبيق يستخدم طريقة مختلفة في الإبلاغ عن أخطاء العمليات.

## اجعل تجربة الأسماء مستقلة عن تجربة ترميز المخرجات

يختبر المثال فراغاً في اسم المجلد ويفرد اختباراً لفراغ في اسم الملف. ويختبر الاسم `مشهد أصلي.txt` في استدعاء آخر. في الحالة التي تحمل علامة `&` استُعمل الاسم `photo & draft.txt`. المسار في كل حالة هو قيمة لخيار واحد. يقرأ البرنامج الفرعي الملف الذي عيّنته تلك القيمة. لا تختبر هذه الحالة صياغة أمر لقوقعة نظام، ولا تسمح باستنتاج قاعدة عامة عن أمان تشغيل برامج يختارها مستخدم خارجي.

يفيد فصل اختبار اسم المجلد عن اسم الملف عند قراءة البلاغات. قد يستبدل مشروع اسم الملف باسم يولده آلياً ثم يحتفظ بدليل أصلي يختاره المستخدم. في هذه الحالة قد يفشل رغم أن الاسم النهائي يبدو بسيطاً. أو قد تكون كل المجلدات قصيرة، لكن اسم الملف جاء من واجهة يستخدمها المحرر لكتابة وصف الصورة. اختر الحالة التي تطابق الجزء الذي يتغير في مشروعك، ثم أبق الحالة الأخرى في الاختبارات إذا كان كلاهما مدخلاً مدعوماً.

ضبط `encoding='utf8'` في الاستدعاء يجعل المشغّل يفك المخرجات الملتقطة بهذا الترميز. وتضبط بيئة Python الفرعية `PYTHONIOENCODING` حتى تكتب المخرجات بترميز متوافق. يطبع البرنامج JSON مع `ensure_ascii=False`، فتستطيع قراءة الاسم العربي في المخرجات. هذه الإعدادات تخص النص الذي يخرجه البرنامج ويقرأه الأب. ليست هي التي تمنع `.split()` من تقسيم المسار. يمكنك استخدام اسم لاتيني يحوي فراغاً لإثبات الانقسام، واستخدام حالة منفصلة للتأكد من أن التقرير النصي يحتفظ بالحروف العربية.

إذا كان برنامجك الفرعي يطبع بيانات غير JSON أو يستعمل ترميزاً آخر، اتفق مع الواجهة التي يقدمها على ما ستقرؤه. قد ينجح البرنامج في فتح المسار بينما يعجز المشغّل عن تفسير نص المخرجات. في تلك الحالة لا يصلح تغيير بناء قائمة الوسائط وحده. ابدأ من رمز الخروج، ثم قارن ما استلمه البرنامج بما أعاده. المخرجات المقصودة في هذا المثال ليست محتوى الملف. إنها مساره وعدد بايتاته، ما يكفي لاختبار حد النقل دون نسخ محتوى العينة إلى السجل.

### launch_probe.py

```
from pathlib import Path
import subprocess,sys,os

def run_probe(input_path,broken=False):
    path=Path(input_path)
    if not path.is_absolute():raise ValueError('Supply an absolute input path')
    child=Path(__file__).with_name('probe_child.py')
    args=('--input '+str(path)).split() if broken else ['--input',str(path)]
    return subprocess.run([sys.executable,str(child),*args],shell=False,capture_output=True,text=True,encoding='utf8',timeout=10,
        env={**os.environ,'PYTHONIOENCODING':'utf-8'},creationflags=subprocess.CREATE_NO_WINDOW if os.name=='nt' else 0)
```

نطاق التحقق المحلي: Nine real local subprocess methods using our owned probe_child.py and owned temporary input files, no shell and hidden Windows child processes. Naive split causes argparse2 for a path with spaces; argument-list path preserved. No FFmpeg/video conversion, arbitrary executable, injection attack, timeout scenario or cross-OS benchmark tested.؛ البيئة: Python 3.12.3 on Windows

### probe_child.py

```
from pathlib import Path
import argparse,json
parser=argparse.ArgumentParser();parser.add_argument('--input',required=True)
args=parser.parse_args();path=Path(args.input)
print(json.dumps({'received':str(path),'bytes':len(path.read_bytes())},ensure_ascii=False))
```

نطاق التحقق المحلي: This owned child ran within the same nine-method parent suite. No additional tests counted.؛ البيئة: Python 3.12.3 on Windows

## اقرأ الاختبارات من حدود الاستدعاء إلى نتائج الطفل

تحتوي المجموعة على تسع طرق اختبار محلية. حالتا البداية تمرران الاسم البسيط والمسار ذا الفراغ إلى البناء المعطوب. الأولى تتوقع 0 والثانية تتوقع 2. أربع حالات بعدها تمرر قائمة الوسائط في النسخة المصححة. تغطي فراغ المجلد وفراغ اسم الملف والاسم العربي وعلامة العطف. في تلك الحالات يستخدم الاختبار وظيفة مساعدة تقارن رمز الخروج بالنجاح وتقارن ناتج JSON كله بالمسار المطلوب والعدد 13.

تنشئ الوظيفة المساعدة الملف من محتوى ثابت مملوك للتجربة. البايتات هي النص الثنائي `owned fixture` وطوله 13. استخدام محتوى صغير يختصر سبب النجاح، لأن الاختبار يحتاج فقط إلى إثبات أن الملف فُتح وأن تقرير الطفل يحمل القيم الصحيحة. لا يقيس ذلك قدرة البرنامج على قراءة ملف كبير أو تحويله أو إبقاء استهلاك الذاكرة ضمن حدود معينة. لو احتجت اختبار تحويل صورة، فابدأ بملف صالح للتنسيق المطلوب وافحص مخرجات التحويل في مجموعة مستقلة.

يمرر اختبار الملف المفقود مساراً مطلقاً غير موجود. ينجح بناء قائمة الوسائط في هذه الحالة، لكن القراءة في البرنامج الفرعي تفشل ويراقب الاختبار أن رمز الخروج ليس صفراً. هذا فصل مهم بين الوصول إلى القيمة والوصول إلى ملف صالح تحتها. قد ينتهي تشغيل غير ناجح حتى عندما تكون قائمة الوسائط صحيحة. لا تُعد كل حالة غير صفرية إلى المسافات. في مشروعك اقرأ رسالة الخطأ وطابقها مع مرحلة العملية التي أطلقتها.

يحتفظ اختبار دليل العمل بمسار العملية الأب، يستدعي الدالة على عينة صالحة، ثم يقارن المسار مرة أخرى. لم يغير الاستدعاء دليل الأب في التجربة. كما تختبر المجموعة رفض مسار نسبي قبل تشغيل الطفل. الدالة لا تطلب أن يقع المسار المطلق ضمن دليل العمل، وليس فيها فحص يفرض الانتماء إلى مجلد بعينه. العينة نفسها محفوظة في مجلد يملكه الاختبار. إذا كان التطبيق يفرض نطاقاً للملفات، اختبر هذه السياسة في طبقة الاختيار قبل بناء الوسائط.

تعيّن الشيفرة مهلة 10 ثوانٍ لـ`subprocess.run`. لم تشغّل المجموعة طفلاً معلقاً أو تنتظر انتهاء المهلة. إذا كانت المهلة جزءاً من عقد المنتج، أنشئ حالة مستقلة ببرنامج اختباري مملوك لك يتأخر عمداً. لاحظ ماذا يتلقى المستدعي وماذا يحدث لمخرجات العملية. وبعدها اجعل واجهة المشروع تفرق بين فشل تحليل الوسائط وفشل القراءة وانتهاء المهلة. لا تضف سبباً إلى تقرير الاختبار لمجرد أن الإعداد موجود في الشيفرة.

## افصل اختيار الملف عن واجهة تشغيل البرنامج

في تطبيق يفتح مربع اختيار صورة، تكون نتيجة الاختيار مساراً أو إلغاءً. الإلغاء لا يحتاج إلى تشغيل برنامج فرعي. وعند وجود مسار، يمكن للتطبيق أن يحدد هل يقبل مساراً نسبياً ويحدد مرجعه، أو يطلب مساراً مطلقاً كما في المثال. اكتب هذا القرار في نقطة معروفة. بعد ذلك أرسل القيمة الناتجة إلى وظيفة تبني عناصر التشغيل. بهذه الطريقة لا يعتمد تفسير المسار على دليل يتغير بين واجهة المعاينة ومهمة تعمل في الخلفية.

[الحفاظ على الأسماء العربية داخل أرشيف المشروع](https://aiseza.com/510/python-project-zip-arabic-members/) يتعلق بأسماء أعضاء الأرشيف. بعد الاستخراج يتولى المشغّل تمرير المسار الذي اختاره المستخدم إلى البرنامج الفرعي. إذا كان مشروعك يمر بهاتين المرحلتين، جرّب اختباراً لمحتوى الأرشيف وآخر للقيمة التي استلمها البرنامج. قد يكون الاسم مخزناً بشكل صحيح في الأرشيف ثم يتجزأ بعد الاستخراج عند بناء وسائط التشغيل. فصل الدليلين يجعل موضع الخلل أوضح.

لا يلزم أن تغير اسم الملف إلى اسم بلا فراغات لحل هذه المشكلة. تغيير الاسم يمكن أن يكسر علاقة قائمة بين الملف ومشروع يعتمد على مساره. في التطبيق المقترح اختر أولاً الاسم الذي تعرفه بقية المكونات. ثم احتفظ به كقيمة واحدة عندما تشغّل أداة تعرف واجهتها. إذا استبدلت البرنامج التجريبي بأداة خارجية، راجع شكل الخيار الذي تقبله وأين تتوقع أن تأتي القيمة. مثال `–input` لا يحدد واجهة كل أداة، وبعض البرامج تتلقى مسارات في مواضع مختلفة.

الأسماء المطلقة تجعل نقطة الاستدعاء أقل اعتماداً على المجلد الذي بدأ فيه الأمر، لكنها لا تثبت وجود الملف أو حق التطبيق في قراءته. قد يتغير المسار بعد اختيار المستخدم له. عالج ذلك كتغير في المدخل، واحتفظ بنتيجة العملية عند الفشل. تستطيع أيضاً أن تختبر من خلال مسار عمل مختلف عن المعتاد في مشروعك. عندما يبقى نفس المسار المطلق متاحاً، تظل القيمة الممررة للطفل هي نفسها. وإذا كان الطفل يعتمد على ملفات جانبية بمسارات نسبية، فحدد له دليل العمل المطلوب وفق واجهته.

## اجعل سجل التشغيل صالحاً للمقارنة

في بلاغ حقيقي يكفي غالباً اسم الخيار، وعدد عناصر الوسائط، وتمثيل مختصر للقيمة التي يفترض أن يتلقاها الطفل. لا تحتاج إلى نشر مسار شخصي أو محتوى ملف. استخدم مساراً تجريبياً يحفظ موضع الفراغ، ثم التقط رمز الخروج والناتج في الحالتين. إذا صار رمز الخروج 0 بعد الانتقال إلى القائمة، تأكد أيضاً أن تقرير الطفل يطابق المسار المتوقع. نجاح التنفيذ وحده لا يبين أي ملف قُرئ.

تستطيع إعادة تشغيل أمثلة المجموعة في مجلد يضم ملف المشغّل والبرنامج الفرعي وملف الاختبار. تستخدم المجموعة ملفاتها المؤقتة. اجعل كل تغيير على حدة عند تقليد الخطأ في تطبيقك. اختبر بناء السلسلة ثم بناء القائمة مع الملف نفسه. بعد ذلك اختبر الاسم العربي أو العلامة الخاصة في مسار مستقل. إذا غيرت الترميز وبناء الوسائط ومكان الملف دفعة واحدة، سيصعب تفسير أي قرار أعاد النجاح. تتيح المجموعة الأصلية نقاط مقارنة واضحة لهذه التغييرات.

عندما يستقبل التطبيق مدخلات لا تملكها أنت، يظل اختيار البرنامج ومسار الملف وحدود العمل قرارات منفصلة. لا يسمح المثال باختيار برنامج عشوائي أو إضافة خيارات من مصدر خارجي. إذا أردت توسيعه، حدد القيم التي يجوز أن تأتي من المستخدم، ومن يراجع المسار قبل القراءة، وكيف تحدد واجهة البرنامج الذي سيعمل عليه. اختبر كل حد بالمخاطر التي تخصه. تجربة الاسم الذي يحمل علامة عطف تثبت وصول تلك القيمة إلى قارئ معلوم، وهي معلومة دقيقة يمكن الاحتفاظ بها دون الادعاء بتقييم حماية التطبيق كله.

اجعل مخرجات الاستخدام العادي موجزة، واحتفظ بنتيجة التجربة التفصيلية في سجل تطوير عند الحاجة. اذكر إصدار المفسر، والاسم التجريبي، والفرق بين استدعاءين، والرقم الذي عاد من قراءة الملف. من يراجع الخطأ بعدك يستطيع عندئذ أن يبدأ من القيمة التي خرجت من `run_probe` لا من تخمينات عن الملفات التي يراها في المجلد. وإذا انتقل التطبيق لاحقاً إلى أداة مختلفة، يمكنه استخدام الأسلوب نفسه للتحقق من الوسائط في تلك الأداة مع اختبار جديد خاص بها.

## جهز تشغيل الدفعة بحيث يحتفظ كل ملف بنتيجته

إذا كان التطبيق يرسل عدة صور إلى برنامج واحد على التوالي، اجعل لكل ملف استدعاء واضحاً وفق ما تقبله واجهة البرنامج. قد تستدعي البرنامج مرة لكل صورة، أو تدعمه واجهة تقبل أكثر من قيمة وفق صيغة موثقة. المثال يرسل `–input` مرة واحدة ويطلب مساراً واحداً. إذا وسعت القائمة بإضافة ملفات، اقرأ أولاً كيف يميز البرنامج بداية كل مدخل. لا يكفي أن تسرد كل المسارات في سلسلة واحدة وتفترض أنه سيعرف أين تنتهي كل قيمة. هذا يعيد المشكلة نفسها على مستوى الدفعة.

يمكن لسجل دفعة أن يحتفظ بمعرف داخلي للصورة والاسم الذي اختير محلياً ونتيجة التشغيل. تظل رسالة الخطأ من البرنامج مرتبطة بالمدخل الذي تسبب فيها. إذا نجح ملفان وفشل الثالث في القراءة، فلا داعي لاستنتاج أن خيارات الملفين السابقين انقسمت أيضاً. تساعدك المقارنة بين نتيجتين لهما نفس إعدادات التشغيل وأسماء مختلفة على معرفة هل يرتبط الفشل بمسار معين أم بالبرنامج. اجعل في تقرير الاختبار الفعلي حالة نجاح وحالة فشل مقصودتين، حتى تتأكد أن التطبيق يميز بينهما بدلاً من إظهار عداد نجاح فقط.

إذا احتجت إلى إعادة تشغيل جزء من دفعة، أعد بناء قائمة الوسائط من قيمة المسار المحفوظة في سجل المهمة. لا تعتمد على إعادة تحليل السطر المقروء الذي طبعه السجل للمراجعة. قد تكون تلك الصياغة مناسبة للعين وليست تمثيلاً يحفظ الحدود بين العناصر. يمكن حفظ القيم المنظمة في مكان يملكه التطبيق، مع عرض وصف مختصر للمستخدم. راجع سياسة الاحتفاظ بالمسارات عندما يكون السجل متاحاً خارج المشروع. المسار قد يكشف اسم مجلد شخصي أو معلومات عن تنظيم جهاز لا يحتاجها من يراجع نتيجة التحويل.

في مرحلة الدمج، جرّب عينة لها مخرجات تحمل الاسم الأساسي نفسه تحت مجلدين مختلفين، إذا كانت تلك حالة يدعمها مشروعك. سجل المسار الذي يعبر إلى البرنامج الفرعي ومعرف الصورة الذي يربط المدخل بنتيجته. تطابق الاسمين الأخيرين لا يعني أن المسارين متساويان. نجاح تمرير المسار الكامل يحل مشكلة وصول القيمة، بينما اختيار اسم فريد لملف الإخراج قرار آخر. يمكن لاختبار الدفعة أن يكشف كلا الخللين بإبقاء موقع المدخل ومعرف الناتج معلومتين مستقلتين.

## راجع تغيير واجهة البرنامج قبل استبدال أداة القراءة

قد تعرض أداة خارجية في وثائقها أمراً تفاعلياً فيه خيار وقيمة. عند نقله إلى Python، حدد العناصر التي يتوقع أن يستلمها البرنامج نفسه. تتعامل القائمة مع علامات الاقتباس داخل قيمة المسار بوصفها حروفاً إذا أدخلتها بالفعل. في العينة لا نضيف تلك الحروف. أما إذا أضفت خياراً له بنية مختلفة مثل قيمة تتبع علامة مساواة وفق توثيق الأداة، فاختبر تلك الصيغة كما تتوقعها الأداة. القاعدة التي نثبتها هنا هي الحفاظ على القيمة المطلوبة في عنصر صحيح، وليست إلزام كل واجهة بشكل واحد.

هناك أيضاً فرق بين الوظيفة التي تستقبل خيارات البرنامج وتلك التي تحدد طريقة تشغيله. قد تحتاج إلى تمرير خيارات ثابتة للمقاس أو صيغة الخرج من إعدادات مشروعك. احتفظ بكل خيار في موضعه المقصود ولا تسمح لمسار المدخل بتغيير الخيارات المجاورة بسبب تقسيم عام. يمكنك في اختبار محلي استعمال برنامج الاستقبال الذي تملكه لتسجيل الوسائط. وعند اعتماد أداة حقيقية، أضف تجربة منفصلة تتحقق من مخرجاتها على ملف يدعم تنسيقها. لا يكفي نجاح قارئ العينة لإثبات أن الأداة الجديدة تفسر كل الخيارات بالطريقة نفسها.

إذا كانت الأداة تقرأ من مجلد عمل محدد، قرر هل سيضبط المشغّل `cwd` للعملية الفرعية. المثال الحالي لا يمرره ولا يغيّر دليل الأب. قد تحتاج إليه عندما تفتح الأداة ملفات مساعدة بأسماء نسبية. في هذه الحالة اختبر مسار المدخل المطلق من دليلين للعمل، وراقب أي ملفات أخرى تحتاجها الأداة. قد يكون عدم العثور على ملف مساعد هو الفشل الحقيقي حتى عندما يصل مسار الصورة كاملاً. سجّل في النتيجة ما الذي حاولت الأداة فتحه إن كان ذلك واضحاً من مخرجاتها.

يمكن أيضاً أن يختلف مسار المفسر بين بيئة التطوير وبيئة التشغيل. تستعمل الدالة `sys.executable` في العينة لتختار المفسر الذي يشغّل الاختبار. لا تبحث عشوائياً عن اسم برنامج من بيئة المستخدم في هذا المثال. إذا صممت تطبيقاً يختار أداة محددة، احتفظ بإصدارها وكيف عثرت عليها في سجل التطوير، ثم تحقق من أن البرنامج الذي استُدعي فعلاً هو الذي بنيت اختبارك عليه. مطابقة محتوى الوسائط وحدها لا تفسر فرقاً في سلوك نسختين لهما واجهتان مختلفتان.

## صغ رسائل الخطأ وفق المرحلة التي تستطيع إثباتها

إذا رفضت `run_probe` مساراً نسبياً، يستطيع التطبيق أن يطلب من المستخدم اختيار ملف من جديد أو يحول المسار وفق مرجع معلن. لا يوجد في تلك الحالة رمز خروج للطفل، لأن العملية لم تبدأ. وإذا وجد رمز 2 من محلل الوسائط في العينة، اعرضه على أنه نتيجة اختبار الاستدعاء لا كرسالة بأن الصورة تالفة. وإذا كان المسار المطلق مفقوداً، اعرض رسالة تفيد بتعذر القراءة أو اطلب مراجعة وجود الملف. يدعم هذا الفصل سجلاً يوضح أين ظهرت النتيجة بدلاً من جمع الحالات تحت عبارة «تعذر فتح الصورة».

جرّب كتابة حالة نجاح لا تطابق الاسم الذي كانت تتوقعه من قبل. مثلاً يمكنك في مشروعك أن تختار ملفاً في مجلد اسمه `My Photos` ثم تقرأ نتيجة البرنامج وتطابقها مع القيمة المطلوبة كاملة. بعد ذلك أنشئ عمداً إدخالاً نسبياً لتختبر رفض المشغّل نفسه. وخذ ملفاً غير موجود لتختبر كيف يصنف التطبيق فشل الطفل. الحالات الثلاث لا تقيس سرعة التشغيل ولا تحدد أمناً شاملاً. إنها تثبت أن المسار يظل قيمة واحدة وأن التطبيق يستطيع تحديد المرحلة التي تعثرت عندما تتغير ظروف القراءة.

بعد نقل الإصلاح إلى مدخل المشروع، افحص ما إذا كانت هناك مسارات أخرى تبني الأوامر بالسلسلة القديمة. قد يستخدم زر المعاينة الكود الجديد بينما يستعمل أمر الدفعة دالة منفصلة. شغّل الحالتين على ملف تجريبي واحد وقارن ما يراه البرنامج الفرعي. وإذا كانت المخرجات تذهب إلى ملف أو إلى واجهة، افحص نتيجة المسار الذي سيستخدمه الشخص فعلاً بعد نجاح الاستدعاء. تستطيع بذلك الحفاظ على فائدة الاختبارات التسعة مع إضافة دليل على أن الإصلاح وصل إلى نقطة تشغيل المشروع.

إذا أردت معرفة هل تغيّرت واجهة الطفل نفسها، احتفظ أيضاً بحالة تدخل فيها القيمة على الشكل الصحيح ولكن تحت خيار مختلف. يمكنك أن تجعل برنامجاً تجريبياً يرفض خياراً لا يعرفه ثم تقارن رسالته برسالة الحالة التي انقسم فيها المسار. قد يتساوى رمز الخروج في الحالتين بينما يختلف سبب الرفض. سجل نص الرسالة من عينة تملكها إن كان مطلوباً للتشخيص. واستعمل أسماء الخيارات الفعلية في وثائق مشروعك حتى يستطيع القارئ تمييز الخطأ في الخيار عن الخطأ في القيمة التي تلته.

من المفيد أن يرى مراجع الإصلاح الفرق بين السطر الذي يختار المفسر والسطر الذي يبني وسائط الإدخال. فإذا بقي الأول كما هو في تجربتين، أمكنه قراءة الفرق بين النتائج بوصفه أثراً لبنية الوسائط. وإذا اختلفت نتيجة أخرى بعد تغيير البرنامج الفرعي نفسه، فاحتفظ بها كتجربة منفصلة. ضبط المتغير الذي تختبره يساعد في إعادة إنتاج المشكلة حتى عند تغيير واجهة المشروع لاحقاً.

أُعد المقال بمساعدة أدوات ذكاء اصطناعي ومراجعة آلية. اختُبرت الشيفرة الأصلية محلياً. الصورة الرئيسية توضح موضوع المقال.

## المصادر

- [Python 3.12 subprocess reference](https://docs.python.org/3.12/library/subprocess.html)
