Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Full-stack testing PHP framework
PHP HTML

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
bin
docs
package
plugins/DocBlox/Codeception
src/Codeception
tests
vendor
.gitignore
.travis.yml
autoload.php
codecept
codecept.bat
codeception.yml
composer.json
package.xml
pearfarm.spec
pearfarm.spec~
readme.md

readme.md

Codeception

Build Status

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.

At a Glance

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.

Sample acceptance test

<?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-mobie-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:

Sample unit test

<?php
class UserControllerCest {
    public $class = 'UserController';

    public function createAction(CodeGuy $I)
    {
        $I->haveFakeClass($userController = Stub::makeEmptyExcept('UserController'));
        $I->executeTestedMethodOn($userController, array('username' => 'MilesDavis', 'email' => 'miles@davis.com'))
            ->seeResultEquals(true)
            ->seeMethodInvoked($userController, 'renderHtml')
            ->seeInDabatase('users', array('username' => 'MilesDavis'));
    }
}
?>

Anyway, if you don't really like writing unit tests in DSL, Codeception can run PHPUnit tests natively.

Documentation

Documentation on Github

Documentation is currently included within the project. Look for it in the 'docs' directory.

Installation

PEAR

Install latest PEAR package from GitHub:

pear channel-discover codeception.com/pear
pear install codeception/Codeception

Phar

Download codecept.phar

Copy it into your project.

Run CLI utility:

php codecept.phar

Getting Started

If you successfully installed Codeception, run this command:

codecept install

this will install all dependency tools like PHPUnit and Mink

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.

License

MIT

(c) Michael Bodnarchuk "Davert" 2011

Something went wrong with that request. Please try again.