MediaWiki 1.30.2

[autoinstallsdev/mediawiki.git] / tests / phpunit / Makefile

diff --git a/tests/phpunit/Makefile b/tests/phpunit/Makefile
new file mode 100644 (file)
index 0000000..d34e183
--- /dev/null
+++ b/tests/phpunit/Makefile
@@ -0,0 +1,78 @@
+.PHONY: help test phpunit coverage warning destructive parser noparser safe databaseless list-groups
+.DEFAULT: warning
+
+SHELL = /bin/sh
+CONFIG_FILE = ${PWD}/suite.xml
+PHP = php
+PU = ${PHP} phpunit.php --configuration ${CONFIG_FILE} ${FLAGS}
+
+all test: warning
+
+warning:
+       @echo "Run 'make help' to get usage"
+       @echo ""
+       @echo "WARNING -- some tests are DESTRUCTIVE and will alter your wiki."
+       @echo "DO NOT RUN THESE TESTS on a production wiki."
+       @echo ""
+       @echo "Until the default tests are made non-destructive, you can run"
+       @echo "the destructive tests like so:"
+       @echo ""
+       @echo "    make destructive"
+       @echo ""
+       @echo "Some tests are expected to be safe, you can run them with"
+       @echo ""
+       @echo "    make safe"
+       @echo ""
+       @echo "You are recommended to run the tests with read-only credentials."
+       @echo ""
+       @echo "If you don't have a database running, you can still run"
+       @echo ""
+       @echo "    make databaseless"
+       @echo ""
+
+destructive: phpunit
+
+phpunit:
+       ${PU}
+
+tap:
+       ${PU} --tap
+
+coverage:
+       ${PU} --coverage-html ../../docs/code-coverage
+
+parser:
+       ${PU} --group Parser
+noparser:
+       ${PU} --exclude-group Parser,Broken,Stub
+
+safe:
+       ${PU} --exclude-group Broken,Destructive,Stub
+
+databaseless:
+       ${PU} --exclude-group Broken,Destructive,Database,Stub
+
+database:
+       ${PU} --exclude-group Broken,Destructive,Stub --group Database
+
+list-groups:
+       ${PU} --list-groups
+
+help:
+       # Usage:
+       #   make <target> [OPTION=value]
+       #
+       # Targets:
+       #   phpunit (default)   Run all the tests with phpunit
+       #   tap                 Run the tests individually through Test::Harness's prove(1)
+       #   help                You're looking at it!
+       #   coverage            Run the tests and generates an HTML code coverage report
+       #                       You will need the Xdebug PHP extension for the latter.
+       #   [no]parser          Skip or only run Parser tests
+       #
+       #   list-groups         List available Tests groups.
+       #
+       #  Options:
+       #   CONFIG_FILE         Path to a PHPUnit configuration file (default: suite.xml)
+       #   FLAGS               Additional flags to pass to PHPUnit
+       #   PHP                 Path to php