# 29.97 ليست 30000/1001: احسب أزمنة الإطارات بكسر صريح

> **الرابط:** https://aiseza.com/545/python-fraction-frame-clock-30000-1001/
> **الكاتب:** INESSE MOUSBIR
> **النشر:** 2026-11-03
> **آخر تحديث:** 2026-11-03

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

المعدل العشري 29.97 يختلف عن 30000/1001. يختبر هذا المشروع حساب مواضع بدء الإطارات بكسور صريحة ومعنى الفهرس والحد الزمني في 17 طريقة محلية. المخرجات المحفوظة نتائج حسابية؛ لم نولد فيديو أو نشغله أو نقس تزامن الصوت.

## ابدأ بمعادلة لا بلقطة تشغيل

في التجربة الحسابية المحفوظة، يعطي 30000 فاصل زمني عند معدل 30000/1001 مدة قدرها 1001 ثانية. وعندما نستعمل بدلاً منه المعدل العشري المحدد 29.97، تصبح مدة العدد نفسه من الفواصل أكبر بمقدار 1/999 ثانية. هذه نتيجتان من دالة أصلية تعمل على الكسور في Python، وليستا ملاحظة لانجراف ظهر في فيديو. لم نولد مقطعاً أو نشغله أو نفحص صوتاً. لذلك نبدأ بالمدخلات والمعادلة التي نستطيع تكرارها، قبل التفكير في ربطها بأداة فيديو لاحقاً.

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

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

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

## حدد معنى الصفر قبل حساب آخر إطار

