History

Max Rice 0bd7d8990c [#3176 ] Refactor bootstrap * Adjust load and install order * Fix issue with stale capabilities after install		2014-09-01 16:11:48 -04:00
..
framework	[#3176 ] Use shop manager role for API tests	2014-09-01 16:11:08 -04:00
unit-tests	[#3176 ] Add woocommerce class tests	2014-09-01 02:59:35 -04:00
README.md	[#3176 ] Add readme	2014-09-01 03:26:26 -04:00
bootstrap.php	[#3176 ] Refactor bootstrap	2014-09-01 16:11:48 -04:00
install-wp-tests.sh	[#3176 ] Add unit test boostrap	2014-09-01 02:03:52 -04:00

README.md

WooCommerce Unit Tests

Initial Setup

Install PHPUnit by following their installation guide. If you've installed it correctly, this should display the version:

$ phpunit --version
Install WordPress and the WP Unit Test lib using the install-wp-tests.sh script. Change to the plugin root directory and type:

$ tests/install-wp-tests.sh [db-host]

Sample usage:

$ tests/install-wp-tests.sh woocommerce_tests root root

Important: The <db-name> database will be created if it doesn't exist and all data will be removed during testing.

Running Tests

Simply change to the plugin root directory and type:

$ phpunit

The tests will execute and you'll be presented with a summary. Code coverage documentation is automatically generated as HTML in the tmp/coverage directory.

You can run specific tests by providing the path and filename to the test class:

$ phpunit tests/unit-tests/api/webhooks

A text code coverage summary can be displayed using the --coverage-text option:

$ phpunit --coverage-text

Writing Tests

TODO

Automated Tests

Tests are automatically run with Travis-CI for each commit and pull request.