ReflectionTest.php

<?php

declare (strict_types=1);
namespace Drupal\Tests\Component\Utility;

use Drupal\Component\Utility\Reflection;
use PHPUnit\Framework\Attributes\CoversClass;
use PHPUnit\Framework\Attributes\DataProvider;
use PHPUnit\Framework\Attributes\Group;
use PHPUnit\Framework\TestCase;

/**
 * Tests Drupal\Component\Utility\Reflection.
 */
class ReflectionTest extends TestCase {
  
  /**
   * @param string|null $expected
   *   The expected value of the parameter.
   * @param \ReflectionParameter $parameter
   *   The reflection parameter.
   *
   * @legacy-covers ::getParameterClassName
   */
  public function testGetParameterClassName(?string $expected, \ReflectionParameter $parameter) : void {
    $this->assertEquals($expected, Reflection::getParameterClassName($parameter));
  }
  
  /**
   * Data provider for ::testGetParameterClassName().
   *
   * @return array[]
   *   An array of test cases. Each test case is an associative array containing:
   *   - string|null $expected: The expected class name.
   *   - \ReflectionParameter $parameter: The reflection parameter.
   */
  public static function providerGetParameterClassName() {
    $reflection_method = new \ReflectionMethod(static::class, 'existsForTesting');
    $parameters = $reflection_method->getParameters();
    return [
      'string' => [
        NULL,
        $parameters[0],
      ],
      'array' => [
        NULL,
        $parameters[1],
      ],
      'same class' => [
        'Drupal\\Tests\\Component\\Utility\\ReflectionTest',
        $parameters[2],
      ],
      'class' => [
        'Drupal\\Component\\Utility\\Reflection',
        $parameters[3],
      ],
      'parent' => [
        'PHPUnit\\Framework\\TestCase',
        $parameters[4],
      ],
      'self' => [
        'Drupal\\Tests\\Component\\Utility\\ReflectionTest',
        $parameters[5],
      ],
    ];
  }
  
  /**
   * This method exists for reflection testing only.
   *
   * Note the capital P in Parent is intentional and for testing purposes.
   */
  // phpcs:disable Generic.PHP.LowerCaseKeyword.Found
  protected function existsForTesting(string $string, array $array, ReflectionTest $test, Reflection $reflection, Parent $parent, self $self) {
  }
  // phpcs:enable

}