Bogus pour C# (.NET) : guide complet avec exemples

Qu'est-ce que Bogus et pourquoi l'utiliser ?

Bogus est une bibliothèque puissante, simple et rapide pour générer des données factices (de test) en langage C# (.NET). C'est un port direct de la célèbre bibliothèque JavaScript Faker.js. L'objectif principal de Bogus est de libérer les développeurs de l'écriture manuelle de code répétitif pour créer des ensembles de données de test.

Pourquoi en avez-vous besoin ? Imaginez que vous développez une application qui gère des utilisateurs, des commandes, des produits ou toute autre entité. Pour tester les fonctionnalités (tests unitaires, tests d'intégration, tests de charge), vous avez constamment besoin de données : noms, adresses, e-mails, numéros de téléphone, texte, nombres, dates, etc. Créer manuellement 1000 objets User avec des données différentes est fastidieux, long et source d'erreurs. Bogus résout ce problème en une seule ligne de code.

Les avantages clés de Bogus :

• Localisation : Prise en charge de dizaines de langues et de formats régionaux (fr, en, de, ru, etc.).
• Flexibilité : Vous pouvez générer des données en respectant des règles métier (ex : "le prix doit être supérieur à 0 et inférieur à 1000").
• Reproductibilité : En utilisant une seed (germe), vous obtenez les mêmes ensembles de données à chaque exécution — essentiel pour des tests reproductibles.
• Performance : Bogus est optimisé pour générer des millions d'enregistrements en quelques secondes.
• Sécurité de type : Fonctionne avec vos propres classes et interfaces, en utilisant le typage fort de C#.

Installation de Bogus

Bogus est distribué sous forme de package NuGet. Vous pouvez l'installer de plusieurs manières :

1. Via .NET CLI (recommandé)

dotnet add package Bogus

2. Via la console du gestionnaire de packages (Visual Studio)

Install-Package Bogus

3. Via l'interface du gestionnaire de packages NuGet dans Visual Studio

Ouvrez "Manage NuGet Packages", recherchez "Bogus" et cliquez sur "Install".

Après l'installation, ajoutez la directive using dans votre code :

using Bogus;

Démarrage rapide : premier exemple

Générons une simple collection d'objets Person avec des noms et adresses français.

using Bogus;

// 1. Création des "règles" (Faker) pour générer les données
//    Spécifiez la locale "fr" pour des données françaises
var faker = new Faker("fr");

// 2. Génération de 10 personnes fictives
for (int i = 0; i < 10; i++)
{
    var person = new
    {
        Name = faker.Name.FullName(),    // Nom complet
        Email = faker.Internet.Email(),  // Email
        Phone = faker.Phone.PhoneNumber(), // Numéro de téléphone
        City = faker.Address.City(),     // Ville
        Age = faker.Random.Int(18, 80)   // Âge entre 18 et 80 ans
    };

    Console.WriteLine($"{person.Name}, {person.Age} ans, {person.City}, {person.Email}, {person.Phone}");
}

// Exemple de sortie (change à chaque exécution) :
// Martin Jean, 34 ans, Paris, jean.martin@example.com, 01 23 45 67 89
// Dubois Marie, 27 ans, Lyon, marie.dubois@test.fr, 04 56 78 90 12
// ...

Comment ça fonctionne ? new Faker("fr") crée l'objet générateur principal. Ses propriétés Name, Internet, Phone, Address, Random sont des "catégories" (API) intégrées, chacune contenant des dizaines de méthodes pour générer des données spécifiques.

Méthodes et fonctions principales de Bogus

Bogus offre un très grand nombre de méthodes. Voici 10+ catégories les plus utilisées et leurs méthodes clés avec des exemples détaillés.

1. Name — Génération de noms

Ce qu'il fait : Génère des prénoms, noms de famille, noms complets, préfixes et suffixes.

Paramètres : La plupart des méthodes ne nécessitent pas de paramètres, mais il existe des surcharges