.NET Projelerinde Specflow Kurulumu

Specflow'u .NET projelerinizde kullanmaya başlamak için, önce test çerçevenizi kurmak, özellik dosyaları oluşturmak ve test senaryolarını tanımlamak için Specflow NuGet paketini yüklemeniz gerekir.

1. Visual Studio'yu açın.
2. Yeni bir .NET projesi oluşturun veya mevcut bir tanesini açın.
3. Uzantılar menüsüne gidin ve ardından Uzantıları Yönet'i seçin.
4. "Specflow" için arama yapın. Specflow uzantısını yükleyin.

Temel Bir Kod Örneği

Specflow kurulduktan sonra, özellikler klasöründe yer alacak ilk özellik dosyanızı oluşturabilirsiniz. Specflow'daki bir özellik dosyası, okunabilir bir formatta test etmek istediğiniz davranışları özetler. Yeni bir özellik dosyası oluşturmanın ve senaryoları tanımlamanın basit bir örneği burada:

Feature: Login Feature
    Scenario: Successful Login with Valid Credentials
        Given I am on the login page
        When I enter valid credentials
        Then I should be redirected to the dashboard

Bu özellik dosyası, temel bir giriş işlemini tanımlar. Given testi hazırlık sahnesine koyar. When hareketi tanımlar. Then beklenen sonucu tanımlar. Bu ifadeleri sade İngilizce ile yazarsınız. Bu, testin akışını ve amacını anlamayı kolaylaştırır.

Adım Tanımları ile Test Yazma

Specflow'da testler, özellik dosyalarında özetlenen senaryolar tarafından yönlendirilir. Bu senaryoları çalıştırılabilir hale getirmek için adım tanımlamalarına ihtiyaçınız var. Adım tanımları, sade dildeki adımları C# koduyla bağlar. Adım tanımlarını nasıl tanımlayacağınız işte burada:

[Binding]
public class LoginSteps
{
    [Given(@"I am on the login page")]
    public void GivenIAmOnTheLoginPage()
    {
        // Code to navigate to the login page
    }

    [When(@"I enter valid credentials")]
    public void WhenIEnterValidCredentials()
    {
        // Code to input username and password
    }

    [Then(@"I should be redirected to the dashboard")]
    public void ThenIShouldBeRedirectedToTheDashboard()
    {
        // Code to verify the dashboard is displayed
    }
}

[Binding]
public class LoginSteps
{
    [Given(@"I am on the login page")]
    public void GivenIAmOnTheLoginPage()
    {
        // Code to navigate to the login page
    }

    [When(@"I enter valid credentials")]
    public void WhenIEnterValidCredentials()
    {
        // Code to input username and password
    }

    [Then(@"I should be redirected to the dashboard")]
    public void ThenIShouldBeRedirectedToTheDashboard()
    {
        // Code to verify the dashboard is displayed
    }
}

<Binding>
Public Class LoginSteps
	<Given("I am on the login page")>
	Public Sub GivenIAmOnTheLoginPage()
		' Code to navigate to the login page
	End Sub

	<[When]("I enter valid credentials")>
	Public Sub WhenIEnterValidCredentials()
		' Code to input username and password
	End Sub

	<[Then]("I should be redirected to the dashboard")>
	Public Sub ThenIShouldBeRedirectedToTheDashboard()
		' Code to verify the dashboard is displayed
	End Sub
End Class

Bu C# sınıfı, giriş senaryosunun adımlarını temsil eder. Her yöntem, belirli adımları tanımlayan bir dize anahtarı gibi adım türüne karşılık gelen bir Specflow etiketi ile etiketlenmiştir.

Veri Odaklı Test

Specflow, senaryolarınızda çeşitli test verileri setlerini kullanmanıza izin vererek veri odaklı testi destekler. Bu, senaryoları çeşitli veri setleriyle test etmenizi sağlar. Bir özellik dosyasındaki bir tabloyu kullanarak bir örnek:

Scenario: Login with multiple users
    Given I am on the login page
    When I login with the following credentials:
        | Username  | Password |
        | user1     | pass1    |
        | user2     | pass2    |
    Then I should see user specific dashboard

Adım tanımlarınızda, bu verilere şu şekilde erişebilirsiniz:

[When(@"I login with the following credentials:")]
public void WhenILoginWithTheFollowingCredentials(Table table)
{
    foreach(var row in table.Rows)
    {
        string username = row["Username"];
        string password = row["Password"];
        // Code to perform login
    }
}

[When(@"I login with the following credentials:")]
public void WhenILoginWithTheFollowingCredentials(Table table)
{
    foreach(var row in table.Rows)
    {
        string username = row["Username"];
        string password = row["Password"];
        // Code to perform login
    }
}

<[When]("I login with the following credentials:")>
Public Sub WhenILoginWithTheFollowingCredentials(ByVal table As Table)
	For Each row In table.Rows
		Dim username As String = row("Username")
		Dim password As String = row("Password")
		' Code to perform login
	Next row
End Sub

Test Gezgini ile Entegrasyon

Specflow, Visual Studio'nun Test Gezgini ile entegre olur ve burada tüm testleri verimli bir şekilde çalıştırabilir ve yönetebilirsiniz. Bu, testlerinizi çalıştırmayı ve yönetmeyi kolaylaştırır. Projenizin doğru yapılandırıldığından emin olun. Projenizi derlediğinizde, testleriniz Test Gezgini'nde görünecektir. Tek tek testleri veya tüm testleri bir kerede çalıştırabilirsiniz.

Paralel Test Yürütme

