codeception/base

BDD-style testing framework

Codeception

Modern PHP Testing for everyone, _(*1)

Codeception is a modern full-stack testing framework for PHP. Inspired by BDD, it provides you an absolutely new way of writing acceptance, functional and even unit tests. Powered by PHPUnit., _(*2)

release	branch	status
Stable	1.8
Current	2.0
Edge	master

Contributions

At Codeception we are glad to receive contributions from the community. If you want to send additions or fixes to the code or the documentation please check the Contributing guide., _(*3)

At a Glance

Describe what you test and how you test it. Use PHP to write descriptions faster., _(*4)

Run tests and see what actions were taken and what results were seen., _(*5)

Sample acceptance test

``` php 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 ?>, <sub>(*6)</sub>

For unit testing you can stay on classic PHPUnit tests, as Codeception can run them too.

## Documentation

[Documentation on Github](https://github.com/Codeception/Codeception/tree/master/docs)

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

## Installation

### Phar

Download [codecept.phar](http://codeception.com/codecept.phar)

Copy it into your project.

You can also make Codeception an executable and it put it into your `$PATH`, for instance:

wget http://codeception.com/codecept.phar, <sub>(*7)</sub>

chmod +x codecept.phar, <sub>(*8)</sub>

sudo mv codecept.phar /usr/local/bin/codecept, <sub>(*9)</sub>

You can then run Codecept in the command line using: `codecept bootstrap`, `codecept run`, etc


Run CLI utility:

php codecept.phar, <sub>(*10)</sub>

### Composer

php composer.phar require "codeception/codeception", <sub>(*11)</sub>

Read Also [Installation](http://codeception.com/install) | **[QuickStart](http://codeception.com/quickstart)**

## Getting Started

If you successfully installed Codeception, run this command:

codecept bootstrap ```, <sub>(*12)</sub>

this will create a default directory structure and default test suites, <sub>(*13)</sub>

See Documentation for more information., <sub>(*14)</sub>

License

MIT, <sub>(*15)</sub>

(c) Michael Bodnarchuk "Davert" 2011-2015, <sub>(*16)</sub>