AutoFixture ist als NuGet-Paket verfügbar und kann mithilfe der NuGet-Paket-Manager-Konsole oder des .NET-Paket-Hinzufügens in der NuGet-Paket-Manager-Benutzeroberfläche von Visual Studio installiert werden.

Install-Package AutoFixture

NuGet lädt die neueste Version von AutoFixture und seinen Abhängigkeiten in Ihr Projekt herunter und installiert sie.

Beispiel für die Erstellung von Testdaten für eine Klasse

Angenommen, wir haben eine einfache Mitarbeiterklasse mit Eigenschaften wie FirstName, LastName und Age. Anstatt Instanzen dieser Klasse in unseren Unit-Tests manuell zu erstellen, können wir AutoFixture nutzen, um für uns zufällige Daten zu generieren.

public class Employee
{
    public string FirstName { get; set; }
    public string LastName { get; set; }
    public int Age { get; set; }

    public Employee(string firstName, string lastName, int age)
    {
        FirstName = firstName;
        LastName = lastName;
        Age = age;
    }

    public string GetFullName() => $"{FirstName} {LastName}";
}

public class Employee
{
    public string FirstName { get; set; }
    public string LastName { get; set; }
    public int Age { get; set; }

    public Employee(string firstName, string lastName, int age)
    {
        FirstName = firstName;
        LastName = lastName;
        Age = age;
    }

    public string GetFullName() => $"{FirstName} {LastName}";
}

Beschreibung des Codes

Die Employee Klasse kapselt wesentliche Details eines Mitarbeiters, einschließlich seines Vornamens, Nachnamens und Alters, die jeweils durch die Eigenschaften FirstName, LastName und Age dargestellt werden. Ihr Konstruktor ermöglicht die Instanziierung eines Mitarbeiterobjekts, indem er diese Details als Parameter akzeptiert und sie den entsprechenden Eigenschaften zuweist. Zusätzlich verkettet die GetFullName Methode den Vornamen und Nachnamen des Mitarbeiters und gibt den vollständigen Namen als Zeichenkette zurück.

Als Nächstes erstellen wir eine Testklasse, um die Employee Klasse zu testen:

using AutoFixture;

public class EmployeeTests
{
    private readonly IFixture _fixture;

    public EmployeeTests()
    {
        // Using AutoFixture's Fixture to create test data
        _fixture = new Fixture();
    }
}

using AutoFixture;

public class EmployeeTests
{
    private readonly IFixture _fixture;

    public EmployeeTests()
    {
        // Using AutoFixture's Fixture to create test data
        _fixture = new Fixture();
    }
}

Beschreibung des Codes

Dieses Codebeispiel integriert AutoFixture in das Unit Testing für die Employee Klasse. Durch das Importieren des AutoFixture Namensraums erhalten Entwickler Zugriff auf die Daten-Generierungsfunktionalität. Das _fixture Feld, initialisiert mit einer neuen Instanz von Fixture, vereinfacht die Erstellung von Testdaten. Diese Konfiguration erhöht die Testeffizienz und Zuverlässigkeit für eine umfassende Employee Klassenabdeckung.

Beispiel 1: Validierung der Werte von Mitarbeiter-Testfall-Objekten

[Fact]
public void Employee_ShouldHaveValidValues()
{
    // Arrange
    var firstName = _fixture.Create<string>();
    var lastName = _fixture.Create<string>();
    var age = _fixture.Create<int>();

    // Act
    var employee = new Employee(firstName, lastName, age);

    // Assert
    Assert.Equal(firstName, employee.FirstName);
    Assert.Equal(lastName, employee.LastName);
    Assert.Equal(age, employee.Age);
}

[Fact]
public void Employee_ShouldHaveValidValues()
{
    // Arrange
    var firstName = _fixture.Create<string>();
    var lastName = _fixture.Create<string>();
    var age = _fixture.Create<int>();

    // Act
    var employee = new Employee(firstName, lastName, age);

    // Assert
    Assert.Equal(firstName, employee.FirstName);
    Assert.Equal(lastName, employee.LastName);
    Assert.Equal(age, employee.Age);
}

Beschreibung des Codes

Die Testmethode Employee_ShouldHaveValidValues überprüft, ob die Employee Klasse ihre Eigenschaften korrekt mit den bereitgestellten Werten initialisiert. Mit einer Testvorrichtung zur Erzeugung zufälliger Daten für die FirstName, LastName und Age, erstellt der Test eine Employee Instanz. Anschließend wird überprüft, dass die FirstName, LastName und Age Eigenschaften des Employee Objekts den generierten Werten entsprechen, um sicherzustellen, dass der Konstruktor diese Eigenschaften korrekt setzt.

