Novak.Net

A .NET library for generating synthetic Czech personal data — names, emails, and phone numbers — for use in testing, seeding databases, and demo applications.

Repository structure

• src/ - modular packages (Novak.Net, Novak.Net.Common, Novak.Net.Names, Novak.Net.Emails, Novak.Net.PhoneNumbers, and placeholders for planned modules)
• tests/ - xUnit test projects (split by module)
• docs/ - module documentation

Quick start

The simplest entry point is NovakClient (or NovakNetClient compatibility alias), which wires up all implemented generators automatically:

using Novak.Net;

var client = new NovakClient();

var name    = client.Names.GenerateFullName();
var email   = client.Emails.GenerateEmail();
var phone   = client.PhoneNumbers.GeneratePhoneNumber();
var rc      = client.RodneCislo.Generate();
var account = client.BankAccounts.GenerateBankAccount();

Console.WriteLine(account);          // e.g. 2253325080/6700
Console.WriteLine(account.ToIban()); // e.g. CZ4767000000002253325080

Runnable sample

A console sample is available in samples/Novak.Net.Sample/.

dotnet run --project ./samples/Novak.Net.Sample/Novak.Net.Sample.csproj -- 42

Names

using Novak.Net.Names;
using Novak.Net.Names.Models;
using Novak.Net.Names.Options;

var generator = new NameGenerator(new DataSource());

// Single name
var full = generator.GenerateFullName(new NameGeneratorOptions { Gender = Gender.Female });

// Deterministic sequence
var names = generator.GenerateMany(
    () => new NameGeneratorOptions { Gender = Gender.Male, Seed = 42 },
    count: 10);

NameGeneratorOptions

Property	Type	Default	Description
Gender	Gender	Any	Male, Female, or Any
Seed	int?	null	Fixed seed for deterministic output
WithDiacritics	bool	true	Preserve Czech diacritics
Casing	Casing	Original	Original, Upper, Lower, Title
MinLength / MaxLength	int?	null	Character length bounds
StartsWith	char?	null	Filter by starting letter
Include / Exclude	IReadOnlyCollection<string>?	null	Allow- / deny-list of specific names
FrequencyBucket	string?	null	"Common", "Normal", or "Rare"
Region	string?	null	Region filter (e.g. "CZ")

Emails

using Novak.Net.Emails;
using Novak.Net.Emails.Data;
using Novak.Net.Emails.Options;

var generator = new EmailGenerator(new EmbeddedEmailDataRepository());
var email = generator.GenerateEmail(new EmailGeneratorOptions { Seed = 42 });
Console.WriteLine(email); // e.g. xk3ab9fz@example.cz

EmailGeneratorOptions

Property	Type	Default	Description
Seed	int?	null	Fixed seed for deterministic output
Region	string?	null	Region used to select domains
Lowercase	bool	true	Force lowercase output
AllowedDomains	IReadOnlyList<string>?	null	Override the domain pool
MaxLocalPartLength	int?	null	Cap the local-part length

Phone numbers

using Novak.Net.PhoneNumbers;
using Novak.Net.PhoneNumbers.Data;
using Novak.Net.PhoneNumbers.Options;

var generator = new PhoneNumberGenerator(new EmbeddedPhoneNumberDataRepository());
var phone = generator.GeneratePhoneNumber(new PhoneNumberGeneratorOptions
{
    Format = PhoneNumberFormat.Spaced,
    Seed   = 42
});
Console.WriteLine(phone); // e.g. +420 603 123 456

PhoneNumberGeneratorOptions

Property	Type	Default	Description
Seed	int?	null	Fixed seed for deterministic output
Region	string?	null	Region used to select country code and prefixes
Format	PhoneNumberFormat	E164	E164, Plain, or Spaced
MobileOnly	bool	true	Restrict to mobile prefixes
CountryCode	string?	null	Override country code (e.g. "420")

Rodné číslo

using Novak.Net.RodneCislo;
using Novak.Net.RodneCislo.Models;
using Novak.Net.RodneCislo.Options;

var generator = new RodneCisloGenerator();
var rc = generator.Generate(new RodneCisloGeneratorOptions
{
    Seed   = 42,
    Gender = Gender.Female,
});

Console.WriteLine(rc);        // e.g. 845204/5228
Console.WriteLine(rc.Digits); // without slash: 8452045228

// Validate any string
bool ok = RodneCisloGenerator.Validate("845204/5228");

RodneCisloGeneratorOptions

Property	Type	Default	Description
Seed	int?	null	Fixed seed for deterministic output
Gender	Gender	Any	Male, Female, or Any
MinYear	int?	1940	Minimum birth year (inclusive)
MaxYear	int?	2005	Maximum birth year (inclusive)
Format	RodneCisloFormat	WithSlash	WithSlash or WithoutSlash

Bank accounts

using Novak.Net.BankAccounts;
using Novak.Net.BankAccounts.Data;
using Novak.Net.BankAccounts.Options;

var generator = new BankAccountGenerator(new EmbeddedBankAccountDataRepository());
var account = generator.GenerateBankAccount(new BankAccountGeneratorOptions
{
    Seed       = 42,
    WithPrefix = false,
});

Console.WriteLine(account);          // e.g. 2253325080/6700
Console.WriteLine(account.ToIban()); // e.g. CZ4767000000002253325080

// Validate any string
bool ok = BankAccountGenerator.Validate("19-2000145399/0800");

BankAccountGeneratorOptions

Property	Type	Default	Description
Seed	int?	null	Fixed seed for deterministic output
BankCode	string?	null	Override bank code (e.g. "0800"). Random when null.
WithPrefix	bool?	null	true = always prefix; false = no prefix; null = random

Install

Until published on NuGet, reference the facade project directly:

<ProjectReference Include="../src/Novak.Net/Novak.Net.csproj" />

Status

Generator	Status
Names (first / surname, gender-aware)	✅ Available
Emails	✅ Available
Phone numbers (CZ)	✅ Available
Addresses	🏗️ Placeholder project created
Rodné číslo	✅ Available
Bank accounts	✅ Available