automation testing with drupal 8
TRANSCRIPT
Automated TestingAbhishek AnandTechnical Architect & TAM
ACQUIA
Prachi NagpalDrupal Developer
ACQUIA
TEST DRIVEN DEVELOPMENT
1. Write a test2. Run the test3. Let the test fail4. Write enough code for the test to pass5. Run your test again6. Refactor/ clean up the code7. Run test again8. Repeat
WHY USE TDD
1. Better understanding of what you're going to write2. Enforces the policy of writing tests a little better3. Speeds up development
BENEFITS OF TDD
1. Testable code2. Clean design3. Able to be refactored with confidence4. The minimal code necessary to satisfy the story card5. A living specification of how the code works6. Able to support a sustainable pace of new features
TOOLS
WHY USE CODECEPTION
1. Powered by PHPUnit2. Any type of test
a. Acceptanceb. Functionalc. Unit
3. Easy to extend4. Lot of test suits already available for Drupal5. Reusable code6. Run all types of test from one place
INSTALLATION
INSTALLATION
GETTING STARTED
By default AcceptanceTester relies on PhpBrowser module, which is set intests/acceptance.suite.yml
It can also be set to use WebDriver
class_name: WebGuyTestermodules: enabled: - WebDriver: url: http://drupal812 browser: chrome wait: 2000 - \Helper\WebGuy
➜ php codecept.phar generate:cept acceptance SigninTest was created in /Users/prachi.nagpal/Sites/drupal8/tests/acceptance/SigninCept.php
<?php$I = new AcceptanceTester($scenario);$I->wantTo('Test index page');$I->amOnPage('/');$I->see('Site-Install','#header #site-name');$I->amGoingTo('login in the test app');$I->fillField('Username','admin');$I->fillField('Password','1234');$I->click('Log in');$I->see('Log out');$I->click('Log out');$I->see('User login');?>
EXAMPLE
<?php$I = new AcceptanceTester($scenario);$I->wantTo('ensure that frontpage works');$I->amOnPage('/'); $I->see('Home');?>
<?php$I = new AcceptanceTester($scenario);$I->amOnPage('/');$I->click('Sign Up');$I->submitForm('#signup', ['username' => prachi.nagpal, 'email' => '[email protected]']);$I->see('Thank you for Signing Up!');?>
EXAMPLE
Codeception can even 'naturalize' this scenario, converting it into plain English:
I WANT TO SIGN INI am on page '/user'I fill field 'username', 'prachi.nagpal'I fill field 'password', '1234'I click 'Log in'I see 'Welcome, prachi.nagpal!'
RUNNING TESTS
Tests can be started with the run command.
➜ php codecept.phar run ➜ php codecept.phar run acceptance ➜ php codecept.phar run acceptance SigninCept.php ➜ php codecept.phar run tests/acceptance/SigninCept.php ➜ php codecept.phar run tests/acceptance/SignInCest.php:anonymousLogin ➜ php codecept.phar run tests/acceptance/backend
SELENIUM WEBDRIVERWAIT
<?php$I->waitForElement('#agree_button', 30); // secs$I->click('#agree_button');?>
SESSION SNAPSHOTS
function test_login($I) { // if snapshot exists - skipping login if ($I->loadSessionSnapshot('login')) return; // logging in $I->amOnPage('/login'); $I->click('Login'); // saving snapshot $I->saveSessionSnapshot('login');}// in test:$I = new AcceptanceTester($scenario);test_login($I);
MULTI SESSION TESTING
$I = new AcceptanceTester($scenario);$I->wantTo('try multi session');$I->amOnPage('/messages');$nick = $I->haveFriend('nick');$nick->does(function(AcceptanceTester $I) { $I->amOnPage('/messages/new'); $I->fillField('body', 'Hello all!') $I->click('Send'); $I->see('Hello all!', '.message');});$I->wait(3);$I->see('Hello all!', '.message');
CLEANING UP / DB SNAPSHOTS→ Db module→ Load a database dump after each passed test.→ SQL dump to be put in /tests/_data directory. → Set the database connection and path to the dump in the global Codeception config.
# in codeception.yml:modules: config: Db: dsn: '[set pdo dsn here]' user: '[set user]' password: '[set password]' dump: tests/_data/dump.sql
DEBUGGING
➜ php codecept.phar run --debug
<?php codecept_debug($I->grabTextFrom('#name')); ?>
REUSING TEST CODE
StepObjects
➜ php codecept.phar generate:stepobject acceptance Admin
➜ php codecept.phar generate:stepobject acceptance AdminAdd action to StepObject class (ENTER to exit): loginAsAdminAdd action to StepObject class (ENTER to exit):StepObject was created in /tests/acceptance/_support/Step/Acceptance/Admin.php
Step Object<?phpnamespace Step\Acceptance;class Member extends \AcceptanceTester{ public function loginAsAdmin() { $I = $this; $I->amOnPage('/admin'); $I->fillField('username', 'admin'); $I->fillField('password', '123456'); $I->click('Login'); }}?>
Actual Test<?phpuse Step/Acceptance/Admin as AdminTester;$I = new AdminTester($scenario);$I->loginAsAdmin();?>
PageObjects
$ php codecept.phar generate:pageobject Login
Defining PageObjects<?phpnamespace Page;
class Login{ public static $URL = '/login';
public static $usernameField = '#mainForm #username'; public static $passwordField = '#mainForm input[name=password]'; public static $loginButton = '#mainForm input[type=submit]';}?>
Using PageObjects
<?phpuse Page\Login as LoginPage;
$I = new AcceptanceTester($scenario);$I->wantTo('login to site');$I->amOnPage(LoginPage::$URL);$I->fillField(LoginPage::$usernameField, 'bill evans');$I->fillField(LoginPage::$passwordField, 'debby');$I->click(LoginPage::$loginButton);$I->see('Welcome, bill');?>
PHPUNIT AND DRUPAL 8
...to be continued by Abhishek Anand
DEATH BY POWERPOINT!!!
THANK YOU!THANK YOU!
DEATH BY POWERPOINT!!!