Beispiel 2: Validierung des Mitarbeiters beim Aufruf des Konstruktors

[Fact]
public void CreateEmployee_ValidData_ReturnsEmployeeObject()
{
    // Arrange
    var employee = _fixture.Create<Employee>();

    // Act 
    // Assert
    Assert.NotNull(employee);
    Assert.False(string.IsNullOrEmpty(employee.FirstName));
    Assert.NotNull(employee.LastName);
    Assert.True(employee.Age > 0);
}

[Fact]
public void CreateEmployee_ValidData_ReturnsEmployeeObject()
{
    // Arrange
    var employee = _fixture.Create<Employee>();

    // Act 
    // Assert
    Assert.NotNull(employee);
    Assert.False(string.IsNullOrEmpty(employee.FirstName));
    Assert.NotNull(employee.LastName);
    Assert.True(employee.Age > 0);
}

Beschreibung des Codes

Diese Testmethode enthält Testaussagen, die validieren, ob die Eigenschaften eines Employee Objekts mit zufällig generierten Werten übereinstimmen. Es wird überprüft, ob die string Typ-Eigenschaften FirstName und LastName, sowie int Age korrekt gesetzt und gültig sind. Alle fehlgeschlagenen Zusicherungen deuten auf eine Diskrepanz zwischen den erwarteten und den zufällig generierten Werten für Mitarbeiterdetails hin.

Einführung in IronPDF

Die IronPDF C# PDF-Bibliothek ist eine robuste C#-PDF-Bibliothek, die von Iron Software entwickelt wurde und das Lesen von PDF-Texten sowie die Erstellung von PDF-Dokumenten mit HTML erleichtert. Dieses vielseitige Tool ermöglicht die Umwandlung von Dokumenten mit einfacher Formatierung und Stilinformationen in hochwertige PDFs. Mit IronPDF ist das Erstellen von PDFs aus HTML-Text ein nahtloser Prozess, der es Benutzern erlaubt, HTML-Inhalte aus URLs zu ziehen und diese in gut strukturierte PDF-Dateien zu transformieren. Diese Fähigkeit macht IronPDF zu einem unverzichtbaren Werkzeug für Entwickler, die die Erstellung von professionellen PDF-Dokumenten direkt aus Webinhalten automatisieren und optimieren möchten.

Öffnen Sie die NuGet-Paket-Manager-Konsole und führen Sie den folgenden Befehl aus:

Install-Package IronPdf

Codebeispiel für die Verwendung der Funktionen von AutoFixture mit IronPDF

Unten ist ein Beispiel, das zeigt, wie AutoFixture zusammen mit IronPDF verwendet wird, um ein PDF mit Mitarbeiterdaten zu generieren:

using DemoAutofixture;
using IronPdf;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;

public class EmployeePdfGenerator
{
    private readonly Fixture _fixture;

    public EmployeePdfGenerator()
    {
        _fixture = new Fixture();
    }

    public List<Employee> GenerateEmployees(int count)
    {
        return _fixture.CreateMany<Employee>(count).ToList();
    }

    public void GeneratePdf(List<Employee> employees, string filePath)
    {
        IronPdf.License.LicenseKey = "Your-License-Key-Here";
        var renderer = new ChromePdfRenderer();
        string htmlContent = GenerateHtml(employees);

        try
        {
            renderer.RenderHtmlAsPdf(htmlContent).SaveAs(filePath);
            Console.WriteLine("PDF Created Successfully!");
        }
        catch (Exception ex)
        {
            Console.WriteLine($"Error generating PDF: {ex.Message}");
        }
    }

    private string GenerateHtml(List<Employee> employees)
    {
        StringBuilder htmlBuilder = new StringBuilder();
        htmlBuilder.Append("<!DOCTYPE html><html><head><title>Employee List</title></head><body><h1>Employee List</h1><ul>");

        foreach (var employee in employees)
        {
            htmlBuilder.Append($"<li>{employee.GetFullName()} - Age: {employee.Age}</li>");
        }

        htmlBuilder.Append("</ul></body></html>");
        return htmlBuilder.ToString();
    }
}

using DemoAutofixture;
using IronPdf;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;

public class EmployeePdfGenerator
{
    private readonly Fixture _fixture;

    public EmployeePdfGenerator()
    {
        _fixture = new Fixture();
    }

    public List<Employee> GenerateEmployees(int count)
    {
        return _fixture.CreateMany<Employee>(count).ToList();
    }

    public void GeneratePdf(List<Employee> employees, string filePath)
    {
        IronPdf.License.LicenseKey = "Your-License-Key-Here";
        var renderer = new ChromePdfRenderer();
        string htmlContent = GenerateHtml(employees);

        try
        {
            renderer.RenderHtmlAsPdf(htmlContent).SaveAs(filePath);
            Console.WriteLine("PDF Created Successfully!");
        }
        catch (Exception ex)
        {
            Console.WriteLine($"Error generating PDF: {ex.Message}");
        }
    }

