i put on my mink and wizard behat

Booking.com@thomas_shone

WE ARE HIRING

Hoare Logic{P} C {Q}

Hodor Logic{P} C {Q}

I put on my mink and

wizard behatQuesting in the world of

front end testing

Why?What's the benefit?

Meet The TeamDon’t feed the druid after midnight

TaskEach test has a different approach

BarbarianQuality Assurance

RangerUnit Test

ClericContinuous Integration

WizardFront End Test

Dreaded Bugbear

Teamwork Wizards are squishy

The glue

Behat(cucumber syntax)

Mink(browser emulation)

Goutte(web driver)

Selenium(web driver)

Zombie(web driver)

Guzzle(curl)

Selenium RC(java)

Zombie.js(node.js)

Feature: Party harmonyAs a leader, I want to ensure harmony and mutual trust, so that we work as a team

Scenario: Teach members to respect others’ property Given that the Wizard has 10 cookies And the Bard eats 1 cookie Then the Bard mysteriously catches fire

Cucumber SyntaxReadable testing language

class FeatureContext … {/** * @Given that the wizard has :num cookies */public function wizardHasCookies($num) {

// $this->wizard is a pre-existing condition... like syphilis$this->wizard->setNumberOfCookies($num);

}}

and converts it intoFeatureContext.php



Cucumber SyntaxWhat’s missing?

Scenario:Given that the wizard has 10 cookiesAnd the Bard eats 1 cookieThen the Bard mysteriously catches fire

Fire spell fizzled (OutOfManaException)

1 scenario (1 failed)3 steps (2 passed, 1 failed)0m0.03s (14.19Mb)

Remember {P} C {Q}Set your starting states


Background:The Wizard’s fire spell is fully chargedAnd the Bard is currently not on fire


Remember {P} C {Q}Set your starting states

???As a leader, I want to ensure harmony and

mutual trust, so that we work as a team

User storiesAs a <role>, I want to <desire> so that

<benefit>

Front end testing is code coverage for your user stories

User storiesCoverage

Features are your contract with the stakeholders

Contract

Scenarios are the use cases that outline the user story

Scenarios

Legend has it...… that someone once convinced their PO to

write all their front end tests.

class MinkContext … {/** * Clicks link with specified id|title|alt|text. *

* @When /^(?:|I )follow "(?P<link>(?:[^"]|\\")*)"$/ */public function clickLink($link) {

$link = $this->fixStepArgument($link); $this->getSession()->getPage()->clickLink($link); }}

Mink provides...MinkContext.php

OK...Lets drop the metaphor and get to actual

code

$ composer require behat/behat="~3.0,>=3.0.5"

Getting started

$ composer require behat/mink-extension="~2.0"

Behat (cucumber syntax)

Mink (browser emulator)

Web drivers$ composer require behat/mink-goutte-driver="~1.0"$ composer require behat/mink-selenium2-driver="~1.2"

$ ./vendor/bin/behat --init

+d features - place your *.feature files here+d features/bootstrap - place your context classes here+f features/bootstrap/FeatureContext.php - place your definitions, transformations and hooks here

InitializeCreate a new test suite

use Behat\MinkExtension\Context\MinkContext;

class FeatureContext extends MinkContext … {…

}

ContextFeatureContext.php

default: suites: default: paths: [ %paths.base%/features/ ] contexts: [ FeatureContext ] extensions: Behat\MinkExtension: base_url: "[your website]" sessions: default: goutte: ~

Configurationbehat.yml

Feature: Authentication and authorisationAs a security conscious developer I wish to ensure that only valid users can access our website.

Scenario: Attempt to login with invalid details Given I am on "/login"

When I fill in "email" with "[email protected]" And I fill in "password" with "invalid" And I press "Login" Then I should see "Invalid Email or Password"

Our first featureauth.feature

$ ./vendor/bin/behat --config behat.yml features/auth.feature

Scenario: Attempt to login with an invalid accountGiven I am on "/login"When I fill in "email" with "[email protected]"And I fill in "password" with "invalid"And I press "Login"Then I should see "Invalid Email or Password"

1 scenarios (1 passed)5 steps (5 passed)

Victoryoutput


Scenario: Attempt to login with invalid details Given I login as "[email protected]" with password "invalid" Then I should see "Invalid Email or Password"

Simplifyauth.feature

Scenario: Attempt to login with an invalid accountGiven I login as "[email protected]" with password "invalid"Then I should see "Invalid Email or Password"

1 scenario (1 undefined) /** * @Given I login as :arg1 with password :arg2 */

public function iLoginAsWithPassword($arg1, $arg2) { throw new PendingException();

}

Simplifyoutput

