Mesaj ikonu
Altbilgi içeriğine atla
  1. IronPDF
  2. IronPDF Blogu
  3. .NET Yardım
  4. AutoFixture C#
.NET YARDıM

AutoFixture C# (Geliştiriciler İçin Nasıl Çalışır)

Jacob Mellor, Teknoloji Direktörü @ Team Iron
Jacob Mellor
Güncellendi:

AutoFixture, birim test yazmada 'Düzenleme' aşamasını en aza indirgemeye yönelik .NET için açık kaynaklı bir kütüphanedir ve böylece test yönetimini iyileştirir. Ana amacı, geliştiricilere nesne grafiklerini test verileriyle oluşturma imkanı vererek, test ettikleri şeye odaklanmalarını sağlamak ve kurulum sürecinden ziyade. Bu makale, AutoFixture'ın verimli test veri üretimi yoluyla test odaklı geliştirmeyi nasıl kolaylaştırabileceğini incelemektedir.

AutoFixture, birim testler için test verileri oluşturma sürecini kolaylaştırmak için tasarlanmış güçlü bir C# kütüphanesidir. Geliştiricilere, test durumları için otomatik olarak veri üreterek yinelenen kurulum kodu yazmaktan kaçınmalarına yardımcı olur. Birim testlerinde, AutoFixture, her birim testinin çeşitli ve gerçekçi girdilerle yürütülmesini sağlayarak test verisi üretimine özen gösteren bir yaklaşım sunar. AutoFixture, C# ile test yapmayı daha verimli hale getirir ve manuel kuruluma olan ihtiyaçı azaltarak otomatik olarak test verisi üretir.

AutoFixture C# (Geliştiriciler için Nasıl Çalışır): Şekil 1 - AutoFixture

AutoFixture Kurulumu ve Kurulması

AutoFixture, bir NuGet paketi olarak mevcuttur ve NuGet Paket Yöneticisi Konsolu veya Visual Studio'nun NuGet Paket Yöneticisi arayüzünde .NET add package kullanılarak kurulabilir.

Install-Package AutoFixture

NuGet, AutoFixture'ın ve bağımlılıklarının en son sürümünü projenize indirip kuracaktır.

Bir Sınıf için Test Verisi Oluşturma Örneği

Diyelim ki FirstName, LastName ve Age gibi özelliklere sahip basit bir çalışan sınıfımız var. Bir birim testlerinde, bu sınıfın örneklerini manuel olarak oluşturmaktansa, bizim için rastgele veriler oluşturmak üzere AutoFixture'dan yararlanabiliriz.

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}";
}
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 Class
$vbLabelText   $csharpLabel

Kod Açıklaması

Employee sınıfı, bir çalışanın ad, soyad ve yaş gibi temel detaylarını enkapsüle eder ve bu detaylar sırasıyla FirstName, LastName ve Age özellikleriyle temsil edilir. Yapıcı metodu, bu detayları parametre olarak kabul edip bunları karşılık gelen özelliklere atanarak çalışan nesnesi oluşturmayı kolaylaştırır. Ek olarak, GetFullName yöntemi çalışanın ad ve soyadını birleştirir, tam ad olarak bir dize döner.

Test Senaryomuzun Kodu Kurulumu

Sonraki adımda, Employee sınıfını test etmek için bir test sınıfı oluşturacağız:

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();
    }
}
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 Class
$vbLabelText   $csharpLabel

Kod Açıklaması

Bu kod parçası, Employee sınıfı için birim testlerine AutoFixture'ı entegre eder. Geliştiriciler, AutoFixture alan adını içe aktararak veri üretim işlevselliğine erişir. Yeni bir Fixture örneği ile başlatılan _fixture alanı, test verisi oluşturmayı kolaylaştırır. Bu kurulum, kapsamlı Employee sınıfının kapsanması için test verimliliğini ve güvenilirliğini artırır.

Örnek 1: Çalışan Test Durumu Nesne Değerlerinin Geçerliliğini Sağlama

[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);
}
<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 Sub
$vbLabelText   $csharpLabel

Kod Açıklaması

Employee_ShouldHaveValidValues test yöntemi, Employee sınıfının özelliklerini verilen değerler ile doğru bir şekilde başlatıp başlatmadığını doğrular. FirstName, LastName ve Age için rastgele veri üretmek üzere bir test düzeneği kullanılarak, test Employee bir örnek oluşturur. FirstName, LastName ve Age özelliklerinin oluşturulan değerlerle eşleştiğini ve yapıcıların bu özellikleri doğru bir şekilde ayarladığını doğrular.

Örnek 2: Yapıcı Çağrıldığında Çalışan Geçerliliğinde Kontrol