    private string GenerateHtml(List<Employee> employees)
    {
        StringBuilder htmlBuilder = new StringBuilder();
        htmlBuilder.Append("<!DOCTYPE html><html><head><title>Employee List</title></head><body><h1>Employee List</h1><ul>");

        foreach (var employee in employees)
        {
            htmlBuilder.Append($"<li>{employee.GetFullName()} - Age: {employee.Age}</li>");
        }

        htmlBuilder.Append("</ul></body></html>");
        return htmlBuilder.ToString();
    }
}

Um diese Klasse zu verwenden, würden Sie EmployeePdfGenerator instanziieren, eine Liste von Mitarbeitern erstellen und dann GeneratePdf aufrufen:

List<Employee> employees = new()
{
    new Employee("John", "Smith", 32),
    new Employee("Emily", "Davis", 18),
    new Employee("David", "Brown", 24),
    new Employee("Jane", "Doe", 16),
    new Employee("Michael", "Johnson", 49),
};

EmployeePdfGenerator pdfGenerator = new();
pdfGenerator.GeneratePdf(employees, "EmployeeList.pdf");

List<Employee> employees = new()
{
    new Employee("John", "Smith", 32),
    new Employee("Emily", "Davis", 18),
    new Employee("David", "Brown", 24),
    new Employee("Jane", "Doe", 16),
    new Employee("Michael", "Johnson", 49),
};

EmployeePdfGenerator pdfGenerator = new();
pdfGenerator.GeneratePdf(employees, "EmployeeList.pdf");

Beschreibung des Codes

Der bereitgestellte C#-Code verwendet die IronPDF-Bibliothek, um ein PDF-Dokument zu generieren, das Mitarbeiter und deren Alter auflistet. Es definiert eine EmployeePdfGenerator Klasse, die die Methode GeneratePdf enthält, welche eine Liste von Employee Objekten und einen Dateipfad entgegennimmt. Intern wird durch die GenerateHtml Methode HTML-Inhalt erstellt und dann die HtmlToPdf Klasse von IronPDF verwendet, um dieses HTML als PDF zu rendern, das am angegebenen Dateipfad gespeichert wird. Verbesserungen umfassen die Verwendung von StringBuilder für die HTML-Generierung und das Hinzufügen von grundlegender Fehlerbehandlung für die PDF-Erzeugung und das Speichern der Datei.

Schreiben einer Testmethode

Im untenstehenden Setup wird AutoFixture zur Erstellung von Instanzen der Employee Klasse verwendet, wodurch die Generierung von zufälligen Daten für Tests ermöglicht wird. IronPDF wird verwendet, um HTML-Inhalte, einschließlich Mitarbeiterinformationen, nahtlos in PDF-Format zu konvertieren. Die EmployeePdfGenerator Klasse koordiniert diese Prozesse, verwaltet sowohl die Datengenerierung als auch die PDF-Konvertierung effizient. Währenddessen stellt die EmployeePdfGeneratorTests XUnit-Testklasse durch rigoroses Testen die ordnungsgemäße Funktionalität der PDF-Erzeugung sicher. Dieser integrierte Ansatz vereinfacht die Generierung und Dokumentation von Mitarbeiterdaten und stellt Robustheit und Zuverlässigkeit im PDF-Generierungsprozess sicher.

using System.IO;
using Xunit;

public class EmployeePdfGeneratorTests
{
    [Fact]
    public void GeneratePdf_GeneratesPdfFile()
    {
        // Arrange
        var generator = new EmployeePdfGenerator();
        var employees = generator.GenerateEmployees(5);
        string filePath = "EmployeeList.pdf";

        // Act
        generator.GeneratePdf(employees, filePath);

        // Assert
        Assert.True(File.Exists(filePath));
    }
}

using System.IO;
using Xunit;

public class EmployeePdfGeneratorTests
{
    [Fact]
    public void GeneratePdf_GeneratesPdfFile()
    {
        // Arrange
        var generator = new EmployeePdfGenerator();
        var employees = generator.GenerateEmployees(5);
        string filePath = "EmployeeList.pdf";

        // Act
        generator.GeneratePdf(employees, filePath);

        // Assert
        Assert.True(File.Exists(filePath));
    }
}

Hier enthält die EmployeePdfGeneratorTests Klasse einen Testfall, der die Erstellung einer PDF-Datei am angegebenen Dateipfad validiert, um sicherzustellen, dass die GeneratePdf Methode korrekt funktioniert.