Generator danych testowych

Generator danych testowych do API, formularza i bazy

Generator danych testowych tworzy syntetyczne rekordy osób z wybranym zestawem pól i eksportuje je jako JSON, CSV, polecenia MySQL INSERT albo proste linie. Możesz podać seed, aby odtworzyć identyczną sekwencję w kolejnym przebiegu, albo wygenerować nowy losowy seed i zachować go wraz z fixture.

Narzędzie korzysta z przygotowanych pul polskich imion, nazwisk, miast i neutralnych nazw firm. Adres e-mail jest budowany z transliterowanego imienia i nazwiska oraz wskazanej domeny, telefon ma przykładowy format +48, a UUID spełnia układ wersji 4. Rekordy są fikcyjne: mogą przypadkiem przypominać istniejącą osobę, ale nie pochodzą z rejestru ani bazy użytkowników.

Jak wybrać pola i rozmiar zestawu

Preset minimalny pozostawia imię, nazwisko i e-mail. Preset pełny włącza dodatkowo telefon, miasto, kod pocztowy, firmę, datę oraz UUID. Każde pole można później odznaczyć osobno. Limit wynosi od 1 do 1000 rekordów i chroni przeglądarkę przed niepotrzebnie dużym wynikiem; do jednostkowego testu walidacji zwykle wystarczy kilka wierszy, a do prototypu listy kilkadziesiąt.

Klucze techniczne są stabilne i angielskie: first_name, last_name, email, phone, city, postal_code, company, date i uuid. Dzięki temu jeden fixture łatwiej wykorzystać w kodzie niezależnie od języka interfejsu. Gdy potrzebujesz wyłącznie identyfikatorów, skorzystaj z generatora UUID lub krótszych wartości z generatora NanoID.

Formaty JSON, CSV, SQL i linie

JSON zachowuje polskie znaki i jest najwygodniejszy, gdy rekord trafia bezpośrednio do klienta API. CSV używa średnika i standardowego mechanizmu cytowania: przecinek, apostrof albo spacja nie psują struktury, a pole zawierające średnik lub nową linię otrzymuje cudzysłowy. Jeżeli potrzebujesz wyspecjalizowanej próbki tylko dla CSV, porównaj wynik z generatorem testowych danych CSV.

SQL i bezpieczne literały

Eksport SQL generuje osobne polecenie INSERT dla każdego rekordu. Nazwa tabeli jest ograniczana do liter, cyfr i podkreśleń, ma maksymalnie 64 znaki i zostaje ujęta w backticki. W wartościach podwajane są apostrofy, a backslash, bajt zerowy, nowa linia, powrót karetki i Control-Z są escapowane zgodnie z zachowaniem MySQL. Serializer potrafi również wyemitować prawdziwe NULL, liczbę i wartość logiczną, choć standardowy zestaw generatora składa się głównie z tekstu.

Eksport celuje w MySQL, ponieważ używa backticków. PostgreSQL i SQLite mogą wymagać zmiany cytowania identyfikatorów. Generator nie tworzy tabeli, indeksów ani ograniczeń i nie gwarantuje unikalności e-maili — losowe kombinacje w zestawie do 1000 rekordów mogą się powtórzyć. Unikalność wymaganą przez test należy sprawdzić lub nadać w warstwie fixture.

Seed, powtarzalność i granice losowości

Seed inicjuje generator pseudolosowy. Ten sam całkowity seed, ten sam wybór pól i ta sama wersja środowiska dają identyczny wynik, co pomaga odtworzyć błąd zgłoszony w teście. Jeśli pole seed pozostanie puste, narzędzie losuje wartość i pokazuje ją w metrykach nad wynikiem. Zapisz ją w nazwie pliku, komentarzu scenariusza albo konfiguracji testu.

1. Wybierz preset oraz pola odpowiadające strukturze formularza lub endpointu.
2. Ustaw liczbę rekordów i poprawną domenę, na przykład example.com.
3. Wpisz stały seed albo kliknij „Losowy seed” i zapisz wyświetloną liczbę.
4. Wybierz JSON, CSV, SQL lub linie i skopiuj wynik.
5. Dodaj walidację, przypadki brzegowe i oczekiwane ograniczenia we właściwym zestawie testów.

Pseudolosowość nie jest przeznaczona do haseł, tokenów ani kluczy kryptograficznych. UUID jest poprawnie sformatowany, ale powstaje z tego samego deterministycznego strumienia, aby fixture był odtwarzalny. Do danych wymagających innego porządku identyfikatorów możesz użyć generatora ULID.

Walidacja domeny, seeda i danych wejściowych

Domena e-mail musi składać się z poprawnych etykiet ASCII i mieć końcówkę, na przykład example.com. Odrzucenie spacji, apostrofów, ukośników i znaków nowej linii zapobiega tworzeniu błędnych adresów i przenoszeniu sterujących fragmentów do CSV lub SQL. Liczba rekordów i seed muszą być liczbami całkowitymi; wartości ułamkowe nie są po cichu obcinane. Format wyniku również jest sprawdzany po stronie komponentu, a nie tylko ograniczony listą w formularzu.

Wygenerowane daty używają zakresu 2018–2026 i dni 1–28, więc zawsze są kalendarzowo poprawne. Nie odzwierciedlają rozkładu wieku, sezonowości ani innych cech populacji. Telefon, kod pocztowy i nazwa firmy mają format demonstracyjny, nie przechodzą weryfikacji z rzeczywistym operatorem czy rejestrem. Generator pomaga w testach interfejsu i serializacji, nie w analizie statystycznej.

Prywatność i dobre praktyki pracy z fixture

Syntetyczne dane ograniczają potrzebę kopiowania rekordów z produkcji, co jest ważne dla prywatności i kontroli dostępu. Nadal warto oznaczyć pliki jako testowe, używać zarezerwowanych domen i nie wysyłać wiadomości ani SMS-ów na wygenerowane wartości. Nie używaj wyniku do tworzenia kont w usługach publicznych. Dla sekretów wybierz oddzielny generator haseł, a same sekrety przechowuj poza repozytorium.

Dobry zestaw testowy zawiera nie tylko „ładne” rekordy. Po wygenerowaniu podstawy dopisz przypadki puste, bardzo długie, z apostrofem, przecinkiem, Unicode, wielolinią i wartością NULL. W ten sposób sprawdzisz walidację oraz serializer aplikacji. Wbudowane serializery tego narzędzia obsługują te znaki, lecz standardowe pule celowo tworzą czytelny scenariusz bazowy.

Najczęściej zadawane pytania