MediaWikiParserTest.php

Go to the documentation of this file.

<?php
require_once __DIR__ . '/NewParserTest.php';

class MediaWikiParserTest {

    const CORE_ONLY = 1;
    const NO_CORE = 2;
    const WITH_ALL = 3; # CORE_ONLY | NO_CORE

    public static function suite( $flags = self::CORE_ONLY ) {
        if ( is_string( $flags ) ) {
            $flags = self::CORE_ONLY;
        }
        global $wgParserTestFiles, $IP;

        $mwTestDir = $IP . '/tests/';

        # Human friendly helpers
        $wantsCore = ( $flags & self::CORE_ONLY );
        $wantsRest = ( $flags & self::NO_CORE );

        # Will hold the .txt parser test files we will include
        $filesToTest = array();

        # Filter out .txt files
        foreach ( $wgParserTestFiles as $parserTestFile ) {
            $isCore = ( 0 === strpos( $parserTestFile, $mwTestDir ) );

            if ( $isCore && $wantsCore ) {
                self::debug( "included core parser tests: $parserTestFile" );
                $filesToTest[] = $parserTestFile;
            } elseif ( !$isCore && $wantsRest ) {
                self::debug( "included non core parser tests: $parserTestFile" );
                $filesToTest[] = $parserTestFile;
            } else {
                self::debug( "skipped parser tests: $parserTestFile" );
            }
        }
        self::debug( 'parser tests files: '
            . implode( ' ', $filesToTest ) );

        $suite = new PHPUnit_Framework_TestSuite;
        foreach ( $filesToTest as $fileName ) {
            $testsName = basename( $fileName, '.txt' );
            $escapedFileName = strtr( $fileName, array( "'" => "\\'", '\\' => '\\\\' ) );
            /* This used to be ucfirst( basename( dirname( $filename ) ) )
             * and then was ucfirst( basename( $filename, '.txt' )
             * but that didn't work with names like foo.tests.txt
             */
            $parserTestClassName = str_replace( '.', '_', ucfirst( $testsName ) );
            $parserTestClassDefinition = <<<EOT
class $parserTestClassName extends NewParserTest {
    protected \$file = '$escapedFileName';
}
EOT;

            eval( $parserTestClassDefinition );
            self::debug( "Adding test class $parserTestClassName" );
            $suite->addTestSuite( $parserTestClassName );
        }
        return $suite;
    }

    protected static function debug( $msg ) {
        return wfDebugLog( 'tests-parser', wfGetCaller() . ' ' . $msg );
    }
}