Philiprehberger.DataFaker 0.3.0

Philiprehberger.DataFaker

Lightweight test data generator with locale support, structured builders, and UUID generation.

Installation

dotnet add package Philiprehberger.DataFaker

Usage

using Philiprehberger.DataFaker;

var name = Faker.Name();        // "Mary Johnson"
var email = Faker.Email();      // "james.smith@example.com"
var phone = Faker.Phone();      // "(555) 867-5309"
var address = Faker.Address();  // "742 Oak Ave"

Internet Data

using Philiprehberger.DataFaker;

var url = FakerInternet.Url();           // "https://alpha-tech.io/data/flux"
var domain = FakerInternet.DomainName(); // "cyber-wave.dev"
var ip4 = FakerInternet.IPv4();          // "192.168.45.12"
var ip6 = FakerInternet.IPv6();          // "2a01:0db8:85a3:0000:0000:8a2e:0370:7334"
var mac = FakerInternet.MacAddress();    // "a4:5e:60:b3:21:ff"
var ua = FakerInternet.UserAgent();      // "Mozilla/5.0 (Windows NT 10.0; ...)"
var slug = FakerInternet.Slug();         // "meta-sync-nova"

Finance Data

using Philiprehberger.DataFaker;

var cc = FakerFinance.CreditCardNumber();  // "4532015112830366" (valid Luhn)
var iban = FakerFinance.Iban();            // "DE89370400440532013000"
var bic = FakerFinance.BicSwift();         // "DEUTDEFF"
var currency = FakerFinance.CurrencyCode(); // "EUR"
var amount = FakerFinance.Amount(10m, 500m); // 247.83m

Weighted Selection

using Philiprehberger.DataFaker;

var items = new List<(string item, double weight)>
{
    ("common", 10.0),
    ("uncommon", 3.0),
    ("rare", 0.5)
};

var picked = Faker.PickWeighted(items); // "common" (most likely)

Collection Helpers

using Philiprehberger.DataFaker;

var names = Faker.List(5, () => Faker.Name());
// ["Mary Johnson", "Robert Garcia", "Jennifer Wilson", ...]

var scores = Faker.List(3, 8, () => Faker.Between(1, 100));
// [42, 87, 15, 63, 91] (random count between 3 and 8)

Locale Support

using Philiprehberger.DataFaker;

var de = Faker.WithLocale("de-DE");
var name = de.Name();     // "Hans Mueller"
var city = de.City();     // "Berlin"
var phone = de.Phone();   // "+49 172 9384756"
var email = de.Email();   // "hans.mueller@example.com"

var fr = Faker.WithLocale("fr-FR");
var frName = fr.Name();   // "Jean Martin"

var es = Faker.WithLocale("es-ES");
var esCity = es.City();   // "Madrid"

UUID Generation

using Philiprehberger.DataFaker;

var uuid = Faker.Uuid();            // "a3b8f042-1c7e-4d9a-b5e6-8f2c3a7d1e09"
var seqId = Faker.UuidSequential();  // time-sortable UUID v7-style

Object Builder

using Philiprehberger.DataFaker;

public class User
{
    public string FirstName { get; set; } = "";
    public string Email { get; set; } = "";
    public int Age { get; set; }
    public bool IsActive { get; set; }
}

var user = FakerBuilder.Build<User>();
// user.FirstName = "Mary"
// user.Email = "james.smith@example.com"
// user.Age = 427
// user.IsActive = true

Seeded Reproducibility

using Philiprehberger.DataFaker;

var faker = Faker.WithSeed(42);

// Same seed always produces the same sequence
var name1 = faker.Name();   // deterministic
var name2 = faker.Name();   // deterministic
var email = faker.Email();  // deterministic

API

Faker (static)

LocaleFaker

FakerBuilder (static)

FakerInternet (static)

FakerFinance (static)

FakerInstance

Same methods as Faker (except WithSeed, WithLocale, PickWeighted, List), plus Uuid() and UuidSequential(), but instance-based with a seeded Random for deterministic output.

Development

dotnet build src/Philiprehberger.DataFaker.csproj --configuration Release

Support

If you find this project useful:

⭐ Star the repo

🐛 Report issues

💡 Suggest features

❤️ Sponsor development

🌐 All Open Source Projects

💻 GitHub Profile

🔗 LinkedIn Profile

License

MIT