<?php

declare(strict_types=1);

namespace Drupal\Tests\Core\Routing;

use Drupal\Core\Routing\RouteMatchInterface;
use Drupal\Tests\UnitTestCase;
use PHPUnit\Framework\Attributes\DataProvider;
use Symfony\Component\Routing\Route;

/**
 * Base test class for testing classes implementing the route match interface.
 */
abstract class RouteMatchTestBase extends UnitTestCase {

  /**
   * Build a test route match object for the given implementation.
   *
   * @param string $name
   *   Route name.
   * @param \Symfony\Component\Routing\Route $route
   *   Request object.
   * @param array $parameters
   *   Parameters array.
   * @param array $raw_parameters
   *   Raw parameters array.
   *
   * @return \Drupal\Core\Routing\RouteMatchInterface
   *   The constructed route match instance.
   */
  abstract protected static function getRouteMatch(string $name, Route $route, array $parameters, array $raw_parameters): RouteMatchInterface;

  /**
   * Provide sets of parameters and expected parameters for parameter tests.
   */
  public static function routeMatchProvider(): array {
    $base_data = [
      [
        new Route(
          '/test-route/{param_without_leading_underscore}/{_param_with_leading_underscore}',
          [
            'default_without_leading_underscore' => NULL,
            '_default_with_leading_underscore' => NULL,
          ]
        ),
        [
          'param_without_leading_underscore' => 'value',
          '_param_with_leading_underscore' => 'value',
          'default_without_leading_underscore' => 'value',
          '_default_with_leading_underscore' => 'value',
          'foo' => 'value',
        ],
        // Parameters should be filtered to only those defined by the route.
        // Specifically:
        // - Path parameters, regardless of name.
        // - Defaults that are not path parameters only if they do not start
        //   with an underscore.
        [
          'param_without_leading_underscore' => 'value',
          '_param_with_leading_underscore' => 'value',
          'default_without_leading_underscore' => 'value',
        ],
      ],
    ];

    $data = [];
    foreach ($base_data as $entry) {
      $route = $entry[0];
      $params = $entry[1];
      $expected_params = $entry[2];
      $data[] = [
        static::getRouteMatch('test_route', $route, $params, $params),
        $route,
        $params,
        $expected_params,
      ];
    }

    return $data;
  }

  /**
   * Tests get route name.
   */
  #[DataProvider('routeMatchProvider')]
  public function testGetRouteName(RouteMatchInterface $route_match, Route $route, array $parameters, array $expected_filtered_parameters): void {
    $this->assertSame('test_route', $route_match->getRouteName());
  }

  /**
   * Tests get route object.
   */
  #[DataProvider('routeMatchProvider')]
  public function testGetRouteObject(RouteMatchInterface $route_match, Route $route, array $parameters, array $expected_filtered_parameters): void {
    $this->assertSame($route, $route_match->getRouteObject());
  }

  /**
   * Tests get parameter.
   *
   * @legacy-covers ::getParameter
   * @legacy-covers \Drupal\Core\Routing\RouteMatch::getParameterNames
   */
  #[DataProvider('routeMatchProvider')]
  public function testGetParameter(RouteMatchInterface $route_match, Route $route, array $parameters, array $expected_filtered_parameters): void {
    foreach ($expected_filtered_parameters as $name => $expected_value) {
      $this->assertSame($expected_value, $route_match->getParameter($name));
    }
    foreach (array_diff_key($parameters, $expected_filtered_parameters) as $name) {
      $this->assertNull($route_match->getParameter($name));
    }
  }

  /**
   * Tests get parameters.
   *
   * @legacy-covers ::getParameters
   * @legacy-covers \Drupal\Core\Routing\RouteMatch::getParameterNames
   */
  #[DataProvider('routeMatchProvider')]
  public function testGetParameters(RouteMatchInterface $route_match, Route $route, array $parameters, array $expected_filtered_parameters): void {
    $this->assertSame($expected_filtered_parameters, $route_match->getParameters()->all());
  }

  /**
   * Tests get raw parameter.
   *
   * @legacy-covers ::getRawParameter
   * @legacy-covers \Drupal\Core\Routing\RouteMatch::getParameterNames
   */
  #[DataProvider('routeMatchProvider')]
  public function testGetRawParameter(RouteMatchInterface $route_match, Route $route, array $parameters, array $expected_filtered_parameters): void {
    foreach ($expected_filtered_parameters as $name => $expected_value) {
      $this->assertSame($expected_value, $route_match->getRawParameter($name));
    }
    foreach (array_diff_key($parameters, $expected_filtered_parameters) as $name) {
      $this->assertNull($route_match->getRawParameter($name));
    }
  }

  /**
   * Tests get raw parameters.
   *
   * @legacy-covers ::getRawParameters
   * @legacy-covers \Drupal\Core\Routing\RouteMatch::getParameterNames
   */
  #[DataProvider('routeMatchProvider')]
  public function testGetRawParameters(RouteMatchInterface $route_match, Route $route, array $parameters, array $expected_filtered_parameters): void {
    $this->assertSame($expected_filtered_parameters, $route_match->getRawParameters()->all());
  }

}