[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);
}
<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 Sub
$vbLabelText   $csharpLabel

Kod Açıklaması

Bu test yöntemi, bir Employee nesnesinin özelliklerinin rastgele üretilmiş değerlerle eşleşip eşleşmediğini doğrulayan test iddialarını içerir. string tipinin FirstName ve LastName özellikleri, int Age'in doğru bir şekilde ayarlanıp ayarlanmadığını ve geçerli olup olmadığını doğrular. Başarısız olan tüm doğrulamalar, çalışan detayları için beklenen ve rastgele üretilen değerler arasında bir uyumsuzluğa işaret eder.

AutoFixture C# (Geliştiriciler için Nasıl Çalışır): Şekil 2 - Geçerli Çalışan Verisi Birim Testi

IronPDF Tanıtımı

IronPDF C# PDF Kitaplığı, Iron Software tarafından geliştirilen, PDF metni okuma ve HTML kullanarak PDF belgeleri oluşturma işlevlerini mümkün kılan bir güçlü C# PDF kütüphanesidir. Bu çok yönlü araç, stil bilgilerini içeren kolay biçimlenebilir belgeleri yüksek kaliteli PDF'lere dönüştürme becerisine sahiptir. IronPDF ile, HTML metninden PDF'ler oluşturmak, URL'lerden HTML içeriği alıp iyi yapılandırılmış PDF dosyalarına dönüştürmeye olanak tanıyan sorunsuz bir süreçtir. Bu yetenek, web içeriğinden doğrudan profesyonel PDF belgeleri oluşturmayı otomatikleştirmeyi ve kolaylaştırmayı düşünen geliştiriciler için IronPDF'i önemli bir araç yapmaktadır.

AutoFixture C# (Geliştiriciler için Nasıl Çalışır): Şekil 3 - IronPDF

IronPDF Kurulumu

NuGet Paket Yöneticisi konsolunu açın ve aşağıdaki komutu çalıştırın:

Install-Package IronPdf

IronPDF ile AutoFixture'un özelliklerini kullanma Kod Örneği

Aşağıda, çalışan verilerinin PDF'ini oluşturmak için IronPDF ile birlikte AutoFixture kullanmayı gösteren bir örnek var:

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();
    }
}
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 Class
$vbLabelText   $csharpLabel

Bu sınıfı kullanmak için EmployeePdfGenerator örneğini oluşturur, çalışanlar listesi üretir ve ardından GeneratePdf'i çağırırsınız:

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");
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")
$vbLabelText   $csharpLabel

AutoFixture C# (Geliştiriciler için Nasıl Çalışır): Şekil 4 - IronPDF Çıkışlı Autofixture

Kod Açıklaması

Verilen C# kodu, çalışanları ve yaşlarını listeleyen bir PDF belgesi oluşturmak için IronPDF kütüphanesini kullanır. EmployeePdfGenerator sınıfını tanımlar, bu yöntemi GeneratePdf içerir ve bir Employee nesnesi listesi ile bir dosya yolu alır. İçsel olarak, GenerateHtml yöntemiyle HTML içeriği oluşturur, ardından IronPDF'nin HtmlToPdf sınıfını kullanarak bu HTML'i belirtilen dosya yolunda kaydedilen bir PDF olarak işler. Geliştirmeler, HTML oluşturma için StringBuilder kullanımını ve PDF oluşturma ve dosya kaydı için temel hata ayıklama eklemeyi içerir.

Bir Test Metodu Yazma

Aşağıdaki kurulumda, rastgele verilere olanak tanıyan Employee sınıfının örneklerini oluşturmak için AutoFixture kullanılır. IronPDF, çalışan bilgilerini içeren HTML içeriğini PDF formatına sorunsuz bir şekilde dönüştürmek için kullanılır. EmployeePdfGenerator sınıfı, hem veri üretimini hem de PDF dönüşümünü verimli bir şekilde yöneterek bu süreçleri düzenler. Bu süreçte, EmployeePdfGeneratorTests XUnit test sınıfı, dikkatli testlerle PDF oluşturmanın düzgün çalışmasını sağlar. Bu entegre yaklaşım, çalışan verilerinin üretilmesini ve belgelenmesini basitleştirir, PDF üretim işleminin güvenilirliği ve sağlamlığı sağlanır.

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));
    }
}
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 Class
$vbLabelText   $csharpLabel

EmployeePdfGeneratorTests sınıfı, GeneratePdf yönteminin doğru çalıştığından emin olarak belirtilen dosya yolunda bir PDF dosyası oluşturulmasını doğrulayan bir test durumu içerir.

