AutoFixture to biblioteka open source dla platformy .NET, której celem jest zminimalizowanie fazy "Arrange" podczas pisania testów jednostkowych, a tym samym usprawnienie zarządzania testami. Jego głównym celem jest umożliwienie programistom skupienia się na tym, co testują, a nie na procesie konfiguracji, poprzez umożliwienie tworzenia grafów obiektów z danymi testowymi. W tym artykułe omówiono, w jaki sposób AutoFixture może ułatwić programowanie sterowane testami poprzez wydajne generowanie danych testowych.
AutoFixture to potężna biblioteka w języku C# zaprojektowana w celu usprawnienia procesu tworzenia danych testowych dla testów jednostkowych. Pomaga programistom uniknąć pisania powtarzalnego kodu konfiguracyjnego poprzez automatyczne generowanie danych dla przypadków testowych. W testowaniu jednostkowym AutoFixture zapewnia usprawnione podejście do generowania danych testowych, gwarantując, że każdy test jednostkowy jest wykonywany przy użyciu zróżnicowanych i realistycznych danych wejściowych. AutoFixture zwiększa wydajność testowania w języku C# poprzez automatyczne generowanie danych testowych, co ogranicza konieczność ręcznej konfiguracji.
AutoFixture jest dostępne jako pakiet NuGet i można je zainstalować za pomocą konsoli NuGet Package Manager Console lub opcji dodawania pakietów .NET w interfejsie użytkownika NuGet Package Manager w programie Visual Studio.
NuGet pobierze i zainstaluje najnowszą wersję AutoFixture oraz jej zależności w Twoim projekcie.
Załóżmy, że mamy prostą klasę pracownika z właściwościami takimi jak FirstName, LastName i Age. Zamiast ręcznie tworzyć instancje tej klasy w naszych testach jednostkowych, możemy wykorzystać AutoFixture do generowania losowych danych.
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 Property FirstName() As String
Public Property LastName() As String
Public Property Age() As Integer
Public Sub New(ByVal firstName As String, ByVal lastName As String, ByVal age As Integer)
Me.FirstName = firstName
Me.LastName = lastName
Me.Age = age
End Sub
Public Function GetFullName() As String
Return $"{FirstName} {LastName}"
End Function
End ClassKlasa Employee enkapsuluje istotne szczegóły pracownika, w tym jego imię, nazwisko i wiek, reprezentowane przez właściwości FirstName, LastName i Age odpowiednio. Jego konstruktor ułatwia instancjonowanie obiektu pracownika poprzez przyjmowanie tych szczegółów jako parametrów i przypisywanie ich do odpowiednich właściwości. Dodatkowo, metoda GetFullName konkatenuje imię i nazwisko pracownika, zwracając pełne imię i nazwisko jako ciąg tekstowy.
Następnie utworzymy klasę testową do testowania klasy Employee:
using AutoFixture;
public class EmployeeTests
{
private readonly IFixture _fixture;
public EmployeeTests()
{
// Using AutoFixture's Fixture to create test data
_fixture = new Fixture();
}
}Imports AutoFixture
Public Class EmployeeTests
Private ReadOnly _fixture As IFixture
Public Sub New()
' Using AutoFixture's Fixture to create test data
_fixture = New Fixture()
End Sub
End ClassTen fragment kodu integruje AutoFixture z testowaniem jednostkowym dla klasy Employee. Importując przestrzeń nazw AutoFixture, deweloperzy uzyskują dostęp do funkcjonalności generowania danych. Pole _fixture, zainicjowane nową instancją Fixture, usprawnia tworzenie danych testowych. To ustawienie zwiększa efektywność i niezawodność testów dla kompleksowego pokrycia klasy Employee.
[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 Sub Employee_ShouldHaveValidValues()
' Arrange
Dim firstName = _fixture.Create(Of String)()
Dim lastName = _fixture.Create(Of String)()
Dim age = _fixture.Create(Of Integer)()
' Act
Dim employee As New Employee(firstName, lastName, age)
' Assert
Assert.Equal(firstName, employee.FirstName)
Assert.Equal(lastName, employee.LastName)
Assert.Equal(age, employee.Age)
End SubMetoda testowa Employee_ShouldHaveValidValues weryfikuje, czy klasa Employee poprawnie inicjuje swoje właściwości z podanymi wartościami. Używając urządzenia testowego do generowania losowych danych dla FirstName, LastName i Age, test tworzy instancję Employee. Następnie sprawdza, czy właściwości FirstName, LastName i Age obiektu Employee odpowiadają wygenerowanym wartościom, zapewniając, że konstruktor poprawnie ustawia te właściwości.
[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 Sub CreateEmployee_ValidData_ReturnsEmployeeObject()
' Arrange
Dim employee = _fixture.Create(Of Employee)()
' Act
' Assert
Assert.NotNull(employee)
Assert.False(String.IsNullOrEmpty(employee.FirstName))
Assert.NotNull(employee.LastName)
Assert.True(employee.Age > 0)
End SubTa metoda testowa zawiera asercje testowe, które sprawdzają, czy właściwości obiektu Employee odpowiadają losowo wygenerowanym wartościom. Weryfikuje, czy właściwości typu string FirstName i LastName, oraz int Age są prawidłowo ustawione i ważne. Wszelkie nieudane asercje sygnalizują niezgodność między wartościami oczekiwanymi a losowymi wartościami wygenerowanymi dla danych pracowników.
IronPDF C# PDF Library to solidna biblioteka C# do obsługi plików PDF opracowana przez Iron Software, która ułatwia odczytywanie tekstu z plików PDF oraz tworzenie dokumentów PDF przy użyciu HTML. To wszechstronne narzędzie umożliwia konwersję łatwych do formatowania dokumentów, wraz z informacjami o stylu, na wysokiej jakości pliki PDF. Dzięki IronPDF generowanie plików PDF z tekstu HTML jest procesem płynnym, umożliwiającym użytkownikom pobieranie treści HTML z adresów URL i przekształcanie ich w dobrze ustrukturyzowane pliki PDF. Ta funkcja sprawia, że IronPDF jest niezbędnym narzędziem dla programistów, którzy chcą zautomatyzować i usprawnić tworzenie profesjonalnych dokumentów PDF bezpośrednio z treści internetowych.
Otwórz konsolę NuGet Package Manager i uruchom następujące polecenie:
Poniżej znajduje się przykład ilustrujący wykorzystanie AutoFixture wraz z IronPDF do wygenerowania pliku PDF zawierającego dane pracowników:
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();
}
}Imports DemoAutofixture
Imports IronPdf
Imports System
Imports System.Collections.Generic
Imports System.Linq
Imports System.Text
Public Class EmployeePdfGenerator
Private ReadOnly _fixture As Fixture
Public Sub New()
_fixture = New Fixture()
End Sub
Public Function GenerateEmployees(ByVal count As Integer) As List(Of Employee)
Return _fixture.CreateMany(Of Employee)(count).ToList()
End Function
Public Sub GeneratePdf(ByVal employees As List(Of Employee), ByVal filePath As String)
IronPdf.License.LicenseKey = "Your-License-Key-Here"
Dim renderer = New ChromePdfRenderer()
Dim htmlContent As String = GenerateHtml(employees)
Try
renderer.RenderHtmlAsPdf(htmlContent).SaveAs(filePath)
Console.WriteLine("PDF Created Successfully!")
Catch ex As Exception
Console.WriteLine($"Error generating PDF: {ex.Message}")
End Try
End Sub
Private Function GenerateHtml(ByVal employees As List(Of Employee)) As String
Dim htmlBuilder As New StringBuilder()
htmlBuilder.Append("<!DOCTYPE html><html><head><title>Employee List</title></head><body><h1>Employee List</h1><ul>")
For Each employee In employees
htmlBuilder.Append($"<li>{employee.GetFullName()} - Age: {employee.Age}</li>")
Next employee
htmlBuilder.Append("</ul></body></html>")
Return htmlBuilder.ToString()
End Function
End ClassAby użyć tej klasy, należy utworzyć instancję EmployeePdfGenerator, wygenerować listę pracowników, a następnie wywoł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");Dim employees As New List(Of Employee)() From {
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)
}
Dim pdfGenerator As New EmployeePdfGenerator()
pdfGenerator.GeneratePdf(employees, "EmployeeList.pdf")
Podany kod w języku C# wykorzystuje bibliotekę IronPDF do wygenerowania dokumentu PDF zawierającego listę pracowników wraz z ich wiekiem. Definiuje klasę EmployeePdfGenerator, która zawiera metodę GeneratePdf przyjmującą listę obiektów Employee i ścieżkę do pliku. Wewnętrznie konstruuje zawartość HTML za pomocą metody GenerateHtml, a następnie używa klasy HtmlToPdf IronPDF do renderowania tego HTML jako PDF, zapisanego w określonej lokalizacji pliku. Ulepszenia obejmują użycie StringBuilder do generowania HTML i dodanie podstawowego zarządzania błędami do generowania PDF i zapisu plików.
W poniższym ustawieniu AutoFixture jest używany do tworzenia instancji klasy Employee, umożliwiając generowanie zrandomizowanych danych do testów. IronPDF służy do płynnej konwersji treści HTML, w tym informacji o pracownikach, do formatu PDF. Klasa EmployeePdfGenerator organizuje te procesy, efektywnie zarządzając zarówno generowaniem danych, jak i konwersją do PDF. Tymczasem klasa testowa XUnit EmployeePdfGeneratorTests zapewnia prawidłowe działanie generowania PDF poprzez rygorystyczne testy. To zintegrowane podejście upraszcza generowanie i dokumentówanie danych pracowników, zapewniając solidność i niezawodność procesu tworzenia plików PDF.
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));
}
}Imports System.IO
Imports Xunit
Public Class EmployeePdfGeneratorTests
<Fact>
Public Sub GeneratePdf_GeneratesPdfFile()
' Arrange
Dim generator = New EmployeePdfGenerator()
Dim employees = generator.GenerateEmployees(5)
Dim filePath As String = "EmployeeList.pdf"
' Act
generator.GeneratePdf(employees, filePath)
' Assert
Assert.True(File.Exists(filePath))
End Sub
End ClassTutaj klasa EmployeePdfGeneratorTests zawiera przypadek testowy, który weryfikuje utworzenie pliku PDF w określonej ścieżce, zapewniając, że metoda GeneratePdf działa poprawnie.
AutoFixture upraszcza fazę "Arrange" podczas pisania testów jednostkowych w .NET, oferując programistom możliwość skupienia się na przypadkach testowych, a nie na zawiłościach konfiguracji. Usprawnia proces testowania jednostkowego, zapewniając zróżnicowane i realistyczne dane wejściowe poprzez automatyczne generowanie danych testowych. W połączeniu z informacjami o licencjonowaniu IronPDF stanowi to potężne połączenie zapewniające ciągłość użytkowania i wsparcia.
Jacob Mellor jest Chief Technology Officer w Iron Software i wizjonerskim inżynierem, pionierem technologii C# PDF. Jako pierwotny deweloper głównej bazy kodowej Iron Software, kształtuje architekturę produktów firmy od jej początku, przekształcając ją wspólnie z CEO Cameron Rimington w firmę liczącą ponad 50 osób, obsługującą NASA, Teslę i światowe agencje rządowe.
IronPDF jest częścią IRONSUITE
10 produktów API .NET dla twoich dokumentów biurowych
Kiedy potrzebujesz, aby twój PDF wyglądał jak HTML, szybko.