class FeatureContext … {/**

* @Given I login as :username with password :password */

public function iLoginAsWithPassword($username, $password) {$this->visit("/login");$this->fillField("email", $username);$this->fillField("password", $password);$this->pressButton("Login");

}}

SimplifyFeatureContext.php

Scenario: Attempt to login with an invalid accountGiven I login as "[email protected]" with password "invalid"Then I should see "Invalid Email or Password"

1 scenarios (1 passed)2 steps (2 passed)

Simplifyoutput


Scenario: Attempt to register a new user Given I am on "/signup"

When I fill in "email" with "[email protected]" And I fill in "password" with "valid" And I fill in "password2" with "valid" And I fill in "first_name" with "some"

And I fill in "last_name" with "guy" And I press "Create my speaker profile" Then I should see "You’ve successfully created your account"

Our first hurdleThis ones easy, you do…. oh….

Migration and seedingDoctrine, Propel, Laravel, Phinx

$ composer require robmorgan/phinx="~0.4"

Phinx to the rescueInstall

$ php vendor/bin/phinx initPhinx by Rob Morgan - https://phinx.org. version 0.4.3Created ./phinx.xml

Configuration

$ php vendor/bin/phinx create InitialMigration

Creating

SIDE NOTE

#!/usr/bin/env bashDATABASE="opencfp"mysql -e "DROP DATABASE IF EXISTS $DATABASE" -uroot -p123mysql -e "CREATE DATABASE $DATABASE" -uroot -p123vendor/bin/phinx migratevendor/bin/behat

But it’s a bit extremerun-behat-test.sh

SAVEPOINT identifier;

# Run tests

ROLLBACK TO SAVEPOINT identifier;RELEASE SAVEPOINT identifier;

Transaction/RollbackRoll your own solution

Activation emails?smtp-sink, FakeSMTP, etc

# Stop the currently running servicesudo service postfix stop# Dumps outgoing emails to file as "day.hour.minute.second"smtp-sink -d "%d.%H.%M.%S" localhost:2500 1000 &

vendor/bin/behat

smtp-sinkrun-behat-test.sh

Or….you could just read the activation code from

the database directly

class DatabaseContext {public function __construct($dsn, $user, $pass) {

$this->dbh = new PDO($dsn, $user, $pass);}/** * @When /^there is no user called :user$/ */public function removeUser($user) {

$this->dbh->prepare("DELETE FROM `users` WHERE username=?")->query([$user]);

}}

A new contextDatabaseContext.php

SIDE NOTE

default: suites: default: paths: [ %paths.base%/features/ ] contexts:

- FeatureContext- DatabaseContext:

- mysql:host=localhost;dbname=opencfp- root- 123

Configurationbehat.yml

SIDE NOTE

Or….actually send the email and read it via SMTP

How far is too far?What are your priorities?

Taking it too farTrue story

// Make sure your server and your behat client have the same time set// Share the secret key between the two. The code should be valid for// 30 second periods$code = sha1($secret_key . floor(time() / 30));if ($request->get("code") === $code) {

// Bypass captcha}

Easier waySimple but safe bypass

Our first talkSet the stage

Feature: Manage paper submissionsIn order to ensure that speakers can submit their papersAs an speaker I need to be able to manage my own submissions

Background:There is a speaker registered as "[email protected]" with a

password "secrets"I login as "[email protected]" with password "secrets"

Scenario: Add a new talk to our submissions...

Tyranny of JavaScriptDeleting a talk

Well that won’t worktalks.feature

Feature: Manage paper submissions In order to ensure that speakers can submit their papers As an speaker I need to be able to manage my own submissions

Scenario: Delete a talkGiven create a talk called "Behat Talk"And I am on "/dashboard"When I follow "Delete"And I should not see "Behat Talk Changed"

The text "Behat Talk Changed" appears in the text of this page, but it should not. (Behat\Mink\Exception\ResponseTextException)

// Guzzle using web scraperbehat/mink-goutte-driver

// Java-based distributed browser workers (support JavaScript)behat/mink-selenium2-driverbehat/mink-sahi-driver

// node.js headless browser proxy (support JavaScript)behat/mink-zombie-driver

DriversSome take the scenic route

default: # … extensions: Behat\MinkExtension: base_url: "[your website]" sessions: default: goutte: ~ javascript: selenium2: ~

ConfigurationSetting up for Selenium

$ java -jar selenium-server-standalone-2.*.jar

Selenium

@javascript # Or we could use @selenium2Feature: Manage paper submissions In order to ensure that speakers can submit their papers As an speaker I need to be able to manage my own submissions

Start Selenium Server

Specify javascript requirement

$ ./vendor/bin/behat --tags speaker,talk

TagsRun specific tags

