wiki.techinc.nl/tests/phpunit
daniel 047151c692 Introduce DB schema overrides for unit tests.
This introduces MediaWikiTestCase::getSchemaOverrides,  which can be overwritten
to return information about which tables are going to be altered, and which SQL
files should be used to set up the target schema. This allows tests for a class
that interacts with the database can have a subclass for each supported database
schema.

NOTE: this has only been tested with MySQL.

Bug: T180705
Change-Id: I7a4071072d802a82ecf7d16fbf8882ff8c79287f
2018-01-05 16:23:55 +00:00
..
data Merge "Add a few schemas to SQLite tests" 2017-10-17 22:37:32 +00:00
docs
includes Merge "[MCR] Tests for WikiPage::doUpdateRestrictions" 2018-01-05 10:24:19 +00:00
languages Generalize non-digit-grouping of four-digit numbers 2018-01-02 11:17:25 +01:00
maintenance build: Updating mediawiki/mediawiki-codesniffer to 15.0.0 2018-01-01 14:10:16 +01:00
mocks RCFilters: define consistent interface in ChangesListFilterGroup 2017-10-18 12:44:51 -07:00
skins Add @covers tags to miscellaneous tests (#2) 2017-12-28 08:52:48 +00:00
structure Use MediaWikiCoversValidator for tests that don't use MediaWikiTestCase 2018-01-01 08:28:02 +00:00
suites Check requirements for parser test suite in phpunit tests 2017-09-14 19:03:02 +00:00
tests Introduce DB schema overrides for unit tests. 2018-01-05 16:23:55 +00:00
autoload.ide.php Setup: Include StartProfiler before others 2017-11-09 16:35:19 -08:00
bootstrap.php
LessFileCompilationTest.php
Makefile
MediaWikiCoversValidator.php Verify that all @covers tags are sane when running tests 2017-12-29 20:19:12 +00:00
MediaWikiLangTestCase.php
MediaWikiPHPUnitTestListener.php
MediaWikiTestCase.php Introduce DB schema overrides for unit tests. 2018-01-05 16:23:55 +00:00
phpunit.php phpunit.php: omit --quiet in help 2017-09-17 06:15:38 +00:00
README
ResourceLoaderTestCase.php Improve some parameter docs 2017-09-10 20:32:31 +02:00
run-tests.bat
suite.xml phpunit: Exclude /languages/messages from coverage report 2017-07-27 21:03:18 -07:00
TODO

== MediaWiki PHPUnit Tests ==

The unit tests for MediaWiki are implemented using the PHPUnit testing
framework and require PHPUnit to run.


=== WARNING ===

Some of the unit tests are DESTRUCTIVE and WILL ALTER YOUR WIKI'S CONTENTS.

DO NOT RUN THESE TESTS ON A PRODUCTION SYSTEM OR ON ANY SYSTEM WHERE YOU NEED
TO RETAIN YOUR DATA.


== Installation ==

If you used composer to install MediaWiki's dependencies PHPUnit will already be available, unless
you explicitly specified the --no-dev flag during the install. In this case just run "composer update".

Otherwise follow the installation instructions in the
PHPUnit Manual at:

  https://phpunit.de/manual/current/en/installation.html


== Running tests ==

The tests are run from your operating system's command line.

Ensure that you are in the tests/phpunit directory of your MediaWiki
installation.


On Unix-like operating systems, the tests runs are controlled with a makefile.
Run command:

  make help

for a full list of options for running tests.


On Windows-family operating systems, run the 'run-tests.bat' batch file.


=== Writing tests ===

A guide to writing PHP unit tests for MediaWiki can be found at:

	https://www.mediawiki.org/wiki/Manual:PHP_unit_testing