acceptance & integration testing with behat (phpnw2011)

Acceptance & Integration

Testing Using Behat

Ben WaineEmail: [email protected]

Twitter: @bwaine

Sunday, 9 October 11

mailto:[email protected]

mailto:[email protected]

Roadmap•Intro To Behaviour Driven Development

•Problems We Are Trying to solve at Sky With BDD

•Behat

•API Testing with Behat

•UI Testing with Behat

•Data Driven Testing

•Is Behat solving our problem?


Me

Sky BetPHP / MySQL Stack

PHPUnit / Selenium / Behat

Software EngineerPHP Developer


BehaviourDriven Development

(BDD)


Behaviour-driven development (BDD) takes the position that you can turn an idea for a requirement into implemented, tested, production-ready code simply and effectively, as long as .... everyone knows what’s going on.

- Dan North


- Drinkwater et al 2011

Writing tests first in a customer friendly language


The Problem


The Business Analyst


The Tester


The Developer


The Problem


Behat


Resistance is futile.......Sunday, 9 October 11

What Does It Test?

ScriptsAPI’s

Web PagesModels


Integration Testing !=

Unit Testing


Anatomy Of A Behat Test


My Amazing PHP Conference Website!


Writing Behat Tests

$ben > cd /path/to/projects/tests$ben > behat --init


Writing Behat Tests


Feature Files

Feature: Home Page When visiting the PHPCon site As a site visitor I need to be able to see what ` conferences are coming up


ScenariosScenario: Get all conferences Given there is conference data in the database When I go to the homepage Then I should see three conferences in a table


ScenariosGiven

(Some Context)

When (Some Event)

Then (The Outcome)


Given (Some Context)

Given there is conference data in the database


When (Some Event)

When I go to the homepage

When I use the findConferences method

When I am on "/index.php"

When I fill in "search-text" with "PHP"


Then (The Outcome)

Then I should see three conferences in a table

Then I should get a array of three conferences

Then I should see "PHPNW"


ConferenceService.feature

Feature: ConferenceService Class In order to display conferences on PHPCon site As a developer I need to be able to retrieve conferences

Scenario: Get all conferences Given there is conference data in the database When I use the findConferences method Then I should get a array of three conferences AND it should contain the conference “PHPNW”


Class Methods & Annotations


/ Everybody Stand Back /

Behat Knows Regular Expressions


Copy and paste these methods into FeatureContext.php


Fill in the Feature Context File public function __construct(array $parameters) { $params = array( 'user' => $parameters['database']['username'], 'password' => $parameters['database']['password'], 'driver' => $parameters['database']['driver'], 'path' => $parameters['database']['dbPath'], );

$con = \Doctrine\DBAL\DriverManager::getConnection($params);

$confMapper = new \PHPCon\Conference\Mapper($con); $confService = new \PHPCon\Conference\Service($confMapper);

$this->service = $confService; }


Fill in the Feature Context File

/** * @Given /^there is conference data in the database$/ */ public function thereIsConferneceDataInTheDatabase() { $fileName = self::$dataDir .

'sample-conf-session-data.sql'; self::executeQueriesInFile($fileName); }


Fill in the Feature Context File

/** * @When /^I use the findConferences method$/ */ public function iUseTheFindConferencesMethod() { $this->result = $this->service->findConferences();

}


Fill in the Feature Context File /** *@Then /^I should get an array of (\d+) conferences$/ */ public function iShouldGetAnArrayOfConferences

($numberOfCons) { assertInternalType('array', $this->result); assertEquals($numberOfCons, count($this->result)); }


/** * @Then /^it should contain the * conference "([^"]*)"$/ */ public function itShouldContainTheConference

($confName) { $names = array();

foreach($this->result as $conf) { $names[$conf->getName()] = true; }

if(!array_key_exists($confName, $names)) { throw new \Exception("Conference "

. $confName . " not found"); } }


Ready to run the tests again.....


Failing Test


Add some application code.....


Passing Test!


What about the UI?


Mink


Mink

Goutte Sahi

Zombie.js


Extend Mink Context

Use Bundled steps to create higher level abstractions.

Includes predefined steps


Back To: My Amazing PHP Conference

Website!


Example

Scenario: View all conferences on the homepage Given there is conference data in the database When I am on "/index.php" Then I should see "PHPNW" in the ".conferences" element And I should see "PHPUK" in the ".conferences" element And I should see "PBC11" in the ".conferences" element

Using Minks Bundled Steps


# features/bootstrap/UIContext.php

use Behat\Behat\Context\ClosuredContextInterface, Behat\Behat\Context\BehatContext, Behat\Behat\Exception\PendingException;

use Behat\Gherkin\Node\PyStringNode, Behat\Gherkin\Node\TableNode;

require_once 'mink/autoload.php';

class UIContext extends Behat\Mink\Behat\Context\MinkContext{

}

class FeatureContext

public function __construct(array $parameters) { $this->useContext('subcontext_alias', new UIContext($parameters));

! // REST OF FEATURE CONSTRUCTOR

}


Powerful Headless UI Testing Out The Box


Scenario: View all conferences on the homepage Given there is conference data in the database When I am on the "home" page Then I should see "PHPNW" in the "conferences" table And I should see "PHPUK" in the "conferences" table And I should see "PBC11" in the "conferences" table

Abstracting your scenario


class UIContext extends Behat\Mink\Behat\Context\MinkContext{ protected $pageList = array( "home" => '/index.php'); protected $elementList = array( "conferences table" => '.conferences');

Mink Feature Context


/** * @When /^I am on the "([^"]*)" page$/ */ public function iAmOnThePage($pageName) {

if(!isset($this->pageList[$pageName])) { throw new Exception( 'Page Name: not in page list'); } $page = $this->pageList[$pageName]; return new When("I am on \"$page\""); }


/** * @Then /^I should see "([^"]*)" in the "([^"]*)"$/ */ public function iShouldSeeInThe($text, $element) { if(!isset($this->elementList[$element])) { throw new Exception( 'Element: ' . $element . ‘not in element list'); } $element = $this->elementList[$element]; return new Then("I should see \"$text\" in then\"$element\" element"); }


Javascript Testing with.....

Sahi


Back To: My Amazing PHP Conference

Website!


@javascriptScenario: Use autocomplete functionality to complete a input field Given there is conference data in the database When I am on the "home" page When I fill in "search-text" with "PHP" And I wait for the suggestion box to appear Then I should see "PHPNW"

Example


@javascriptScenario: Use autocomplete functionality to complete a input field Given there is conference data in the database When I am on the "home" page When I fill in "search-text" with "PHP" And I wait for the suggestion box to appear Then I should see "PHPNW"

Great Reuse


// In the UIContext class /**

* @Given /^I wait for the suggestion box to appear$/ */ public function iWaitForTheSuggestionBoxToAppear() { $this->getSession()->wait(5000, "$('.suggestions-results').children().length > 0" ); }


Data


SQL Fixture


Phabric


Back To Our Problem At Sky


Balance.


A whole world of trouble.


Questions?


Behat Github Page: https://github.com/Behat/Behat

Mink On Github: https://github.com/Behat/Mink

Website: http://behat.org/

Phabric On Github: https://github.com/benwaine/Phabric

Links

joind.in: http://joind.in/3592 Sunday, 9 October 11

https://github.com/Behat/Behat

https://github.com/Behat/Behat

https://github.com/Behat/Mink

https://github.com/Behat/Mink

http://behat.org/

http://behat.org/

https://github.com/benwaine/Phabric




http://joind.in/3732

http://joind.in/3732

acceptance & integration testing with behat (phpnw2011)

Technology