Testing Files Generator
العربية

كيف تصنع ملفًا تالفًا للاختبار

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

الجواب المختصر

tfg generate --format png --size 2mb --damage zero-head --out ./out يكتب ملف PNG حجمه 2097152 بايتًا بالضبط، وبايتاته الأولى أصفار، ويسجّل البيان المجاور له أن نظامك ينبغي أن يرفضه.

الطريقة المعتادة

لماذا يُعدّ الملف المتلف يدويًا اختبارًا رديئًا

الطرق المعتادة هي محرر سداسي عشري، أو سكربت يقلب بضع بايتات عشوائية، أو قصّ الملف بـ head أو truncate. تنجح مرة واحدة، ثم تكلّفك:

ما تحصل عليه

الملف التالف يبقى بالحجم الذي طلبته

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

tfg generate --format png --size 2mb --damage zero-head --out ./out
tfg generate --format pdf --size 1mb --count 5 --damage zero-head:bytes=16 --out ./broken
tfg generate --format zip --size 5mb --damage truncate:missing=30 --out ./cut
tfg generate --format jpg --size 500kb --damage append-junk --out ./tail

تُكتب الإعدادات بعد النقطتين. يمكن تكرار الخيار، وتُطبَّق أنواع التلف بالترتيب الذي تكتبه. ويعمل مع كل واحدة من 32 صيغة.

ما الذي يستطيعه

ما أنواع التلف المتاحة؟

هذه هي القائمة التي يطبعها البرنامج، وتُقرأ منه عند بناء هذه الصفحة. يطبع tfg damage القائمة نفسها، ويبيّن tfg damage <id> ما يقبله واحد منها.

التلف ما يفعله بالبايتات أصغر ملف الإعدادات
append-junk يكتب بايتات عشوائية بعد نهاية الملف ويحافظ على الحجم الذي طلبته بالضبط، كما يصل ملف التصق شيء بنهايته. 64 bytes
truncate يقطع نهاية الملف ويحافظ على الحجم الذي طلبته بالضبط، كما يتركه رفع أو نسخ انقطع في منتصفه. 4 missing
zero-head يكتب أصفارًا فوق أول بايتات الملف دون المساس بطوله. معظم القارئات تنظر إلى هناك أولًا، فيلاحظ هذا التلف كل شيء تقريبًا. 8 bytes

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

truncate يقطع نهاية الملف، كما يتركه رفع أو نسخ انقطع في منتصفه، ويبقى الملف بالحجم الذي طلبته: يُولَّد أكبر ولا يصل إلى القرص إلا أوله. ويقول missing أي جزء من الملف كله يضيع، النصف ما لم تحدد غير ذلك.

append-junk يكتب بايتات عشوائية بعد نهاية الملف، 64 ما لم تحدد غير ذلك، كما يصل ملف التصق شيء بنهايته. والأمر نفسه يضيف البايتات نفسها.

ما يقوله البيان

بيان يقول ما ينبغي أن يحدث

حيث يخرق التلف قواعد الصيغة، يقول المدخل إن نظامك ينبغي أن يرفضه، ويُسجَّل التلف بجانبه:

"expected": {
  "outcome": "reject",
  "reason": "content_malformed",
  "confidence": "certain"
},
"damage": [
  {
    "type": "zero-head",
    "settings": {
      "bytes": "8"
    }
  }
]

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

"expected": {
  "outcome": "unspecified",
  "reason": "content_malformed",
  "detail": "A PNG ends at its IEND chunk and most viewers skip what follows it.",
  "confidence": "policy_dependent",
  "policy_options": ["accept", "reject"]
}

يسرد tfg damage <id> الصيغ التي يترك فيها التلف الجواب لنظامك، مع السبب.

تُرفض أربعة طلبات قبل أن يُكتب أي شيء، لأن كلًّا منها سيترك على القرص ملفًا يصفه البيان وصفًا خاطئًا:

في وصفة

ملفات سليمة وتالفة في تشغيل واحد

ضع الاثنين في وصفة واحدة، فيحمل البيان المتوقَّع لكل ملف، ولا يحتاج الاختبار إلى قائمة تقول أيها أيّ:

version: 1
targets:
  - id: healthy
    format: pdf
    size: 1mb
    expected: accept
  - id: broken
    format: pdf
    size: 1mb
    damage:
      - zero-head

في اختبار

تحويله إلى اختبار

يقرأ الاختبار البيان ويتحقق من أن ما حدث هو ما أُعلن. لا يحتاج إلى قائمة بأسماء الملفات:

import json, os

directory = "healthy-and-broken"
manifest = json.load(open(os.path.join(directory, "manifest.json")))

for entry in manifest["files"]:
    outcome = entry["expected"]["outcome"]
    if outcome == "unspecified":
        continue
    response = upload(os.path.join(directory, entry["path"]))
    if outcome == "reject":
        assert not response.ok
    else:
        assert response.ok

يُستبعد هنا الملف الذي نتيجته unspecified، لأن ما ينبغي لنظامك أن يفعله به هو سياستك أنت. ومدخله يقول السبب، وpolicy_options يسرد الأجوبة الممكنة.

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

التالي

إلى أين من هنا