AutoFixture está disponible como un paquete NuGet y se puede instalar usando la Consola del Administrador de Paquetes NuGet o el complemento de .NET en la interfaz de usuario del Administrador de Paquetes NuGet de Visual Studio.

Install-Package AutoFixture

NuGet descargará e instalará la última versión de AutoFixture y sus dependencias en su proyecto.

Ejemplo de creación de datos de prueba para una clase

Supongamos que tenemos una clase de empleado simple con propiedades como FirstName, LastName, y Age. En lugar de crear manualmente instancias de esta clase en nuestras pruebas unitarias, podemos utilizar AutoFixture para generar datos aleatorios para nosotros.

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}";
}

Descripción del código

La clase Employee encapsula los detalles esenciales de un empleado, incluidos su nombre, apellido y edad, representados por las propiedades FirstName, LastName, y Age respectivamente. Su constructor facilita la creación de un objeto empleado aceptando estos detalles como parámetros y asignándolos a las propiedades correspondientes. Además, el método GetFullName concatena el nombre y apellido del empleado, devolviendo el nombre completo como una cadena.

A continuación, crearemos una clase de prueba para probar la clase Employee:

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();
    }
}

Descripción del código

Este fragmento de código incorpora AutoFixture en las pruebas unitarias para la clase Employee. Al importar el espacio de nombres AutoFixture, los desarrolladores acceden a la funcionalidad de generación de datos. El campo _fixture, inicializado con una nueva instancia de Fixture, optimiza la creación de datos de prueba. Esta configuración mejora la eficiencia y fiabilidad de las pruebas para la cobertura completa de la clase Employee.

Ejemplo 1: Validación de valores de objetos de casos de prueba de empleados

[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);
}

Descripción del código

El método de prueba Employee_ShouldHaveValidValues valida que la clase Employee inicializa correctamente sus propiedades con los valores proporcionados. Usando un fixture de prueba para generar datos aleatorios para FirstName, LastName y Age, la prueba crea una instancia de Employee. Luego afirma que las propiedades FirstName, LastName, y Age del objeto Employee coinciden con los valores generados, asegurando que el constructor establece estas propiedades con precisión.

Ejemplo 2: Validación de empleado cuando se invoca al constructor

[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);
}

Descripción del código

Este método de prueba incluye afirmaciones de prueba que validan si las propiedades de un objeto Employee coinciden con valores generados aleatoriamente. Verifica si las propiedades de tipo string FirstName y LastName, y int Age están correctamente establecidas y son válidas. Cualquier aserción fallida señala una discordancia entre los valores esperados y los valores aleatorios generados para los detalles del empleado.

Presentación de IronPDF

IronPDF C# PDF Library es una robusta biblioteca de PDF en C# desarrollada por Iron Software que facilita la lectura de texto PDF y la creación de documentos PDF usando HTML. Esta herramienta versátil permite la conversión de documentos fáciles de formatear, completos con información de estilo, en PDFs de alta calidad. Con IronPDF, generar PDFs a partir de texto HTML es un proceso sencillo, permitiendo a los usuarios extraer contenido HTML de URLs y transformarlo en archivos PDF bien estructurados. Esta capacidad convierte a IronPDF en una herramienta esencial para los desarrolladores que buscan automatizar y optimizar la creación de documentos PDF profesionales directamente desde contenido web.

Abra la consola del Administrador de Paquetes NuGet, y ejecute el siguiente comando:

Install-Package IronPdf

Ejemplo de código usando las características de AutoFixture con IronPDF

A continuación se presenta un ejemplo que demuestra el uso de AutoFixture junto a IronPDF para generar un PDF de datos de empleados:

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();
    }
}

Para utilizar esta clase, instanciaría EmployeePdfGenerator, generaría una lista de empleados y luego llamaría a GeneratePdf:

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");

Descripción del código

El código proporcionado en C# utiliza la biblioteca IronPDF para generar un documento PDF que lista empleados y sus edades. Define una clase EmployeePdfGenerator que incluye el método GeneratePdf, que toma una lista de objetos Employee y una ruta de archivo. Internamente, construye contenido HTML a través del método GenerateHtml, luego utiliza la clase HtmlToPdf de IronPDF para renderizar este HTML como un PDF, guardado en la ruta de archivo especificada. Las mejoras incluyen el uso de StringBuilder para la generación de HTML y la adición de manejo básico de errores para la generación y guardado del archivo PDF.

Escribir un método de prueba

En la configuración que sigue, se utiliza AutoFixture para crear instancias de la clase Employee, permitiendo la generación de datos aleatorios para pruebas. Se emplea IronPDF para convertir sin problemas el contenido HTML, incluyendo información del empleado, en formato PDF. La clase EmployeePdfGenerator orquesta estos procesos, gestionando eficientemente tanto la generación de datos como la conversión a PDF. Mientras tanto, la clase de prueba XUnit EmployeePdfGeneratorTests asegura el correcto funcionamiento de la generación de PDFs a través de rigurosas pruebas. Este enfoque integrado simplifica la generación y documentación de datos de empleados, asegurando robustez y fiabilidad en el proceso de generación de PDFs.

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));
    }
}

Aquí la clase EmployeePdfGeneratorTests contiene un caso de prueba que valida la creación de un archivo PDF en la ruta de archivo especificada, asegurando que el método GeneratePdf funcione correctamente.