Bogus for C# (.NET): Complete Guide with Examples

What is Bogus and why is it needed?

\n\n

Bogus is a powerful, simple, and fast library for generating fake (test) data in C# (.NET). It is a direct port of the popular JavaScript library Faker.js. The main goal of Bogus is to free developers from manually writing boilerplate code to create test data sets.

\n\n

Why is this needed? Imagine you are developing an application that works with users, orders, products, or any other entities. For testing functionality (unit tests, integration tests, load testing), you constantly need data: names, addresses, emails, phone numbers, text, numbers, dates, etc. Manually creating 1000 User objects with different data is tedious, time-consuming, and error-prone. Bogus solves this problem in one line of code.

\n\n

Key advantages of Bogus:

\n

\n
• Localization: Support for dozens of languages and regional formats (ru, en, de, fr, etc.).
\n
• Flexibility: You can generate data considering business rules (e.g., "price must be greater than 0 and less than 1000").
\n
• Repeatability: Using a seed, you can get the same data sets on every run — critically important for reproducible tests.
\n
• Performance: Bogus is optimized to generate millions of records in seconds.
\n
• Type Safety: Works with your own classes and interfaces using C#'s strong typing.
\n

\n\n

Installing Bogus

\n\n

Bogus is distributed as a NuGet package. It can be installed in several ways:

\n\n

1. Via .NET CLI (recommended)

\n

dotnet add package Bogus

\n\n

2. Via Package Manager Console (Visual Studio)

\n

Install-Package Bogus

\n\n

3. Via the NuGet Package Manager interface in Visual Studio

\n

Open "Manage NuGet Packages", find "Bogus", and click "Install".

\n\n

After installation, add a using directive to your code:

\n

using Bogus;

\n\n

Quick Start: First Example

\n\n

Let's generate a simple collection of Person objects with Russian names and addresses.

\n\n

using Bogus;\n\n// 1. Create "rules" (Faker) for data generation\n//    Specify the "ru" locale for Russian data\nvar faker = new Faker("ru");\n\n// 2. Generate 10 fake persons\nfor (int i = 0; i < 10; i++)\n{\n    var person = new\n    {\n        Name = faker.Name.FullName(),    // Full name\n        Email = faker.Internet.Email(),  // Email\n        Phone = faker.Phone.PhoneNumber(), // Phone number\n        City = faker.Address.City(),     // City\n        Age = faker.Random.Int(18, 80)   // Age from 18 to 80\n    };\n\n    Console.WriteLine($"{person.Name}, {person.Age} years old, {person.City}, {person.Email}, {person.Phone}");\n}\n\n// Example output (will change on each run):\n// Ivanov Ivan Petrovich, 34 years old, Moscow, ivanov@example.com, +7 (495) 123-45-67\n// Petrova Anna Sergeevna, 27 years old, Saint Petersburg, petrova@test.ru, +7 (812) 987-65-43\n// ...

\n\n

How does this work? new Faker("ru") creates the main generator object. Its properties Name, Internet, Phone, Address, Random are built-in "categories" (APIs), each containing dozens of methods for generating specific data.

\n\n

Main Methods and Functions of Bogus

\n\n

Bogus provides a huge number of methods. Below are 10+ of the most commonly used categories and their key methods with detailed examples.

\n\n

1. Name — Generating Names

\n

What it does: Generates first names, last names, patronymics (for Russian locale), full names, prefixes, and suffixes.

\n

Parameters:

Also in library

Reactive Programming in Java: Project Reactor and RxJava Libraries mockery for Go: Complete Guide with Examples Authorization and Authentication in TypeScript: A Complete Guide Go Application Configuration: Best Practices and Tools Email Sending in Go