Testing Files Generator
Română

Cum faci un fișier corupt pentru teste

Un validator căruia i s-au arătat doar fișiere sănătoase nu a fost cu adevărat testat. Iată cum obții un fișier stricat intenționat, care iese cu exact mărimea pe care o ceri și vine cu un manifest care spune ce trebuie să facă sistemul tău cu el.

Răspunsul scurt

tfg generate --format png --size 2mb --damage zero-head --out ./out scrie un PNG de exact 2097152 de octeți ai cărui primi octeți sunt zerouri, iar manifestul de lângă el notează că sistemul tău trebuie să îl respingă.

Calea obișnuită

De ce un fișier corupt de mână face un test prost

Căile obișnuite sunt un editor hexazecimal, un script care schimbă câțiva octeți la întâmplare sau un fișier scurtat cu head ori truncate. Merg o dată, apoi te costă:

Ce primești

Un fișier deteriorat are în continuare mărimea cerută

Fișierul este generat normal și stricat după aceea, pe drumul spre disc. Păstrează mărimea cerută, iar aceeași comandă scrie din nou aceiași octeți.

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

Setările se scriu după două puncte. Opțiunea poate fi repetată, iar deteriorările se aplică în ordinea în care le scrii. Funcționează cu fiecare dintre cele 32 formate.

Ce poate face

Ce deteriorări există?

Aceasta este lista pe care o afișează programul, citită din el când se construiește pagina. tfg damage o afișează pe aceeași, iar tfg damage <id> spune ce primește una dintre ele.

Deteriorare Ce face cu octeții Cel mai mic fișier Setări
append-junk Scrie octeți aleatori după sfârșitul fișierului și păstrează exact dimensiunea cerută, așa cum sosește un fișier cu ceva lipit la capăt. 64 bytes
truncate Taie sfârșitul fișierului și păstrează exact dimensiunea cerută, așa cum îl lasă o încărcare sau o copiere întreruptă. 4 missing
zero-head Suprascrie cu zerouri primii octeți ai fișierului, fără să îi schimbe lungimea. Majoritatea cititorilor se uită întâi acolo, deci aproape orice observă această deteriorare. 8 bytes

zero-head scrie zerouri peste începutul fișierului. Majoritatea cititorilor se uită întâi acolo, la semnătura și antetul care spun ce este fișierul, așa că aproape orice cititor observă. Textul simplu și jurnalele nu au semnătură și sunt respinse și ele, pentru că un șir de octeți nuli nu este text. Sub patru octeți, unele formate ies cu o deteriorare de care nu se plânge niciun cititor, de aceea setarea începe de la patru.

truncate taie sfârșitul fișierului, așa cum îl lasă o încărcare sau o copiere întreruptă, iar fișierul are totuși dimensiunea cerută: este generat mai mare și doar începutul lui ajunge pe disc. missing spune ce parte din fișierul întreg lipsește, jumătate dacă nu spui altceva.

append-junk scrie octeți aleatori după sfârșitul fișierului, 64 dacă nu spui altceva, așa cum sosește un fișier cu ceva lipit la capăt. Aceeași comandă adaugă aceiași octeți.

Ce spune manifestul

Un manifest care spune ce trebuie să se întâmple

Acolo unde deteriorarea încalcă regulile formatului, intrarea spune că sistemul tău trebuie să îl respingă, cu deteriorarea notată alături:

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

Acolo unde cititorii diferă, intrarea spune asta în loc să ghicească. Un fișier text tăiat rămâne text, iar majoritatea vizualizatoarelor sar peste octeții de după sfârșitul unui PNG, așa că intrarea lasă răspunsul sistemului tău, le oferă pe amândouă și spune de ce:

"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> enumeră formatele în care o deteriorare lasă răspunsul sistemului tău, și de ce.

Patru cereri sunt refuzate înainte să se scrie ceva, pentru că fiecare ar lăsa pe disc un fișier pe care manifestul îl descrie greșit:

Într-o rețetă

Fișiere sănătoase și stricate într-o singură rulare

Pune-le pe amândouă într-o rețetă, iar manifestul poartă așteptarea fiecărui fișier, deci testul nu are nevoie de o listă cu care este care:

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

Într-un test

Transformarea într-un test

Testul citește manifestul și verifică dacă ce s-a întâmplat este ce s-a declarat. Nu are nevoie de o listă de nume de fișiere:

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

Un fișier al cărui rezultat este unspecified este lăsat deoparte aici, pentru că ce trebuie să facă sistemul tău cu el ține de propria ta politică. Intrarea lui spune de ce, iar policy_options enumeră răspunsurile posibile.

O respingere bună este una curată. Un mesaj care spune ce a fost greșit este răspunsul pe care îl vrei. O eroare de server, o blocare sau un fișier salvat pe jumătate este defectul pe care acest test există ca să îl găsească.

Mai departe

Unde să mergi de aici