class PhpUnitTestRunnerTest

Same name in other branches
  1. 9 core/tests/Drupal/Tests/Core/Test/PhpUnitTestRunnerTest.php \Drupal\Tests\Core\Test\PhpUnitTestRunnerTest
  2. 8.9.x core/tests/Drupal/Tests/Core/Test/PhpUnitTestRunnerTest.php \Drupal\Tests\Core\Test\PhpUnitTestRunnerTest
  3. 10 core/tests/Drupal/Tests/Core/Test/PhpUnitTestRunnerTest.php \Drupal\Tests\Core\Test\PhpUnitTestRunnerTest

@coversDefaultClass \Drupal\Core\Test\PhpUnitTestRunner @group Test

Hierarchy

Expanded class hierarchy of PhpUnitTestRunnerTest

See also

Drupal\Tests\simpletest\Unit\SimpletestPhpunitRunCommandTest

File

core/tests/Drupal/Tests/Core/Test/PhpUnitTestRunnerTest.php, line 19

Namespace

Drupal\Tests\Core\Test
View source
class PhpUnitTestRunnerTest extends UnitTestCase {
    
    /**
     * Tests an error in the test running phase.
     *
     * @covers ::execute
     */
    public function testRunTestsError() : void {
        $test_id = 23;
        $log_path = 'test_log_path';
        // Create a mock test run storage.
        $storage = $this->getMockBuilder(SimpletestTestRunResultsStorage::class)
            ->disableOriginalConstructor()
            ->onlyMethods([
            'createNew',
        ])
            ->getMock();
        // Set some expectations for createNew().
        $storage->expects($this->once())
            ->method('createNew')
            ->willReturn($test_id);
        // Create a mock runner.
        $runner = $this->getMockBuilder(PhpUnitTestRunner::class)
            ->disableOriginalConstructor()
            ->onlyMethods([
            'xmlLogFilepath',
            'runCommand',
        ])
            ->getMock();
        // Set some expectations for xmlLogFilepath().
        $runner->expects($this->once())
            ->method('xmlLogFilepath')
            ->willReturn($log_path);
        // We mark a failure by having runCommand() deliver a serious status code.
        $runner->expects($this->once())
            ->method('runCommand')
            ->willReturnCallback(function (string $test_class_name, string $log_junit_file_path, int &$status) : string {
            $status = TestStatus::EXCEPTION;
            return ' ';
        });
        // The execute() method expects $status by reference, so we initialize it
        // to some value we don't expect back.
        $status = -1;
        $test_run = TestRun::createNew($storage);
        $results = $runner->execute($test_run, 'SomeTest', $status);
        // Make sure our status code made the round trip.
        $this->assertEquals(TestStatus::EXCEPTION, $status);
        // A serious error in runCommand() should give us a fixed set of results.
        $row = reset($results);
        $fail_row = [
            'test_id' => $test_id,
            'test_class' => 'SomeTest',
            'status' => TestStatus::label(TestStatus::EXCEPTION),
            'message' => 'PHPUnit Test failed to complete; Error: ',
            'message_group' => 'Other',
            'function' => 'SomeTest',
            'line' => '0',
            'file' => $log_path,
        ];
        $this->assertEquals($fail_row, $row);
    }
    
    /**
     * @covers ::phpUnitCommand
     */
    public function testPhpUnitCommand() : void {
        $runner = new PhpUnitTestRunner($this->root, sys_get_temp_dir());
        $this->assertMatchesRegularExpression('/phpunit/', $runner->phpUnitCommand());
    }
    
    /**
     * @covers ::xmlLogFilePath
     */
    public function testXmlLogFilePath() : void {
        $runner = new PhpUnitTestRunner($this->root, sys_get_temp_dir());
        $this->assertStringEndsWith('phpunit-23.xml', $runner->xmlLogFilePath(23));
    }
    public static function providerTestSummarizeResults() {
        return [
            [
                [
                    [
                        'test_class' => static::class,
                        'status' => 'pass',
                    ],
                ],
                '#pass',
            ],
            [
                [
                    [
                        'test_class' => static::class,
                        'status' => 'fail',
                    ],
                ],
                '#fail',
            ],
            [
                [
                    [
                        'test_class' => static::class,
                        'status' => 'exception',
                    ],
                ],
                '#exception',
            ],
            [
                [
                    [
                        'test_class' => static::class,
                        'status' => 'debug',
                    ],
                ],
                '#debug',
            ],
        ];
    }
    
    /**
     * @dataProvider providerTestSummarizeResults
     * @covers ::summarizeResults
     */
    public function testSummarizeResults($results, $has_status) : void {
        $runner = new PhpUnitTestRunner($this->root, sys_get_temp_dir());
        $summary = $runner->summarizeResults($results);
        $this->assertArrayHasKey(static::class, $summary);
        $this->assertEquals(1, $summary[static::class][$has_status]);
        foreach (array_diff([
            '#pass',
            '#fail',
            '#exception',
            '#debug',
        ], [
            $has_status,
        ]) as $should_be_zero) {
            $this->assertSame(0, $summary[static::class][$should_be_zero]);
        }
    }

}

Members

Title Sort descending Modifiers Object type Summary Overrides
ExpectDeprecationTrait::expectDeprecation public function Adds an expected deprecation.
ExpectDeprecationTrait::getCallableName private static function Returns a callable as a string suitable for inclusion in a message.
ExpectDeprecationTrait::setUpErrorHandler public function Sets up the test error handler.
ExpectDeprecationTrait::tearDownErrorHandler public function Tears down the test error handler.
PhpUnitTestRunnerTest::providerTestSummarizeResults public static function
PhpUnitTestRunnerTest::testPhpUnitCommand public function @covers ::phpUnitCommand
PhpUnitTestRunnerTest::testRunTestsError public function Tests an error in the test running phase.
PhpUnitTestRunnerTest::testSummarizeResults public function @dataProvider providerTestSummarizeResults
@covers ::summarizeResults
PhpUnitTestRunnerTest::testXmlLogFilePath public function @covers ::xmlLogFilePath
RandomGeneratorTrait::getRandomGenerator protected function Gets the random generator for the utility methods.
RandomGeneratorTrait::randomMachineName protected function Generates a unique random string containing letters and numbers.
RandomGeneratorTrait::randomObject public function Generates a random PHP object.
RandomGeneratorTrait::randomString public function Generates a pseudo-random string of ASCII characters of codes 32 to 126.
UnitTestCase::$root protected property The app root.
UnitTestCase::getClassResolverStub protected function Returns a stub class resolver.
UnitTestCase::getConfigFactoryStub public function Returns a stub config factory that behaves according to the passed array.
UnitTestCase::getConfigStorageStub public function Returns a stub config storage that returns the supplied configuration.
UnitTestCase::getContainerWithCacheTagsInvalidator protected function Sets up a container with a cache tags invalidator.
UnitTestCase::getStringTranslationStub public function Returns a stub translation manager that just returns the passed string.
UnitTestCase::setUp protected function 355
UnitTestCase::setUpBeforeClass public static function

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.