قبل تصدير SRT: قرّب الزمن مرة واحدة وافحص التداخل بعد التقريب
ابدأ بـ0.0005→0 في الأسلوب المعيب و1 بـسياسة ROUND_HALF_UP. هذه سياسة وتقريب مختبر، وليست تجربة أخطاء دقة float على كل رقم أو تجربة توليد فيديو. عند التعامل مع الأطوال الزمنية لملفات الترجمة النصية من صيغة SRT، يبرز فارق جوهري بين طرائق تحويل الكسور العشرية للثواني إلى أعداد صحيحة تمثل الميلي ثانية. يعتمد الأسلوب المعيب غالباً على تحويل الأرقام عبر دوال الفاصلة العائمة المدمجة والاقتطاع القسري عبر نوع int، وهو ما يؤدي إلى بتر الأجزاء الكسرية وتراجع نصف الميلي ثانية إلى الصفر، في حين تتيح مكتبة Decimal في بايثون تمرير القيم كنصوص والتحكم الدقيق بقواعد التقريب الرياضي المعياري. يقتصر النطاق التجريبي المعتمد والموثق في هذا المشروع على أحد عشر فحصاً برمجياً محلياً نُفذت باستخدام بايثون 3.12.3 على نظام ويندوز، واختبرت نصوصاً وسلاسل زمنية اصطناعية دون أي توليد وسائط أو تشغيل لملفات فيديو أو فحص محاذاة في مشغلات حقيقية.
قارن نصف ميلي ثانية بين القطع والتقريب المختار
لتتبع الفارق العملي بين القطع والتقريب المختار، يمكن تتبع المسار الحسابي لقيمة الإدخال النصية 0.0005 ثانية داخل الدالتين المعرفتين في الكود. في الدالة المعيبة broken_milliseconds، يتم تحويل النص أولاً إلى عدد عائم float(value) ليصبح 0.0005، ثم يُضرب في 1000 ليكون الناتج 0.5، وعند تمرير هذا الناتج إلى دالة التحويل العددي int(0.5)، تُسقط لغة بايثون الجزء الكسري تماماً بالبتر المباشر لتعيد القيمة الصحيحة 0. أما في الدالة المنضبطة milliseconds، يتم إنشاء كائن Decimal من النص مباشرة، وعند ضربه في 1000 يتحول إلى Decimal('0.5000')، ثم تطبق عليه دالة quantize بقيمة Decimal('1') وبسياسة التقريب ROUND_HALF_UP، فترفع الكسر 0.5 إلى أقرب عدد صحيح نحو الأعلى لتعيد القيمة 1 ميلي ثانية. هذا الاختبار المسجل في test_half_millisecond يثبت بالأرقام كيف يحول التقريب الحسابي نصف الميلي ثانية إلى وحدة موجبة بينما يسقطه الاقتطاع العشوائي.
يفرض تصميم دالة milliseconds شرطاً قاطعاً للتحقق من نوع المدخل في مستهل التنفيذ، حيث تفحص العبارة الشرطية if not isinstance(value, str) طبيعة المتغير الممرر وتطلق خطأ TypeError بنص صريح Supply decimal seconds as text في حال تمرير أي نوع آخر. يتجلى الدافع التقني وراء هذا القيد في منع الأخطاء الكامنة في أعداد الفاصلة العائمة الثنائية float، إذ إن تمرير رقم مثل 0.5 مباشرة كقيمة عددية يُدخل شوائب التمثيل الثنائي غير التام قبل أن تتاح لمكتبة Decimal فرصة قراءة خانات الكسر العشري بدقة. ويتحقق الفحص التاسع المسجل باسم test_float_rejected من هذه الحصانة البرمجية المحددة باختبار استدعاء milliseconds(0.5)، مما يؤكد أن الدالة ترفض الأرقام العشرية غير النصية وتلزم المنظومة بتمرير الثواني كمدخلات نصية نقية ومحددة الخانات.
تعتمد الدالة بعد استلام النص على محاولة بناء كائن Decimal داخل كتلة try، فإذا احتوت السلسلة على أحرف غير عددية تطلق المكتبة استثناء InvalidOperation الذي تلتقطه الدالة وتعيد إطلاقه كخطأ ValueError بنص Invalid decimal seconds. وبعد بناء الكائن، يخضع المتغير لفحص إضافي عبر الشرط if not number.is_finite() or number < 0، مما يمنع تمرير القيم السالبة أو القيم الرياضية غير المنتهية، ويعيد إطلاق استثناء ValueError بنص Expected nonnegative finite seconds. عند التحقق من سلامة الرقم، يُنفذ التعبير الحسابي int((number*1000).quantize(Decimal('1'), rounding=ROUND_HALF_UP))، حيث يحدد التكميم Decimal('1') موضع المنزلة الصفرية الصحيحة، ويحول الناتج النهائي مباشرة إلى عدد صحيح عادي صالح للاستخدام في حسابات الوحدات الزمنية دون بقاء أي أثر للكسور العشرية.
يوضح التدقيق في سلوك سياسة ROUND_HALF_UP أنها تفصل بدقة بين الكسور التي تقل عن نصف ميلي ثانية وتلك التي تساويه أو تزيد عنه، فعلى سبيل المثال لو تم تمرير 0.000499 ثانية فإن ضربها في ألف ينتج 0.499، وتكميمها يرجع الصفر لكونها تقع دون حاجز النصف، بينما القيمة 0.000500 تصعد حتماً إلى الواحد الصحيح. هذا الانضباط الحسابي يلغي التراكم التدريجي للأخطاء الطفيفة التي تحدث عند إجراء عمليات حسابية متتالية باستخدام الأعداد العائمة، ويوفر قاعدة تشغيل حتمية تعيد الناتج العددي ذاته في كل تنفيذ. يترتب على ذلك استقرار الطوابع الزمنية المستخلصة للمقاطع، بحيث تصبح الحدود المعبرة عن بداية ونهاية كل سطر نصوص دقيقة وقابلة للمقارنة الرياضية المباشرة دون خوف من تشوهات التقريب الثنائي.
شغّل المحول والمصدر بالنص العربي الأصلي
تصف مكتبة الكونغرس SRT كملف نصي يضم ترقيم الكتلة وطابعي البداية والنهاية والنص وفاصلاً فارغاً؛ لا يحتوي الملف نفسه على الفيديو أو الصوت. Library of Congress SubRip format
تنص المواصفة القياسية لصيغة SRT، كما توثقها سجلات مكتبة الكونغرس، على أن ملف الترجمة هو ملف نصي مجرد مرمز بصيغة محرفية مثل UTF-8، وتتكون بنيته من كتل متتالية تفصل بينها أسطر فارغة، بحيث تشتمل كل كتلة على ترقيم عددي تصاعدي يبدأ بالرقم 1، يليه سطر التوقيت المشكل من طابع البداية وطابع النهاية مفصولين بسهم التنسيق المحدد –>، ثم سطر أو أكثر من النص الحقيقي المعروض. لا يحتوي هذا الملف النصي بأي شكل على قنوات صوتية مدمجة أو إطارات فيديو مرئية، بل يقتصر دوره الهندسي على كونه جدولاً نصياً زمنياً مخصصاً للاستهلاك من قبل برمجيات العرض اللاحقة التي تتولى بدورها مهمة إظهار الكلمات بالتزامن مع الوسائط الموازية.
تفيد معرفة حدود أدوات توليد الفيديو عند بناء مسار إنتاج أوسع، لكن إنشاء ملف SRT هنا عمل نصي مستقل. صلاحية الطابع الذي يصدره الكود لا تثبت تزامن الكلام مع لقطة أو قبول الملف في كل مشغل.
يضع التعامل مع النصوص العربية داخل كتل SRT متطلبات هيكلية دقيقة لحماية الملف من الفساد التنسيقي، إذ إن ظهور أسطر فارغة غير مقصودة في جسم النص يؤدي إلى شطر الكتلة الواحدة وإرباك المفسرات النصية التي تعتمد السطر الفارغ فاصلاً بين الكتل. لهذا السبب تفرض دالة export_srt فحصاً صارماً على كل نص ممرر عبر الشرط if not isinstance(text, str) or '\r' in text or any(not line.strip() for line in text.split('\n'))، وتطلق خطأ ValueError بنص Expected nonblank subtitle lines إذا رصدت إرجاع المؤشر التقليدي المستخدم في أنظمة قديمة، أو إذا وُجد سطر فارغ أو مكون من مسافات بيضاء فقط. هذا التدقيق يحمي المحتوى العربي ويضمن سلامة فواصل الأسطر القياسية المنتهية برمز التغذية السطرية \n فقط.
يبرهن الفحص الرابع المعرف باسم test_arabic_export على تدفق البيانات عند إدخال نص عربي أصلي، حيث تم تمرير القائمة [('0','1','صورة أولى')] إلى دالة export_srt. تقوم الدالة بمعالجة طابع البداية النصي '0' ليتحول إلى 0 ميلي ثانية، وطابع النهاية '1' ليتحول إلى 1000 ميلي ثانية، وبعد التأكد من عدم وجود تداخل وأن النهاية أكبر من البداية، وتجاوز النص العربي شروط الفحص التنسيقي، يتم استدعاء دالة stamp لإنتاج السلسلة 00:00:00,000 –> 00:00:01,000. تدمج الكتلة مع الرقم التسلسلي 1 والنص صورة أولى، ليكون الناتج المطابق تماماً لتأكيد الاختبار هو: 1\n00:00:00,000 –> 00:00:01,000\nصورة أولى\n\n، مما يؤكد سلامة تصدير المحتوى بالرموز العربية القياسية.
تعتمد نهاية عملية التصدير في الكود على التعبير '\n'.join(blocks) + ('\n' if blocks else '')، وهو منطق تجميعي يعالج الحالات الحدية بدقة. فعند وجود كتل منشأة، تضمن الدالة أن كل كتلة ستحصل على سطر فارغ يفصلها عن الكتلة اللاحقة، مع وجود سطر فارغ أخير في نهاية الملف يلتزم بهيكل ملفات SubRip الرسمية لمنع التباس نهاية الملف لدى المشغلات، بينما في حال تمرير قائمة فارغة تماماً كما في الفحص الحادي عشر test_empty، يعيد التعبير سلسلة فارغة تماماً دون أسطر جديدة إضافية. هذا الفصل بين إنتاج عناصر الكتلة المستقلة وتجميعها في تيار نصي نهائي يضمن توحيد المسافات الرأسية والفواصل الفارغة بين مقاطع الترجمة بطريقة برمجية محكمة.
subtitles.py
from decimal import Decimal, InvalidOperation, ROUND_HALF_UP
def broken_milliseconds(value):
return int(float(value) * 1000)
def milliseconds(value):
if not isinstance(value, str):
raise TypeError('Supply decimal seconds as text')
try:
number = Decimal(value)
except InvalidOperation as error:
raise ValueError('Invalid decimal seconds') from error
if not number.is_finite() or number < 0:
raise ValueError('Expected nonnegative finite seconds')
return int((number*1000).quantize(Decimal('1'), rounding=ROUND_HALF_UP))
def stamp(value):
if type(value) is not int or value < 0:
raise ValueError('Expected nonnegative integer milliseconds')
seconds, ms = divmod(value, 1000)
minutes, seconds = divmod(seconds, 60)
hours, minutes = divmod(minutes, 60)
return f'{hours:02d}:{minutes:02d}:{seconds:02d},{ms:03d}'
def export_srt(cues):
blocks, previous_end = [], 0
for index, (start, end, text) in enumerate(cues, 1):
start, end = milliseconds(start), milliseconds(end)
if start < previous_end or end <= start:
raise ValueError('Local policy rejects overlap and collapsed intervals')
if not isinstance(text, str) or '\r' in text or any(not line.strip() for line in text.split('\n')):
raise ValueError('Expected nonblank subtitle lines')
blocks.append(f'{index}\n{stamp(start)} --> {stamp(end)}\n{text}\n')
previous_end = end
return '\n'.join(blocks) + ('\n' if blocks else '')
نطاق التحقق المحلي: أحد عشر اختباراً على ثوان نصية ومقاطع ترجمة اصطناعية. حُفظ ملف SRT فعلي بنص عربي أصلي. فُحص التقريب وحمل الثانية، وتنسيق ساعة تتجاوز اليوم، والتصدير العربي، والتداخل والتلامس، وانهيار فترة بعد التقريب، وNaN، ورفض float وسطر نصي فارغ، والمدخل الفارغ. لم يُولد فيديو أو صوت ولم يُختبر تشغيل الملف في مشغل وسائط أو توافقه العام أو محاذاته مع الصوت. البيئة: Python 3.12.3 على Windows.
افصل الثواني العشرية عن شكل الطابع الزمني
يقوم التصميم الهندسي للمكتبة على الفصل التام بين مرحلة تحويل وقراءة الثواني العشرية بدقة الميلي ثانية من خلال دالة milliseconds، وبين مرحلة تركيب وعرض الطابع الزمني عبر دالة stamp. هذا الفصل المعماري يمنع حدوث أي خلط بين القواعد الحسابية المجردة الخاصة بالتقريب وحسابات الكسور، وبين العمليات الرياضية المتعلقة بتوزيع الأعداد الصحيحة على مراتب الوقت الستينية. فالمسؤولية الأولى تنتهي تماماً بمجرد الحصول على رقم صحيح يمثل الميلي ثانية الإجمالية من نقطة الصفر، بينما تتولى الدالة الثانية صياغة هذا الرقم في صورة سلسلة نصية نمطية دون الحاجة لمعرفة السياسة التي تم بها استخلاص تلك الميلي ثواني من النصوص الأصلية.
تبدأ دالة stamp(value) بالتحقق الدفاعي من مدخلاتها بواسطة الشرط if type(value) is not int or value < 0، حيث تتطلب نوع int حصراً وليس أي نوع آخر مشتق أو عشري، وترفض القيم السالبة بإطلاق استثناء ValueError بنص Expected nonnegative integer milliseconds. بعد اجتياز الفحص، تلجأ الدالة إلى العامل الحسابي divmod لاستخراج المكونات بتسلسل تنازلي دقيق، فتقسم القيمة المدخلة أولاً على 1000 لاستخلاص إجمالي الثواني وباقي قسمة الميلي ثانية عبر seconds, ms = divmod(value, 1000). هذه الخطوة الحسابية تفصل الأجزاء المتبقية من الألف التي تشغل الخانات الثلاث الواقعة بعد الفاصلة في الطابع الزمني عن إجمالي الثواني الكاملة التي تتطلب مزيداً من التحليل.
تواصل الدالة تفكيك الثواني باستدعاء minutes, seconds = divmod(seconds, 60)، ثم استدعاء hours, minutes = divmod(minutes, 60)، لتنتهي باستخراج الساعات والدقائق والثواني والميلي ثانية كأعداد صحيحة خالصة. ويتجلى سلوك حمل الثواني بدقة في الفحص الثاني test_second_carry، حيث تم تمرير القيمة العشرية '0.9995' إلى milliseconds فتنتج ضرباً 999.5 يُقرب بسياسة ROUND_HALF_UP إلى 1000 ميلي ثانية بالضبط. وعند تمرير 1000 إلى stamp، تعيد divmod الأولى 1 ثانية و0 ميلي ثانية، لتعيد الدالة النص 00:00:01,000، مما يثبت انتقال فائض التقريب بسلاسة من أجزاء الألف إلى خانة الثواني الكاملة دون خطأ في المراتب.
تعتمد دالة stamp في صياغة مخرجها على نص التنسيق f'{hours:02d}:{minutes:02d}:{seconds:02d},{ms:03d}'، وهو تنسيق يفرض خانتين للساعات والدقائق والثواني مع إكمال الفراغات بالأصفار، وثلاث خانات للميلي ثانية مسبوقة بفاصلة واوية تقليدية تميز صيغة SRT عن صيغة WebVTT التي تستخدم النقطة. ويكشف الفحص الثالث test_over_24_hours_formatter عن قدرة هذا المنسق على معالجة الطوابع التي تتجاوز اليوم الكامل، فعند تمرير '90061.002' ثانية يتم تحويلها إلى 90061002 ميلي ثانية، ومن ثم تقسيمها لتنتج 25 ساعة ودقيقة واحدة وثانية واحدة و2 ميلي ثانية، ليكون المخرج 25:01:01,002. يثبت هذا الفحص قدرة دوال التقسيم على التعامل مع المقاطع الزمنية الطويلة جداً دون انهيار الصياغة النصية.
افحص الفترات بعد التقريب لا قبله فقط
من الناحية الرياضية البحتة، فإن تطبيق دالة تقريب رتيبة مثل ROUND_HALF_UP على نقاط زمنية مرتبة مسبقاً لا يمكن على الإطلاق أن يولد تداخلاً زمنياً جديداً لم يكن موجوداً في البيانات الأصلية. فالخاصية الرياضية الأساسية لدوال التقريب الرتيبة تنص على أنه إذا كانت القيمة أ أصغر من أو تساوي القيمة ب، فإن تقريب أ سيكون دائماً أصغر من أو مساوياً لتقريب ب. بناءً على ذلك، إذا كانت نهاية المقطع الأول 1.4 ثانية وبداية المقطع الثاني 1.6 ثانية بحيث لا يوجد بينهما تداخل في القيم الحقيقية، فإن تقريبهما سينتج 1400 ميلي ثانية و1600 ميلي ثانية، مما يبقي الترتيب غير متداخل حتماً. الزعم القائل بأن التقريب بحد ذاته يخلق تداخلاً من نقاط متباعدة هو زعم غير صحيح رياضياً.
ما يمكن أن يحدثه التقريب بالفعل هو انهيار الفترات الإيجابية الصامتة أو الفترات القصيرة جداً، فإذا كان الفارق الزمني بين بداية المقطع ونهايته جزءاً يسيراً من الميلي ثانية، فإن التقريب قد يساوي بين طرفي الفترة ويقود إلى انعدام مدتها الزمنية. يتضح هذا السيناريو عملياً في الفحص السابع test_collapsed_after_rounding، حيث تم تمرير مقطع يبدأ عند '0.0001' ثانية وينتهي عند '0.0002' ثانية، وهي فترة إيجابية في القيم الأصلية مقدارها 0.0001 ثانية. عند ضرب القيمتين في 1000 ينتج 0.1 و0.2، وكلاهما يتقرب إلى الصفر، فتصبح البداية 0 والنهاية 0، مما يجعل شرط الفحص end <= start صحيحاً داخل export_srt، فيطلق الكود استثناء ValueError بنص Local policy rejects overlap and collapsed intervals.
تتمثل النتيجة الثانية المحتملة للتقريب الرياضي في تحويل الفجوة الإيجابية الضيقة بين مقطعين متعاقبين إلى نقطة تلامس زمنية صفرية الفارق. فإذا انتهى المقطع الأول عند 0.9996 ثانية وبدأ المقطع الثاني عند 1.0004 ثانية، فإن الفارق الفاصل بينهما في الأصل هو 0.0008 ثانية، لكن تطبيق تقريب النصف للأعلى على القيمتين بعد ضربهما في ألف سيقرب الأولى إلى 1000 ميلي ثانية والثانية إلى 1000 ميلي ثانية أيضاً. في هذه الحالة، تتلاشى الفجوة الزمنية الأصلية بالكامل ويصبح المقطعان متلامسين زمنياً دون أن يتداخلا. لذلك، فإن فحص الفترات بعد التقريب يعد ضرورياً للتحقق من عدم انهيار الفترة ذاتها إلى الصفر، وللتأكد من مطابقة الحدود لما تقبله سياسة النظام التحريرية.
تعتمد سياسة الكود في export_srt شرط المقارنة الصارم if start < previous_end or end <= start لتقرير قبول الكتلة أو رفضها. يظهر الفحص الخامس test_overlap_rejected كيف يرفض النظام التداخل الصريح القادم من المدخلات عبر القائمة [('0','2','a'),('1','3','b')]، حيث ينتهي المقطع الأول عند 2000 ميلي ثانية بينما يبدأ الثاني عند 1000 ميلي ثانية، مما يجعل start < previous_end محققاً ويطلق الخطأ فوراً. في المقابل، يبرهن الفحص السادس test_touching_intervals_allowed على قبول التلامس التام من خلال المدخلات [('0','1','a'),('1','2','b')]، حيث يكون نهاية الأول 1000 وبداية الثاني 1000، وحيث إن 1000 ليست أقل من 1000 فإن الكود يسمح بالكتلة الثانية ويدمجها في الناتج دون أخطاء.
اكتب حدود كتل SRT بوضوح
تفرض البنية النصية لصيغة كتل SRT ترتيباً هندسياً صارماً لكل عنصر داخل الملف المصدر، حيث تبدأ الكتلة برقم الفهرس التسلسلي العددي الذي يزيد بمقدار واحد لكل مقطع متتالٍ. يليه مباشرة في السطر التالي سطر التوقيت الذي يطابق النموذج القياسي الساعات والدقائق والثواني وأجزاء الألف، مع استخدام الرمز المعياري المحدد –> للفصل بين طابع البداية وطابع النهاية، مع وجوب وجود مسافة مفردة قبله ومسافة مفردة بعده. يُعبر عن أجزاء الثانية بثلاث خانات رقمية تسبقها فاصلة سفلية comma، ولا يُقبل استخدام الفاصلة المنقوطة أو النقطة العشرية في هذا الموقع وفق مواصفات SubRip المعيارية.
تتولى الحلقة التكرارية داخل export_srt فحص سلامة جسم النص المصاحب لكل كتلة لضمان عدم احتوائه على أخطاء هيكلية قد تؤدي إلى تشويه ملف الترجمة. ويشمل ذلك فحص وجود محرف إرجاع المؤشر '\r' الذي يتم رفضه صراحة لمنع تباين تمثيل نهايات الأسطر بين أنظمة التشغيل، إضافة إلى تجزئة النص إلى أسطره المكونة عبر text.split('\n') والتأكد من أن كل سطر يحتوي على أحرف نصية حقيقية عبر العبارة any(not line.strip() for line in text.split('\n')). ويتحقق الفحص العاشر test_blank_line_rejected من كشف هذا الخلل عند تمرير القيمة 'a\n\nb'، حيث يتسبب السطر الأوسط الفارغ في إطلاق خطأ ValueError فوراً لمنع انقسام الكتلة إلى شظايا مشوهة.
يُدار بناء الكتل المتتالية في دالة export_srt بالاعتماد على دالة الترقيم المدمجة enumerate(cues, 1) التي توفر عداداً تصاعدياً يبدأ من الواحد الصحيح، مع حفظ نهاية كل مقطع معالج في المتغير previous_end الذي تبدأ قيمته بالصفر. عند كل تكرار، يتم حساب الميلي ثانية للبداية والنهاية عبر دالة milliseconds، وبعد تجاوز شروط التداخل وصلاحية النصوص، تُصاغ الكتلة النصية وتُلحق بمصفوفة الكتل blocks عبر التعبير blocks.append(f'{index}\n{stamp(start)} –> {stamp(end)}\n{text}\n'). يتم بعد ذلك تحديث المتغير previous_end ليأخذ قيمة end الحالية، مما يضمن أن الفحص التالي سيقارن بداية المقطع اللاحق بنهاية المقطع الحالي المحدثة بدقة.
تكتمل صياغة الملف النهائي بربط عناصر المصفوفة blocks معاً، حيث يضمن استخدام فاصل السطر '\n'.join(blocks) توفير سطر فارغ بين كل كتلة والتي تليها، بالإضافة إلى إلحاق سطر جديد نهائي إضافي إذا كانت القائمة غير فارغة لإنهاء الملف بفاصل مزدوج يتوافق مع القواعد المعتمدة لقراءة ملفات SRT. هذا التنظيم الهيكلي يحافظ على وضوح حدود الكتل وتمايزها، بحيث يسهل على أي أداة قراءة لاحقة تمييز أرقام الفهارس عن أسطر التوقيت وعن النصوص الفعلية دون حدوث تداخلات أو تشويه في تسلسل الفقرات النصية أثناء التصدير.
تتيح Decimal اختيار قاعدة التقريب صراحة، ويستعمل مثالنا ROUND_HALF_UP عند التحويل إلى وحدة الميلي ثانية. Python3.12 Decimal rounding
اقرأ الفحوص الأحد عشر دون توسيعها إلى تشغيل فيديو
تتألف منظومة الاختبارات المسجلة في ملف test_example.py من أحد عشر فحصاً برمجياً مستقلاً كُتبت ضمن فئة SubtitleTests المشتقة من فئة TestCase القياسية في وحدة unittest. تركز هذه الاختبارات حصراً على التحقق من صحة القواعد الرياضية لتحويل الأرقام وسلامة الهيكل النصي المولد، وتعمل على مدخلات مصطنعة محددة دون أي اتصال بقواعد بيانات أو واجهات شبكية أو أدوات وسائط متعددة. ولا يدعي هذا الفحص البرمجي التوافق مع مشغلات فيديو محددة أو سلامة توقيتات الكلام مع الصوت، بل يقيس حصراً التزام الكود بالشروط المنطقية المعتمدة داخله واجتياز كافة الحالات الحدية المنصوص عليها.
تختبر المجموعة الأولى من الفحوص العمليات الحسابية والتحويل العددي الخالص، حيث يثبت الفحص الأول test_half_millisecond الفرق بين الاقتطاع والتقريب بمقارنة مخرجات broken_milliseconds('0.0005') التي تعيد 0 مع مخرجات milliseconds('0.0005') التي تعيد 1، مما يؤكد رفع النصف ميلي ثانية بنجاح. ويختبر الفحص الثاني test_second_carry انتقال الحمل العددي عند تقريب '0.9995' لينتج '00:00:01,000'، بينما يختبر الفحص الثالث test_over_24_hours_formatter صياغة الطوابع التي تتجاوز اليوم الكامل عبر '90061.002' لتعيد '25:01:01,002'، وهو ما يؤكد سلامة الحسابات الرياضية وتراكم الساعات دون قيود الـ 24 ساعة.
تختبر المجموعة الثانية الحالات الشاذة ورفض المدخلات غير الصالحة، حيث يركز الفحص الثامن test_nonfinite على تمرير القيمة النصية 'NaN' تحديداً إلى دالة milliseconds والتحقق من إطلاق استثناء ValueError عبر الشرط if not number.is_finite(). ويجدر التنبيه هنا إلى أن هذا الفحص مخصص لاختبار كائن NaN فقط، ولا يمثل فحصاً عاماً لكل السلاسل النصية غير العددية أو لقيم اللانهاية، وإن كان الكود يتعامل مع النصوص الأخرى عبر كتلة InvalidOperation. أما الفحص التاسع test_float_rejected فيختبر رفض الأعداد العشرية غير النصية مثل 0.5 بإطلاق TypeError، في حين يتحقق الفحص العاشر test_blank_line_rejected من رفض الأسطر الفارغة داخل نصوص الترجمة.
تغطي المجموعة الثالثة العلاقات الزمنية بين الكتل المتعاقبة وصلاحية الفترات، حيث يثبت الفحص الخامس test_overlap_rejected رفض التداخل الصريح في المدخلات المكونة من فترتين [('0','2','a'),('1','3','b')] بإطلاق خطأ ValueError. ويقابله الفحص السادس test_touching_intervals_allowed الذي يسمح بتلامس الفترات المتتالية [('0','1','a'),('1','2','b')] ويتحقق من وجود النص '2\n00:00:01,000' في الملف المخرج. في حين يختبر الفحص السابع test_collapsed_after_rounding انهيار الفترة الإيجابية الضيقة [('0.0001','0.0002','a')] بعد تقريب كلا الطرفين إلى الصفر، مما يؤكد يقظة الكود لرفض الفترات الصفرية.
تكتمل المنظومة بفحصين مخصصين لسلامة الإخراج النهائي، حيث يتحقق الفحص الرابع test_arabic_export من التصدير السليم للكتل المحتوية على أحرف عربية أصلية مثل صورة أولى وإنتاج الهيكل المتكامل للترجمة، بينما يتأكد الفحص الحادي عشر test_empty من أن تمرير قائمة كتل فارغة إلى export_srt يعيد سلسلة فارغة تماماً دون أخطاء. وتؤكد سجلات التنفيذ المحلية المسجلة أن الاختبارات الأحد عشر كافة قد اجتيزت بنجاح كامل وبرمز خروج 0 على بيئة بايثون 3.12.3، مما يحدد الإطار الدقيق لما تم اختباره والتأكد من صحته برمجياً.
صل المصدر ببيانات مشروع مقترح
عند النظر في ربط وحدة تصدير الترجمة ببيانات مشروع مستقبلي مقترح، مثل منظومة تحويل الصوت إلى نصوص أو أدوات توليد الفهارس اللغوية، يتم تعريف هذا التكامل بوصفه عقداً هندسياً مقترحاً لم يُنفذ بعد ولم يخضع للاختبار الفعلي. لا يهدف هذا المقترح إلى تقديم وعود تشغيلية أو ادعاء التوافق التلقائي مع واجهات برمجية خارجية، بل يوضح الشروط والمتطلبات المسبقة التي يجب أن تستوفيها أي بيانات مدخلة قبل تمريرها إلى دالة export_srt، بحيث تتوافق مع افتراضات الكود الصارمة حول أنواع البيانات والبنية النصية للثواني.
يقضي العقد البرمجي المقترح بأن تسلم المنظومة المصدرية قائمة من الحبيبات الزمنية، حيث يمثل كل عنصر زوجاً ثلاثياً يضم وقت البدء ووقت الانتهاء وسطر المحتوى العربي. ويشترط العقد أن تكون قيم الوقت ممثلة في صورة سلاسل نصية للأعداد العشرية للثواني مثل '14.250' و '17.800' بدلاً من تمرير قيم float عائمة لتجنب رفضها الفوري عبر فحص النوع. كما يوجب العقد أن تكون النصوص خالية تماماً من رموز إرجاع المؤشر '\r' وأن تكون الأسطر المتعددة داخل المقطع الواحد مفصولة برمز التغذية السطرية '\n' النقي فقط مع ضمان عدم وجود أسطر فارغة بين الكلمات.
يتضمن مسار تدفق البيانات المقترح طبقة تنقية وسيطة تسبق الاستدعاء المباشر لدالة التصدير، بحيث تتولى هذه الطبقة مهمة معالجة الفروق الزمنية الضيقة التي قد تنشأ عن خوارزميات التعرف الصوتي الآلي. فإذا أنتجت الخوارزمية مقطعاً مدته أجزاء ضئيلة من الميلي ثانية يخشى انهياره بعد التقريب، أو فترات تتداخل فيها أصوات المتحدثين، يتوجب على الطبقة المقترحة تسوية تلك الفترات أو دمجها أو توجيهها لمسار مراجعة بدلاً من إرسالها إلى export_srt فتتسبب في إطلاق استثناء يوقف المعالجة التصديرية للملف بالكامل.
يوفر هذا العقد التوضيحي نموذجاً لفصل المهام البرمجية في المشاريع البرمجية الأكبر، حيث تتحمل المنظومة المجمعة مسؤولية تحضير وتطهير البيانات النصية والزمنية وفق المواصفات القياسية، بينما تتولى دالة export_srt مهمة الحسابات الرياضية للتقريب وتطبيق قيود التنسيق الصارمة وإنتاج مخرجات SRT النصية. هذا التحديد الواضح لحدود المسؤولية يضمن عدم المساس بالمنطق الرياضي المستقر داخل المحول المعتمد، ويمنح مطوري المنظومات اللاحقة دليلاً صريحاً على بنية البيانات المطلوبة لتحقيق التوافق التام مع متطلبات الكود.
ضع اختبار قبول منفصلاً للتزامن والقراءة
تقتضي الممارسة الهندسية السليمة وضع اختبار قبول مستقل ينفصل تماماً عن اختبارات الوحدة البرمجية للشيفرة، بحيث يركز هذا الفحص على معايير الملاءمة البشرية وتجربة القراءة والتزامن دون خلطه بالتحقق الرياضي من دقة الميلي ثانية. فنجاح ملف SRT في اجتياز دوال الفحص الحسابي لا يعني بالضرورة أن النص المكتوب يسهل تتبعه بالعين، أو أن سرعة ظهور الكلمات ملائمة لمعدل القراءة الطبيعي، أو أن تقسيم الأسطر يحترم السياق النحوي والتركيبي للجمل العربية، وهي عوامل تحتاج إلى طبقة تحقق مخصصة لمعايير العرض.
يشمل نموذج اختبار القبول المقترح فحص طول السطر النصي ومعدل الحروف المعروضة في الثانية الواحدة، حيث يُنصح بألا يتجاوز طول السطر الواحد في الترجمة العربية ما بين 35 إلى 40 حرفاً لمنع تشتت بصر القارئ، وألا يقل زمن بقاء المقطع القصير على الشاشة عن ثانية واحدة إلى ثانية ونصف حتى يتمكن المشاهد من استيعاب الكلمات. كما يفترض بالاختبار التحقق من عدم قطع العبارات اللغوية المترابطة أو فصل المضاف عن المضاف إليه عند توزيع النص على سطرين داخل الكتلة الواحدة، لضمان القراءة المريحة والسلسة.
يتطرق فحص القبول أيضاً إلى ملاءمة التشفير المحرفي واتجاه النص العربي أثناء العرض، والتأكد من أن برمجيات المشغلات المستهدفة تقرأ ملف UTF-8 دون حدوث انعكاس للحروف أو تشوه في أدوات الربط والتشكيل، والتأكد من معالجة علامات الترقيم العربية مثل الفاصلة المنقوطة وعلامات الاستفهام بحيث تظهر في موضعها الصحيح من السطر. هذه المعايير تقع بالكامل خارج نطاق واختصاص دالة التصدير النصية المجردة، لكنها تشكل حلقة وصل ضرورية لضمان جودة المنتج النهائي المقدم للجمهور في بيئات النشر الحقيقية.
ختاماً، يؤكد هذا التمييز الواضح بين فحص الوحدة الرياضية واختبار القبول البصري على ضرورة الحفاظ على دقة النطاق الهندسي للمشروع، حيث يظل الكود الحالي مسؤولاً عن صحة التمثيل العددي وسلامة هيكل ملف SRT النصي وفق المواصفات الرسمية دون تجاوزها. إن بناء خطوط الإنتاج البرمجية يعتمد على تضافر هذه الوحدات المتخصصة؛ فتبدأ المعالجة بالحسابات الرياضية الدقيقة للثواني والتقريب المنضبط، لتسلم مخرجاتها بثقة إلى منظومات الفحص البصري والتزامن النهائي التي تقيم جودة العرض على شاشات المشاهدين.
أُعد المقال بمساعدة أدوات ذكاء اصطناعي ومراجعات آلية. شُغلت الشيفرة الأصلية محلياً ضمن نطاق الاختبارات المسجل، دون ادعاء تجربة بشرية ميدانية أو اتصال بمزود صور أو تجربة توليد فيديو.
التعليقات
كن أول من يعلّق على هذا المقال.