تمثل Fraction أعداداً نسبية، ويختلف إنشاء كسر من قيمة float عن إنشائه من سلسلة عشرية أو بسط ومقام صريحين. [Python 3.12 fractions reference](https://docs.python.org/3.12/library/fractions.html)

يعني الفهرس 0 في هذا النموذج بداية الإطار الأول. ولذلك تعيد frame_time عند هذا الفهرس الزمن 0. أما بداية الإطار ذي الفهرس 1 فتقع بعد فاصل واحد، وبدايته عند المعدل المحدد هي 1001/30000 ثانية. لا نضيف فاصلاً إلى كل فهرس لمجرد أن المستخدم قد يسمي الصورة الأولى الإطار رقم 1. ينبغي التمييز بين ترقيم الواجهة الذي يمكن أن يبدأ من 1 وفهرس الحساب الذي يبدأ هنا من 0.

إذا كان لديك N إطاراً في نموذج ثابت المعدل يبدأ من الصفر، فآخر فهرس هو N-1، وزمن بدايته هو (N-1)/rate. أما N/rate فيمثل N فواصل زمنية كاملة في ذلك النموذج. هذا يزيل التباساً شائعاً عند استعمال نتيجة frame_time كمدة كاملة: الدالة تعيد موضع بداية الإطار صاحب الفهرس، ولا تسأل عن نهاية عرضه. إذا أردت حساب طول N فواصل، فسمِّ المدخل على هذا الأساس بدلاً من تمرير عدد الإطارات وتسميته آخر فهرس.

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

حفظنا ضمن المخرجات الحسابية موضع الفهرس 29999 وهو 30028999/30000 ثانية، وموضع الفهرس 30000 وهو 1001 ثانية عند المعدل 30000/1001. يفصل بينهما فاصل واحد. تسمية الاختبار الأصلي test_30000_frames لا تغير المعنى الرياضي للمدخل: القيمة الممررة للدالة هي فهرس 30000، أي عدد الفواصل من البداية إلى ذلك الموضع. عند شرح النتيجة نستعمل هذا التعريف حتى لا تتحول تسمية مختصرة في الاختبار إلى ادعاء خاطئ عن آخر إطار في مقطع من 30000 إطار.

## اقرأ حراس frame_time ثم عملية القسمة

تطلب frame_time فهرساً من النوع int نفسه وغير سالب. لذلك ترفض True رغم علاقته بالأعداد الصحيحة في Python، وترفض الفهرس السالب. في هاتين الحالتين تثير ValueError. يثبت test_bool_index وtest_negative_index سلوك المدخلين المحددين. لا تحاول الدالة تقريب فهرس كسري أو تحويل نص إلى عدد. إذا كانت واجهة المشروع تستقبل أرقاماً مكتوبة، فهناك خطوة تحليل منفصلة قبل هذا الحد، ولا ينبغي أن نخفيها داخل وصف عام يقول إن الدالة تقبل أي رقم.

يتحقق الحارس التالي من أن المعدل من النوع Fraction نفسه. تمرير القيمة float مثل 29.97 إلى frame_time يثير TypeError في test_float_rate_refused. وبعد قبول النوع تتحقق الدالة من أن المعدل موجب، فيثير الصفر ValueError في test_zero_rate. فصل النوع عن القيمة يجعل سبب الرفض واضحاً في المثال: كسر صفري من النوع الصحيح ليس معدلاً صالحاً، وقيمة float موجبة لا تحقق عقد التمثيل الذي اخترناه، حتى لو أمكن تحويلها حسابياً في سياق آخر.

بعد هذه الحراس تعيد الدالة index/rate. عند فهرس 1 ومعدل Fraction(30000,1001) يكون الناتج 1001/30000. وعند الفهرس 2 يسجل ملف النتائج 1001/15000، وهي صورة مختزلة من 2002/30000. لا نحتاج إلى تقريب القيم الوسيطة لعرض عدد عشري مبكر. يمكن الاحتفاظ بالكسر أثناء الحساب ثم اتخاذ قرار العرض في الحد الذي يحتاج إلى نص. اختزال الكسر لا يغير الزمن؛ إنه تمثيل آخر للقيمة النسبية نفسها.

لا تعرف الدالة من أي مصدر جاء المعدل. كونه Fraction يحقق شرط نوع واحد، لكنه لا يثبت أنه الكسر المقصود للمشروع. أضفنا test_fraction_type_does_not_choose_the_intended_rate ليظهر هذا الحد صراحة: المعدل Fraction("29.97") مقبول من حيث النوع والإشارة، لكنه يعطي زمناً مختلفاً عن Fraction(30000,1001) عند الفهرس نفسه. لا تعدّل الحارس ليخمن المعدل الشائع؛ اجعل اختيار المصدر قراراً واضحاً قبل حساب الأزمنة.

### frame_clock.py

```
from fractions import Fraction

def frame_time(index,rate):
    if type(index) is not int or index < 0:raise ValueError('Expected a nonnegative frame index')
    if type(rate) is not Fraction:raise TypeError('Supply an exact Fraction rate')
    if rate <= 0:raise ValueError('Rate must be positive')
    return index/rate

def frame_at(seconds,rate):
    if type(seconds) is not Fraction or seconds < 0:raise ValueError('Supply nonnegative Fraction seconds')
    if type(rate) is not Fraction or rate <= 0:raise ValueError('Supply positive Fraction rate')
    return int(seconds*rate)
```

اجتازت المجموعة الأصلية 10 طرق، وأضيفت 5 طرق لعقد المدخلات وطريقتان للرجوع الحسابي في 30 حالة فرعية. المجموع 17 طريقة مختلفة. البيئة Python 3.12.3 على Windows. حفظت مخرجات كسرية في arithmetic-results.json. لا تشمل النتيجة توليد فيديو أو تشغيله أو قياس تزامن.

## اشتق الفرق دون تحويله إلى نتيجة فيديو

يمكن كتابة 29.97 بالضبط على صورة 2997/100. عند حساب 30000 فاصلة بهذا المعدل تكون المدة 30000 ÷ (2997/100)، أي 3000000/2997، وتختزل إلى 1000000/999. أما المعدل 30000/1001 فيعطي 30000 ÷ (30000/1001)، أي 1001. نحن نقارن مدتي العدد نفسه من الفواصل تحت اختيارين مختلفين للمعدل؛ لا نقارن طابعاً زمنياً سحبناه من ملف مع ساعة خارجية.

لإيجاد الفرق، اكتب 1001 على مقام 999 فتكون 999999/999. طرحها من 1000000/999 يعطي 1/999 ثانية. الجهة مهمة: المعدل العشري هو الأصغر في هذه المقارنة؛ لذلك تكون مدة العدد نفسه من الفواصل أكبر قليلاً. يسجل test_decimal_rate_is_different الفرق بهذا الكسر الصريح، كما حفظناه في arithmetic-results.json. لا نستبدله بعبارة تقريبية من نوع ثانية كاملة، ولا ننسبه إلى فقد إطارات أو خلل في نموذج توليد لم نستعمله.

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

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

## اعكس العلاقة عند الحد وعند اللحظة السابقة له

تستقبل frame_at زمناً من النوع Fraction وغير سالب، ومعدلاً موجباً من النوع Fraction، ثم تعيد int(seconds*rate). في المجال غير السالب الذي تقبله، يختار هذا التحويل الجزء الصحيح من حاصل الضرب، أي فهرس الفاصل الذي لم يتجاوز بدايته الزمن المدخل. لا تستعمل الدالة تقريباً إلى أقرب إطار. لذلك ينبغي أن يحدد المستهلك هل يريد الإطار عند الزمن، أم أقرب بداية، أم إطاراً تالياً؛ هذه قرارات مختلفة لا يحققها اسم واحد دون شرح.

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

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

أضفنا ثلاثة اختبارات للمدخلات في الاتجاه العكسي: زمن float مرفوض، وزمن Fraction سالب مرفوض، ومعدل float مرفوض. تثير frame_at في هذه الحالات ValueError وفق تنفيذها الحالي. هذا يختلف عن TypeError الذي تثيره frame_time عند رفض نوع المعدل. لا نعمم نوع استثناء واحداً على الدالتين لأنهما تشتركان في كلمة معدل. إذا أردت توحيد واجهتهما لاحقاً، فسيكون ذلك تعديلاً للعقد يحتاج تحديث الحالات التي تصف رسائل المستهلك ومسار المعالجة.

## اختر طريقة إنشاء الكسر من المعنى المطلوب

يفحص test_float_construction_differs_from_decimal_string أن Fraction(29.97) لا تساوي Fraction("29.97") في البيئة المحلية. الأولى تبدأ من قيمة float التي وصلت إلى المنشئ، والثانية تبدأ من النص العشري المحدد. لذلك لا يكفي استبدال كل float باستدعاء Fraction حوله ثم وصف المصدر بأنه أصبح المعدل المقصود. الكسر يحفظ القيمة التي قدمتها له؛ فإذا كان المطلوب أصلاً 30000/1001، فإن الكتابة المباشرة للبسط والمقام تعبر عن هذا المعنى بوضوح أكبر.

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

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

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

## احفظ الأزمنة المحسوبة كبيانات حسابية مستقلة

يضم arithmetic-results.json المعدل الصريح ومواضع بدء الفهارس 0 و1 و2 و3 و4 و29999 و30000. حفظت القيم كسلاسل كسرية كي يبقى البسط والمقام ظاهرين في السجل، لا كقيم عشرية مقربة فقط. هذه مخرجات فعلية من تشغيل الدالة على الأعداد المحددة. ولا يضاعف هذا الملف عدد طرق unittest؛ إنه فحص إضافي محفوظ للقيم التي نناقشها. افصل عدّ الملفات أو قيم النتائج عن عدّ الحالات حتى لا يتحول كل سطر إلى اختبار لم يكتب.

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

عندما تصل إلى طبقة تتطلب مللي ثانية، اتخذ قرار التقريب هناك بصورة معلنة. يرتبط بذلك المقال المستقل عن [حساب توقيت SRT بالمللي ثانية](https://aiseza.com/506/srt-decimal-milliseconds-overlap-export/)، لكنه يعالج عقداً مختلفاً. نجاح معادلة الكسر لا يختار وحده كيف تكتب حداً زمنياً في ملف ترجمة، ولا يثبت أن مقطع ترجمة ظهر في اللحظة المقصودة. حدّد هل التحويل لبداية أو نهاية، وأي اتجاه للتقريب تعتمده، ثم اختبر تلك الطبقة على مدخلاتها الفعلية.

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

## افحص الرجوع إلى الفهرس وفي منتصف الفاصل

بعد الحالات الأولى أضفنا ملف test_roundtrip.py لطرح سؤال مختلف: هل ترجع بداية الإطار المحسوبة إلى فهرسها عند تمريرها إلى الاتجاه العكسي؟ يستعمل الاختبار معدلات Fraction(24) وFraction(30) وFraction(30000,1001)، ولكل منها الفهارس 0 و1 و2 و29 و30000. تمر هذه القيم في حلقتين واضحتين، وتفحص الطريقة الأولى أن frame_at(frame_time(index,rate),rate) تساوي index. اجتازت الطريقة التركيبات الخمس عشرة المسجلة، دون استبدالها بمقارنة تقريبية لأعداد عشرية.

لا يعني نجاح الرجوع أن الدالتين تعيدان كل قيمة زمنية إلى ذاتها في الاتجاه الآخر. frame_time تختار بداية محددة لكل فهرس، بينما frame_at تجمع الأزمنة الواقعة داخل الفاصل تحت الفهرس نفسه. لهذا أضفنا طريقة ثانية تختار بداية الإطار ثم تزيد نصف فاصل، أي Fraction(1,2)/rate. النتيجة المتوقعة تظل الفهرس نفسه. تقرأ هذه الحالة تعريف الجزء الصحيح عملياً، وتمنع تفسير الاتجاه العكسي كاختيار لأقرب بداية على جانبي الزمن المدخل.

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

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

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

يمكن تكرار الملف الجديد بالأمر python -m unittest discover -s . -p test_roundtrip.py -v في مجلد نسختك. يستورد الدالتين من الوحدة نفسها، فلا يقدم تنفيذاً بديلاً قد ينجح بمعنى مختلف. وتظل هذه المجموعة منفصلة عن ملفات النتائج الحسابية المحفوظة للعرض؛ النجاح هنا يأتي من assertions شُغلت على القيم المحددة. عند مقارنة سجلين لاحقاً، راجع اسم ملف الاختبار وبصمة المصدر كي لا تنسب هذه المصفوفة إلى نسخة لم تكن تحتويها.

## شغّل المجموعات واقرأ حدود كل حالة

احفظ frame_clock.py وtest_example.py وtest_contract.py وtest_roundtrip.py في مجلد واحد، واقرأ الدالتين والحراس قبل التنفيذ. تعتمد الشيفرة على fractions وunittest من المكتبة القياسية في البيئة المسجلة. المجموعة الأصلية تحتوي 10 طرق، منها الفهرس الأول والفاصل الواحد وموضع الفهرس 30000 وفرق المعدلين وحدا الاتجاه العكسي، إضافة إلى حالات رفض محددة. مجموعة عقد المدخلات تحتوي 5 طرق، ومجموعة الرجوع تحتوي طريقتين. المجموع 17 طريقة مختلفة، لا 17 فيديو أو تجربة مزامنة.

لإعادة التشغيل في نسختك، استعمل python -m unittest discover -s . -p test_example.py -v، ثم الأمر المقابل مع test_contract.py. هذه تعليمات تكرار مختصرة، بينما يحتفظ السجل بمسار المفسر ومجلد الاكتشاف الفعليين. شغلت المجموعتان على Python 3.12.3 في Windows. لا نستنتج من اسم البيئة سرعة أو دقة مشغل فيديو؛ فهي تصف أين نفذت العمليات الحسابية والـ assertions. ويمكن للقارئ تغيير مدخلات في نسخة منفصلة مع الاحتفاظ بالمثال الأصلي للمقارنة.

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

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

## خطط لتجربة فيديو لاحقة دون نسبتها إلى هذا الحساب

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

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

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

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

### test_example.py

```
import unittest
from fractions import Fraction as F
from frame_clock import frame_time,frame_at
class ClockTests(unittest.TestCase):
 def test_first_frame(self):self.assertEqual(frame_time(0,F(30000,1001)),0)
 def test_30000_frames(self):self.assertEqual(frame_time(30000,F(30000,1001)),1001)
 def test_one_frame_interval(self):self.assertEqual(frame_time(1,F(30000,1001)),F(1001,30000))
 def test_decimal_rate_is_different(self):self.assertEqual(frame_time(30000,F('29.97'))-frame_time(30000,F(30000,1001)),F(1,999))
 def test_negative_index(self):
  with self.assertRaises(ValueError):frame_time(-1,F(30))
 def test_bool_index(self):
  with self.assertRaises(ValueError):frame_time(True,F(30))
 def test_zero_rate(self):
  with self.assertRaises(ValueError):frame_time(1,F(0))
 def test_float_rate_refused(self):
  with self.assertRaises(TypeError):frame_time(1,29.97)
 def test_inverse_boundary(self):self.assertEqual(frame_at(F(1001,30000),F(30000,1001)),1)
 def test_inverse_just_before(self):self.assertEqual(frame_at(F(1001,30000)-F(1,1000000),F(30000,1001)),0)
```

### test_contract.py

```
from fractions import Fraction as F
import unittest
from frame_clock import frame_time,frame_at

class RateInputTests(unittest.TestCase):
    def test_float_construction_differs_from_decimal_string(self):
        self.assertNotEqual(F(29.97),F('29.97'))

    def test_fraction_type_does_not_choose_the_intended_rate(self):
        self.assertNotEqual(frame_time(30000,F('29.97')),frame_time(30000,F(30000,1001)))

    def test_float_seconds_rejected_by_inverse(self):
        with self.assertRaises(ValueError):frame_at(0.5,F(30))

    def test_negative_seconds_rejected_by_inverse(self):
        with self.assertRaises(ValueError):frame_at(F(-1),F(30))

    def test_float_rate_rejected_by_inverse(self):
        with self.assertRaises(ValueError):frame_at(F(1),30.0)
```

### test_roundtrip.py

```
from fractions import Fraction as F
import unittest
from frame_clock import frame_time,frame_at

RATES=[F(24),F(30),F(30000,1001)]
INDICES=[0,1,2,29,30000]

class RoundTripTests(unittest.TestCase):
    def test_exact_starts_return_their_indices(self):
        for rate in RATES:
            for index in INDICES:
                with self.subTest(rate=rate,index=index):
                    self.assertEqual(frame_at(frame_time(index,rate),rate),index)

    def test_half_interval_still_belongs_to_same_index(self):
        for rate in RATES:
            for index in INDICES:
                with self.subTest(rate=rate,index=index):
                    halfway=frame_time(index,rate)+F(1,2)/rate
                    self.assertEqual(frame_at(halfway,rate),index)
```

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

## المصادر

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