wiki.techinc.nl/tests/phpunit
Bryan Davis 71fc32c303 Support precomputed data in GitInfo
Support reading git repository information from a JSON file in the cache
directory. When present, this file serves to provide information needed
by getHead, getHeadSHA1, getHeadCommitDate, getCurrentBranch and a new
getRemoteUrl method. A GitInfo::precomputeValues method is also provided
which can generate the cache file for a given GitInfo instance.

This support can be combined with a deployment step to reduce the need
to repeatedly gather information from the .git files/git binary. It also
allows computing information that can be lost when directory structures
differ between deployment staging hosts and hosts running MediaWiki.

This change also adds memoization of computed values for a given GitInfo
instance which may provide a small performance boost even for
deployments which are not using precomputed cache files.

Bug: 53972
Change-Id: I66e058acc5a71e5d82644f85d819f49d6ee9d1e6
2014-05-05 23:50:12 +00:00
..
data Support precomputed data in GitInfo 2014-05-05 23:50:12 +00:00
docs Clean up ExportDemoTest 2014-03-07 21:17:08 +00:00
includes Support precomputed data in GitInfo 2014-05-05 23:50:12 +00:00
languages Adjust indent of some comment blocks 2014-05-01 18:46:34 +00:00
maintenance Pass phpcs-strict on some test files (11/11) 2014-04-24 13:51:05 -07:00
mocks Addition of a parser test for page= parameter of image inclusion 2014-04-29 19:55:44 +02:00
skins Fixed some @params documentation (tests) 2014-04-17 20:43:42 +02:00
structure Pass phpcs-strict on some test files (11/11) 2014-04-24 13:51:05 -07:00
suites Pass phpcs-strict on some test files (11/11) 2014-04-24 13:51:05 -07:00
tests Throw exception when trying to stash unset globals 2014-03-09 14:52:40 +01:00
bootstrap.php
install-phpunit.sh
LessFileCompilationTest.php Add a LESS test suite 2014-03-31 23:02:53 -04:00
Makefile
MediaWikiLangTestCase.php Pass phpcs-strict on some test files (1/x) 2014-04-24 17:05:32 +02:00
MediaWikiPHPUnitCommand.php Remove color opt setting from MediaWikiPHPUnitCommand 2014-05-05 13:09:56 +01:00
MediaWikiPHPUnitTestListener.php Pass phpcs-strict on some test files (1/x) 2014-04-24 17:05:32 +02:00
MediaWikiTestCase.php Pass phpcs-strict on some test files (1/x) 2014-04-24 17:05:32 +02:00
phpunit.php Remove color opt setting from MediaWikiPHPUnitCommand 2014-05-05 13:09:56 +01:00
README
ResourceLoaderTestCase.php Pass phpcs-strict on some test files (1/x) 2014-04-24 17:05:32 +02:00
run-tests.bat
suite.xml Remove color opt setting from MediaWikiPHPUnitCommand 2014-05-05 13:09:56 +01: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 PHPUnit is not installed, follow the installation instructions in the
PHPUnit Manual at:

  http://www.phpunit.de/manual/current/en/installation.html

- or -

On Unix-like operating systems, run:

  make install


== 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 unit tests for MediaWiki can be found at:

	http://mediawiki.org/wiki/Unit_Testing