C# Unit Testing (Geliştiriciler için Nasıl Çalışır)

Birim Test Projesi Oluşturma

C# dilinde birim testi yapmaya başlamak için Visual Studio'da bir birim test projelerinden birini kurmanız gerekecek. Visual Studio, yerleşik bir birim test çerçevesi sunar ve bu başlangıcı oldukça kolaylaştırır. Yeni bir proje oluştururken, C# kategorisi altında "Birim Test Projesi" şablonunu seçin. Bu şablon, birim testleri oluşturmak ve bunları verimli bir şekilde çalıştırmak için ihtiyacınız olan her şeyi ayarlar.

using Microsoft.VisualStudio.TestTools.UnitTesting;
using System;

namespace Unit_Test_Project_Example
{
    // A simple calculator class with an Add method
    public class Calculator
    {
        public int Add(int a, int b)
        {
            return a + b;
        }
    }

    // A test class to validate the functionality of the Calculator class
    [TestClass]
    public class CalculatorTests
    {
        // A test method to check if the Add method in Calculator returns the correct sum
        [TestMethod]
        public void Add_ShouldReturnCorrectSum()
        {
            // Arrange
            var calculator = new Calculator();

            // Act
            var result = calculator.Add(2, 2);

            // Assert
            Assert.AreEqual(4, result);
        }
    }
}

using Microsoft.VisualStudio.TestTools.UnitTesting;
using System;

namespace Unit_Test_Project_Example
{
    // A simple calculator class with an Add method
    public class Calculator
    {
        public int Add(int a, int b)
        {
            return a + b;
        }
    }

    // A test class to validate the functionality of the Calculator class
    [TestClass]
    public class CalculatorTests
    {
        // A test method to check if the Add method in Calculator returns the correct sum
        [TestMethod]
        public void Add_ShouldReturnCorrectSum()
        {
            // Arrange
            var calculator = new Calculator();

            // Act
            var result = calculator.Add(2, 2);

            // Assert
            Assert.AreEqual(4, result);
        }
    }
}

Imports Microsoft.VisualStudio.TestTools.UnitTesting
Imports System

Namespace Unit_Test_Project_Example
	' A simple calculator class with an Add method
	Public Class Calculator
		Public Function Add(ByVal a As Integer, ByVal b As Integer) As Integer
			Return a + b
		End Function
	End Class

	' A test class to validate the functionality of the Calculator class
	<TestClass>
	Public Class CalculatorTests
		' A test method to check if the Add method in Calculator returns the correct sum
		<TestMethod>
		Public Sub Add_ShouldReturnCorrectSum()
			' Arrange
			Dim calculator As New Calculator()

			' Act
			Dim result = calculator.Add(2, 2)

			' Assert
			Assert.AreEqual(4, result)
		End Sub
	End Class
End Namespace

Test Yöntemlerini ve Test Sınıflarını Anlama

Bir birim test projesinde, testleri sınıflara ve yöntemlere organize edersiniz. Bir test sınıfı, bir arada çalıştırılması gereken birim test yöntemleri koleksiyonunu temsil eder. Her bir birim test yöntemi, [TestMethod] niteliği ile işaretlenmiştir ve kodunuzun belirli bir fonksiyonunu test etme mantığını içerir. Test sınıfının kendisi [TestClass] niteliği ile işaretlenmiştir ve test çerçevesine çalıştırılacak testleri içerdiğini bildirir.

Visual Studio'da Test Gezgini Kullanma

Visual Studio Test Gezgini penceresi, tüm test yöntemlerini çalıştırmak ve yönetmek için merkez hub'ınızdır. Tüm testleri, bir test seçimini veya bireysel testleri çalıştırabilirsiniz. Testleri çalıştırdıktan sonra, Test Gezgini geçen ve başarısız olan testlerin ayrıntılı bir özetini sağlayarak sorunları hızlıca tanımlamanıza ve ele almanıza olanak tanır.

Test Sonuçlarını Yorumlama

• Geçen Testler: Bu testler başarılıyla çalıştırılmıştır ve test edilen kodun belirtilen koşullar altında beklenildiği gibi davrandığını gösterir.
• Başarısız Testler: Bunlar, beklentiler ve gerçek sonuçlar arasındaki bir uyumsuzluğu gösterir ve gereksinimlerde veya test kodunda potansiyel hatalar veya yanlış anlaşılmalara işaret edebilir.

Kod tabanınızda sorunların erken uyarı işaretlerini sağladıkları için başarısız testleri hemen incelemek önemlidir.

Testleri Etkili Bir Şekilde Düzenleme

