BDD

From Logic Wiki
Jump to: navigation, search


Behaviour Driven Development

It's one step ahead of Test Driven Development. BDD

Installation

PM>Install-Package SpecFlow
PM>Install-Package SpecFlow.NUnit

Usage

AppFolder -> features -> step_definitions You may find BDD implementation for .net in http://www.specflow.org/

Example

Feature: Sign up
 Sign up should be quick and friendly.

 Scenario: Successful sign up
   New users should get a confirmation email and be greeted
   personally by the site once signed in.
   Given I have chosen to sign up
   When I sign up with valid details
   Then I should receive a confirmation email
   And I should see a personalized greeting message

 Scenario: Duplicate email
   Where someone tries to create an account for an email address
   that already exists.
   Given I have chosen to sign up
   But I enter an email address that has already registered
   Then I should be told that the email is already registered
   And I should be offered the option to recover my password

Example

  • Create a new Project with C# Class Library and save it (‘SpecflowTest‘ in my example).
  • Download and install NuGet Package Manager using Tools -> Extension Manager. Restart MS Visual Studio in order for the changes to take effect.
  • Go to Package Manager Console install the latest version of Selenium WebDriver by running the command Install-Package Selenium.WebDriver -Version 2.20.0
  • Install the latest version of Selenium WebDriver Support Classes by running the command Install-Package Selenium.Support
  • Download the latest NUnit framework from the site: http://www.nunit.org
  • Install the NUnit software on your machine.
  • In Visual Studio, Go to the Project -> Add Reference menu item.
  • When the Add Reference dialog appears, click on ‘Browse‘ and navigate to C:\Program Files (x86)\NUnit 2.5.10\bin\net-2.0\framework and select nunit.framework.dll.
  • Download the latest NUnit framework from the site: http://www.specflow.org/
  • Install the SpecFlow software on your machine.
  • In Visual Studio, Go to the Project -> Add Reference menu item.
  • When the Add Reference dialog appears, click on ‘Browse‘ and navigate to C:\Program Files (x86)\TechTalk\SpecFlow and select TechTalk.SpecFlow.dll.

Consider a sample user story: 

As an end user,
I would like to visit the google search page 
And then I would like to search an item so that
I can view the search results

Let me write a test scenario for the above story: 

Given I am on the Google home page
When I search for text selenium
Then I should see the search results

Creating a new SpecFlow feature file: Context-click on the project name ‘SpecflowTest‘ in the Solution Explorer Select Add -> New Item Select the ‘SpecFlow Feature File‘ and save it as ‘GoogleSearch.feature‘

Specflow creates a new file “GoogleSearch.feature” and a designer file “GoogleSearch.feature.cs“. The default content of the Specflow file is in the Gherkin format. The default content of the file is as shown is below: 

Feature: Addition
 In order to avoid silly mistakes
 As a math idiot
 I want to be told the sum of two numbers

@mytag
Scenario: Add two numbers
 Given I have entered 50 into the calculator
 And I have entered 70 into the calculator
 When I press add
 Then the result should be 120 on the screen

Change the contents of the file to the new scenario as below and the Specflow generates a feature file ‘GoogleSearch.feature.cs': 

Feature: Google Search
 As an end user,
 I would like to visit the google search page
 And then I would like to search an item so that
 I can view the search results

@mytag Scenario: Google Search 

Given I am on the Google home page
When I search for text selenium
Then I should see the search results

* Creating a new SpecFlow Step Definition file:
* Rename the class ‘Class1.cs‘ to ‘GoogleSearchStepDefinition.cs‘.
* Context-click on the feature file ‘GoogleSearch.feature‘ and select …… System generates a specification file ‘…..’ as shown below.

* Debug the project. Go to Projects -> Project Properties (‘SpecflowTest Properties‘ in my example).
* Click on the ‘Debug‘ tab and set the ‘Start external program‘ to the location of NUnit exe file (C:\Program Files (x86)\NUnit 2.5.10\bin\net-2.0\nunit-x86.exe).
* Build the solution, Go to ‘Build -> Build Solution‘ (hit the F6 key) in Visual Studio.
* Execute the test, Go to ‘Debug -> Start Debugging‘ (hit the F5 key) in Visual Studio. Visual Studio invokes the NUnit application.
* In NUnit, click on ‘File -> Open Project‘ and choose the location of the SpecflowTest.dll file.
* In NUnit, click on the ‘Run‘ button to run the tests. Test shows Inconclusive result and the result is displayed in NUnit ‘Text Output’ tab.
* Copy the contents of the NUnit  ‘Text Output‘ tab and paste it in the ‘GoogleSearchStepDefinition.cs‘ step definition file as shown below. The key point here is that the class needs to be annotated with the binding attribute and we can use the (.*) expression to represent variables coming from the feature file.

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using TechTalk.SpecFlow;
namespace SpecflowTest
{
 [Binding]
 class GoogleSearchStepDefinition
  {
 
