seedfaker 0.2.0a2

Deterministic synthetic data generator for realistic, correlated, and noisy test records across 68 locales. Rust CLI + Python + Node.js + Go + PHP + Ruby + MCP.

seedfaker

Python binding for seedfaker. PyO3.

CLI · Node.js · Python · Browser/WASM · Go · PHP · Ruby · MCP

pip install seedfaker

Pre-1.0 notice: The API may change between minor versions until 1.0.0 is released. Pin your version and check CHANGELOG.md before upgrading.

Python API

from seedfaker import SeedFaker

f = SeedFaker(seed="ci", locale="en")

# Single values
f.field("name")
f.field("phone", e164=True)
f.field("credit-card", space=True)
f.field("email", omit=30)                    # "" for 30% of calls

# Weighted locales: 70% English, 20% German, 10% French
mixed = SeedFaker(seed="ci", locale="en=7,de=2,fr=1")

# Single correlated record
f.record(["name", "email", "phone"], ctx="strict")
# → {"name": "Zoe Kumar", "email": "zoe.kumar@...", "phone": "+1..."}

# Batch
f.records(["name", "email", "phone"], n=5, ctx="strict")

# Validate without generating
f.validate(["name", "email:e164"])  # raises ValueError if invalid

# Corruption
f.records(["name", "email", "ssn"], n=100, corrupt="high")

# Determinism — same seed = same output
a = SeedFaker(seed="test")
b = SeedFaker(seed="test")
assert a.field("name") == b.field("name")

# Fingerprint — detect algorithm changes after upgrade
SeedFaker.fingerprint()  # 'sf0-...'

# All field names
SeedFaker.fields()

Documentation

• Quick start
• Field reference (200+ fields)
• Library API
• Full documentation

---

Disclaimer

This software generates synthetic data that may resemble real-world identifiers, credentials, or personal information. All output is artificial. See LICENSE for the full legal disclaimer.