@speakerFeature: Manage paper submissions In order to ensure that speakers can submit their papers As an speaker I need to be able to manage my own submissions

@talk Scenario: Create a new talk Given I am logged in as a speaker ...

SIDE NOTE

Feature: Submitting and managing talks As a speaker I wish be able to submit talks so I can get a chance to talk at a conference.

@javascript Scenario: Delete a talk

Given create a talk called "Behat Talk"And I am on "/dashboard"When I fill "Delete"And I accept alertsAnd I should not see "Behat Talk"

Enable JavaScripttalks.feature

Run as JavaScripttalks.feature

Feature: Submitting and managing talks As a speaker I wish be able to submit talks so I can get a chance to talk at a conference.

Scenario: Delete a talkGiven create a talk called "Behat Talk"And I am on "/dashboard"When I follow "Delete"And I accept alertsAnd I should not see "Behat Talk"

class FeatureContext … {public function takeAScreenshotCalled($filename) { $driver = get_class($this->getSession()->getDriver());

if ($driver == 'Behat\Mink\Driver\Selenium2Driver') {$ss = $this->getSession()

->getDriver()->getScreenshot();

file_put_contents($filename, $ss);}

}}

ScreenshotFeatureContext.php

Advanced Usagewith extra bells and whistles

use Behat\Behat\Hook\Scope\AfterFeatureScope; // @AfterFeature \AfterScenarioScope; // @AfterScenario \AfterStepScope; // @AfterStep \BeforeFeatureScope; // @BeforeFeature \BeforeScenarioScope; // @BeforeScenario \BeforeStepScope; // @BeforeStep \FeatureScope; // @Feature \ScenarioScope; // @Scenario \StepScope; // @Step

HooksListen in close

class FeatureContext … {/** * @AfterScenarioScope */public function afterScenario(AfterScenarioScope $scope) {

$scenario = $scope->getScenario()->getTitle();$filename = make_safe_filename($scenario);// Take a screenshot and put it on a dashboard// where people can see it

}}

HooksFeatureContext.php

class FeatureContext … {/** * @AfterStep */public function afterStep(AfterStepScope $scope) {

$code = $event->getTestResult()->getResultCode();if ($code == TestResult::FAILED) {

// Take a screenshot}

}}

HooksFeatureContext.php

Some days everything is made of glass

Common Gotchas

Expect breakagesAnd that’s a good thing

Speed vs CoverageFind the right balance

Keep Selenium updatedBrowsers change faster than fashion trends

Behat documentshttp://docs.behat.org points to v2.5 docs but

doesn’t tell you.Use http://docs.behat.org/en/v3.0/

http://docs.behat.org

http://docs.behat.org/en/v3.0/

Questions?or ask me later via @thomas_shone

Thank youPhoto from Flickr by John Morey, TrojanRat, Gerry Machen, USFS Region 5,

Peregrina Tyss and Thomas Hawk

PermutationsThe reason why testing is painful

class MemoryContext {/**

* @Transform /^memory:(.*)$/ */

public function fromMemory($key) { if (!isset($this->memory[$key])) { throw new LogicException("Entry $key does not exist"); }

return $this->memory[$key];}

}

TransformationsMemoryContext.php

default: suites: web: paths: [ %paths.base%/features/web ] contexts: [ BaseContext, WebContext ] api: paths: [ %paths.base%/features/api ] contexts: [ BaseContext, ApiContext ]

ConfigurationMultiple contexts

default: suites: admin: paths: [ %paths.base%/features/web ] contexts: [ BaseContext, AdminContext ] filters: role: admin speaker: paths: [ %paths.base%/features/web ] contexts: [ BaseContext, SpeakerContext ] filters: tags: @speaker

ConfigurationGrouping and filtering

$ ./vendor/bin/behat --suite admin

SuitesRun a specific suite

Feature: Managing the CFP In order to ensure that speakers can submit their papers As an admin I need to be able to open the call for papers

$ ./vendor/bin/behat --suite speaker

SuitesRun a specific suite

@speakerFeature: Submitting to the CFP In order to ensure that the conference has papers As an speaker I need to be able to submit papers

$ java -jar selenium-server-standalone-2.*.jar -role hub

Selenium Grid

$ java -jar selenium-server-standalone-2.*.jar -role node -hub http://[gridserver]:4444/grid/register

Start the grid

Add a node

default: extensions: Behat\MinkExtension: sessions: javascript: selenium2: wd_host: "http://127.0.0.1:4444/wb/hub" capabilities: version: ""

ConfigurationBecause magic...

http://127.0.0.1:4444/wb/hub

i put on my mink and wizard behat

Technology

party harmony

team scenario

wizard behat questing

num cookies

mutual trust

end testing

cucumber syntax whats

team dont