woocommerce/plugins/woocommerce-admin/docker/wc-admin-php-test-suite/readme.md

33 lines
960 B
Markdown
Raw Normal View History

# Docker PHP Test Suite
A docker app to run the PHP Test Suite.
## Getting Started
For convenience, the PHP Test Suite can be run from an npm script.
```shell
npm run test:php
```
This runs the the `phpunit` container with `docker-compose -f run --rm phpunit`. On first use, the container will install the PHP Test Suite and perform the tests. Subsequent use will only perform the tests.
## Re-install Test Suite
Re-installation is useful to update WordPress and WooCommerce to the latest versions. To do this, remove the existing `test-suite` volume using Docker. For example:
```shell
docker volume rm -f wc-admin-php-test-suite_test-suite
```
Then run the test suite normally using the npm script. Installation will be automatically performed.
## Testing a single test case
PHPUnit flags can be passed to the npm script. To limit testing to a single test case, use the `--filter` flag.
```shell
npm run test:php -- --filter=<name of test>
```