Codeception is a new PHP full-stack testing framework. Inspired by BDD, it provides you an absolutely new way of writing acceptance, functional and even unit tests. Powered by PHPUnit 3.6.
Describe what you test and how you test it. Use PHP to write descriptions faster.
Run tests and see what actions were taken and what results were seen.
<?php
$I = new TestGuy($scenario);
$I->wantTo('create wiki page');
$I->amOnPage('/');
$I->click('Pages');
$I->click('New');
$I->see('New Page');
$I->submitForm('form#new_page', array('title' => 'Tree of Life Movie Review','body' => "Next time don't let Hollywood create art-house!"));
$I->see('page created'); // notice generated
$I->see('Tree of Life Movie Review','h1'); // head of page of is our title
$I->seeInCurrentUrl('pages/tree-of-life-movie-review'); // slug is generated
$I->seeInDatabase('pages', array('title' => 'Tree of Life Movie Review')); // data is stored in database
?>Ok, as for unit test similar approach may seem weird, but...
Take a look at this:
<?php
class UserControllerCest {
public $class = 'UserController';
public function createAction(CodeGuy $I)
{
$I->haveFakeClass($userController = Stub::makeEmptyExcept('UserController'));
$I->executeTestedMethodOn($userController, array('username' => 'MilesDavis', 'email' => '[email protected]'))
$I->seeResultEquals(true)
$I->seeMethodInvoked($userController, 'renderHtml')
$I->seeInDatabase('users', array('username' => 'MilesDavis'));
}
}
?>Anyway, if you don't really like writing unit tests in DSL, Codeception can run PHPUnit tests natively.
Documentation is currently included within the project. Look for it in the 'docs' directory.
Install latest PEAR package from GitHub:
pear channel-discover codeception.com/pear
pear install codeception/Codeception
Download codecept.phar
Copy it into your project.
Run CLI utility:
php codecept.phar
If you successfully installed Codeception, run this command:
codecept bootstrap
this will create a default directory structure and default test suites
codecept build
This will generate Guy-classes, in order to make autocomplete work.
See Documentation for more information.
MIT
(c) Michael Bodnarchuk "Davert" 2011-2012