Test-Driven Development for TYPO3

Test-Driven Development
for TYPO3

Oliver Klee, 2011-12-13 and 2011-12-14
typo3-coding@oliverklee.de

Unit tests for the
Realty Manager
extension

Verify that your code
does what you expect

Make sure that your
changes won‘t break
anything

Keep
other coders
from breaking your code

Don‘t break anything
even in complex projects

Create asafety net
for refactoring

The phpunit extension
has it all

has it all
phpunit (TYPO3 extension)

has it all
PHPUnit (PEAR package)

has it all

Testrunner
(back-end-
module)

has it all

Testrunner Testrunner
(back-end-
module) (CLI module)

has it all
Testing framework for FE & DB
Testrunner Testrunner
(back-end-
module) (CLI module)

Let‘s get
some terms
straight

Two tests
Test meet in a
bar ...

Two tests
Test meet in a
Assertion bar ...

Two tests
Test meet in a
Assertion bar ...
Test
Test

Two tests
Test meet in a
Assertion bar ...
Test
Test
Test case

Two tests
Test meet in a
Assertion bar ...
Test
Test
Test case
Test case

Two tests
Test meet in a
Assertion bar ...
Test
Test
Test case
Test case
Test suite

Code test-first

write write
test code

Code test-first

write write
test code

refactor

The life cycle unit test
of a

of a
new FooTest();

of a
new FooTest();

setUp();

of a
new FooTest();

setUp();

/** @test */
lifeIsGood();

of a
new FooTest();

setUp();

/** @test */
lifeIsGood();

tearDown();

Use meaningful
unit test names

Use meaningful
unit test names
Name the
behavior. classCanBeInstantiated

Use meaningful
unit test names
Name the

Mention the
method. setTitleSetsTitle

Use meaningful
unit test names
Name the

Mention the

Name the setSizeWithZeroThrowsException
preconditions. hasTitleForEmptyTitleReturnsFalse

Use meaningful
unit test names
Name the

Mention the


Dont‘t use
"works" or
"correctly".

Use meaningful
unit test names
Name the

Mention the


Dont‘t use
"works" or measureFrubbleWorksCorrectly
"correctly".

Continuous
Integration
=
checking in
more often

The continuous integration server
monitors the code
Checkin

Repository (SVN)

monitors the code
Checkin

hook
Repository (SVN)

SVN

monitors the code
Checkin

hook
Repository (SVN)

SVN

continuous integration
server

monitors the code
Checkin

hook
Repository (SVN)

SVN
Hey, a
change!

continuous integration
server

monitors the code
Checkin

hook
Repository (SVN)

SVN
Hey, a
change!

continuous integration run the unit
server tests etc.

monitors the code
Checkin

hook
Repository (SVN)

SVN
Hey, a
change!

continuous integration run the unit Report
server tests etc.

There are
small and huge
tests

Unit tests are
small and fast

Integration tests test
the complete thing

Automated click tests
test the interface

Automated click tests
test the interface

Selenium

Blackbox tests
test
the public interface

Whitebox tests test the
inner workings

The testing framework
is created quickly
/**
* @var Tx_Phpunit_Framework
*/
protected $testingFramework = NULL;

public function setUp() {
$this->testingFramework = new Tx_Phpunit_Framework('tx_news2');
}

public function tearDown() {
$this->testingFramework->cleanUp();
unset($this->testingFramework);
}

is created quickly
/**
*/

}
discard the FE,
delete DB records,
delete ﬁles
}

is created quickly
/**
*/

}
discard the FE,
delete DB records,
delete ﬁles
}

