Testing Files Generator
Français

Questions fréquentes

Licence, vie privée, reproductibilité et ce que les gens vérifient avant de mettre un générateur dans un pipeline de build. Si votre question n'est pas ici, le suivi des tickets est ouvert.

En quoi est-ce différent de dd, fsutil ou truncate ?

Ces commandes donnent un fichier de la bonne taille rempli de rien. Un fichier de 2 Mo nommé photo.png fabriqué ainsi n'est pas un PNG, donc tout ce qui l'analyse vraiment le refuse pour la mauvaise raison, et votre test réussit alors lui aussi pour la mauvaise raison. Cet outil produit un vrai PNG d'exactement 2 Mo, qui s'ouvre dans une visionneuse d'images, accompagné d'une déclaration sur la façon dont votre système doit le traiter.

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

Est-ce gratuit, et puis-je l'utiliser au travail ?

Oui aux deux. Il est publié sous GPL-3.0 et ne coûte rien. Il n'y a ni compte, ni clé de licence, ni offre payante.

Puis-je utiliser les fichiers générés dans un produit propriétaire ?

Oui. La licence couvre le code de l'outil, pas ce qu'il produit. Les fichiers, recettes et manifestes générés sont une sortie et non des œuvres dérivées, vous pouvez donc les commiter et les livrer sans aucune obligation.

Les fichiers générés contiennent-ils de vraies données personnelles ?

Non. Tout ce qu'ils contiennent est synthétisé à partir d'une graine. Aucun jeu de données n'est lu, aucun service n'est contacté et aucun contenu tiers n'est intégré. Considérez une adresse e-mail générée comme inutilisable plutôt que comme inutilisée, car n'importe quelle chaîne aléatoire peut coïncider par hasard avec une vraie.

Obtiendrai-je exactement les mêmes fichiers sur une autre machine ?

Oui, à l'octet près, avec la même recette et la même graine. Le projet le teste à chaque modification, et le casser exige un changement de version majeure. C'est ce qui vous permet de commiter une petite recette plutôt que de gros fixtures binaires.

Faut-il une connexion internet ?

Jamais. Il n'y a ni télémétrie, ni vérification de mises à jour, ni client cloud, et le binaire en ligne de commande n'a aucune pile réseau compilée dedans. Il fonctionne sur une machine sans réseau et dans un environnement d'entreprise fermé.

Que se passe-t-il si je demande une taille qu'un format ne peut pas atteindre ?

Vous obtenez une erreur qui nomme le format, la taille minimale possible, la raison de ce plancher et ce qu'il faut faire à la place, et aucun fichier n'est écrit. L'outil n'arrondit jamais une taille en silence. Chaque plancher est listé sur la page des formats.

tfg formats png

Puis-je générer un fichier volontairement cassé ?

Oui. Ajoutez --damage zero-head et le fichier sort à la taille exacte demandée, avec ses premiers octets écrasés par des zéros, si bien qu'un lecteur le refuse, et le manifeste dit que votre système doit le rejeter. La page sur les fichiers de test corrompus donne le détail.

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

Quels formats arrivent ensuite ?

7z, mp3 et mp4. 26 formats fonctionnent de bout en bout aujourd'hui.

Sur quels systèmes puis-je l'exécuter ?

La ligne de commande fonctionne sous Windows et Linux, sur Intel comme sur ARM, et sur les Mac Apple silicon. La fenêtre de bureau est fournie pour Windows sur Intel, Linux sur Intel et les Mac Apple silicon. Les Mac Intel ne sont pas pris en charge et rien n'est construit pour eux.

Dois-je installer quelque chose ?

Non. Téléchargez l'archive de votre système, décompressez-la et lancez le binaire. Il n'y a pas d'installateur, pas d'environnement d'exécution à ajouter et pas de dépendance à résoudre. Si vous avez Go, une seule commande go install fonctionne aussi.

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

Pourquoi une exécution sur des milliers de fichiers est-elle plus lente sous Windows ?

Parce que Windows facture plus cher chaque chemin qu'il examine, et une commande qui parcourt des milliers de fichiers examine des milliers de chemins. Mesuré sur une machine avec 3000 fichiers de 1 ko, verify prend environ 0,9 seconde sous Windows et environ 0,2 seconde sous Linux dans un conteneur. Un chemin de sortie plus court réduit le chiffre de Windows, car chaque dossier au-dessus des fichiers fait partie de ce qui est examiné.

Encore indécis ?

La page des cas d'usage montre les tâches pour lesquelles il est conçu, et la page des formats liste chaque format avec le plus petit fichier qu'il peut produire. Le README du dépôt est la référence complète.

Gratuit et open source, GPL-3.0. Aucune inscription. Les téléchargements Windows et macOS sont signés et démarrent sans avertissement.