mirror of
https://github.com/pestphp/pest.git
synced 2026-03-06 07:47:22 +01:00
106 lines
7.3 KiB
Plaintext
106 lines
7.3 KiB
Plaintext
|
|
Pest Testing Framework 2.x-dev.
|
|
|
|
USAGE: pest <file> [options]
|
|
|
|
CONFIGURATION OPTIONS:
|
|
--init ............................ Initialise a standard Pest configuration
|
|
-c|--configuration <file> ....................... Read configuration from XML file
|
|
--no-configuration ......... Ignore default configuration file (phpunit.xml)
|
|
--no-extensions ............................. Do not load PHPUnit extensions
|
|
--include-path <path(s)> ..... Prepend PHP's include_path with given path(s)
|
|
-d <key[=value]> ...................................... Sets a php.ini value
|
|
--cache-directory <dir> ................................. Specify cache directory
|
|
--generate-configuration Generate configuration file with suggested settings
|
|
--migrate-configuration ....... Migrate configuration file to current format
|
|
|
|
SELECTION OPTIONS:
|
|
--list-suites ................................... List available test suites
|
|
--testsuite <name> ............... Only run tests from the specified test suite(s)
|
|
--exclude-testsuite <name> ........ Exclude tests from the specified test suite(s)
|
|
--list-groups ................................... List available test groups
|
|
--group <name> ........................ Only run tests from the specified group(s)
|
|
--exclude-group <name> ................. Exclude tests from the specified group(s)
|
|
--covers <name> ......................... Only run tests annotated with "@covers <name>"
|
|
--uses <name> ............................. Only run tests annotated with "@uses <name>"
|
|
--list-tests .......................................... List available tests
|
|
--list-tests-xml <file> ....................... List available tests in XML format
|
|
--filter <pattern> ........................................ Filter which tests to run
|
|
--test-suffix <suffixes> Only search for test in files with specified suffix(es). Default: Test.php,.phpt
|
|
|
|
EXECUTION OPTIONS:
|
|
--process-isolation ................ Run each test in a separate PHP process
|
|
--globals-backup ................. Backup and restore $GLOBALS for each test
|
|
--static-backup ......... Backup and restore static properties for each test
|
|
--strict-coverage . Be strict about code coverage attributes and annotations
|
|
--strict-global-state .............. Be strict about changes to global state
|
|
--disallow-test-output ................. Be strict about output during tests
|
|
--enforce-time-limit ................. Enforce time limit based on test size
|
|
--default-time-limit <sec> Timeout in seconds for tests that have no declared size
|
|
--dont-report-useless-tests .. Do not report tests that do not test anything
|
|
--stop-on-defect ................. Stop execution upon first not-passed test
|
|
--stop-on-error ............................ Stop execution upon first error
|
|
--stop-on-failure ............... Stop execution upon first error or failure
|
|
--stop-on-warning ........................ Stop execution upon first warning
|
|
--stop-on-risky ....................... Stop execution upon first risky test
|
|
--stop-on-skipped ................... Stop execution upon first skipped test
|
|
--stop-on-incomplete ............. Stop execution upon first incomplete test
|
|
--fail-on-incomplete .................... Treat incomplete tests as failures
|
|
--fail-on-risky .............................. Treat risky tests as failures
|
|
--fail-on-skipped .......................... Treat skipped tests as failures
|
|
--fail-on-warning .................... Treat tests with warnings as failures
|
|
--repeat <times> ...................................... Runs the test(s) repeatedly
|
|
--cache-result ............................ Write test results to cache file
|
|
--do-not-cache-result .............. Do not write test results to cache file
|
|
--order-by <order> Run tests in order: default|defects|duration|no-depends|random|reverse|size
|
|
--random-order-seed <N> .......... Use a specific random seed <N> for random order
|
|
|
|
REPORTING OPTIONS:
|
|
--colors <flag> ............... Use colors in output ("never", "auto" or "always")
|
|
--columns <n> .................... Number of columns to use for progress output
|
|
--columns max ............ Use maximum number of columns for progress output
|
|
--stderr ................................. Write to STDERR instead of STDOUT
|
|
--no-progress .................... Disable output of test execution progress
|
|
--no-results ................................ Disable output of test results
|
|
--no-output ............................................. Disable all output
|
|
--display-incomplete .................. Display details for incomplete tests
|
|
--display-skipped ........................ Display details for skipped tests
|
|
--display-deprecations . Display details for deprecations triggered by tests
|
|
--display-errors ............. Display details for errors triggered by tests
|
|
--display-notices ........... Display details for notices triggered by tests
|
|
--display-warnings ......... Display details for warnings triggered by tests
|
|
--reverse-list .............................. Print defects in reverse order
|
|
--teamcity ............... Report test execution progress in TeamCity format
|
|
--testdox ............................ Report test results in TestDox format
|
|
|
|
LOGGING OPTIONS:
|
|
--log-junit <file> ................ Log test execution in JUnit XML format to file
|
|
--log-teamcity <file> .............. Log test execution in TeamCity format to file
|
|
--testdox-html <file> ................. Write documentation in HTML format to file
|
|
--testdox-text <file> ................. Write documentation in Text format to file
|
|
--testdox-xml <file> ................... Write documentation in XML format to file
|
|
--log-events-text <file> ..................... Stream events as plain text to file
|
|
--log-events-verbose-text <file> Stream events as plain text to file (with telemetry information)
|
|
--no-logging .................................. Ignore logging configuration
|
|
|
|
CODE COVERAGE OPTIONS:
|
|
--coverage ..... Generate code coverage report and output to standard output
|
|
--coverage --min Set the minimum required coverage percentage, and fail if not met
|
|
--coverage-crap4j <file> ...... Generate code coverage report in Crap4J XML format
|
|
--coverage-html <dir> .............. Generate code coverage report in HTML format
|
|
--coverage-php <file> ..................... Export PHP_CodeCoverage object to file
|
|
--coverage-text=<file> Generate code coverage report in text format [default: standard output]
|
|
--coverage-xml <dir> ........ Generate code coverage report in PHPUnit XML format
|
|
--warm-coverage-cache ........................... Warm static analysis cache
|
|
--coverage-filter <dir> ...................... Include <dir> in code coverage analysis
|
|
--path-coverage ............................. Perform path coverage analysis
|
|
--disable-coverage-ignore Disable attributes and annotations for ignoring code coverage
|
|
--no-coverage ........................... Ignore code coverage configuration
|
|
|
|
MISCELLANEOUS OPTIONS:
|
|
-h|--help .................................... Prints this usage information
|
|
--version ..................................... Prints the version and exits
|
|
--atleast-version <min> ....... Checks that version is greater than min and exits
|
|
--check-version ................ Check whether PHPUnit is the latest version
|
|
|