Automated Web Acceptance Testing with Behat Shashikant Jagtap Twitter : @Shashikant86
Aug 23, 2014
Automated Web Acceptance Testing
with Behat Shashikant Jagtap
Twitter : @Shashikant86
Overview
Behat : BDD for PHP Mink: Web Acceptance Testing Framework Behat with Sauce Labs for cloud testing Relish for living documentation Building feature with Jenkins Useful Links
Behat : BDD for PHP
Behat is a BDD framework for PHP applications. http://behat.org/
BDD approach
Feature is defined in story format. Domain Specific Language used is 'Gherkin'.
Behat is developed by Konstantin Kudryashov (@everzet)
Mink
Mink is a acceptance test framework for PHP applications http://mink.behat.org/ Mink has different drivers for browser emulation. Bowser emulation can be headless or with browser controllers. Mink supports both selenium1 driver as well as webdriver. Mink has various API's that can used to control browser actions. Full list of Mink API's can found here http://mink.behat.org/api/
Installations
Behat Installation: Run following commands from your pear channel
$ sudo pear channel-discover pear.behat.org
$ sudo pear channel-discover pear.symfony.com
$ sudo pear install behat/gherkin-beta
$ sudo pear install behat/behat-beta Mink Installation$ pear channel-discover pear.symfony.com
$ pear channel-discover pear.behat.org
$ pear install behat/mink Check Installations$ behat –version
Behat version 2.2.0
Mink can be used by including following file in PHP classes. require_once 'mink/autoload.php';
Start Your Project
Navigate to the project root directory and initialize Behat by running these commands:
FeatureContext.php
Bootstrap.php Create 'features->bootstrap->bootstrap.php' and include mink and all
other third party libraries in it. Include bootstrap.php into 'FeatureContext.php'.
Behat.yml Create 'behat.yml'. This is configuration file to run
features You can specify mink driver, base url and browser of your
choice. This file uses 'selenium' driver to run feature.
wikiSearch.feature Now, write sample feature file. This feature file good example of data-
driven tests.
Get code for Step Definitions Now, you are ready to run 'behat' command again. This will give you example
code for undefined steps
Implement Step definitions
Now, copy example code and paste it in 'FeatureContext.php' Use Mink API's to implement steps like this
Start your engine Download Selenium from http://seleniumhq.org/download/ Run Selenium server using command
$java -jar selenium-server-standalone-2.15.0.jar
Watch your Test running Now run 'behat' again and watch your test running in
browser.
Watch Your Test Passed
Behat with Sauce Labs Sauce Labs is a cloud testing service which allows tests to run in
cloud machine with specified browser. http://saucelabs.com/ Behat features can be run on sauce labs by simple configuration We need to create another configuration file to run features on
Sauce Labs.
Create 'sauce.yml' In order to run feature on Sauce Labs, we need to create
'sauce.yml' as a config file. You need Sauce labs 'username' and 'API key'.
Run Feature on Sauce Labs You need to tell behat to pick 'sauce.yml' as config file $behat -c sauce.yml You can watch video this job here:
http://snipurl.com/21y5lb6
Relish: Living Documentation
Relish is cool tool to manage Gherkins feature files online. https://www.relishapp.com/relish/relish/docs
Install Relish You need to have Ruby gems installed on your system. $gem install relish Create Project $relish projects:add projectName
# or, if you want a private project: $relish projects:add my-secret-project:private Push your files online
$relish push my-best-projectmoonstar:NewBehat sjagtap$ relish push sjagtap/acnesent:features/wikiSearch.feature
Relish
You can find our feature on Relish here https://www.relishapp.com/sjagtap/acne/docs/wikisearch
Source Code from GitHub
Get Sample Source Code available on GitHub https://github.com/Shashi-ibuildings/Behat-SauceClone the repository $ git clone [email protected]:Shashi-ibuildings/Behat-Sauce.git
$ cd /path to/Behat-SauceEdit ‘Sauce.yml’ file in order to specify your username and API key. Now, Run ANT command to execute feature on sauce Labs $ ant runSauceSee the reports generated in 'report/report.html' file.
Directory Structure
Once you cloned project, You will have following files in the project, directory structure looks like this
Running Features on Jenkins
Jenkins is continuous integration server To configure Behat with CI server, we need 'build.xml '
file You need to have Jenkins installed on server or localhost- We will Run Jenkins- moonstar:~ sjagtap$ java -jar jenkins-1.war Visit http://localhost:8080/ to see Jenkins Dashboard Create new job called “BehatSauce”. Specify it as 'Build
a free-style software project. Specify Git repository as SCM. Select ‘Invoke Ant’ from ‘Build’ and specify ‘runSauce’
target Specify HTML report path. (You need to have HTML report
plugin installed on Jenkins)
Jenkins Configuration
Jenkins Configuration Contd..
Jenkins Project
Jenkins Test Report
Links
Blogpost 'Adding Sauce To behat'http://saucelabs.com/blog/index.php/2012/01/adding-sauce-to-behat/ Video Demohttp://www.youtube.com/watch?v=Zu9mWuVvsUQ Source Code on GitHub https://github.com/Shashi-ibuildings/Behat-Sauce Relish Documentationhttps://www.relishapp.com/sjagtap/acne My Blogshttp://lestbddphp.wordpress.com/ About Me http://about.me/shashikantjagtap
Questions
Thank You