This is the global ILIAS test suite. More...

Inheritance diagram for ilGlobalSuite:

Collaboration diagram for ilGlobalSuite:

Public Member Functions
	hasInstalledILIAS ()
	Check if there is an installed ILIAS to run tests on. More...

Static Public Member Functions
static	suite ()

Data Fields
const	PHPUNIT_GROUP_FOR_TESTS_REQUIRING_INSTALLED_ILIAS = "needsInstalledILIAS"

const	REGEX_TEST_FILENAME = "#[a-zA-Z]+Test\.php#"

const	PHP_UNIT_PARENT_CLASS = TestCase::class

Static Protected Member Functions
static	addTestFolderToSuite (ilGlobalSuite $suite)
	Find and add all testSuits beneath ILIAS_ROOL/tests - folder. More...

Detailed Description

This is the global ILIAS test suite.

It searches automatically for components test suites by scanning all Modules/.../test and Services/.../test directories for test suite files.

Test suite files are identified automatically, if they are named "ilServices[ServiceName]Suite.php" or ilModules[ModuleName]Suite.php".

Author: alex..nosp@m.kill.nosp@m.ing@g.nosp@m.mx.d.nosp@m.e

Definition at line 19 of file ilGlobalSuite.php.

Member Function Documentation

◆ addTestFolderToSuite()

static ilGlobalSuite::addTestFolderToSuite ( ilGlobalSuite $suite )

staticprotected

Find and add all testSuits beneath ILIAS_ROOL/tests - folder.

Parameters

ilGlobalSuite $suite

Returns: ilGloblaSuite $suite

Definition at line 123 of file ilGlobalSuite.php.

    {
        $test_directories = array("tests");
        while ($aux_dir = current($test_directories)) {
            if ($handle = opendir($aux_dir)) {
                $aux_dir .= DIRECTORY_SEPARATOR;
                while (false !== ($entry = readdir($handle))) {
                    if ($entry === '.' || $entry === '..') {
                        continue;
                    }
                    if (is_dir($aux_dir . $entry)) {
                        $test_directories[] = $aux_dir . $entry;
                    } else {
                        if (1 === preg_match(self::REGEX_TEST_FILENAME, $entry)) {
                            $ref_declared_classes = get_declared_classes();
                            require_once $aux_dir . "/" . $entry;
                            $new_declared_classes = array_diff(get_declared_classes(), $ref_declared_classes);
                            foreach ($new_declared_classes as $entry_class) {
                                $reflection = new ReflectionClass($entry_class);
                                if (!$reflection->isAbstract() && $reflection->isSubclassOf(self::PHP_UNIT_PARENT_CLASS)) {
                                    echo "Adding Test-Suite: " . $entry_class . "\n";
                                    $suite->addTestSuite($entry_class);
                                }
                            }
                        }
                    }
                }
            }
            next($test_directories);
        }
        return $suite;
    }

References $suite.

Referenced by suite().

Here is the caller graph for this function:

◆ hasInstalledILIAS()

ilGlobalSuite::hasInstalledILIAS ( )

Check if there is an installed ILIAS to run tests on.

TODO: implement me correctly!

Returns: bool

Definition at line 34 of file ilGlobalSuite.php.

    {
        $ilias_ini_path = __DIR__ . "/../../../ilias.ini.php";
 
        if (!is_file($ilias_ini_path)) {
            return false;
        }
        require_once './Services/Init/classes/class.ilIniFile.php';
        $ilias_ini = new ilIniFile($ilias_ini_path);
        $ilias_ini->read();
        $client_data_path = $ilias_ini->readVariable("server", "absolute_path") . "/" . $ilias_ini->readVariable("clients", "path");
 
        if (!is_dir($client_data_path)) {
            return false;
        }
 
        include_once($ilias_ini->readVariable("server", "absolute_path") . "/Services/PHPUnit/config/cfg.phpunit.php");
 
        if (!isset($_GET["client_id"])) {
            return false;
        }
 
        $phpunit_client = $_GET["client_id"];
 
        if (!$phpunit_client) {
            return false;
        }
 
        if (!is_file($client_data_path . "/" . $phpunit_client . "/client.ini.php")) {
            return false;
        }
 
        return true;
    }

References $_GET.

◆ suite()

static ilGlobalSuite::suite ( )

static

Definition at line 69 of file ilGlobalSuite.php.

    {
        $suite = new ilGlobalSuite();
        echo "ILIAS PHPUnit-Tests need installed dev-requirements, please install using 'composer install' in ./libs/composer \n";
        echo "\n";
        
        // scan Modules and Services directories
        $basedirs = array("Services", "Modules");
 
        foreach ($basedirs as $basedir) {
            // read current directory
            $dir = opendir($basedir);
 
            while ($file = readdir($dir)) {
                if ($file != "." && $file != ".." && is_dir($basedir . "/" . $file)) {
                    $suite_path =
                        $basedir . "/" . $file . "/test/il" . $basedir . $file . "Suite.php";
                    if (is_file($suite_path)) {
                        include_once($suite_path);
                        
                        $name = "il" . $basedir . $file . "Suite";
                        $s = $name::suite();
                        echo "Adding Suite: " . $name . "\n";
                        $suite->addTest($s);
                        //$suite->addTestSuite("ilSettingTest");
                    }
                }
            }
        }
 
        $suite = self::addTestFolderToSuite($suite);
 
        echo "\n";
 
        if (!$suite->hasInstalledILIAS()) {
            echo "Removing tests requiring an installed ILIAS.\n";
            $ff = new FilterFactory();
            $ff->addFilter(
                new ReflectionClass(GroupExcludeFilter::class),
                array(self::PHPUNIT_GROUP_FOR_TESTS_REQUIRING_INSTALLED_ILIAS)
                );
            $suite->injectFilter($ff);
        } else {
            echo "Found installed ILIAS, running all tests.\n";
        }
        return $suite;
    }

References $name, $suite, and addTestFolderToSuite().

Here is the call graph for this function:

Field Documentation

◆ PHP_UNIT_PARENT_CLASS

const ilGlobalSuite::PHP_UNIT_PARENT_CLASS = TestCase::class

Definition at line 26 of file ilGlobalSuite.php.

◆ PHPUNIT_GROUP_FOR_TESTS_REQUIRING_INSTALLED_ILIAS

const ilGlobalSuite::PHPUNIT_GROUP_FOR_TESTS_REQUIRING_INSTALLED_ILIAS = "needsInstalledILIAS"

Definition at line 24 of file ilGlobalSuite.php.

◆ REGEX_TEST_FILENAME

const ilGlobalSuite::REGEX_TEST_FILENAME = "#[a-zA-Z]+Test\.php#"

Definition at line 25 of file ilGlobalSuite.php.

The documentation for this class was generated from the following file:

Services/PHPUnit/test/ilGlobalSuite.php

Public Member Functions

Static Public Member Functions

Data Fields

Static Protected Member Functions