20 formatów plików, każdy generowany o dokładnym rozmiarze

Co znaczą kolumny

• Najmniejszy plik

  Najmniejsza liczba bajtów, jaką narzędzie przyjmie dla tego formatu, razem z etykietą, którą zapisuje w środku pliku. Poproś o mniej, a dostaniesz błąd nazywający to ograniczenie i jego powód, nigdy plik o innym rozmiarze.

• Wierność

  Jak kompletny jest plik. full znaczy, że czytnik naprawdę parsujący ten format przyjmuje plik, a nie tylko że zgadza się rozszerzenie.

• Sprawdzany przez

  Niezależny czytnik, który otwiera każdy wygenerowany plik, zanim format trafi do wydania - inna implementacja, a nie nasz własny kod oceniający własną pracę.

Każdy format powtarza się też co do bajta: ten sam przepis i ziarno dają identyczne pliki na dowolnej maszynie, i właśnie dlatego przepis można bezpiecznie commitować zamiast samych danych testowych.

Ustawienia, które przyjmuje każdy format

Większość formatów ma własne ustawienia - wymiary obrazu, jakość JPEG, liczbę stron PDF, wiersze i kolumny arkusza, liczbę wpisów w archiwum. Podajesz je przez --set klucz=wartość w wierszu poleceń albo pod properties: w przepisie.

tfg generate --format jpg --size 500kb --set width=1920 --set height=1080 --set quality=85

Wartość spoza tego, co ustawienie przyjmuje, jest odrzucana komunikatem nazywającym ustawienie, dozwolony zakres i to, czego użyć zamiast tego. Nieznane ustawienie też jest błędem, nigdy cichym pominięciem - literówka przyjęta w milczeniu daje plik z niewłaściwymi ustawieniami i godzinę zastanawiania się, czemu test przechodzi, choć nie powinien.

Uruchom tfg formats <id>, żeby zobaczyć, co dokładnie przyjmuje jeden format w wersji, którą masz.

Archiwa zawierają prawdziwe pliki

targz oraz zip można wypełnić wpisami, zamiast zostawiać jako pustą skorupę. Wygenerowane archiwum naprawdę zawiera dokumenty, o których mówi, więc cokolwiek rozpakowuje je w trakcie testu, znajduje w środku prawdziwe pliki.

targets:
  - id: bundle
    format: zip
    contains:
      - format: txt
        count: 200
        size: 4kb

Formaty, których jeszcze nie ma

7z, tiff, webp, mp3 i mp4 są zaplanowane i niezbudowane. Nie ma ich na liście wyżej, zamiast być obecne i działać połowicznie, a poproszenie o któryś kończy się błędem mówiącym, że format jest nieznany.

Jeśli potrzebujesz któregoś z nich albo formatu, którego nie ma na żadnej z tych list, zgłoszenia są miejscem, gdzie się o tym decyduje.