Büyük bir test paketi sürdürmenin anahtarı iyi organizasyondur. Testlerinizi, kapladıkları işlevselliklere göre mantıklı bir şekilde gruplayın. Her testin neyi doğruladığını belirtmek için test yöntemlerinize ve sınıflarınıza açıklayıcı adlar kullanın. Bu yaklaşım, test paketi büyüdükçe testleri bulmayı ve anlamayı kolaylaştırır.

Soyutlama ve Bağımlılık Enjeksiyonu

Sıklıkla, test ettiğiniz kod, dış kaynaklarla veya uygulamanızın diğer parçalarıyla etkileşime geçer. Bu tür durumlarda, Moq veya NSubstitute gibi soyutlama çerçevelerini kullanarak taklit nesneler oluşturun. Bu stand-in'ler gerçek nesnelerin davranışını taklit eder, böylece kodunuzu izole bir şekilde test etmenizi sağlar. Bağımlılık enjeksiyonu, kodunuzu daha test edilebilir hale getirir çünkü test sırasında gerçek bağımlılıkları taklitlerle veya stub'larla değiştirmenize olanak tanır.

using Microsoft.VisualStudio.TestTools.UnitTesting;
using Moq;

// A sample test class demonstrating the use of mocks
[TestClass]
public class ProductServiceTests
{
    // A test method to verify the GetProductById method of ProductService
    [TestMethod]
    public void GetProductById_ShouldReturnCorrectProduct()
    {
        // Arrange
        var mockRepository = new Mock<IProductRepository>();
        mockRepository.Setup(x => x.FindById(1)).Returns(new Product { Id = 1, Name = "Laptop" });

        ProductService productService = new ProductService(mockRepository.Object);

        // Act
        Product result = productService.GetProductById(1);

        // Assert
        Assert.IsNotNull(result);
        Assert.AreEqual("Laptop", result.Name);
    }
}

using Microsoft.VisualStudio.TestTools.UnitTesting;
using Moq;

// A sample test class demonstrating the use of mocks
[TestClass]
public class ProductServiceTests
{
    // A test method to verify the GetProductById method of ProductService
    [TestMethod]
    public void GetProductById_ShouldReturnCorrectProduct()
    {
        // Arrange
        var mockRepository = new Mock<IProductRepository>();
        mockRepository.Setup(x => x.FindById(1)).Returns(new Product { Id = 1, Name = "Laptop" });

        ProductService productService = new ProductService(mockRepository.Object);

        // Act
        Product result = productService.GetProductById(1);

        // Assert
        Assert.IsNotNull(result);
        Assert.AreEqual("Laptop", result.Name);
    }
}

Imports Microsoft.VisualStudio.TestTools.UnitTesting
Imports Moq

' A sample test class demonstrating the use of mocks
<TestClass>
Public Class ProductServiceTests
	' A test method to verify the GetProductById method of ProductService
	<TestMethod>
	Public Sub GetProductById_ShouldReturnCorrectProduct()
		' Arrange
		Dim mockRepository = New Mock(Of IProductRepository)()
		mockRepository.Setup(Function(x) x.FindById(1)).Returns(New Product With {
			.Id = 1,
			.Name = "Laptop"
		})

		Dim productService As New ProductService(mockRepository.Object)

		' Act
		Dim result As Product = productService.GetProductById(1)

		' Assert
		Assert.IsNotNull(result)
		Assert.AreEqual("Laptop", result.Name)
	End Sub
End Class

Veri Tabanlı Testleri Kullanma

Veri tabanlı testler, aynı test yöntemini farklı giriş verileriyle birden çok kez çalıştırmanızı sağlar. Bu teknik, birden fazla test yöntemi yazmadan geniş bir giriş aralığını ve senaryoyu test etmek için özellikle yararlıdır. Visual Studio, verileri tuplan verisinden, CSV dosyalarından veya veritabanlarından almanızı sağlayarak veri tabanlı testleri destekler.

Onayları Etkili Bir Şekilde Anlama ve Kullanma

Onaylar, test yöntemlerinizin kalbidir çünkü testlerinizin sonuçlarını doğrularlar. Test çerçevenizde mevcut olan onay yöntemlerinin kapsamını anlayın ve beklenen değerleri, istisnaları veya koşulları kontrol etmek için uygun şekilde kullanın. Doğru onayı kullanmak testlerinizi daha net ve güvenilir hale getirir.

Süreli Entegrasyon ve Test Otomasyonu

Birim testlerinizi sürekli entegrasyon (CI) boru hattınıza entegre edin. Bu, her kod tabanına yapılan değişiklikte testlerin otomatik olarak çalışmasını sağlayarak, sorunları erken aşamada yakalamanızı ve düzeltmenizi sağlar. Otomasyon ayrıca testleri sık ve düzenli olarak çalıştırmayı kolaylaştırır, bu da sağlıklı bir kod tabanı sürdürmek için önemlidir.

