Generuj pliki testowe o zadanym rozmiarze

Problem

Zrobić jeden plik testowy jest łatwo. Zrobić właściwy tysiąc to już robota

Testujesz oprogramowanie, które przyjmuje pliki od ludzi. Prędzej czy później potrzebujesz:

• PDF-a o rozmiarze dokładnie 10 MB, żeby sprawdzić, czy limit uploadu naprawdę działa
• trzech plików po obu stronach tego limitu, żeby złapać błąd o jeden
• 10 000 plików logów, żeby zobaczyć, co nocne zadanie zrobi z dużym katalogiem
• ZIP-a, który naprawdę zawiera 200 dokumentów, a nie zaślepki z właściwym rozszerzeniem
• pliku 4 GB, bez trzymania pliku 4 GB w repozytorium
• tych samych danych testowych na laptopie i na serwerze budującym, co do bajta

To właśnie zastępuje. Powstało dla inżynierów QA, automatyzacji testów i każdego, kogo kod ma za sobą formularz uploadu, import danych, parser albo limit miejsca.

Czym to się wyróżnia

Inne generatory kończą na bajtach. Ten odpowiada na pytanie, które naprawdę zadaje test

Katalog plików zostawia Cię z decyzją, co każdy z nich ma właściwie udowodnić. Tutaj każdy przebieg zapisuje obok plików manifest.json - zwykłą listę wszystkiego, co powstało, a przy każdej pozycji zadeklarowane oczekiwanie.

Załóżmy, że Twój endpoint przyjmuje 1 MB. Poproś o trzy pliki leżące na tej granicy:

tfg generate --preset size-boundaries --limit 1mb --spread 1B --format pdf --out ./edges

Trzy pliki, trzy różne odpowiedzi, w postaci czytelnej dla maszyny. Test czyta manifest, zamiast żebyś pisał asercje ręcznie:

import json, os

directory = "edges"
manifest = json.load(open(os.path.join(directory, "manifest.json")))

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

Presety

Wybierz pytanie, dostań cały zestaw

Preset to zestaw plików testowych zaprojektowany wokół jednego pytania testowego, więc nie musisz sam ustalać, który plik czego dowodzi. Każdy ma stronę, która mówi, co zwykle znajduje, co jest w zestawie i jakie ustawienia przyjmuje.

• Pliki puste i minimalne

  Czy plik poprawny i najmniejszy, na jaki format pozwala, przechodzi?

  empty-and-minimal

• Obsługa nazw plików

  Czy mój system zapisze, pokaże i odda nazwę pliku, której się nie spodziewał?

  filename-handling

• Granice rozmiaru

  Czy limit rozmiaru działa dokładnie tam, gdzie jest zadeklarowany?

  size-boundaries

• Import tabel

  Czy import tabeli poradzi sobie z tym, co eksportują prawdziwe narzędzia?

  tabular-import

• Kodowanie tekstu

  Czy mój czytnik wie, w jakim kodowaniu jest plik, czy zgaduje?

  text-encoding

• Walidacja uploadu

  Czy mój formularz przesyłania plików przyjmuje to, co powinien, i odrzuca resztę?

  upload-validation

Wszystkie presety i to, jak mają się do przepisów

Szybki start

Trzy polecenia, żeby zobaczyć, jak to działa

1. Zrób plik

   Jeden PNG, dokładnie dwa megabajty:

   tfg generate --format png --size 2mb --out ./fixtures

2. Zrób dużo plików

   Dziesięć tysięcy plików logów, każdy od jednego do ośmiu kilobajtów, z rozmiarami losowanymi z ziarna, więc jutro dostaniesz ten sam zestaw. Każdy przebieg dostaje własny katalog - manifest jest jedynym zapisem tego, co przebieg zapisał, więc narzędzie odmawia nadpisania go drugim:

   tfg generate --format log --size-range 1kb-8kb --count 10000 --out ./logs

3. Sprawdź je, a potem usuń

   verify mówi, że nic się nie ruszyło. cleanup usuwa dokładnie to, co zostało zapisane, i nic poza tym:

   tfg verify ./logs/manifest.json
   tfg cleanup ./logs/manifest.json --yes

Rozmiary liczą się po 1024, tak jak pokazuje je menedżer plików, więc 2mb znaczy 2097152 bajty. Zwykła liczba bajtów też zadziała. Dokumentacja opisuje przepisy, manifest i kody wyjścia.

Co dostajesz

Zbudowane pod zestaw, który chodzi bez nadzoru

• Dokładny rozmiar, co do bajta

  Poproś o 10485761 bajtów i tyle dostaniesz. Rozmiar nieosiągalny dla formatu to błąd z powodem, nigdy plik o innym rozmiarze.

• 30 prawdziwych formatów

  Nie zera z doklejonym rozszerzeniem. Wygenerowany PNG otwiera się w przeglądarce obrazów, DOCX w Wordzie, a ZIP się rozpakowuje. Każdy format jest sprawdzany niezależnym czytnikiem, zanim trafi do wydania.

• Manifest, który jest wyrocznią testu

  Ścieżka, rozmiar, SHA-256, format, ziarno, wersja narzędzia - i to, co system ma z plikiem zrobić.

• Powtarzalność

  Ten sam przepis i ziarno dają te same bajty na każdej maszynie. Commituj mały przepis YAML zamiast dużych plików binarnych.

• Dwie powierzchnie, jeden silnik

  Wiersz poleceń zrobiony pod CI i okno do testów eksploracyjnych. Żadne nie jest okrojoną wersją drugiego, a test porównuje je możliwość po możliwości.

• Całkowicie offline

  Bez konta, bez chmury, bez telemetrii, bez sprawdzania aktualizacji. Binarka wiersza poleceń nie ma w ogóle wkompilowanej obsługi sieci.

Pobieranie

Wybierz wersję dla swojego systemu

Rozpakuj archiwum i uruchom. tfg to wiersz poleceń, a tfg-gui to okno. Nie ma instalatora i nie trzeba niczego dokładać do systemu.

Darmowe i otwarte, GPL-3.0. Bez zakładania konta. Pliki dla Windows i macOS są podpisane i uruchamiają się bez ostrzeżenia.