fooStack for CodeIgniter

CIUnit: Unit testing for CodeIgniter

CIUnit is a cool bridge between your CodeIgniter application and phpUnit.

• CodeIgniter 1.6.0+ ( tested with 1.6.X, 1.7.0 and 1.7.1 )
• PHP 5.1+

Download the current fooStack v0.15 here!

(The cutting edge development version and older versions are accessible through the public mercurial repository at bitbucket.org / ciunit)

Install it as follows:

1. Copy the fooStack directory in your YourProject/system/application/libraries directory
2. Note that at the moment CIUnit assumes you use the standard layout for your CodeIgniter project.
3. Copy the tests directory in your YourProject/system/application directory
4. Replace the CodeIgniter.php file in your YourProject/system/codeigniter directory with the one of the package
5. replace the line that starts with

   $active_group =

   in your database.php (YourProject/system/application/config directory) with:
   

   $env_used = 'default'; //where default would be the name of your development setting
   if(defined('CIUnit_Version')){
     $env_used .= '_test';
   }
   $active_group = $env_used;

6. Create a new database setting that will act as the test database (it will always be cleared when you run tests!), that is named like your development setting but with a trailing '_test'. Note: CIUnit fixtures will ask for the trailing '_test' to prevent accidental data loss.

Congratulations you are done with installing fooStack!

Oh, wait, do you have phpUnit already installed?

http://www.phpunit.de/manual/current/en/installation.html

Once you have fooStack and phpUnit running:

Run tests:

• Run all tests from within the tests directory: "phpunit AllTests.php", or use "phpunit --verbose AllTests.php" to get more detailed output
• Run only a subgroup of tests, eg model tests, go into the tests/models directory and run "phpunit ModelAllTests.php"
• Consequently, for running just one particular test, change to this test's directory and type "phpunit testSomeStuff.php"

Generating database fixtures:

Given you have tables in your test database (you should have the same as in the development database!), you can generate empty yaml fixtures like so: From within the tests directory type (make sure the fixtures directory is writable!):

php generate fixtures

The fixture files are then available in the tests/fixtures directory.

Using the fixtures is easy: Fill the yaml fixture files with the fixture data needed (yaml is a easily readable format to format your data in). Once this is done, call e.g.

$this->dbfixt('items', 'comments', 'users'); 

from within the test setup function. Then these table fixtures are assured to be loaded into your test database AND are available as test variables like so:

$this->items_fixt, $this->comments_fixt, $this->users_fixt.

E.g the second row of data in the comments table in your tests database is also available through

$this->comments_fixt['second'];

CIUnit tests itself

Without writing any tests, typing "phpunit CIUnitAllTests.php" from within the application/tests/ciunit directory will already run a couple of tests - these make sure that CIUnit is correctly installed and works as expected.