  [Given(@"I am on the Google home page")]
  public void GivenIAmOnTheGoogleHomePage()
  {
  ScenarioContext.Current.Pending();
  }
 
  [When(@"I search for text (.*)")]
  public void WhenISearchForATextSelenium()
  {
  ScenarioContext.Current.Pending();
  }
 
  [Then(@"I should see the search results")]
  public void ThenIShouldSeeTheSearchResultsForSelenium()
  {
  ScenarioContext.Current.Pending();
  }
 } 
}

Creating a Static Browser class for defining the browser selection: 

* This class is a static helper class for selecting the browser and Selenium has support for Internet Explorer, Firefox and Chrome.
* Context-click on the project name ‘SpecflowTest‘ in the Solution Explorer and select Add -> New Item
* Create a C# file with name ‘WebBrowser.cs‘.
* Now, copy and paste the code below to the ‘WebBrowser.cs‘.



using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using TechTalk.SpecFlow;
using OpenQA.Selenium;
using OpenQA.Selenium.IE;
using OpenQA.Selenium.Firefox;
using OpenQA.Selenium.Chrome;
namespace SpecflowTest
{
   [Binding]
   public class WebBrowser
   {
     public static IWebDriver Current
     {
       get
       {
          if (!ScenarioContext.Current.ContainsKey("browser"))
          {
          //Select IE browser
          ScenarioContext.Current["browser"] = new InternetExplorerDriver();
 
          //Select Firefox browser
          //ScenarioContext.Current["browser"] = new FirefoxDriver();
 
          //Select Chrome browser
          //ScenarioContext.Current["browser"] = new ChromeDriver();
          }
        return (IWebDriver)ScenarioContext.Current["browser"];
        }
      }
 
    [AfterScenario]
    public static void Close()
    {
     if (ScenarioContext.Current.ContainsKey("browser"))
      {
          Current.Dispose();
      }
    }
  }
}

Implementing the Steps:

  • Remove all the methods ‘ScenarioContext.Current.Pending()‘
  • Now, copy and paste the code below to the ‘GoogleSearchStepDefinition.cs‘ as shown below.
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using TechTalk.SpecFlow;
using NUnit.Framework;
using OpenQA.Selenium;
using OpenQA.Selenium.Firefox;
using OpenQA.Selenium.Support.UI;
namespace SpecflowTest
{
 [Binding]
 public class StepDefinition1
 {
 
 [Given(@"I am on the Google home page")]
 public void GivenIAmOnTheGoogleHomePage()
 {
 //Navigate to the site
 WebBrowser.Current.Navigate().GoToUrl("http://www.google.com");
 //Check that the Title is what we are expecting
 Assert.AreEqual("Google", WebBrowser.Current.Title);
 }
 
 [When(@"I search for text (.*)")]
 public void WhenISearchForATextSelenium(string keyword)
 {
 // Find the text input element by its name
 IWebElement query = WebBrowser.Current.FindElement(By.Name("q"));
 // Input the search text
 query.SendKeys(keyword);
 // Now submit the form
 query.Submit();
 
  // Google's search is rendered dynamically with JavaScript.
  // Wait for the page to load, timeout after 5 seconds
  WebDriverWait wait = new WebDriverWait(WebBrowser.Current, TimeSpan.FromSeconds(5));
  IWebElement title = wait.Until<IWebElement>((d) =>
  {
  return d.FindElement(By.ClassName("ab_button"));
  });
 }
 
 [Then(@"I should see the search results")]
 public void ThenIShouldSeeTheSearchResultsForSelenium()
 {
 //Check that the Title is what we are expecting
 Assert.AreEqual("selenium - Google Search", WebBrowser.Current.Title);
 }
 
}
}

Executing the Tests:

  • Build the solution, Go to ‘Build -> Build Solution‘ (hit the F6 key) in Visual Studio.
  • Execute the test, Go to ‘Debug -> Start Debugging‘ (hit the F5 key) in Visual Studio. Visual Studio invokes the NUnit application.
  • In NUnit, click on ‘File -> Open Project‘ and choose the location of the SpecflowTest.dll file.
  • In NUnit, click on the ‘Run‘ button to run the tests. Test is executed using NUnit.
Retrieved from "https://logicwiki.co.uk/index.php?title=BDD&oldid=47"