jrv-mock-data#

Generate realistic test data instantly — no API key, no network. Supports dozens of data types, bulk generation, and multiple output formats including JSON, CSV, and SQL.

Quick Start#

bash

# Generate 10 fake users as JSON
python3 scripts/mock_data.py user --count 10

# Generate fake email addresses
python3 scripts/mock_data.py email --count 5

# Generate addresses
python3 scripts/mock_data.py address --count 3

# Generate a custom record with multiple fields
python3 scripts/mock_data.py record --fields "name,email,phone,company" --count 5

# Output as CSV
python3 scripts/mock_data.py user --count 20 --format csv

# Output as SQL INSERT
python3 scripts/mock_data.py user --count 10 --format sql --table users

# Single values (no count)
python3 scripts/mock_data.py uuid
python3 scripts/mock_data.py name
python3 scripts/mock_data.py lorem --words 50

# Save to file
python3 scripts/mock_data.py user --count 100 --format csv --output test_users.csv

Commands & Data Types#

TypeDescriptionExample OutputuserFull user record (name, email, phone, address){"name": "Jane Smith", "email": "jane@example.com", ...}``nameFull name"Marcus Rivera"``emailEmail address"tmarcus@fakecorp.io"``phoneUS phone number"(415) 555-0193"``addressStreet address"1234 Oak Ave, Austin TX 78701"``companyCompany name"Nexigen Solutions LLC"``uuidUUID v4"f47ac10b-58cc-..."``dateRandom date"2024-07-15"``datetimeRandom datetime"2024-07-15T14:23:00"``loremLorem ipsum text"Lorem ipsum dolor sit amet..."``numberRandom integer42``floatRandom float3.14159``boolTrue/falsetrue``colorHex color"#3a7bd5"``urlFake URL"https://fakecorp.io/api/v1"``ipIPv4 address"192.168.1.104"``recordCustom fields comboUse --fields name,email,phone

Formats#

FormatFlagNotesJSON--format json (default)Pretty-printed arrayCSV--format csvWith header rowSQL--format sql --table <name>INSERT statementsLines--format linesOne value per line

Options#

FlagDescription--count NNumber of records (default: 1)--format <fmt>Output format: json, csv, sql, lines--table <name>Table name for SQL output--fields <list>Comma-separated fields for record type--seed NRandom seed for reproducible output--output <file>Write to file instead of stdout

Use Cases#

• API testing: Seed databases with realistic-looking test records
• UI prototyping: Fill mockups with plausible names and emails
• QA automation: Generate test fixtures in CSV or JSON
• SQL seeding: Ready-to-paste INSERT statements for dev databases
• Load testing: Generate thousands of unique records instantly