Testleri ve Üretim Kodunu Uyumlu Tutma

Birim testleriniz, üretim koduyla uyumu kadar iyidir. Fonksiyonlardaki herhangi bir değişikliğin, ilgili birim testlerinde yansıdığından emin olun. Bu uygulama, güncel olmayan testlerin yanlış şekilde geçmesini önler ve test paketinizi uygulamanızın durumunu doğru bir şekilde temsil eder hale getirir.

Başarısız Testlerden Öğrenme

Bir test başarısız olduğunda, öğrenme ve gelişme için bir fırsattır. Başarısız bir test, beklenmedik davranışları, yanlış varsayımları veya kodunuzun gereğinden daha karmaşık ve hataya meyilli olan alanlarını ortaya çıkarabilir. Başarısız testleri dikkatlice analiz edin ve bunların altında yatan nedenleri anlamak için bu anlayışları hem testlerinizi hem de üretim kodunuzu geliştirmek için kullanın.

Kod Örneği

İşte C# birim testi senaryosunda IronPDF'i nasıl kullanabileceğinize dair bir örnek. HTML içeriğinden bir PDF oluşturan bir fonksiyonu test etmek istediğinizi varsayalım. IronPDF'i kullanarak HTML'yi bir PDF olarak işleyebilir ve ardından test olarak PDF'nin varlığını veya içeriğini doğrulayabilirsiniz:

using IronPdf;
using Microsoft.VisualStudio.TestTools.UnitTesting;
using System;
using System.IO;

// A sample test class to verify PDF generation
[TestClass]
public class PdfGenerationTests
{
    // A test method to verify HTML to PDF generation using IronPDF
    [TestMethod]
    public void TestHtmlToPdfGeneration()
    {
        IronPdf.License.LicenseKey = "License-Key"; // Set your IronPDF license key

        var renderer = new ChromePdfRenderer();

        // Render HTML to a PDF
        var pdf = renderer.RenderHtmlAsPdf("<h1>Hello, world!</h1>");

        string filePath = Path.Combine(Path.GetTempPath(), "test.pdf");

        // Save the generated PDF to a file
        pdf.SaveAs(filePath);

        // Assert the PDF file was created successfully
        Assert.IsTrue(File.Exists(filePath), "The generated PDF does not exist.");

        // Additional assertions to verify the PDF content could be added here
        // Clean up generated file
        File.Delete(filePath);
    }
}

using IronPdf;
using Microsoft.VisualStudio.TestTools.UnitTesting;
using System;
using System.IO;

// A sample test class to verify PDF generation
[TestClass]
public class PdfGenerationTests
{
    // A test method to verify HTML to PDF generation using IronPDF
    [TestMethod]
    public void TestHtmlToPdfGeneration()
    {
        IronPdf.License.LicenseKey = "License-Key"; // Set your IronPDF license key

        var renderer = new ChromePdfRenderer();

        // Render HTML to a PDF
        var pdf = renderer.RenderHtmlAsPdf("<h1>Hello, world!</h1>");

        string filePath = Path.Combine(Path.GetTempPath(), "test.pdf");

        // Save the generated PDF to a file
        pdf.SaveAs(filePath);

        // Assert the PDF file was created successfully
        Assert.IsTrue(File.Exists(filePath), "The generated PDF does not exist.");

        // Additional assertions to verify the PDF content could be added here
        // Clean up generated file
        File.Delete(filePath);
    }
}

Imports IronPdf
Imports Microsoft.VisualStudio.TestTools.UnitTesting
Imports System
Imports System.IO

' A sample test class to verify PDF generation
<TestClass>
Public Class PdfGenerationTests
	' A test method to verify HTML to PDF generation using IronPDF
	<TestMethod>
	Public Sub TestHtmlToPdfGeneration()
		IronPdf.License.LicenseKey = "License-Key" ' Set your IronPDF license key

		Dim renderer = New ChromePdfRenderer()

		' Render HTML to a PDF
		Dim pdf = renderer.RenderHtmlAsPdf("<h1>Hello, world!</h1>")

		Dim filePath As String = Path.Combine(Path.GetTempPath(), "test.pdf")

		' Save the generated PDF to a file
		pdf.SaveAs(filePath)

		' Assert the PDF file was created successfully
		Assert.IsTrue(File.Exists(filePath), "The generated PDF does not exist.")

		' Additional assertions to verify the PDF content could be added here
		' Clean up generated file
		File.Delete(filePath)
	End Sub
End Class

Bu örnek, bir HTML dizisinden IronPDF kullanarak bir PDF oluşturup, ardından geçici bir dosyaya kaydeden ve dosyanın varlığını doğrulayan basit bir birim testi gösterir.