.NET Projelerinde Specflow Kurulumu

.NET projelerinizde Specflow kullanmaya başlamak için, öncelikle Specflow NuGet paketini yükleyerek test çerçevenizi kurmanız, özellik dosyaları oluşturmanız ve test senaryolarını tanımlamanız gerekiyor.

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

Temel Kod Örneği

Specflow kurulduktan sonra, özellikler klasöründe yer alacak olan ilk özellik dosyanızı oluşturabilirsiniz. Specflow'da bir özellik dosyası, test etmek istediğiniz davranışları okunabilir bir formatta özetler. İşte yeni bir özellik dosyası oluşturmak ve senaryolar tanımlamak için basit bir örnek:

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 için sahneyi kurar. When işlemi açıklar. Then beklenen sonucu tanımlar. Bu ifadeleri sade bir şekilde İngilizce yazıyorsunuz. Bu, testin akışını ve amacını anlamayı kolaylaştırır.

Adım Tanımlarıyla Test Yazma

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

[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 metot, belirli adımları tanımak için bir dize anahtarı gibi bir Specflow özniteliği ile etiketlenmiştir.

Veri Odaklı Testler

Specflow, senaryolarınızda çeşitli test veri setlerini kullanmanıza olanak tanıyarak veri odaklı testleri destekler. Bu, çeşitli veri setleriyle senaryoları test etmenize olanak tanır. İşte bir özellik dosyasında tablo kullanma örneği:

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 veriye ş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 entegredir; burada tüm testleri verimli bir şekilde çalıştırabilir ve yönetebilirsiniz. Bu, testlerinizi çalıştırmayı ve yönetmeyi kolay hale getirir. Projenizin doğru bir şekilde yapılandırıldığından emin olun. Projeyi derlediğinizde testleriniz Test Gezgini'nde görünecektir. Tek tek testleri veya tüm testleri aynı anda çalıştırabilirsiniz.

Paralel Test Yürütme

Specflow, tüm testlerin yürütme süresini azaltan paralel test yürütmeyi destekler. Tüm testlerin yürütülmesi için gereken süreyi azaltır. Paralel yürütmeyi etkinleştirmek için specflow.json dosyanızı veya AssemblyInfo.cs dosyasınızı yapılandırmanız gerekir:

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

Bu yapılandırma, aynı anda dört testin çalışmasına olanak tanır.

Özel Kancalar

Specflow özel kancalar tanımlamanıza olanak tanır. Bu kancalar, test yaşam döngüsünün çeşitli noktalarında kod çalıştırabilir. Herhangi bir test çalıştırılmadan önce veritabanını ayarlamak için bir kancanın nasıl tanımlanacağına yönelik bir örnek:

[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 işlemlerini yönetmenize yardımcı olur.

Bu bölüm, .NET projelerinde test çerçevenizi geliştirmenize yardımcı olabilecek Specflow'un beş ana özelliğini gösterdi. Her özellik, test otomasyon ç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 ile Specflow'un birleştirilmesinin pratik bir kullanım durumu, uygulamanız tarafından oluşturulan 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 belirtilen gereklilikler içinde erişilebilir olup olmadığını otomatik olarak test edebilirsiniz. Bu entegrasyon, doğruluk belgelemesinin, örneğin fatura veya uyum raporlarının önemli olduğu senaryolarda özellikle kullanışlıdır.

IronPDF'i kurduğunuzdan emin olun. NuGet Paket konsolunu kullanarak yükleyebilirsiniz:

Install-Package IronPdf

Kullanım Durumuna Ait Kod Örneği

İşte IronPDF kullanarak PDF içeriğini test etmek için bir SpecFlow adım tanımının nasıl ayarlanacağını gösteren tam bir kod örneği. Bu örnek, uygulamanız tarafından üretilen ve belirli bir metin 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 belirlenen bir yoldan bir PDF yükleyen ve ardından bu PDF'nin beklenen metni içerdiğini doğrulayan bir Specflow adımı tanımlıyoruz. IronPdf.PdfDocument sınıfı, PDF dosyasını yüklemek ve işlemek için kullanılır. Bu kurulum, PDF doğrulamasını otomatik testlerinize entegre etmenize olanak tanır, bu da hataları yakalamayı kolaylaştırır.