AutoFixture C# (Geliştiriciler için Nasıl Çalışır): Şekil 5 - AutoFixture C#

Sonuç

AutoFixture, geliştiricilere test vaka durumlarına odaklanma kolaylığı sağlayarak,. 'Düzenleme' aşamasını basitleştiren ve kurulum ayrıntılarından ziyade birim testleri ile ilgilenmeyi sağlayan .NET birim testleri yazma sürecini daha verimli hale getirir. Birim test sürecini kolaylaştırır ve otomatik olarak test verileri üreterek çeşitli ve gerçekçi girdilerin olmasını sağlar. IronPDF Lisanslama Bilgisi ile birlikte, sürekli kullanım ve destek için güçlü bir kombinasyon sunar.

Sıkça Sorulan Sorular

C#'da AutoFixture kullanarak test verilerini nasıl oluşturabilirim?

C#'da test verileri oluşturmak için AutoFixture'un 'Fixture' sınıfını kullanabilirsiniz. Bu sınıf, sınıfların örneklerini rastgele verilerle otomatik olarak oluşturmanıza olanak tanır ve bu da çeşitli test senaryolarını verimli bir şekilde kurmanıza yardımcı olur.

Bir .NET projesinde AutoFixture'ın kurulum adımları nelerdir?

AutoFixture'ı bir .NET projesine kurmak için, NuGet Paket Yöneticisi Konsolu'nda Install-Package AutoFixture komutunu kullanabilirsiniz. Ayrıca, Visual Studio'nun NuGet Paket Yöneticisi ara yüzünden AutoFixture'ı aratıp projenize ekleyebilirsiniz.

AutoFixture birim testi sürecini nasıl geliştirir?

AutoFixture, gerçekçi ve çeşitli test verileri otomatik olarak üreterek birim testi sürecini geliştirir. Bu, manuel kurulum ihtiyaçını azaltır ve testlerin geniş bir girdi aralığında gerçekleştirilmesini sağlar, böylece test kapsamını ve güvenilirliğini artırır.

AutoFixture, .NET'te PDF oluşturma kütüphaneleriyle entegre edilebilir mi?

Evet, AutoFixture .NET'te IronPDF gibi PDF oluşturma kütüphaneleriyle entegre edilebilir. AutoFixture kullanarak veri oluşturup, IronPDF'un HTML'den PDF'ye çevirme yeteneklerinden faydalanarak, çalışan verileri gibi dinamik içerikler içeren PDF'ler oluşturabilirsiniz.

'Fixture' sınıfının AutoFixture'daki amacı nedir?

AutoFixture'daki 'Fixture' sınıfı, test kurulumunu basitleştirmek için tasarlanmıştır ve otomatik olarak test verileri oluşturur. Bu, geliştiricilerin verilerin manuel kurulumu yerine daha fazla test lojistiğine odaklanmalarını sağlar.

AutoFixture, Test Odaklı Geliştirme'yi (TDD) nasıl kolaylaştırır?

AutoFixture, test verilerini kolayca üretme işlevi sağlayarak Test Odaklı Geliştirme'yi (TDD) destekler. Bu, geliştiricilerin işlevselliği uygularken ve testler yazarken veri kurulumuna aşırı zaman harcamadan süreci kolaylaştırır ve TDD sürecinin daha verimli hale gelmesine katkıda bulunur.

AutoFixture ve PDF kütüphanelerini kullanarak C#'da nasıl belge oluşturmayı otomatikleştirebilirim?

C#'da belge oluşturmayı AutoFixture ve IronPDF gibi bir PDF kütüphanesi ile birleştirerek otomatikleştirebilirsiniz. AutoFixture, belge için gereken verileri üretebilirken, IronPDF bu verileri HTML formatında biçimlendirip verimli bir şekilde bir PDF belgesine dönüştürebilir.

Jacob Mellor, Teknoloji Direktörü @ Team Iron
Jacob Mellor
  Mühendislik takımıyla şimdi sohbet edin
Chief Technology Officer

Jacob Mellor, Iron Software'in Teknoloji Müdürü ve C# PDF teknolojisinin öncüsü olan vizyoner bir mühendis. Iron Software’in temel kod tabanının ilk geliştiricisi olarak, şirketin ürün mimarisini kuruluşundan bu yana şekillendirdi ve CEO Cameron Rimington ile birlikte NASA, Tesla ve ...

Daha Fazlasını Oku

İlgili Makaleler

30 günlük deneme → Tam ürün. Sınırlama yok. Kart gerekmez. Ücretsiz Deneme Başlat

Iron Destek Ekibi

Haftanın 5 günü, 24 saat çevrimiçiyiz.
Sohbet
E-posta
Beni Ara