تفشل معاينة Pillow بعد إغلاق الملف: افصل البكسلات قبل إغلاق المصدر
تستلم دالة المعاينة كائن صورة من دالة أخرى، لكن أول طلب للبكسلات يفشل. في المثال المحلي حدث هذا بعد أن أعادت `broken_png` كائناً فتحته من مخزن بايتات. انتهت كتلة الفتح وأُغلق المصدر، ولم تكن الدالة قد طلبت تحميل البكسلات. في Pillow 12.3.0 أعطى استدعاء `load` على ذلك الكائن `AssertionError`. وجود كائن يعود من الدالة لا يعني أن العمل الذي ينتظر مصدره قد اكتمل.
يمكن إصلاح هذا التسليم بنقل تحميل البكسلات إلى داخل كتلة الفتح. تعيد `detached_png` نسخة جُهزت بينما كان المصدر متاحاً. قرأ الاختبار من النسخة العائدة قيمة البكسل الأول `(10, 20, 30)`، في صورة أبعادها 3 في 2. المهمة هنا قراءة بيانات PNG محلية. لم تُعرض النتيجة في تطبيق معاينة أو متصفح أثناء الاختبار.
تابع ثلاثة أشياء تملك أعماراً مختلفة
تبدأ الدالة التجريبية ببايتات تمثل ملفاً صغيراً. تضعها في `BytesIO` حتى تستطيع المكتبة قراءتها كتيار. تفتح `Image.open` صورة مرتبطة بذلك المصدر أثناء الفحص والتحميل. هذه أشياء مختلفة في الاستعمال. البايتات هي التمثيل المضغوط. التيار وسيط القراءة الذي تملكه الدالة. كائن الصورة هو ما يتعامل معه المستدعي حين يحتاج إلى بكسل أو عملية معالجة. تستطيع الدالة الاحتفاظ بمرجع إلى كائن الصورة بعد انتهاء التيار، لكن المرجع لا يطيل عمر المصدر المغلق تلقائياً.
يفصل Pillow بين فتح الصورة وتحميل البكسلات، ويختلف عمر الملف في الصور ذات الإطار الواحد عن الصور المتعددة الإطارات. Pillow file lifecycle documentation
اقرأ ترتيب العمل في `broken_png`. تبدأ كتلة `with BytesIO(blob)`، ثم تدخل كتلة `with Image.open(stream)`. يظهر `return image` داخل الثانية. قبل أن يستلم المستدعي القيمة، تنتهي الكتلتان. لم تطلب الدالة البكسلات قبل الخروج. أعدنا استخدام نفس بايتات PNG المحلية في استدعاء آخر لتشغيل النسخة المصححة. بهذه الطريقة يظل الإدخال ثابتاً ويتغير قرار الدالة بشأن ما تُكمله قبل إغلاق المصدر.
حين تتبع عطل المعاينة في مشروعك، اسأل متى حدث أول وصول فعلي إلى البكسلات. قد لا يكون في دالة الفتح، بل في دالة تصنع مصغراً بعد أن تحصل على الكائن. انظر أيضاً إلى المكان الذي يغلق المصدر. ضع قراءة مقصودة بعد عودة الدالة في اختبار صغير، لأن قراءة داخل الكتلة نفسها لا تختبر التسليم. وإذا كان الكائن يبقى داخل الدالة حتى تنتهي كل عمليات الصورة، يمكنك ترك المصدر حياً حتى تنتهي تلك العمليات. يظهر الاحتياج إلى النسخة المستقلة عند إعطاء النتيجة لطرف يستعملها لاحقاً.
تسجل مجموعة الاختبار الحالية نوع الاستثناء الذي رآه هذا المسار في البيئة المحلية. كانت النسخة الأولى من توقع الاختبار تنتظر فئة مختلفة. عاينا الفشل، احتفظنا بالسجل السابق، وصححنا التوقع إلى `AssertionError` ثم أعدنا تشغيل الاختبارات. لم يتطلب ذلك تعديل الدالة المعطوبة كي تفشل بالطريقة التي توقعناها. في بيئة أخرى افحص السلوك عند هذا الحد ولا تعتمد على اسم الاستثناء وحده كي تشخص علاقة الكائن بالمصدر.
حدد ما الذي تعيده دالة القراءة
في `detached_png` يبقى المصدر داخل الدالة. بعد الفتح تفحص الدالة `image.format` وتقبل `PNG` في هذا المثال. ثم تقرأ `n_frames` مع القيمة الافتراضية 1 وتشترط إطاراً واحداً. عند تحقق الشرطين تنفذ `image.load()` وتعيد نتيجة `image.copy()`. تظهر خطوة التحميل صراحة داخل عمر التيار. ويمثل الكائن المنسوخ ما ستستعمله المرحلة التالية بعد انتهاء الفتح.
يمكنك قراءة التغيير كتعديل في عقد الدالة. قبل الإصلاح كانت تعيد الكائن الذي فتحته مباشرة. بعد الإصلاح تعيد كائن صورة يملك المستدعي استخدامه وإغلاقه. لا ترجع معه `BytesIO` ولا تعيد بايتات ملف مصدَّر. إذا أراد المستدعي كتابة ملف، يستعمل النسخة في عملية حفظ منفصلة ويختار صيغة الإخراج. وإذا احتاج إلى تحويلها إلى مصغّر، يحدد الأبعاد وطريقة التحجيم في تلك الخطوة. المثال لا يخلط نجاح التحميل مع قرار كيف ستُعرض الصورة.
في دالة مختلفة يمكنك اختيار عقد آخر حسب احتياجات التطبيق. قد تعيد البايتات الأصلية وتترك للمستدعي مسؤولية فتحها وتحميلها وإغلاقها. أو قد تنهي المعالجة داخل سياق واحد وتعيد فقط نتيجة مكتملة، مثل مقاس أو ملف مصغّر. تقليل عدد الأشياء التي تعبر حدود الدوال قد يجعل الملكية أوضح. اختر العقد قبل توسيع الاختبارات. فالاختبار الذي يطلب بكسلاً من كائن لا ينطبق على دالة تتعهد بإرجاع بايتات فقط.
لاحظ أيضاً أن طلب `load` في هذه الدالة يصف نقطة زمنية مقصودة. نستطيع اختبار أن العمل الذي يحتاج المصدر يكتمل قبل نهاية الكتلة. لا تحتاج إلى إطالة عمر التيار في أماكن متعددة لمجرد أن بعض العمليات كانت تستعمله متأخرة. وإذا استمر الفشل في النسخة المصححة، انظر إلى مرحلة حدوثه. قد يكون الإدخال غير قابل للفتح أصلاً أو قد يرفضه شرط الصيغة. هذا مختلف عن أن ينجح الفتح، ثم تفشل القراءة عند انتقال الكائن إلى مستدعيه.
حافظ على حدود الصيغة والإطار في عقد المعاينة
ملف PNG ذو الإطار الواحد هو الحالة التي اختارها المثال. يختبر المسار السليم صورتي RGB وRGBA. لا توجد في الكود قائمة ترفض كل الأنماط الأخرى، لذلك لا يصح وصف الشرط بأنه يقبل هذين النمطين حصراً. يثبت الاختبار فقط النتائج المحددة لهما. في حالة RGBA يصل البكسل الأول بالأربع قيم `(10, 20, 30, 40)`. إذا كان مشروعك يريد إخراج RGB دائماً، ضع تحويلاً صريحاً وعرّف ماذا سيفعل بقيمة الشفافية. التحميل والنسخ هنا لا يضعان خلفية وراء الصورة ولا يختاران لوناً لها.
يرفض اختبار JPEG الإدخال عند شرط الصيغة. أنشأ الاختبار صورة JPEG حقيقية في الذاكرة، لا مجرد ملف اسمه ينتهي بلاحقة مختلفة. تستقبل الدالة بايتات ولا تتلقى اسم ملف، لذا يمكنها النظر إلى ما تعرفه المكتبة عن الصيغة عند الفتح. أما اختبار البايتات غير الصالحة فيمرر النص الثنائي `not image`، وينتظر `UnidentifiedImageError`. في هذه الحالة لا تصل الدالة إلى قرار أن الصيغة معروفة ولكنها ليست PNG. سجّل نوع الفشل الذي ظهر قبل تقديم رسالة إصلاح للمستخدم.
ويضع اختبار الحركة إطارين، أحدهما أحمر والآخر أزرق، في ملف PNG حفظته Pillow داخل `BytesIO`. تُرفض البايتات الناتجة في المثال ذي الإطار الواحد. لم نصنع من الملف مقطع فيديو ولم نقس سرعة عرض الإطارات. إذا كنت تبني ميزة تختار إطاراً من صورة متحركة، فستحتاج إلى تحديد أي إطار تريد، وإلى متى يبقى المصدر متاحاً أثناء القراءة. يستطيع الاختبار المقترح التحقق من الإطار المطلوب بعد بدء معالجة حقيقية. شرط الإطار الواحد في هذه الدالة يتجنب اتخاذ ذلك القرار نيابة عن التطبيق.
يمكنك أن ترتب الأخطاء في واجهة مشروع وفق ما يستطيع صاحب الملف إصلاحه. صيغة معروفة ومرفوضة قد تحتاج إعادة تصدير. ملف لا يستطيع المحلل التعرف عليه يستحق مقارنة مع النسخة التي صدرت أصلاً. صورة متحركة قد تحتاج قراراً عن الإطار أو مساراً مستقلاً. لا تبدأ بتحويل كل فشل إلى عبارة تفيد بأن الملف تالف. بعض الإدخالات سليمة لصيغة أخرى أو لا تتفق فقط مع العقد الذي اخترته لهذه المعاينة.
detached_png.py
from io import BytesIO
from PIL import Image
def broken_png(blob):
with BytesIO(blob) as stream:
with Image.open(stream) as image:return image
def detached_png(blob):
with BytesIO(blob) as stream:
with Image.open(stream) as image:
if image.format!='PNG':raise ValueError('PNG input required')
if getattr(image,'n_frames',1)!=1:raise ValueError('Single frame required')
image.load()
return image.copy()
نطاق التحقق المحلي: Ten local synthetic PNG/Pillow lifecycle methods. Baseline returns unloaded image after closing source context and load fails; fixed load+copy detachedsamples. RGB/RGBA/size, independentreturns, JPEG/badbytes/animatedPNG refusal, explicitimageclose disposal. No actual browser/phone image, memory/time benchmark, metadata privacy scrub, allformats or resource-security guard tested.؛ البيئة: Python 3.12.3 on Windows; Pillow 12.3.0
اقرأ نتيجة كل اختبار بعد عودة الكائن
شُغلت عشرة اختبارات محلية في Python 3.12.3 مع Pillow 12.3.0 على Windows. اختبار النسخة المعطوبة يحاول التحميل بعد انتهاء الدالة ويتحقق من نوع الخطأ في تلك البيئة. اختبار النسخة المصححة يقرأ البكسل عند الإحداثيات `(0, 0)`. اختبار آخر يقرأ المقاس. وهذان الفحصان يوضحان لماذا لا يكفي أن ترى الكائن أو أن ترى مقاساً في سجل التشغيل. الوصول إلى بياناته في النقطة التي ينتظرها المستدعي هو ما نريد التأكد منه.
اختبار البكسل الأول يبدأ من صورة ذات لون معروف. لا يعتمد على مقارنة صور بصرية يصعب تفسيرها أو تقدير جودة التحجيم. وفي نسخة RGBA يُفحص المكوّن الرابع مع بقية القيم. إذا زدت حالات الاختبار لاحقاً لتغطية معالجة جزء من الصورة، اختر بكسلات مختلفة بحيث يظهر خطأ اختيار المنطقة عند المقارنة. الصورة الأصلية هنا صغيرة ومتجانسة لأنها تخدم سؤال العمر والوصول، لا سؤال ترتيب عناصر مشهد.
يحتفظ اختبار البايتات بنسخة من الإدخال ويقارنها بعد استدعاء الدالة. وتستدعي حالة الاستقلال الدالة مرتين، ثم تعدل البكسل الأول من الكائن الأول إلى `(1, 2, 3)`. يتأكد الاختبار من أن الكائن الثاني بقي يعيد `(10, 20, 30)`. هذه نتيجة عن الكائنين في التجربة. لا تعني أن وضع الكائن نفسه في مكانين يجعله نسختين. فإذا شارك مكوّنان المرجع نفسه ثم عدل أحدهما البكسلات، يحتاج التطبيق إلى عقد يحدد هل كانت المشاركة مقصودة.
يتحقق الاختبار الأخير من تصرف المستدعي عندما ينهي عمله. يستدعي `close()` على النسخة العائدة ثم يحاول قراءة بكسل منها. في الاختبار المحلي ظهرت `ValueError`. يوضح ذلك أن استقلال الكائن عن التيار الأول لا يجعله قابلاً للاستعمال بعد إغلاقه هو نفسه. إذا احتاجت عدة مراحل إلى الكائن، اجعل الجهة التي تعرف أنها آخر مستخدم له مسؤولة عن الإغلاق. وإذا كانت الجهة التالية تحتاج نتيجة لفترة أطول، قرر هل تنقل إليها ملكية الكائن أو تعطيها مخرجاً مستقلاً.
حُفظت عينتا `source.png` و`detached.png` في تشغيل المخرجات المحلي. أعطتا البصمة نفسها في هذا المثال الصغير، حيث أعاد البرنامج حفظ نفس بيانات الصورة في إعدادات التجربة. لا تعتمد على تساوي البصمة في كل إعادة حفظ. يمكن لصيغة الملف أو معلمات الحفظ أن تغير التمثيل الثنائي حتى إذا بقيت بكسلات الاختبار مقروءة. احتفظ بفحص البكسلات والمقاس عندما يكون المطلوب نسخة متاحة للمعالجة، وضع اختباراً منفصلاً لهوية الملف إذا كانت وظيفتك تتعهد بحفظ البايتات الأصلية حرفياً.
أعط كل مرحلة مسؤولية في خط المعاينة
قد يبدأ خط معاينة صغير من قارئ يحمل الملف الذي اختاره المستخدم. يحدد قارئ الصورة متى تجهز نسخة مستقلة. وتستعمل مرحلة المصغّر تلك النسخة لإنتاج المقاس المطلوب. ثم تعرض واجهة المشروع نتيجة المصغّر أو تحفظها في مخزن منفصل. إذا ظهر خطأ، معرفة هذه الحدود تساعدك على معرفة ما الذي يملك المصدر وما الذي استلم البكسلات. لا تمرر كائناً مفتوحاً بين المراحل ثم تعتمد على بقاء التيار بالصدفة حتى نهاية العرض.
يبقى تطبيق اتجاه EXIF قبل إنشاء المصغّر قراراً في مسار المعالجة. المثال هنا يفصل البكسلات عن مصدرها حتى يمكن تطبيق معالجة لاحقة وفق عقد واضح. انظر إلى ما يفترضه مولّد المصغرات عن اتجاه الصورة ومقاسها. إذا كانت تلك الافتراضات جزءاً من التطبيق، اختبرها بعد تسليم الكائن وضمن مدخلات مناسبة لها. لا تستنتج من نجاح قراءة البكسل الأول أن العرض النهائي يطابق اتجاه العرض الذي يريده صاحب الصورة.
تتغير مسؤولية المرحلة التالية إذا كانت تخزن النتيجة مؤقتاً. تخزين كائنات صور محملة مدة طويلة يختلف عن تخزين مسار أو بايتات مضغوطة أو مصغرات صغيرة. اختر العنصر الذي يحتاجه المستدعي فعلاً. إذا كانت كل المعاينات تُصنع مرة واحدة، قد تكفي معالجة الصورة ثم إغلاقها بعد الحصول على المصغّر. وإذا كان المستخدم سيطلب عرض مقاسات متعددة، قد يحتاج التطبيق إلى قرار واضح عن إعادة القراءة أو الاحتفاظ بنسخة. هذه مقايضة في التصميم. المثال لا يتضمن قياساً للذاكرة ولا يحدد عدداً آمناً من الصور لتخزينها.
في اختبار الربط المقترح، استعمل نقطة الدخول التي تقرأ ملفاً مملوكاً للتجربة، واجعل المستدعي يطلب بكسلاً أو مصغراً بعد عودة الدالة. سجّل هل تعطل الفتح أم التحميل أم المعالجة اللاحقة. إذا كان المشروع يرفض صوراً متحركة في هذا المسار، تأكد من أن واجهته تعرض سبب الرفض عند اختيار عينة متحركة. وإذا أضفت مساراً آخر يدعمها، أعطه فحوصه الخاصة. الاختبارات المحلية الحالية تراجع الوظيفة الصغيرة وتُبقي تنفيذ واجهة المشروع عملاً منفصلاً.
اختر ما الذي تعيد استعماله وما الذي تقرؤه مجدداً
افترض أن التطبيق يحفظ مسار الملف في قائمة مشاريع ويعيد فتحه عندما يطلب المستخدم المعاينة بعد دقائق. في هذه الحالة لا يحتاج إلى الاحتفاظ بكل صورة محملة بين الطلبين. لكنه يحتاج إلى التعامل مع احتمال تغيير الملف أو حذفه. وإذا كان يحتاج إلى أن تبقى المعاينة كما كانت عند اختيار الملف، قد يحتفظ بناتج مشتق أو بنسخة محددة من الأصل. هذه سياسة عن معنى المعاينة، لا عن الدالة التي ترجع بكسلات صالحة للاستعمال.
يمكن لبرنامج يجهز صورة واحدة ثم ينهي عمله أن يبقي الفتح والتحجيم والحفظ داخل كتلة واحدة. بهذه الطريقة لا يعبر كائن الصورة المفتوح حد الوظيفة. المثال المصحح يعالج حالة مختلفة هي تسليم الكائن نفسه بعد العودة. عند مقارنة الأسلوبين، اكتب أولاً ما يحتاجه الطرف التالي. إذا كان يحتاج ملفاً جديداً فقط، فليكن الاختبار على ذلك الملف بعد إغلاق المصدر. وإذا كان يحتاج كائناً للتحرير اللاحق، فليكن الاختبار على استعمال الكائن نفسه وإغلاقه في النقطة المناسبة.
لا يحتاج سجل البلاغ إلى نسخة كاملة من صور المستخدم كي يكون قابلاً للتكرار. دوّن نوع المصدر والعملية الأولى التي احتاجت البكسلات وموضع إغلاق التيار أو الصورة. أضف إصدار المكتبة، ونوع الاستثناء الذي ظهر، وحالة الإطار إن كان مهماً. ثم حضّر عينة صغيرة بملكية واضحة تعيد الفشل في الحد نفسه. تستطيع بعد ذلك تغيير موضع التحميل فقط وإبقاء بقية الشروط ثابتة، كما فعلنا مع بايتات PNG الصغيرة. عند نجاح العينة المصححة، اتبع نقطة التسليم في التطبيق قبل تعميم النتيجة على كل طرق فتح الصور فيه.
لو تعطل المصغّر رغم وصول البكسلات في هذا الاختبار، عاين عملية التحويل التالية على حدة. يمكن أن يرفضها شرط المقاس أو اختيار صيغة الخرج أو طريقة التعامل مع قناة الشفافية. ابدأ من نسخة ثابتة أعطت قيمة معروفة في الاختبار. مررها إلى مرحلة واحدة وتحقق من ناتجها قبل الانتقال إلى المرحلة التالية. بهذه الطريقة يصبح أثر كل قرار قابلاً للقراءة، وتستطيع الاحتفاظ بنتائج أصغر من تطبيق كامل يسجل عبارة واحدة لكل فشل.
اكتب عقد التسليم قبل إضافة مهمة تعمل لاحقاً
تصوّر أداة تتلقى اختيار صورة من نافذة ثم تضيف إلى طابور العمل مهمة تصنع المصغّر. لحظة إضافة المهمة ليست لحظة قراءتها للبكسلات. إذا أضفت إلى الطابور كائن الصورة المفتوح، فابحث عن الدالة التي تغلق التيار قبل أن تبدأ المهمة. توجد عدة عقود ممكنة. يمكن تجهيز النسخة وإرسال ملكيتها إلى المهمة. ويمكن إرسال بايتات الأصل وترك الفتح للمهمة نفسها. ويمكن بدلاً من ذلك إرسال مرجع إلى ملف محدد إذا كانت سياسة المشروع تسمح بإعادة القراءة من القرص. لكل اختيار تكلفة مختلفة ومعنى مختلف لما يحدث عند تغير الأصل.
في الاختيار الذي يرسل نسخة من الصورة، تستطيع الدالة التي تستقبلها أن تعرف أن القراءة الأولية قد نجحت. تظل مسؤولية إغلاق النسخة في مكان واضح، كالمهمة التي تنتهي بعد إنتاج المصغّر. حدّد أيضاً ماذا يحدث إذا أُلغيت المهمة قبل أن تبدأ. إذا احتفظ الطابور بمرجع إلى كائن كبير بعد الإلغاء فقد يبقى مملوكاً له إلى أن يحرره. جرّب مسار الإلغاء على مشروعك قبل أن تعتمد على التنظيف عند نهاية التنفيذ العادي. هذا مثال لتخطيط الملكية. الاختبارات المحلية لا تشغّل طوابير أو خيوط تنفيذ أو تحاكي إلغاء مهام.
أما إذا كانت المهمة تستلم بايتات، فيمكنها إبقاء المصدر محلياً أثناء فتح الصورة. عندئذ تعرف من سجلها متى بدأ فك التمثيل ومتى انتهت معالجة الصورة. لكن نجاح استقبال البايتات لا يثبت أن فكها سينجح. أضف اختباراً يرسل مدخلاً صالحاً ومدخلاً يتعذر فتحه من خلال نقطة الدخول نفسها. ثم افصل حالة رفض المصدر عن حالة رفض صيغة الإخراج. بهذا تستطيع أداة المشروع أن تخبر المستخدم هل تعذر قراءة ما أرسله أم تعذر تحويل صورة مقروءة إلى المقاس المطلوب.
قد تحتاج جهة ثالثة إلى إعادة معالجة النتيجة بمقاس جديد. إذا كان المصغّر الأول يمثل نسخة صغيرة من الأصل، فتكبيره لا يعيد التفاصيل التي لم يحملها. قد يكون من الأفضل أن يحصل ذلك المستدعي على البايتات الأصلية أو على طريقة لإعادة فتح النسخة التي اتفق عليها المشروع. وإذا اختار المشروع استخدام ملف من القرص، فاحتفظ بما يكفي لتحديد الملف المقصود عند إعادة المعالجة. يستطيع مشروع بسيط تخزين معرّف للأصل ضمن سجله. لا يفيد مسار مؤقت حُذف بعد العملية الأولى في توليد نتيجة جديدة.
يمكنك تجربة عقد التسليم في برنامج صغير من دون واجهة. جهّز الإدخال، نفّذ الدالة التي تملك التيار، ثم اجعل إجراءً منفصلاً يستهلك الناتج بعد انتهاء الدالة. ضع في إجراء الاستهلاك القياس الذي يعتمد عليه المشروع، مثل قراءة بكسل معروف ثم حفظ مصغّر في مجلد اختبار. أعد التجربة بعد إغلاق الكائن العائد عمداً لترى كيف يسجل مشروعك محاولة استعماله بعد نهاية عمره. القصد هنا هو اختبار حدود الدوال ومسؤولية الإغلاق. لا تحتاج إلى شاشة أو مستخدم حقيقي لإثبات هذا الجزء.
افصل سلامة البكسلات عن متطلبات ملف التصدير
قد يطلب منك مشروع عرض صورة شفافة فوق خلفية محددة. وجود أربع قيم في اختبار RGBA يثبت أن العينة العائدة احتوت على المكوّن الرابع المتوقع. لا يثبت أن المصغّر النهائي احتفظ به، لأن عملية الحفظ لم تمر عبر خط تصدير التطبيق. إذا كان الخرج مطلوباً مع الشفافية، افحص الملف الناتج نفسه بعد فتحه مرة أخرى. وإذا كان المطلوب خلفية معتمة، اختر الخلفية وعرّف اللون المتوقع عند موضع معروف في عينة شفافة. هذا يجعل أثر التصدير مستقلاً عن أثر فتح الأصل وتسليم نسخة منه.
هناك حالات تتعلق بالمعلومات الملحقة بالصورة، مثل بيانات الوصف أو إعدادات العرض التي يتوقع تطبيق آخر قراءتها. كود المثال لا يضع عقداً لحفظ تلك المعلومات أو حذفها. إذا كانت طبقة التصدير تنقل بيانات محددة إلى ملف خارجي، اختبر الحقول التي وعدت بها فقط من خلال قراءة الملف المكتوب فعلاً. لا تستعمل تساوي البصمة في العينة الصغيرة دليلاً على ذلك. ويمكن أن يختلف عقد الصورة المعدة للعرض العام عن عقد النسخة التي تبقى داخل المشروع. تحديد الحقول المطلوبة قبل الحفظ يجعل الاختبار قابلاً للتفسير.
تتعلق بعض المقارنات بالمقاس على الشاشة وبعضها بالمقاس المسجل في الملف. يبلغ مقاس العينة 3 في 2 بكسل قبل النسخ وبعده. إذا عرضت التطبيق الصورة في مربع، فقد تظهر بحواف فارغة أو تُمدد أو تُقص حسب سياسة العرض. أي اختلاف هنا يقع بعد نجاح الدالة. يمكنك وضع اختبار لمقاس الملف واختبار آخر لطريقة إعداد مساحة العرض إذا كانت المهمة تتطلب ذلك. بهذه الطريقة تستطيع أن ترى هل تغيرت البكسلات فعلاً أم تغير شكل الإطار الذي يحملها.
إذا قرأت نتيجة عبر أدوات متعددة، دوّن صيغة كل خطوة بدلاً من المقارنة بكلمة عامة مثل «نفس الصورة». في التطبيق المقترح قد تبدأ من بايتات PNG، تمر بكائن صورة مستقل، ثم تنتهي إلى ملف مصغّر بصيغة اختارها المشروع. لكل تمثيل معلومات متاحة وأخرى قد تتغير. اختبار النسخ المحلي يقيس البكسل والمقاس بعد رجوع الكائن. اختبار الملف الذي سيقرأه المستخدم يقيس ما كتبه برنامج التصدير. وإذا تطلب المشروع تطابقاً بصرياً عند العرض، فهذه مهمة أخرى تحتاج أصولاً ومعايير مختلفة.
اترك للمستدعي ما يحتاجه لإعادة الاختبار
ضع في بلاغ الفشل اسم الدالة التي فتحت المصدر واسم الإجراء الذي طلب البيانات بعد ذلك. إذا حصل المستدعي على المقاس قبل أن يتعطل، اذكر أنه قرأ المقاس وأي عملية تالية فشلت. تساعد هذه الملاحظة على فرز الفشل الذي يبدأ عند تعريف الملف من الفشل الذي يحدث عند طلب بياناته. حين تضيف شيفرة مصغّرة إلى البلاغ، اترك فيها حدود `with` وترتيب الاستدعاءات. إزالة الكتل في سبيل تقليل عدد الأسطر قد تزيل سبب الفشل الذي تحاول عرضه.
عند إعادة التشغيل في بيئة أخرى، احتفظ بملف الاختبار الصغير والنسخة الفعلية من الشيفرة ونتيجة تشغيلها. إذا ظهر نوع استثناء مختلف مع بقاء المشكلة في الموضع نفسه، صف الفرق قبل تعديل الاختبار. قد تحتاج في مكتبة تدعم إصدارات متعددة إلى اختبار النتيجة التي يعتمد عليها مستدعيك، ثم تسجيل نوع الخطأ الذي أعادته كل بيئة عندما يكون مهماً للتشخيص. لا تضف قائمة استثناءات واسعة لمجرد أن اختباراً واحداً فشل. حدّد العملية التي تتوقع فشلها كي لا يعتبر الاختبار أخطاء غير متصلة بها نجاحاً.
يمكن أن يكون لديك اختبار قديم يفتح الصورة ويقرأ بكسلاً داخل الكتلة نفسها. احتفظ به إن كان يثبت أن العينة سليمة، ثم أضف حالة تسليم مستقلة. إذا نجحت القراءة الداخلية وفشلت القراءة الخارجية، فقد حصلت على نقطة مقارنة ضيقة تكشف أثر إغلاق المصدر. وإذا فشل الاثنان، ابدأ بفحص البايتات أو شرط الصيغة قبل تعديل الملكية. افحص أيضاً أن اختبار التسليم لا يطلب البكسلات داخل الدالة عن غير قصد أثناء إعداد السجل، لأن خطوة مبكرة من هذا النوع قد تغير المسار الذي تحاول إعادة إنتاجه.
وأخيراً، خذ حالة قبول صغيرة وحالة رفض واحدة من العينة معك عند نقل الدالة إلى مشروع. حالة القبول يجب أن تقرأ البكسلات بعد عودة الدالة، لأن هذا هو الوعد الذي تحتاجه المعاينة. حالة الرفض يمكن أن تستخدم PNG متحركاً إذا كان الإطار الواحد شرطاً في المشروع. جرّبهما من نقطة الدخول التي يعرفها المستخدم عندما تصبح متاحة. أما قبل دمج واجهة أو طابور أو مصغّر، فتبقى النتيجة المحلية محددة بالوظيفة التي تشغّلها الشيفرة المعروضة وبالعينات المسجلة معها.
أُعد المقال بمساعدة أدوات ذكاء اصطناعي ومراجعة آلية. اختُبرت الشيفرة الأصلية محلياً. الصورة الرئيسية توضح موضوع المقال.
التعليقات
كن أول من يعلّق على هذا المقال.