title | description |
---|---|
CLI Options |
Documentation of the available command-line options. |
The Pest command line runner has many available options that can make your testing experience easier.
Pest defers non-Pest-specific options to PHPUnit, so please refer to the PHPUnit command-line test runner documentation for a full list.
This option allows you to initialize a standard Pest configuration, with the following files:
- A
tests
directory. - A
phpunit.xml
file that contains the PHPUnit configuration file. - A
tests/Pest.php
file that contains the Pest configuration file. - A
tests/ExampleTest.php
file, with a default example test.
This option enables coverage using the underlying --coverage-php
option, and will output the results to the terminals standard output.
You can combine this with other coverage options from PHPUnit such as --coverage-xml
or --coverage-html
.
This option allows you to set a minimum required coverage value. If the coverage does not meet this value, the test suite will fail.
This option allows you to only run a specific list of grouped tests. This is a comma-separated list.
This option allows you to specify the directory that will be used to gather the tests that should be run. If it isn't provided the default tests
directory will be used.
You may use the --ci
option to instruct Pest that the test suite is running within a Continuous Integration environment. When provided, this option makes Pest ignore development/local features such as ->only().
Next section: Laravel Plugin →