Test için bozuk dosya nasıl yapılır
Yalnızca sağlam dosyalar gösterilmiş bir doğrulayıcı gerçekten sınanmış sayılmaz. İşte kasıtlı bozulmuş, tam istediğiniz boyutta çıkan ve sisteminizin onunla ne yapması gerektiğini söyleyen bir bildirimle gelen bir dosyayı nasıl elde edeceğiniz.
Kısa yanıt
tfg generate --format png --size 2mb --damage zero-head --out ./out tam 2097152 bayt
boyutunda, ilk baytları sıfır olan bir PNG yazar ve yanındaki bildirim sisteminizin onu
reddetmesi gerektiğini kaydeder.
Olağan yol
Elle bozulmuş bir dosya neden kötü bir testtir
Olağan yollar bir onaltılık düzenleyici, birkaç rastgele baytı çeviren bir betik ya da bir dosyayı
head veya truncate ile kısaltmaktır. Bir kez işe yarar, sonra size
pahalıya mal olur:
- Her seferinde farklıdır. Rastgele bir bayt her çalıştırmada başka bir yere düşer, bu yüzden salı günkü bir hata çarşamba dönmeyebilir.
- Boyutu değiştirir. Kesilmiş bir dosya, altında kalması gereken sınırdan küçüktür. Böylece boyut denetimi içerik denetiminden önce yanıt verir ve test yanlış nedenle geçer.
- Çoğu zaman fark edilmez. Düz metin ortasında değişmiş bir baytla da okunur, hoşgörülü bir görüntü okuyucusu ise onu olduğu gibi çizer. Böylece bozuk olması gereken dosya kabul edilir.
- Ne olması gerektiğini söylemez. Dosya yalnızca bayttır ve testi sonradan okuyan, kabulün mü reddin mi amaçlandığını tahmin etmek zorunda kalır.
Ne elde edersiniz
Hasarlı bir dosya yine istediğiniz boyuttadır
Dosya normal üretilir, sonra diske giderken bozulur. İstediğiniz boyutu korur ve aynı komut yine aynı baytları yazar.
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
Ayarlar iki noktadan sonra yazılır. Seçenek tekrarlanabilir ve hasarlar yazdığınız sırayla uygulanır. 32 biçimin her biriyle çalışır.
Neler yapabilir
Hangi hasarlar var?
Bu, programın yazdırdığı listedir ve bu sayfa oluşturulurken programdan okunur. tfg
damage aynısını yazdırır, tfg damage <id> ise birinin neyi kabul
ettiğini söyler.
| Hasar | Baytlara ne yapar | En küçük dosya | Ayarlar |
|---|---|---|---|
append-junk |
Dosyanın sonundan sonra rastgele baytlar yazar ve istediğiniz boyutu tam olarak korur, tıpkı sonuna bir şey yapışmış bir dosyanın gelişi gibi. | 64 | bytes |
truncate |
Dosyanın sonunu keser ve istediğiniz boyutu tam olarak korur, tıpkı yarıda kalan bir yüklemenin ya da kopyalamanın bıraktığı gibi. | 4 | missing |
zero-head |
Dosyanın ilk baytlarını uzunluğuna dokunmadan sıfırlarla ezer. Okuyucuların çoğu önce oraya bakar, bu yüzden hemen her şey bu hasarı fark eder. | 8 | bytes |
zero-head dosyanın başına sıfırlar yazar. Okuyucuların çoğu önce oraya bakar, dosyanın
ne olduğunu söyleyen imzaya ve başlığa, bu yüzden hemen her okuyucu fark eder. Düz metin ve
günlüklerin imzası yoktur ve onlar da reddedilir, çünkü bir sıfır baytı dizisi metin değildir.
Dört baytın altında bazı biçimler hiçbir okuyucunun şikâyet etmediği bir hasarla çıkar, ayarın
dörtten başlamasının nedeni budur.
truncate dosyanın sonunu keser, tıpkı yarıda kalan bir yüklemenin ya da
kopyalamanın bıraktığı gibi, ve dosya yine de istediğiniz boyuttadır: daha büyük üretilir ve
diske yalnızca başı ulaşır. missing, dosyanın tamamının ne kadarının kaybolduğunu
söyler, başka bir şey belirtmezseniz yarısı.
append-junk dosyanın sonundan sonra rastgele baytlar yazar, başka bir şey
belirtmezseniz 64, tıpkı sonuna bir şey yapışmış bir dosyanın gelişi gibi. Aynı komut aynı
baytları ekler.
Bildirim ne söyler
Ne olması gerektiğini söyleyen bir bildirim
Hasarın biçimin kurallarını çiğnediği yerde kayıt, sisteminizin dosyayı reddetmesi gerektiğini söyler ve hasar yanına yazılır:
"expected": {
"outcome": "reject",
"reason": "content_malformed",
"confidence": "certain"
},
"damage": [
{
"type": "zero-head",
"settings": {
"bytes": "8"
}
}
]
Okuyucuların ayrıştığı yerde kayıt, tahmin yürütmek yerine bunu söyler. Kesilmiş bir metin dosyası yine metindir ve çoğu görüntüleyici bir PNG'nin sonundan sonraki baytları atlar, bu yüzden kayıt yanıtı sisteminize bırakır, ikisini de sunar ve nedenini söyler:
"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>, bir hasarın yanıtı sisteminize bıraktığı biçimleri nedeniyle
birlikte listeler.
Dört istek, bir şey yazılmadan önce reddedilir, çünkü her biri diskte bildirimin yanlış tarif ettiği bir dosya bırakırdı:
- hasarın gerektirdiğinden küçük bir dosya, ki değişmeden çıkardı
-
Biçimin kurallarını çiğneyen bir hasarın yanında
expected: accept, çünkü bu kurallara uyan hiçbir şey dosyayı kabul etmez. Yanıtın sisteminize bağlı olduğu yerdeacceptserbesttir. Sisteminiz dosyayı onarmalıysasanitize, tam da bunu soruyorsanızunspecifiedyazın -
append-junksonrasındatruncate, çünkü eklenen baytları keserdi.truncateöğesini başa koyun -
İçeriğinden boyut alan bir arşivde
truncateya daappend-junk, çünkü yola çıkılacak bir boyut yoktur
Bir tarifte
Tek çalıştırmada sağlam ve bozuk dosyalar
İkisini de tek bir tarife koyun, bildirim her dosyanın beklentisini taşır. Böylece testin hangisinin hangisi olduğuna dair bir listeye ihtiyacı kalmaz:
version: 1
targets:
- id: healthy
format: pdf
size: 1mb
expected: accept
- id: broken
format: pdf
size: 1mb
damage:
- zero-head
Bir testte
Bunu bir teste dönüştürmek
Test bildirimi okur ve olanın bildirilenle aynı olup olmadığına bakar. Dosya adı listesine ihtiyacı yoktur:
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
Sonucu unspecified olan bir dosya burada atlanır, çünkü sisteminizin onunla ne
yapması gerektiği kendi politikanıza bağlıdır. Kaydı nedenini söyler,
policy_options ise olası yanıtları listeler.
İyi bir ret temiz bir rettir. Neyin yanlış olduğunu söyleyen bir ileti istediğiniz yanıttır. Sunucu hatası, takılma ya da yarım kaydedilmiş dosya, bu testin bulmak için var olduğu kusurdur.
Sonraki
Buradan nereye gidilir
- upload-validation hazır ayarı bir forma diğer iki soruyu sorar, boyutu ve türü.
- CI'da test dosyaları böyle bir tarifi bir hatta çalıştırır.
-
Belgeler
tfg generateiçin her seçeneği içerir.