Testing Files Generator
Čeština

Často kladené otázky

Licence, soukromí, opakovatelnost a věci, které lidé ověřují, než generátor zařadí do build pipeline. Pokud tu vaše otázka není, sledování issues je otevřené.

Čím se to liší od dd, fsutil nebo truncate?

Ty vám dají soubor správné velikosti plný ničeho. Soubor o 2 MB pojmenovaný photo.png vytvořený takto není PNG, takže ho cokoli, co ho skutečně zpracovává, odmítne z nesprávného důvodu a váš test pak projde také z nesprávného důvodu. Tohle vytvoří skutečné PNG o přesně 2 MB, které se otevře v prohlížeči obrázků, a přichází s prohlášením, jak s ním má váš systém naložit.

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

Je to zdarma a mohu to používat v práci?

Ano k obojímu. Je vydáno pod GPL-3.0 a nestojí nic. Není tu účet, licenční klíč ani placená úroveň.

Mohu generované soubory použít v produktu s uzavřeným zdrojovým kódem?

Ano. Licence se vztahuje na kód nástroje, ne na to, co nástroj vytváří. Generované soubory, recepty a manifesty jsou výstup, nikoli odvozená díla, takže je můžete commitovat a dodávat bez jakékoli povinnosti.

Obsahují generované soubory skutečné osobní údaje?

Ne. Vše uvnitř je syntetizováno ze seedu. Nečte se žádný datový soubor, nekontaktuje se žádná služba a nevkládá se obsah třetích stran. Vygenerovanou e-mailovou adresu považujte za nepoužitelnou, ne za nepoužitou, protože libovolný náhodný řetězec se může shodou okolností shodovat se skutečným.

Dostanu na jiném počítači přesně stejné soubory?

Ano, bajt po bajtu, při stejném receptu a stejném seedu. Projekt to testuje při každé změně a porušit to vyžaduje novou hlavní verzi. Díky tomu můžete commitovat malý recept místo velkých binárních fixtures.

Potřebuje připojení k internetu?

Nikdy. Není tu telemetrie, kontrola aktualizací ani cloudový klient a do binárky příkazového řádku není zkompilován žádný síťový zásobník. Funguje na počítači bez sítě i v uzavřeném firemním prostředí.

Co se stane, když požádám o velikost, které formát nedosáhne?

Dostanete chybu, která pojmenuje formát, nejmenší možnou velikost, důvod tohoto minima a co dělat místo toho, a nezapíše se žádný soubor. Nástroj nikdy velikost mlčky nezaokrouhlí. Každé minimum je uvedeno na stránce formátů.

tfg formats png

Mohu vygenerovat soubor, který je záměrně rozbitý?

Ano. Přidejte --damage zero-head a soubor vyjde v přesně požadované velikosti, s prvními bajty přepsanými nulami, takže ho čtečka odmítne, a manifest říká, že ho má váš systém odmítnout. Podrobnosti jsou na stránce o poškozených testovacích souborech.

tfg generate --format png --size 2mb --damage zero-head --out ./out

Které formáty přijdou dál?

7z, mp3 a mp4. Dnes funguje od začátku do konce 26 formátů.

Na kterých systémech to mohu spustit?

Příkazový řádek běží na Windows a Linuxu na Intelu i ARM a na Macích s Apple Silicon. Desktopové okno se dodává pro Windows na Intelu, Linux na Intelu a Macy s Apple Silicon. Intel Macy nejsou podporovány a nic se pro ně nesestavuje.

Musím něco instalovat?

Ne. Stáhněte archiv pro svůj systém, rozbalte ho a spusťte binárku. Není tu instalátor, běhové prostředí k doplnění ani závislost k vyřešení. Pokud máte Go, funguje i jediný příkaz go install.

go install github.com/donislawdev/TestingFilesGenerator/cmd/tfg@latest

Proč je běh nad tisíci soubory na Windows pomalejší?

Protože Windows si účtuje víc za každou cestu, na kterou se podívá, a příkaz, který prochází tisíce souborů, se dívá na tisíce cest. Změřeno na jednom počítači s 3000 soubory po 1 kB: verify trvá na Windows asi 0,9 sekundy a na Linuxu v kontejneru asi 0,2 sekundy. Kratší výstupní cesta číslo na Windows zmenší, protože každá složka nad soubory je součástí toho, na co se dívá.

Ještě se rozhodujete?

Stránka případů použití ukazuje úlohy, pro které je určen, a stránka formátů uvádí každý formát s nejmenším souborem, který umí vytvořit. README v repozitáři je úplná reference.

Zdarma a open source, GPL-3.0. Žádná registrace. Stažené soubory pro Windows a macOS jsou podepsané a spustí se bez varování.