Specflow, genel yürütme süresini azaltmak için paralel testler çalıştırmayı destekler. Bu, tüm testleri çalıştırma süresini azaltır. Paralel yürütmeyi etkinleştirmek için specflow.json dosyanızı veya AssemblyInfo.cs yapılandırmanız gerekiyor:

{
  "specFlow": {
    "runtime": {
      "testThreadCount": 4,
      "testSchedulingMode": "Parallel"
    }
  }
}

Bu yapılandırma, aynı anda dört teste kadar çalışmasına izin verir.

Özel Kancalar

Specflow, özel kancaları tanımlamanıza izin verir. Bu kancalar, test yaşam döngüsünün çeşitli noktalarında kod çalıştırabilir. İşte herhangi bir testi çalıştırmadan önce bir veritabanı kurmak için bir kanca nasıl tanımlanır:

[BeforeTestRun]
public static void SetUpDatabase()
{
    // Code to set up database
}

[BeforeTestRun]
public static void SetUpDatabase()
{
    // Code to set up database
}

<BeforeTestRun>
Public Shared Sub SetUpDatabase()
	' Code to set up database
End Sub

Özel kancalar, güçlü bir özelliktir. Test kurulum ve yıkım süreçlerini yönetmenize yardımcı olurlar.

Bu bölüm, .NET projelerinizde test çerçevenizi geliştirebilecek beş ana Specflow özelliğini ele aldı. Her özellik, test otomasyonu çabalarınızın esnekliğini ve verimliliğini artırmak için tasarlanmıştır.

Use Case of Merging IronPDF with Specflow C

IronPDF ve Specflow'u birleştirmenin pratik bir kullanım örneği, uygulamanız tarafından üretilen bir PDF raporunun içeriğini ve biçimlendirmesini doğrulamaktır. Örneğin, bir raporun doğru verileri içerip içermediğini, beklenen düzene uyup uymadığını ve belirlenen gereksinimler dahilde erişilebilir olup olmadığını otomatik olarak test edebilirsiniz. Bu entegrasyon, özellikle faturalar veya uyum raporları gibi doğru belgelemenin önemli olduğu senaryolarda faydalı olur.

IronPDF'i yüklediğinizden emin olun. NuGet Paket konsolunu kullanarak kurabilirsiniz:

Install-Package IronPdf

Kullanım Örneğinin Kod Örneği

IronPDF kullanarak PDF içeriğini test etmek için bir SpecFlow adım tanımı kurmayı gösteren bir kod örneği işte burada. Bu örnek, uygulamanız tarafından üretilen ve belirli metni içermesi gereken bir PDF belgesini test ettiğinizi varsayar.

using IronPdf;
using TechTalk.SpecFlow;

[Binding]
public class PdfContentSteps
{
    private string? _pdfPath;
    private PdfDocument? _pdfDocument;

    [Given(@"a PDF file generated at '(.*)'")]
    public void GivenAPDFFileGeneratedAt(string pdfPath)
    {
        _pdfPath = pdfPath;
        _pdfDocument = new PdfDocument(_pdfPath);
    }

    [Then(@"the PDF should contain the text '(.*)'")]
    public void ThenThePDFShouldContainTheText(string expectedText)
    {
        // Extract text from the PDF and check if it contains the expected text
        var textContent = _pdfDocument.ExtractAllText();
        if (!textContent.Contains(expectedText))
        {
            throw new Exception("PDF content does not contain the expected text.");
        }
    }
}

using IronPdf;
using TechTalk.SpecFlow;

[Binding]
public class PdfContentSteps
{
    private string? _pdfPath;
    private PdfDocument? _pdfDocument;

    [Given(@"a PDF file generated at '(.*)'")]
    public void GivenAPDFFileGeneratedAt(string pdfPath)
    {
        _pdfPath = pdfPath;
        _pdfDocument = new PdfDocument(_pdfPath);
    }

    [Then(@"the PDF should contain the text '(.*)'")]
    public void ThenThePDFShouldContainTheText(string expectedText)
    {
        // Extract text from the PDF and check if it contains the expected text
        var textContent = _pdfDocument.ExtractAllText();
        if (!textContent.Contains(expectedText))
        {
            throw new Exception("PDF content does not contain the expected text.");
        }
    }
}

Imports IronPdf
Imports TechTalk.SpecFlow

<Binding>
Public Class PdfContentSteps
'INSTANT VB WARNING: Nullable reference types have no equivalent in VB:
'ORIGINAL LINE: private string? _pdfPath;
	Private _pdfPath As String
	Private _pdfDocument? As PdfDocument

	<Given("a PDF file generated at '(.*)'")>
	Public Sub GivenAPDFFileGeneratedAt(ByVal pdfPath As String)
		_pdfPath = pdfPath
		_pdfDocument = New PdfDocument(_pdfPath)
	End Sub

	<[Then]("the PDF should contain the text '(.*)'")>
	Public Sub ThenThePDFShouldContainTheText(ByVal expectedText As String)
		' Extract text from the PDF and check if it contains the expected text
		Dim textContent = _pdfDocument.ExtractAllText()
		If Not textContent.Contains(expectedText) Then
			Throw New Exception("PDF content does not contain the expected text.")
		End If
	End Sub
End Class

Bu kodda, önce belirtilen bir yoldan bir PDF yükleyen ve ardından bu PDF'nin beklenen metni içerip içermediğini doğrulayan bir Specflow adımı tanımlarız. IronPdf.PdfDocument sınıfı, PDF dosyasını yüklemek ve manipüle etmek için kullanılır. Bu kurulum, PDF doğrulamasını otomatik testlerinize entegre etmenize olanak tanır, hataları yakalamayı kolaylaştırır.