FakeForge 0.2.1

FakeForge

Offline, deterministic fake-data generation for .NET.

FakeForge is a lightweight fake-data generation library for development, testing, prototyping, demos, fixtures, and synthetic datasets.

It runs entirely locally and does not require a cloud service, API key, or network connection.

Features

• Deterministic, seeded data generation
• Country-aware configuration
• Person names
• Job titles
• Email addresses
• Usernames
• URLs
• IPv4 addresses
• MAC addresses
• Phone numbers
• Addresses
• Companies
• Integers
• Floating-point numbers
• Booleans
• UUID generation
• ULID generation
• NanoID generation
• Dates and date/time values
• Unix timestamps
• Fully offline operation

Installation

Install FakeForge from NuGet:

dotnet add package FakeForge

Basic Usage

using FakeForge;

var fake = FakeForgeClient.Create(new FakeForgeOptions
{
    Seed = 12345
});

var record = fake.Record();

Console.WriteLine(record.Name.FullName());
Console.WriteLine(record.Internet.Email());
Console.WriteLine(record.Phone.Number());
Console.WriteLine(record.Address.City());
Console.WriteLine(record.Company.Name());

Deterministic Generation

FakeForge supports seeded pseudo-random generation.

Providing the same seed produces the same deterministic sequence, making generated data reproducible across test runs.

using FakeForge;

var first = FakeForgeClient.Create(new FakeForgeOptions
{
    Seed = 12345
});

var second = FakeForgeClient.Create(new FakeForgeOptions
{
    Seed = 12345
});

Console.WriteLine(first.Record().Name.FullName());
Console.WriteLine(second.Record().Name.FullName());

Using the same seed and making the same sequence of generator calls produces reproducible results.

Country / Locale Configuration

FakeForge supports country-aware data generation.

using FakeForge;

var fake = FakeForgeClient.Create(new FakeForgeOptions
{
    Country = "IN",
    Seed = 12345
});

var record = fake.Record();

Console.WriteLine(record.Address.Country());
Console.WriteLine(record.Address.City());
Console.WriteLine(record.Address.State());
Console.WriteLine(record.Address.PostalCode());

Supported Country Codes

Currently supported country codes include:

API Reference

Person

record.Name.FirstName();
record.Name.LastName();
record.Name.FullName();
record.Name.JobTitle();

Internet

record.Internet.Email();
record.Internet.Username();
record.Internet.Url();
record.Internet.IPv4();
record.Internet.MacAddress();

Phone

record.Phone.Number();

Address

record.Address.Street();
record.Address.City();
record.Address.State();
record.Address.PostalCode();
record.Address.Country();
record.Address.FullAddress();

Company

record.Company.Name();

Numbers

record.Number.Integer(1, 100);
record.Number.Float(0, 100);
record.Number.Boolean();

Boolean

record.Boolean();

Identifiers

record.String.Uuid();
record.String.Ulid();
record.String.NanoId();
record.String.NanoId(32);

Dates

record.Date.Date();
record.Date.DateTime();
record.Date.UnixTimestamp();

Offline

FakeForge generates data locally.

No cloud service, API key, or network connection is required for fake-data generation.

This makes FakeForge suitable for:

• Air-gapped development environments
• CI/CD pipelines
• Unit tests
• Integration tests
• Local development
• Automated test fixtures
• Reproducible datasets

Determinism

FakeForge uses a seeded pseudo-random generator to make generated data reproducible.

This is particularly useful for:

• Unit testing
• Integration testing
• Test fixtures
• Development environments
• Prototyping
• Demonstrations
• Reproducible test datasets
• Synthetic data generation

License

FakeForge is distributed under the FakeForge Proprietary Free-Use License.

Commercial applications using FakeForge are permitted under the license.

Redistribution of FakeForge itself as a standalone library, SDK, package, or competing product is not permitted without additional permission.

See LICENSE for the complete terms.

Repository

GitHub