CREATE TABLE tx_news2_domain_model_news (
…
is_dummy_record tinyint(1) unsigned DEFAULT '0' NOT NULL,
…

can fake almost everything

$recordUid = $tf->createRecord($tableName, array $recordData = array());


$tf->changeRecord($tableName, $uid, array $recordData);



$tf->deleteRecord($tableName, $uid);




$tf->createRelation($tableName, $uidLocal, $uidForeign, $sorting = 0);





$tf->createRelationAndUpdateCounter($tableName, $uidLocal, $uidForeign, $columnName);






$tf->removeRelation($tableName, $uidLocal, $uidForeign);







$numberOfRecords = $tf->countRecords($tableName, $whereClause = '');








$success = $tf->existsRecord($tableName, $whereClause = '');









$success = $tf->existsExactlyOneRecord($tableName, $whereClause = '');









$success = $tf->existsExactlyOneRecord($tableName, $whereClause = '');

$success = $tf->existsRecordWithUid($tableName, $uid);

$pageUid = $tf->createFrontEndPage($parentId = 0, array $recordData = array());


$pageUid = $tf->createSystemFolder($parentId = 0, array $recordData = array());



$elementUid = $tf->createContentElement($pageId = 0, array $recordData = array());




$tf->createTemplate($pageId, array $recordData = array());





$pageUid = $tf->createFakeFrontEnd($pageUid = 0);






$tf->discardFakeFrontEnd();







$groupUid = $tf->createFrontEndUserGroup(array $recordData = array());








$userUid = $tf->createFrontEndUser($groups = '', array $recordData = array());









$tf->loginFrontEndUser($userId);









$tf->logoutFrontEndUser(); $tf->loginFrontEndUser($userId);










$userUid = $tf->createAndLoginFrontEndUser($groups = '', array $recordData = array());










$userUid = $tf->createAndLoginFrontEndUser($groups = '', array $recordData = array());

$isLoggedIn = $tf->isLoggedIn();

$recordUid = $tf->createBackEndUser(array $recordData = array());

$recordUid = $tf->createBackEndUser(array $recordData = array());

$recordUid = $tf->createBackEndUserGroup(array $recordData = array());

$path = $tf->createDummyFile($fileName = 'test.txt', $content = '');


$path = $tf->createDummyZipArchive($fileName = 'test.zip', array $filesToAdd = array());



$tf->deleteDummyFile($fileName);




$path = $tf->createDummyFolder($folderName);




$path = $tf->createDummyFolder($folderName);

$tf->deleteDummyFolder($folderName);

How to your test
extbase controllers
class Tx_Coffee_Controller_CoffeeControllerTest extends Tx_Extbase_Tests_Unit_BaseTestCase {
/** @var Tx_Coffee_Controller_CoffeeController */
protected $fixture;
/** @var Tx_Fluid_View_TemplateView */
protected $view = NULL;
/** @var Tx_Coffee_Domain_Repository_CoffeeRepository */
protected $coffeeRepository = NULL;

$this->fixture = new Tx_Coffee_Controller_CoffeeController();

$this->view = $this->getMock('Tx_Fluid_View_TemplateView', array(), array(), '', FALSE);
$this->fixture->setView($this->view);

$this->objectManager = $this->getMock('Tx_Extbase_Object_ObjectManagerInterface');
$this->fixture->injectObjectManager($this->objectManager);

$this->coffeeRepository = $this->getMock(
'Tx_Coffee_Domain_Repository_CoffeeRepository',
array('findAll', 'findByBrand'), array($this->objectManager)
);
$this->fixture->injectCoffeeRepository($this->coffeeRepository);
}

How to your test
extbase controllers
class Tx_Coffee_Controller_CoffeeControllerTest extends Tx_Extbase_Tests_Unit_BaseTestCase {
/** @var Tx_Coffee_Controller_CoffeeController */
protected $fixture;
/** @var Tx_Fluid_View_TemplateView */
protected $view = NULL;
/** @var Tx_Coffee_Domain_Repository_CoffeeRepository */
protected $coffeeRepository = NULL;

$this->fixture = new Tx_Coffee_Controller_CoffeeController();

$this->view = $this->getMock('Tx_Fluid_View_TemplateView', array(), array(), '', FALSE);
$this->fixture->setView($this->view);

$this->objectManager = $this->getMock('Tx_Extbase_Object_ObjectManagerInterface');
$this->fixture->injectObjectManager($this->objectManager);

$this->coffeeRepository = $this->getMock(
'Tx_Coffee_Domain_Repository_CoffeeRepository',
array('findAll', 'findByBrand'), array($this->objectManager)
);
$this->fixture->injectCoffeeRepository($this->coffeeRepository);
}
class Tx_Coffee_Controller_CoffeeController extends Tx_Extbase_MVC_Controller_ActionController {
/**
* Sets the view.
*
* This function is intended to be used for unit testing purposes only.
*
* @param Tx_Fluid_View_TemplateView $view the new view
*
* @return void
*/
public function setView(Tx_Fluid_View_TemplateView $view) {
$this->view = $view;
}

How to test your
extbase controllers

How to your test
extbase controllers
/**
* @test
*/
public function indexActionAssignsAllCoffeesToView() {
$models = $this->getMock('Tx_Extbase_Persistence_QueryResultInterface');
$this->coffeeRepository->expects($this->once())->method('findAll')
->will($this->returnValue($models));

$this->view->expects($this->at(0))->method('assign')->with('coffees', $models);

$this->fixture->indexAction();
}

How to your test
extbase controllers
/**
* @test
*/
public function indexActionAssignsAllCoffeesToView() {
$models = $this->getMock('Tx_Extbase_Persistence_QueryResultInterface');
$this->coffeeRepository->expects($this->once())->method('findAll')
->will($this->returnValue($models));

$this->view->expects($this->at(0))->method('assign')->with('coffees', $models);

$this->fixture->indexAction();
}

/**
* @test
*/
public function showActionAssignsModelToView() {
$model = clone new Tx_Coffee_Domain_Model_Coffee();
$this->view->expects($this->at(0))->method('assign')->with('coffee', $model);

$this->fixture->showAction($model);
}

Test-Driven Development for TYPO3

More Related Content

What's hot

Viewers also liked

Similar to Test-Driven Development for TYPO3

More from Oliver Klee

Recently uploaded

Test-Driven Development for TYPO3

Editor's Notes