README

Zapper - Laravel Test Builder

This is an attempt to make your test process easier when a db is envolved.

What's missing in the current test process?

In Laravel 4, you write your tests, put stuff in setUp() and tierDown(), then run phpunit. Which is all fine except that when there is a db involved it's using your dev/staging db. Your test cases pickup existing data and blah blah blah... you know where I'm going.

What can you expect from Zapper?

So all zapper does, is gives you an isolated test db where all your test queries can be executed. It builds the test db and drops it afterwards, and ohhh, it does migration (including your packages) and seeding for you.

How to use it?

Start by adding zapper to your composer.json

"require": {
    "andizzle/zapper": "dev-master"
}

After composer updates you can start writing your tests:

<?php
class MyTest extens Andizzle\Zapper\TestCase {

    public function testPostAuthCode() {}

}
?>

To run your tests, run zapper's run command in your laravel project:

$ php artisan zapper:run

Furthermore, you can specify the test case you want run, without any @group or @filter in your test comments.

$ php artisan zapper:run SUITE
$ php artisan zapper:run SUITE.CLASS
$ php artisan zapper:run SUITE.CLASS.METHOD

You can still pass any phpunit arguments and parameters as you used to.

TestCase, TransactionTestCase and Others

Zapper offers two types of testcases for you, testcase and transaction testcase.

They all do the same thing except test case does a rollback of your db, and Transaction truncates and reseeds at the beginning of each testcase.

If your tests requires db transactions then you can use TransactionTestCase, obviously...

Zapper actually reorders your tests so all testcases run before transaction testcases that may alter the database without restoring it to its original state.

Zapper also runs other tests after its TestCase and TransactionTestCase.

Some helper commands

There are some commands that zapper uses. They are offered to you as well so you can do what you think fits.

zapper:build_db        Create test DB.
zapper:drop_db         Drop the test DB.
zapper:migrate         Migrate schemas.
zapper:run             Run tests.
zapper:truncate        Truncate certain tables.

PR if you think it's shitty and feel like improving it.

Copyright (C) 2013  Andy Zhang

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <http://www.gnu.org/licenses/>.

andizzle / zapper

Maintainers

Details